# Przegląd (/pl-PL/aan-de-slag)

Na tej stronie przejdziesz przez swój pierwszy dzień w Tillor: od logowania do pierwszej faktury. Kolejność ma znaczenie, bo każdy element opiera się na poprzednim. Na przykład długoterminowe zajęcie miejsca wymaga klienta i działki, dlatego tworzysz je najpierw. Wolisz pójść za przykładem z prawdziwego życia? Zajrzyj do [Z praktyki](/praktijk). Gdy trafisz na nieznane słowo, sprawdź je w [Pojęciach](/begrippen).

## Jak to się łączy? [#hoe-hangt-dit-samen]

Oto elementy składowe i to, czego potrzebują:

```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]
```

Faktura zawsze należy do klienta. Klienta na działce przez dłuższy czas nazywamy zajęciem miejsca (bezetting), a pobyt z datą zameldowania i wymeldowania rezerwacją. Produkty nie są obowiązkowe, ale dzięki nim cena, VAT i akcje na pozycji faktury są ustawione poprawnie.

<Callout type="info" title="Warto wiedzieć">
- Jeśli masz więcej niż jedną organizację, po zalogowaniu wybierasz jedną z nich. Brakuje którejś? Poproś administratora o zaproszenie.
- To, które pozycje menu widzisz, zależy od Twoich uprawnień. Nie widzisz czegoś? Poproś administratora o uprawnienie.
- Bez działki nie utworzysz zajęcia miejsca. Bez klienta nie utworzysz rezerwacji, zajęcia miejsca ani faktury.
- Płatności gotówką, przelewem i inne ręczne działają bez integracji. Do płatności online lub kartą na terminalu połącz Mollie.
- Najszybszy sposób, by coś znaleźć, to wyszukiwanie przez **Ctrl+K** lub **⌘K**.
</Callout>

Zanim zaczniesz:

- Masz konto Microsoft, Google lub Apple, a administrator zaprosił Cię do Twojej organizacji. Bez zaproszenia nie zobaczysz żadnej organizacji.
- Masz uprawnienia do tego, co chcesz zrobić. Jeśli ich brakuje, pozycji menu nie ma albo przycisk jest wyszarzony.

## Konfiguracja parku [#je-park-inrichten]

<Steps>
<Step>
### Zaloguj się i wybierz organizację [#log-in-en-kies-je-organisatie]
Zaloguj się kontem Microsoft, Google lub Apple. Jeśli masz dostęp do więcej niż jednej organizacji, wybierz jedną. Nie masz jeszcze dostępu? Poproś administratora o zaproszenie. Zobacz [Logowanie](/inloggen).
</Step>
<Step>
### Przejrzyj ustawienia organizacji [#loop-de-organisatie-instellingen-na]
Otwórz <UIPath>Pomoc > Ustawienia</UIPath>. W sekcji **Ogólne** sprawdź strefę czasową i domyślny kraj, a w sekcji **Godziny otwarcia** wpisz swoje godziny otwarcia. W sekcji **Fakturowanie** znajdziesz między innymi domyślny termin płatności i stawki VAT. Współpracowników zapraszasz w sekcji **Użytkownicy**. Zobacz [Organizacja](/gebruikers/organisaties).
</Step>
<Step>
### Utwórz działki [#maak-je-terreinen-aan]
Przejdź do <UIPath>Park > Działki</UIPath> i dodaj swoje miejsca, takie jak pola kempingowe, domki i stałe stanowiska. Bez działki nie utworzysz zajęcia miejsca, a liczniki przypisujesz do działki. Zobacz [Działki](/terreinen).
</Step>
<Step>
### Utwórz produkty [#maak-je-producten-aan]
Przejdź do <UIPath>Administracja > Produkty</UIPath> i utwórz taryfy oraz usługi, które trafiają na faktury, na przykład noclegi. Pozycja faktury może też działać bez produktu, ale z produktem cena, VAT i ewentualne akcje są od razu ustawione poprawnie. Zobacz [Produkty](/producten).
</Step>
<Step>
### Dodaj klientów [#voeg-je-klanten-toe]
Przejdź do <UIPath>Klienci > Podsumowanie</UIPath> i utwórz klienta. Rezerwacje, zajęcia miejsc i faktury zawsze należą do klienta. Zobacz [Zarządzanie klientami](/klantenbeheer).
</Step>
<Step>
### Utwórz rezerwację lub zajęcie miejsca [#maak-een-reservering-of-bezetting-aan]
Rezerwacja dotyczy pobytu z datą zameldowania i wymeldowania i możesz ją utworzyć także bez stałej działki. Zajęcie miejsca łączy klienta z działką na dłuższy czas, na przykład stanowisko całoroczne. Zobacz [Rezerwacje](/reserveringen) i [Zajęcia miejsc](/bezettingen).
</Step>
<Step>
### Wystaw pierwszą fakturę [#maak-je-eerste-factuur]
Otwórz profil klienta i utwórz tam nową fakturę. Dodaj pozycje, zaksięguj fakturę i wyślij ją. Zobacz [Faktury](/facturen).
</Step>
<Step>
### Połącz płatności [#koppel-betalingen]
Chcesz, aby klienci płacili online lub kartą na terminalu? Połącz Mollie w <UIPath>Pomoc > Ustawienia</UIPath> w sekcji **Integracje**. Płatności gotówką, przelewem i inne ręczne działają bez integracji. Zobacz [Przetwarzanie płatności](/betalingsverwerking) i [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).
</Step>
</Steps>

Jeśli korzystasz z liczników, szlabanów lub tagów NFC, skonfiguruj je w dalszej kolejności. Najpierw zajrzyj do [Parku](/park) i [Kontroli dostępu](/toegangscontrole).

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Twoi klienci, działki i produkty są gotowe, więc na co dzień możesz tworzyć rezerwacje, zajęcia miejsc i faktury.
- Twoja pierwsza faktura czeka u klienta jako szkic. Dopiero po zaksięgowaniu dostaje ostateczny numer, a potem możesz ją wysłać i pozwolić klientowi zapłacić.
- Jeśli połączysz Mollie, klienci mogą płacić online lub kartą na terminalu, a płatność sama wraca na fakturę.

## Poruszanie się po systemie [#je-weg-vinden]

Menu główne znajduje się po lewej stronie. Na górze przełączasz organizację, jeśli masz ich więcej niż jedną. To, które pozycje widzisz, zależy od Twoich uprawnień.

<DocScreenshot src="/screenshots/inleiding/dashboard-welcome.png" alt="Panel - ekran startowy po zalogowaniu" />

| Menu | Do czego służy |
|------|----------------|
| **Panel** | Ekran startowy z dzisiejszymi przyjazdami i wyjazdami |
| **Rezerwacje** | Pobyty i kalendarz rezerwacji |
| **Zadania** | Rozdzielanie i śledzenie pracy |
| **Kontrola dostępu** | Punkty dostępu i dziennik dostępu |
| **Klienci** | **Podsumowanie** i **Niezafakturowane zużycie** |
| **Park** | **Mapa**, **Działki**, **Liczniki**, **Szafki licznikowe** i **Pogoda** |
| **Komunikacja** | **Połączenia telefoniczne**, **Powiadomienia** i **Uwagi** |
| **Administracja** | **Dokumenty**, **Podpisy**, **Faktury**, **Płatności**, **Transakcje bankowe** (z uprawnieniem do ich przeglądania), **Raporty płatności**, **Kolejka druku** i **Produkty** |

Pod nagłówkiem **Administrator** znajdziesz **Automatyzacje** (z uprawnieniem do ich przeglądania) i **Kontrolery**. Na dole, w sekcji **Pomoc**, są Twoje powiadomienia, **Skrzynka odbiorcza** i **Dziennik audytu** (z odpowiednimi uprawnieniami), **Ustawienia** oraz **Więcej zasobów** z dokumentacją. To, które pozycje widzisz, zależy od Twoich uprawnień.

Wyszukiwanie uruchamiasz przyciskiem **Szukaj** w nagłówku albo skrótem **⌘K** (Mac) lub **Ctrl+K** (Windows). Przeskakujesz nim od razu do klienta, faktury, rezerwacji lub działki. Zobacz [Wyszukiwanie](/zoeken).

Swoje konto, sesje i klucze API znajdziesz pod swoim imieniem na dole menu.


## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę wejść do swojej organizacji">
Administrator musi Cię najpierw zaprosić. Zaloguj się kontem, na które Cię zaprosił. Zobacz [Logowanie](/inloggen).
</Accordion>
<Accordion title="Nie widzę pozycji menu, która jest opisana w tej instrukcji">
Widzisz tylko te pozycje, do których masz uprawnienia. Poproś administratora o uprawnienie lub o rolę, która je zawiera.
</Accordion>
<Accordion title="Nie mogę utworzyć zajęcia miejsca">
Nie ma dostępnej działki albo klient jeszcze nie istnieje. Najpierw utwórz działkę i klienta. Działka z trwającym zajęciem miejsca nie pojawia się na liście wyboru.
</Accordion>
<Accordion title="Nie wiem, gdzie coś znaleźć">
Użyj przycisku **Szukaj** w nagłówku albo wyszukaj w tej instrukcji za pomocą paska wyszukiwania na górze.
</Accordion>
</Accordions>

## Potrzebujesz pomocy? [#hulp-nodig]

- Szukasz czegoś w tej instrukcji? Użyj paska wyszukiwania na górze albo wybierz w Tillor **Więcej zasobów > Dokumentacja**.
- Tillor nie działa tak, jak powinien? Sprawdź najpierw [status systemu](https://status.tillor.eu), czy nie ma awarii i planowanych prac.
- Brakuje Ci dostępu do organizacji albo chcesz zmienić dane firmy na fakturach? Napisz na support@tillor.eu.
- Chcesz odzyskać dane z kopii zapasowej? Zobacz [Dane i kopie zapasowe](/gegevens-backups).

## Pojęcia [#begrippen]

- **Organizacja**: Twoje konto Tillor, zwykle Twoja firma. Zobacz [Pojęcia](/begrippen#organisatie).
- **Park**: fizyczne miejsce. Zobacz [Pojęcia](/begrippen#park).
- **Klient**: osoba lub firma w Tillor. Zobacz [Pojęcia](/begrippen#klant).
- **Działka**: miejsce w Twoim parku. Zobacz [Pojęcia](/begrippen#terrein).
- **Zajęcie miejsca** i **rezerwacja**: klient na działce przez dłuższy czas albo pobyt z datą zameldowania i wymeldowania. Zobacz [Pojęcia](/begrippen#bezetting).
- **Księgowanie**: nadanie fakturze ostatecznej postaci. Zobacz [Pojęcia](/begrippen#boeken).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Z praktyki" href="/praktijk" description="Rozbudowane przykłady z dnia pracy" />
  <Card title="Pojęcia" href="/begrippen" description="Wszystkie terminy w jednym miejscu" />
  <Card title="Logowanie" href="/inloggen" description="Metody logowania i Twoje konto" />
  <Card title="Wyszukiwanie" href="/zoeken" description="Szybko znajdź to, czego szukasz" />
  <Card title="Dane i kopie zapasowe" href="/gegevens-backups" description="Okresy przechowywania i odtwarzanie" />
  <Card title="Co nowego" href="/wat-is-nieuw" description="Ostatnie zmiany miesiąc po miesiącu" />
</Cards>


# Pojęcia (/pl-PL/begrippen)

Tillor często używa kilku słów, a niektóre z nich są do siebie podobne. Na tej stronie przy każdym pojęciu znajdziesz, co oznacza i gdzie przeczytasz o nim więcej. Lista jest ułożona alfabetycznie według holenderskich nazw. Szukasz czegoś o samych kontrolerach, jak ACL czy firmware? Zajrzyj do [słownika kontrolerów](/controllers/lexicon).

<Callout type="info" title="Dwa słowa, które często się mylą">
**Zajęcie miejsca** (bezetting) to klient, który stoi na działce przez dłuższy czas, na przykład klient sezonowy. **Rezerwacja** to rezerwacja jednego pobytu. Przez **księgowanie** Tillor zawsze rozumie nadanie fakturze ostatecznej postaci, nigdy rezerwowanie pobytu.
</Callout>

### Upomnienie (Aanmaning) [#aanmaning]

Przypomnienie dla klienta, że zaksięgowana faktura nie została jeszcze zapłacona. Wysyłasz je dla każdej faktury, z tym samym linkiem do zapłaty online. Zobacz [Wysyłanie upomnienia](/facturen/versturen#een-aanmaning-versturen).

### Automatyzacja (Automatisering) [#automatisering]

Reguła, którą Tillor wykonuje sam: gdy zdarzy się to, zrób tamto. Na przykład utwórz zadanie kontrolne, gdy kończy się zajęcie miejsca. Kroki jednej automatyzacji tworzą razem flow, rysunek na kanwie. Zobacz [Automatyzacje](/automatiseringen).

### Płatność (Betaling) [#betaling]

Kwota, którą klient płaci lub która jest jeszcze w drodze, z metodą, statusem i zwykle fakturą. Znajdziesz je w <UIPath>Administracja > Płatności</UIPath>. Zobacz [Wyszukiwanie płatności](/betalingsverwerking/betalingen-bekijken).

### Grupa płatności (Betalingsgroep) [#betalingsgroep]

Pakiet płatności pod jedną nazwą, który później jednym ruchem przypisujesz do zaksięgowanej faktury. Na przykład wszystkie płatności kartą z jednego dnia. Zobacz [Grupy płatności](/betalingsverwerking/groepen).

### Raport płatności (Betalingsrapport) [#betalingsrapport]

Zestawienie wszystkich płatności z jednego dnia kalendarzowego, przeznaczone dla Twojej księgowości. Raport z dzisiaj jest szkicem i staje się ostateczny, gdy dzień się skończy. Zobacz [Raporty płatności](/boekhouden/betalingsrapporten).

### Strona dowodowa (Bewijspagina) [#bewijspagina]

Strony na końcu podpisanego pliku PDF, z tytułem dokumentu, informacją, kto i kiedy podpisał, oraz dwoma cyfrowymi odciskami palca. Nazywają się **Dowód podpisania** i później pokazują, że dokument nie został zmieniony. Zobacz [Dowód i ważność](/handtekeningen/bewijs-en-geldigheid).

### Zajęcie miejsca (Bezetting) [#bezetting]

Klient, który stoi na działce przez dłuższy okres. Dopóki zajęcie miejsca trwa, Tillor przypisuje temu klientowi zużycie liczników na tej działce. Działka ma najwyżej jednego klienta naraz. Zobacz [Zajęcia miejsc](/bezettingen).

### Księgowanie (Boeken) [#boeken]

Nadanie szkicowi faktury ostatecznej postaci. Faktura dostaje numer i potem nie możesz jej już dowolnie zmieniać. To słowo nie ma w Tillor nic wspólnego z rezerwowaniem. Zobacz [Księgowanie faktury](/facturen/boeken).

### Szkic (Concept) [#concept]

Faktura, która nie jest jeszcze zaksięgowana. Możesz jeszcze zmieniać pozycje i nic nie poszło jeszcze do klienta ani do księgowości. Zobacz [Statusy faktury](/facturen/statussen).

### Connector [#connector]

Małe urządzenie w sieci Twojego parku, które łączy Tillor z urządzeniami na miejscu, takimi jak drukarki i kontrolery dostępu. Tillor dostarcza je wstępnie skonfigurowane i sam je aktualizuje. Zobacz [Connector](/connector).

### Kontroler (Controller) [#controller]

Urządzenie z ekranem dotykowym na Twoim parku, przy prysznicu lub drzwiach. Odczytuje tag NFC lub kod QR, a Tillor decyduje, czy gość może wejść. Kontrolerami zarządzasz w **Kontrolery**. Zobacz [Kontrolery](/controllers).

### Faktura korygująca (Creditnota) [#creditnota]

Faktura z kwotami ujemnymi, która znosi wcześniejszą fakturę. Aplikacja nazywa ją **fakturą kredytową**. Tworzysz ją przyciskiem **Stornuj fakturę**. Zobacz [Storno faktury](/facturen/corrigeren#een-factuur-omkeren).

### Pole niestandardowe (Eigen veld) [#eigen-veld]

Pole, które Twoja organizacja sama dodaje do klienta, działki, zajęcia miejsca, licznika lub zadania, ponad pola, które dostarcza Tillor. Zarządzasz nimi w <UIPath>Ustawienia > Pola niestandardowe</UIPath>. Zobacz [Pola niestandardowe](/eigen-velden).

### Faktura (Factuur) [#factuur]

To, czym obciążasz klienta, z pozycjami według produktów. Nowa faktura jest zawsze szkicem. Tworzysz ją w profilu klienta, a wszystkimi fakturami zarządzasz w <UIPath>Administracja > Faktury</UIPath>. Zobacz [Faktury](/facturen).

### Zdarzenie (Gebeurtenis) [#gebeurtenis]

Wiersz na osi czasu klienta, faktury lub innego rekordu, który pokazuje, co się stało, kto to zrobił i co się zmieniło. Zobacz [Dziennik aktywności](/activiteitenlog).

### Użytkownik (Gebruiker) [#gebruiker]

Konto z dostępem do Tillor. W zwykłym tekście innego użytkownika nazywamy współpracownikiem. Użytkownikami i ich uprawnieniami zarządzasz w <UIPath>Ustawienia > Użytkownicy</UIPath>. Zobacz [Organizacja](/gebruikers/organisaties).

### Grupa (Groep) [#groep]

Stały zestaw współpracowników, na przykład **Recepcja**. Przypisujesz zadania do grupy, udostępniasz widoki grupie i możesz nadać grupie uprawnienia lub je odebrać. Zobacz [Grupy](/gebruikers/groepen). Grupa płatności to coś innego.

### Księga główna (Grootboek) [#grootboek]

Numer konta w Twojej księgowości, na które księgowany jest produkt. Wpisujesz go przy produkcie i jest przekazywany razem z danymi do księgowości. Zobacz [Numer konta księgi głównej](/producten/product-aanmaken#grootboeknummer).

### Polecenie zapłaty (Incasso) [#incasso]

Tillor sam pobiera kwotę faktury z rachunku bankowego klienta. Jest to możliwe tylko z aktywnym mandatem. Zobacz [Pobranie kwoty faktury](/betalingsverwerking/incasso).

### Lista wyboru (Keuzelijst) [#keuzelijst]

Stała lista opcji, z której korzysta pole niestandardowe typu **Wybór** lub **Wybór wielokrotny**. Tworzysz listę raz i używasz jej w wielu polach. Zobacz [Listy wyboru](/eigen-velden/keuzelijsten).

### Kiosk [#kiosk]

Tablet z Androidem, który wyświetla aplikację Tillor i w niej pozostaje, aby goście nie mieli dostępu do ustawień urządzenia. Zobacz [Konfiguracja kiosku](/mobiele-app/kiosk-inrichten).

### Klient (Klant) [#klant]

Rekord osoby lub firmy w Tillor: dane, faktury, zajęcia miejsc, metody dostępu i więcej. Słowa gość używamy tylko w zwykłym tekście, mówiąc o kimś, kto przebywa w Twoim parku. Zobacz [Zarządzanie klientami](/klantenbeheer).

### Mandat (Mandaat) [#mandaat]

Zgoda klienta na pobieranie faktur z jego rachunku bankowego (mandat SEPA). Klient podpisuje go w samym Tillor. Zobacz [Podpisanie mandatu SEPA](/betalingsverwerking/mandaat).

### Licznik (Meter) [#meter]

Urządzenie do wody, prądu lub gazu. Licznik należy do działki, nie do klienta. Zużycie trafia do klienta, który w danym momencie ma zajęcie miejsca na działce. Zobacz [Zarządzanie licznikami](/meterbeheer).

### Szafka licznikowa (Meterkast) [#meterkast]

Szafka, w której znajdują się liczniki. W <UIPath>Park > Szafki licznikowe</UIPath> zarządzasz szafkami licznikowymi i przypisanymi do nich licznikami. Zobacz [Park](/park#meterkasten).

### Tag NFC (NFC-tag) [#nfc-tag]

Karta, opaska lub brelok, który gość przykłada do kontrolera, na przykład przy prysznicu lub punkcie dostępu. Tag może mieć saldo. Zobacz [NFC](/nfc).

### Powiadomienie (Notificatie) [#notificatie]

Wiadomość, którą Tillor wysyła do klienta lub współpracownika e-mailem, SMS-em, pocztą, przez WhatsApp lub push. W <UIPath>Komunikacja > Powiadomienia</UIPath> widzisz, czy dotarła. Zobacz [Powiadomienia](/notificaties).

### Prośba o podpis (Ondertekenverzoek) [#ondertekenverzoek]

Prośba o podpisanie online pliku PDF, takiego jak umowa najmu, przez jedną lub więcej osób po kolei. Zarządzasz nimi w <UIPath>Administracja > Podpisy</UIPath>. Zobacz [Podpisy](/handtekeningen).

### Niezafakturowane zużycie (Openstaand verbruik) [#openstaand-verbruik]

Zużycie liczników, które nie znajduje się jeszcze na żadnej fakturze. Widzisz je według klienta w <UIPath>Klienci > Niezafakturowane zużycie</UIPath> i fakturujesz przyciskiem **Zafakturuj zużycie**. Zobacz [Zarządzanie licznikami](/meterbeheer/verbruik-factureren).

### Uwaga (Opmerking) [#opmerking]

Wewnętrzna notatka przy kliencie, fakturze, rezerwacji lub innym rekordzie. Uwagi nigdy nie są widoczne dla klienta. Zobacz [Uwagi](/notities).

### Organizacja (Organisatie) [#organisatie]

Twoje konto Tillor, czyli Twoja firma z jej użytkownikami, ustawieniami i danymi. Park to fizyczne miejsce. Zobacz [Organizacja](/gebruikers/organisaties).

### Park [#park]

Fizyczne miejsce: Twój kemping lub park rekreacyjny. W sekcji **Park** znajdziesz mapę, działki, liczniki i szafki licznikowe. Zobacz [Park](/park).

### Peppol [#peppol]

Europejska sieć, przez którą wysyłasz faktury elektronicznie bezpośrednio do systemu księgowego odbiorcy, bez pliku PDF. Dla belgijskich faktur dla firm z numerem VAT jest obowiązkowa. Zobacz [Peppol](/boekhouden/peppol).

### Produkt (Product) [#product]

Taryfa lub usługa, którą umieszczasz na pozycji faktury, taka jak nocleg, opłata za postój lub kWh prądu. Produkt może mieć akcje, które Tillor wykonuje przy księgowaniu lub płatności. Zobacz [Produkty](/producten).

### Akcja produktu (Productactie) [#productactie]

Coś, co Tillor robi automatycznie, gdy pozycja faktury z tym produktem zostanie zaksięgowana lub zapłacona, na przykład przedłużenie zajęcia miejsca lub doładowanie tagu NFC. Zobacz [Akcje produktów](/producten/productacties).

### Uprawnienie (Recht) [#recht]

To, co użytkownik może robić w Tillor, na przykład edytować produkty lub przywracać faktury. Uprawnienia nadajesz użytkownikowi lub przez grupę. Odmowa przez grupę zawsze wygrywa. Zobacz [Edycja uprawnień](/gebruikers/organisaties#rechten-bewerken) i [Uprawnienia grupy](/gebruikers/groepen#groepsrechten).

### Rezerwacja (Reservering) [#reservering]

Rezerwacja jednego pobytu na działce, z przyjazdem i wyjazdem. Rezerwacja to nie to samo co zajęcie miejsca. Zobacz [Rezerwacje](/reserveringen).

### Zadanie (Taak) [#taak]

Praca dla Ciebie lub współpracownika, z między innymi terminem, podzadaniami i powiązanymi klientami lub działkami. Zadania przeglądasz w widokach. Zobacz [Zadania](/taken).

### Tablet [#tablet]

Urządzenie w recepcji, na którym działa aplikacja Tillor, na przykład aby klient mógł podpisać umowę lub mandat. Tablety, kioski i telefony, na których ktoś jest zalogowany, znajdziesz w **Ustawienia**. Zobacz [Tablety i kioski](/mobiele-app/tablets-en-kiosken).

### Działka (Terrein) [#terrein]

Miejsce w Twoim parku, które wynajmujesz lub na którym planujesz pobyty, z nazwą i ewentualnie licznikami. Do działki przypisujesz liczniki, a klienci trafiają na nią przez zajęcie miejsca lub rezerwację. Zobacz [Działki](/terreinen).

### Typ działki (Terreintype) [#terreintype]

Podział Twoich działek, na przykład **Miejsce**, **Domek** lub **Miejsce dla kamperów**. Używasz typu do filtrowania listy, kolorowania mapy i w automatyzacjach. Zobacz [Typy działek](/terreinen#terreintypes).

### Metoda dostępu (Toegangsmethode) [#toegangsmethode]

Sposób, w jaki klient przechodzi przez punkt dostępu: rozpoznawanie tablic rejestracyjnych, tag NFC lub kod QR. Zarządzasz nimi przy kliencie na karcie **Kontrola dostępu**. Zobacz [Kontrola dostępu](/toegangscontrole).

### Punkt dostępu (Toegangspunt) [#toegangspunt]

Szlaban, brama lub drzwi elektroniczne, w których kontrolowany jest dostęp. Punkt dostępu możesz otwierać i zamykać z Tillor, a w dzienniku zobaczysz, kto przechodził. Zobacz [Kontrola dostępu](/toegangscontrole).

### Wyzwalacz (Trigger) [#trigger]

Początek automatyzacji: zdarzenie, moment lub wiadomość, która ją uruchamia. Wyzwalacz może mieć filtr, aby automatyzacja startowała tylko wtedy, gdy coś się zgadza. Zobacz [Wyzwalacze](/automatiseringen/triggers).

### Partia zużycia (Verbruiksbatch) [#verbruiksbatch]

Okres zużycia licznika dla jednego klienta i jednego licznika, ze stanem początkowym i końcowym. Aplikacja nazywa to **okresem zużycia**, a w tej instrukcji spotkasz też określenie partia zużycia. Zobacz [Partie zużycia](/meterbeheer/consumptie-batches).

### Widok (Weergave) [#weergave]

Zapisany sposób przeglądania zadań, na przykład **Otwarte zadania** lub **Konserwacja**. Każdy widok jest kartą na górze strony Zadania. Zobacz [Widoki](/taken/weergaven).

### Pieczęć (Zegel) [#zegel]

Cyfrowy podpis Twojej organizacji, którym Tillor zamyka podpisany plik PDF. Jeśli potem cokolwiek zmieni się w pliku, czytnik PDF to zgłosi. Do tego należy też znacznik czasu. Zobacz [Pieczęć i znacznik czasu](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="W praktyce" href="/praktijk" description="Cztery rozbudowane przykłady łączące wiele modułów" />
  <Card title="Kontrolery: słownik" href="/controllers/lexicon" description="Pojęcia techniczne związane z kontrolerami" />
</Cards>


# Dane i kopie zapasowe (/pl-PL/gegevens-backups)

Tillor automatycznie tworzy kopie zapasowe danych Twojej organizacji. Nie musisz niczego ustawiać i nie widzisz ich w Tillor. Jeśli potrzebujesz danych z przeszłości albo coś poszło nie tak, wsparcie Tillor odtworzy dla Ciebie wcześniejszy stan. Tak o to poprosisz i tak daleko możesz wrócić.

<Callout type="info" title="Warto wiedzieć">
- Kopie zapasowe sięgają wstecz do pierwszego minionego miesiąca kalendarzowego, z jednym archiwum na miesiąc. Szczegóły są w tabeli poniżej.
- Odtwarzania nie robisz sam: zawsze odbywa się ono przez wsparcie Tillor.
- Nie możesz sam pobrać ani przejrzeć kopii zapasowej.
</Callout>

Zanim zaczniesz: ustal, jakich danych potrzebujesz i od jakiego momentu lub miesiąca.

## Jak długo Tillor przechowuje kopie zapasowe? [#hoe-lang-bewaart-tillor-back-ups]

Tillor przechowuje obok siebie trzy rodzaje kopii zapasowych. Razem dają Ci niedawny punkt odtwarzania i dłuższą historię.

| Okres | Co możesz odzyskać |
|-------|--------------------|
| **Ostatnie 48 godzin** | Kopia co 4 godziny, do odtworzenia stanu z niedawnej chwili |
| **Ostatnie 14 dni** | Jedna kopia na noc |
| **Każdy miniony miesiąc kalendarzowy** | Jedno archiwum miesięczne na miesiąc, bez automatycznego usuwania |

Bieżący miesiąc kalendarzowy ma tylko nocne kopie z ostatnich 14 dni. Gdy miesiąc się skończy, jedna kopia z tego miesiąca zostaje zachowana jako archiwum miesięczne.

Terminy obowiązują wszystkie organizacje. Jeśli Tillor zmieni zasady, zaktualizujemy tę stronę.

## Zlecenie odtworzenia kopii zapasowej [#een-back-up-laten-terugzetten]

Odtwarzania nie wykonujesz sam w Tillor. Robi to wsparcie Tillor razem z Tobą, aby Twoje obecne dane nie zostały przypadkiem nadpisane.

<Steps>
<Step>
### Zbierz, co chcesz odzyskać [#verzamel-wat-je-wilt-terughalen]
Ustal, jakich danych potrzebujesz, na przykład faktur, klientów lub rezerwacji. Zanotuj moment lub okres, do którego chcesz wrócić, na przykład „wczoraj około 14:00” albo „marzec 2026”.
</Step>
<Step>
### Skontaktuj się ze wsparciem Tillor [#neem-contact-op-met-tillor-support]
Napisz na support@tillor.eu i podaj nazwę swojej organizacji, jakie dane chcesz odzyskać oraz żądany moment lub okres.
</Step>
<Step>
### Ustalcie, co dokładnie wróci [#overleg-wat-er-precies-terugkomt]
Wsparcie Tillor znajdzie kopię zapasową pasującą do Twojej prośby i omówi z Tobą, co się stanie, zanim rozpocznie się odtwarzanie.
</Step>
</Steps>

<Callout type="warn" title="Uwaga">
Odtworzenie może cofnąć dane do wcześniejszego stanu. Wszystko, co wprowadzisz po wybranym momencie, może przez to zniknąć. Zawsze najpierw omów to ze wsparciem Tillor.
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Wsparcie Tillor znajdzie odpowiednią kopię zapasową i omówi z Tobą, co wróci, zanim rozpocznie się odtwarzanie.
- Podczas odtwarzania Twoja organizacja jest w trybie konserwacji i dostęp mają tylko pracownicy Tillor. Potem wszystko znów jest dostępne.
- Dane, które wprowadziłeś po wybranym momencie, mogły zniknąć. Dlatego zawsze najpierw to omów.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Chcę sam pobrać lub przejrzeć kopię zapasową">
Nie da się tego zrobić w Tillor. Kopie zapasowe są dostępne tylko dla wsparcia Tillor. Poproś wsparcie, aby wyszukało potrzebne Ci dane.
</Accordion>
<Accordion title="Chcę danych sprzed więcej niż miesiąca">
Dla wcześniejszych miesięcy Tillor przechowuje jedną kopię na miesiąc kalendarzowy. Możesz więc wrócić do miesiąca, ale nie do konkretnego dnia czy godziny w tym miesiącu. Dla ostatnich 14 dni da się to zrobić z dokładnością do dnia, a dla ostatnich 48 godzin do 4 godzin.
</Accordion>
<Accordion title="Tillor jest niedostępny podczas odtwarzania">
Podczas odtwarzania Twoja organizacja jest w trybie konserwacji i dostęp mają tylko pracownicy Tillor. Umów się ze wsparciem Tillor na dogodny moment.
</Accordion>
<Accordion title="Przypadkowo usunąłem fakturę lub klienta">
Napisz do wsparcia Tillor, podając nazwę danych i moment usunięcia. Najpierw sprawdź w [dzienniku aktywności](/activiteitenlog), kto, co i kiedy zmienił.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Pierwsze kroki" href="/aan-de-slag" description="Konfiguracja parku krok po kroku" />
  <Card title="Dziennik aktywności" href="/activiteitenlog" description="Zobacz, kto, co i kiedy zmienił" />
</Cards>


# Logowanie do Tillor (/pl-PL/inloggen)

Do Tillor logujesz się kontem, które już masz u Microsoftu, Google lub Apple. Tillor nie ma własnego hasła: hasłem zajmuje się ten dostawca. Po zalogowaniu wybierasz organizację i trafiasz na panel. Jeśli to Twój pierwszy dzień, przejdź dalej do [Pierwszych kroków](/aan-de-slag).

Zanim zaczniesz:

- Potrzebujesz konta Microsoft, Google lub Apple.
- Administrator musi najpierw zaprosić Cię jako użytkownika na ten sam adres e-mail. Jeśli tego nie zrobił, zobaczysz **Nie znaleziono organizacji**.

## Logowanie [#inloggen]

<Steps>
<Step>
### Otwórz Tillor [#open-tillor]
Przejdź w przeglądarce do aplikacji internetowej Tillor. Jeśli jesteś już zalogowany, Tillor od razu przekieruje Cię do Twojej organizacji.
</Step>
<Step>
### Wybierz metodę logowania [#kies-je-inlogmethode]
Kliknij **Zaloguj przez Microsoft**, **Zaloguj przez Google** lub **Zaloguj przez Apple**. Metoda, której użyto ostatnio, jest oznaczona etykietą **Ostatnio użyto**.
</Step>
<Step>
### Postępuj zgodnie z krokami dostawcy [#volg-de-stappen-van-de-provider]
Przechodzisz do ekranu logowania Microsoftu, Google lub Apple. W przypadku Microsoftu i Google sam wybierasz, którego konta użyć. Potem wracasz do Tillor.
</Step>
<Step>
### Wybierz organizację [#kies-je-organisatie]
Jeśli masz dostęp do więcej niż jednej organizacji, zobaczysz ekran wyboru. Znajdź swoją organizację na liście i kliknij **Otwórz**. Jeśli masz tylko jedną, trafiasz bezpośrednio na panel.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Trafiasz na panel swojej organizacji. Tillor zapamiętuje ostatnią metodę logowania i następnym razem oznacza ją etykietą **Ostatnio użyto**.
- Widzisz tylko te elementy, do których masz uprawnienia.
- Twoja sesja pozostaje aktywna na tym urządzeniu do 30 dni bez używania albo do chwili, gdy sam się wylogujesz.

## Jak to się łączy? [#hoe-hangt-dit-samen]

Jedna osoba ma jedno konto Tillor. To konto możesz połączyć z wieloma metodami logowania. Administrator dodaje Cię jako użytkownika do organizacji i nadaje Ci uprawnienia. To, co potem widzisz, zależy od tych uprawnień.

```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="Warto wiedzieć">
- Pozostajesz zalogowany, dopóki korzystasz z Tillor. Po 30 dniach bez używania logujesz się ponownie.
- Link weryfikacyjny do Twojego adresu e-mail jest ważny 15 minut. Nową wiadomość możesz zamówić najwyżej raz na dwie minuty.
- Microsoft jest zawsze włączony jako metoda logowania. Google i Apple mogą być niedostępne, zależnie od Twojego środowiska Tillor.
- Ostatniej metody logowania nie można odłączyć.
</Callout>

## Nadanie współpracownikowi dostępu [#een-collega-toegang-geven]

Administrator z odpowiednimi uprawnieniami zaprasza współpracowników.

<Requires permission="Zarządzanie uprawnieniami użytkowników" />

<Steps>
<Step>
### Otwórz użytkowników [#open-de-gebruikers]
Przejdź do <UIPath>Pomoc > Ustawienia</UIPath> i wybierz **Użytkownicy**.
</Step>
<Step>
### Zaproś współpracownika [#nodig-de-collega-uit]
Kliknij **Zaproś użytkownika**, wpisz adres e-mail i kliknij **Zaproś**.
</Step>
</Steps>

Jeśli konto Tillor z tym adresem e-mail już istnieje, współpracownik zostaje dodany od razu. W przeciwnym razie dostaje zaproszenie e-mailem i zostaje członkiem przy pierwszym logowaniu. Potem ustawiasz uprawnienia, zobacz [Organizacja](/gebruikers/organisaties). Współpracownik zobaczy coś przydatnego dopiero po ustawieniu tych uprawnień.

## Zarządzanie własnym kontem [#je-eigen-account-beheren]

Kliknij swoje imię na dole menu i wybierz **Konto**. Znajdziesz tam:

- **E-mail**: czy Twój adres e-mail jest **Zweryfikowany** czy **Niezweryfikowany**. Jeśli widzisz **Niezweryfikowany**, pojawia się przycisk **Potwierdź adres e-mail**, zobacz [Potwierdzanie adresu e-mail](#je-e-mailadres-verifiëren).
- **Powiązane platformy**: połącz Microsoft, Google lub Apple z tym samym kontem przyciskiem **Połącz** albo usuń powiązanie przyciskiem **Odłącz**. Ostatniej metody logowania nie można odłączyć.
- **Aktywne sesje**: zobacz, na jakich urządzeniach jesteś zalogowany. Przyciskiem **Wyloguj** kończysz jedną sesję, a przyciskiem **Wyloguj wszystkie inne urządzenia** wszystkie pozostałe.
- Twój numer telefonu i język konta.

Pozostajesz zalogowany, dopóki korzystasz z Tillor. Po 30 dniach bez używania logujesz się ponownie. Aby się wylogować, wybierz **Wyloguj** w menu pod swoim imieniem.

## Potwierdzanie adresu e-mail [#je-e-mailadres-verifiëren]

Tillor przejmuje Twój adres e-mail od dostawcy, którym zalogowałeś się po raz pierwszy. Google i Apple przekazują przy tym, że adres należy do Ciebie. Microsoft zwykle tego nie robi i wtedy Twój adres na stronie **Konto** ma status **Niezweryfikowany**.

Dopóki adres nie jest zweryfikowany, Tillor przy logowaniu nie łączy drugiej metody logowania z Twoim kontem. Jeśli na przykład logujesz się po raz pierwszy przez Google, a konto zostało utworzone przez Microsoft, zobaczysz komunikat, że adres należy już do konta, które nie jest jeszcze zweryfikowane. Zweryfikuj adres raz, a potem to zadziała.

<Steps>
<Step>
### Zamów e-mail weryfikacyjny [#vraag-de-verificatiemail-aan]
Jeśli jesteś zalogowany, kliknij na stronie **Konto** przycisk **Potwierdź adres e-mail**. Jeśli nie jesteś zalogowany i komunikat pojawił się na stronie logowania, wpisz tam swój adres e-mail i kliknij **Wyślij e-mail weryfikacyjny**. Ta strona zawsze pokazuje to samo potwierdzenie, także gdy konto z takim adresem nie istnieje.
</Step>
<Step>
### Otwórz wiadomość [#open-de-e-mail]
Dostaniesz e-mail z tematem **Potwierdź swój adres e-mail dla Tillor**. Kliknij **Potwierdź adres e-mail**. Link jest ważny 15 minut; jeśli wygasł, po prostu zamów nowy.
</Step>
<Step>
### Zaloguj się [#log-in]
Po kliknięciu wracasz na stronę logowania lub na stronę konta. Zaloguj się wybraną metodą. Od tej chwili Tillor łączy nową metodę logowania z tym samym adresem e-mail z Twoim kontem.
</Step>
</Steps>

Nowy e-mail weryfikacyjny możesz zamówić najwyżej raz na dwie minuty. Nie chcesz czekać na wiadomość? Jako zalogowany użytkownik możesz też od razu połączyć drugą metodę w **Konto > Powiązane platformy**.

## Klucze API do integracji [#api-sleutels-voor-koppelingen]

Do integracji technicznych zarządzasz kluczami API na stronie **Konto**. Otwórz **Dla deweloperów** w menu profilu i kliknij **Przejdź do kluczy API**, albo przejdź do **Konto** > **Klucze API**. Dokumentację integracji znajdziesz w [Dla deweloperów](/ontwikkelaars).

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Konto - sekcja Klucze API" />

## Problemy? [#problemen]

<Accordions>
<Accordion title="Widzisz komunikat Nie znaleziono organizacji">
Twoje konto istnieje, ale nie jest jeszcze powiązane z żadną organizacją. Poproś administratora swojej organizacji o zaproszenie na ten sam adres e-mail, którego używa Twoje konto Microsoft, Google lub Apple.
</Accordion>
<Accordion title="Widzisz komunikat, że adres e-mail należy już do konta, które nie jest jeszcze zweryfikowane">
Konto Tillor z tym adresem już istnieje, zostało utworzone inną metodą logowania, a adres nie jest jeszcze zweryfikowany. Wpisz pod komunikatem swój adres e-mail i kliknij **Wyślij e-mail weryfikacyjny**, albo zaloguj się metodą, której używałeś wcześniej, i kliknij na stronie **Konto** przycisk **Potwierdź adres e-mail**. Zobacz [Potwierdzanie adresu e-mail](#je-e-mailadres-verifiëren).
</Accordion>
<Accordion title="Link weryfikacyjny wygasł lub jest nieprawidłowy">
Link weryfikacyjny działa 15 minut. Zamów nowy na stronie logowania lub na stronie **Konto** i użyj najnowszej wiadomości.
</Accordion>
<Accordion title="Nie udało się połączyć konta">
To konto jest już przypisane do innego użytkownika albo adres e-mail nie zgadza się z Twoim obecnym kontem. Użyj tego samego adresu e-mail albo zaloguj się kontem, które jest już połączone, i najpierw je tam odłącz.
</Accordion>
<Accordion title="Sesja logowania wygasła">
Logowanie trwało zbyt długo albo strona była otwarta zbyt długo. Kliknij ponownie swoją metodę logowania i wykonaj kroki szybciej.
</Accordion>
<Accordion title="Nie widzę wszystkiego, co widzi mój współpracownik">
To, co widzisz, zależy od Twoich uprawnień. Poproś administratora o zmianę uprawnień, zobacz [Organizacja](/gebruikers/organisaties).
</Accordion>
<Accordion title="Pojawia się inny komunikat o błędzie">
Spróbuj jeszcze raz. Jeśli znowu się nie uda, napisz na support@tillor.eu i podaj treść komunikatu.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Pierwsze kroki" href="/aan-de-slag" description="Konfiguracja parku krok po kroku" />
  <Card title="Użytkownicy" href="/gebruikers" description="Uprawnienia użytkowników i ustawienia organizacji" />
</Cards>


# Vraag het Tillie (/pl-PL/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>


# Co nowego (/pl-PL/wat-is-nieuw)

Tillor dostaje aktualizację prawie codziennie. Na tej stronie są zmiany, które zauważysz jako administrator. Drobne ulepszenia i poprawki błędów pomijamy.

## Listopad 2026 [#november-2026]

### Zadania [#taken]

- Filtruj zadania filtrem **Tekst**: pokazuj tylko zadania, których nazwa lub opis zawiera albo właśnie nie zawiera danego tekstu, i dodawaj tyle tekstów, ile chcesz (na przykład **Nie zawiera** `Verzekering vervallen:`). Zobacz [Filtrowanie według tekstu](/taken/filteren#filteren-op-tekst).
- Filtry i ustawienia widoku we wbudowanym widoku **Wszystkie** możesz teraz zapisać dla całej organizacji, z uprawnieniem **Zarządzanie etykietami i wspólnymi widokami**. Zobacz [Zapisywanie lub odrzucanie zmian](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

### Wyszukiwanie [#zoeken]

- Okno wyszukiwania pokazuje wyniki według kategorii, z kategorią najlepszego trafienia na górze i trzema najlepszymi trafieniami w każdej kategorii. Przyciskiem **Wszystko** na początku pola wyszukiwania albo klawiszami od **⌥1** do **⌥9** (**Alt** w systemie Windows) szukasz w jednej kategorii, nawet zanim zaczniesz pisać. Na dole są skróty klawiszowe i kategorie bez wyników. Zobacz [Wyszukiwanie](/zoeken).

### Instrukcja [#handleiding]

- Tillie może teraz zajrzeć też do Twojego konta: daj jej dostęp do odczytu Twojej organizacji i pytaj o swoich klientów, faktury czy liczniki. Proponuje zmianę, która następuje dopiero po Twoim potwierdzeniu. Zobacz [Pozwól Tillie zajrzeć do konta](/vraag-het-tillie#tillie-in-je-account-laten-kijken).
- Jasny lub ciemny motyw wybierasz teraz tylko raz: podręcznik używa motywu wybranego w Tillor i odwrotnie.
- Nowość: [Zapytaj Tillie](/vraag-het-tillie). Zadaj pytanie własnymi słowami w prawym dolnym rogu, a Tillie odpowie na podstawie podręcznika, podając strony, z których skorzystała.
- Instrukcja jest teraz dostępna także w innych językach: wybierz swój język w prawym górnym rogu. Otwiera się automatycznie w języku, którego używasz w Tillor. Strona, która nie jest jeszcze przetłumaczona, pokazuje tekst holenderski.

### Czat na stronie [#website-chat]

- Odwiedzający może teraz wysłać przez czat 10 wiadomości na minutę i 200 dziennie, a wszyscy odwiedzający z jednej sieci razem 30 na minutę. Powyżej tego odwiedzający widzi prośbę, by chwilę poczekać. Dzięki temu skrypt nie zaleje twojej skrzynki ani odpowiedzi Tillie. Zobacz [Problemy?](/inbox/website-chat#problemen).

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

- Tillor odczytuje teraz ICY przez nowe API v2. Wpisz w <UIPath>Ustawienia > Integracje > ICY</UIPath> dane logowania do API v2 i wybierz numer swojego parku na liście; bez tych danych liczniki ICY nie są już aktualizowane.
- Licznik ICY pokazuje, jaki **Moduł** wisi na danym miejscu (Campère lub PRM) i, jeśli ICY go zna, **Numer seryjny modułu**. Jeśli ten numer seryjny zmieni się w ICY, widać to w **Aktywność** licznika.
- Karta **Kontrolery ICY** w <UIPath>Park > Liczniki</UIPath> pokazuje dla każdego kontrolera, kiedy ICY widział go ostatni raz, i ile liczników jest za nim podłączonych. Alarmy zgłaszane przez ICY na kontrolerze są teraz też tam widoczne i dostajesz o nich to samo powiadomienie push co o alarmie licznika. Kontroler z alarmem albo taki, który milczy dłużej niż godzinę, jest na górze. Kontroler nosi nazwę Twojej szafki licznikowej (na przykład **MK6**) zamiast numeru z ICY. Zobacz [Kontrolery ICY](/meterbeheer/alarmen-en-status#icy-controllers).
- Licznik ICY pokazuje teraz także swój **Kontroler** i **Czas wyłączenia**. Inny czas wyłączenia modułu widać w **Aktywność** licznika.
- Lista w <UIPath>Park > Liczniki</UIPath> ma kolumnę **Moduł** (Campère lub PRM), a plik Excel z **Eksportuj wszystkie liczniki** ma na arkuszu ICY kolumnę `module`.
- W polu **Natężenie** są już tylko wartości do maksimum ustawionego w ICY dla modułu na tym miejscu. Wcześniej Tillor oferował na każdym liczniku całą listę parku.
- Alarmy z ICY dostają stałą nazwę w Twoim języku, taką jak **Przetężenie** lub **Przerwa w zasilaniu**, a **Ostrzeżenia** pokazują teraz, ile razy użyto już limitu przełączeń.

### Dla deweloperów [#ontwikkelaars]

- **Niezgodne wstecz:** alarmy nazywają się w API i w eventach od teraz `integration-alarm`, ponieważ mogą teraz dotyczyć także kontrolera ICY. Eventy `meter-alarm:created` i `meter-alarm:resolved` zostały zastąpione przez [`integration-alarm:created`](/ontwikkelaars/events#integration-alarm-created) i [`integration-alarm:resolved`](/ontwikkelaars/events#integration-alarm-resolved), a ścieżki REST `/meter-alarms` przez `/integration-alarms`. Stare nazwy już nie istnieją. Istniejące webhooki i automatyzacje zostały automatycznie przeniesione na nowe eventy; w swoim kodzie zmień nazwę eventu i ścieżkę. Pole `meterId` alarmu może być puste; wtedy wypełnione jest `icyControllerId`.
- Klienta OAuth można teraz ograniczyć do osób z Twojej organizacji, a dalej do grup i uprawnień: zaznacz **Logować się mogą tylko osoby z (Twojej organizacji)** w oknie klienta w <UIPath>Konto > Klienci OAuth</UIPath>. Przeznaczone do logowania jednokrotnego w usłudze zewnętrznej. Zobacz [Klienci OAuth](/ontwikkelaars/oauth-clients).
- Każdy endpoint w [dokumentacji API](/api-referentie) pokazuje teraz w sekcji **Dostęp**, kto może go wywołać i jakiego uprawnienia potrzebuje członek. Klucz API z zakresami potrzebuje też tego uprawnienia w swoich zakresach. [Indeks zdarzeń](/ontwikkelaars/events) pokazuje to samo dla każdego zdarzenia.

### Klucze API [#api-sleutels]

- Klucz API możesz teraz ograniczyć do uprawnień, których potrzebuje integracja: włącz **Ogranicz do wybranych uprawnień** w oknie klucza w <UIPath>Konto > Klucze API</UIPath>. Ograniczony klucz nigdy nie może więcej niż Ty sam. Zobacz [Ograniczanie uprawnień](/ontwikkelaars/http#rechten-beperken).

### Pola niestandardowe [#eigen-velden]

- Pole powiązania z licznikami może ograniczyć się do liczników działki zajęcia miejsca, a każde pole powiązania z rekordem, który można wylistować, może filtrować swoje opcje własnym TypeScriptem. Tillor odrzuca przy zapisie rekord spoza tego ograniczenia. Krótkie listy (mniej niż 50 rekordów) lista wyboru pokazuje od razu, bez wpisywania najpierw 2 znaków. Zobacz [Filtrowanie opcji](/eigen-velden/veldtypes#opties-filteren).
- Ten sam filtr może też nadać opcji własną etykietę i nagłówek na liście wyboru, zwracając tekst lub `{ label, group }` zamiast `true`. Zobacz [Własne etykiety](/eigen-velden/veldtypes#eigen-labels).

### Instrukcja [#handleiding-1]

- Nowości w instrukcji: [Pojęcia](/begrippen), słownik wszystkich terminów w Tillor, oraz [W praktyce](/praktijk), cztery rozbudowane przykłady, które prowadzą przez całą metodę pracy w różnych modułach, takie jak pozyskanie klienta sezonowego albo naliczanie zużycia.
- Każdy moduł zaczyna się teraz od tego, czym jest, czego potrzebujesz i co dzieje się potem, z blokiem **Warto wiedzieć** i listą **Problemy?** przy każdym zadaniu. Nowe są też [Zapraszanie użytkowników i nadawanie uprawnień](/gebruikers/gebruikers-en-rechten), przegląd wszystkich [typów powiadomień](/communicatie/notificatietypes) oraz osobne strony dla zadań dotyczących [liczników](/meterbeheer), [kontrolerów](/controllers) i [drukarek](/printer).

### Podpisy [#handtekeningen]

- Klienci, osoby kontaktowe i strony zewnętrzne mogą teraz podpisać dokument także na tablecie w recepcji. Kliknij w ich kolejce **Podpisz na tablecie**, z kodem lub bez kodu, jeśli tożsamość sprawdziłeś sam; tablet pokazuje ich imię i nazwisko dużymi literami, także przy mandacie SEPA. Zobacz [Na tablecie w recepcji](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).
- Przy **Wyślij** edytor sprawdza wszystko naraz: podpisujący bez pola podpisu albo klient lub osoba kontaktowa bez adresu e-mail i numeru komórkowego są od razu wskazani. Zobacz [Nie mogę wysłać](/handtekeningen/handtekening-vragen#problemen).

### Transakcje bankowe [#banktransacties]

- Kliknij ikonę (i) przy transakcji bankowej, aby otworzyć jej panel szczegółów. Z menu akcji tworzysz zadanie na jej temat albo kopiujesz link, który od razu otwiera panel. Zobacz [Przeglądanie transakcji bankowych](/boekhouden/betalingsrapporten/betaalmethodes/ponto#banktransacties-bekijken).

### Produkty i faktury [#producten-en-facturen]

- Odwrotne obciążenie VAT jest teraz wyborem w **VAT %**, obok stawek: dla usług UE i podwykonawcy, a także dostawy wewnątrzwspólnotowej, eksportu i zwolnienia. Faktura dostaje wymaganą prawem adnotację, księgowanie wymaga numeru VAT tam, gdzie trzeba, a pozycja trafia w Admisol do właściwej siatki. Dla Odoo wpisujesz dla każdego reżimu nazwę VAT z Odoo w [ustawieniach eksportu](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo#btw-regimes); zaplanowana cena może też przełączyć produkt na inny reżim. Zobacz [Odwrotne obciążenie VAT i inne reżimy bez VAT](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw).
- Wpisz kwoty sprzed Tillor, takie jak stare kaucje, jako saldo początkowe na koncie klienta: ręcznie albo importem dla wszystkich klientów naraz. Liczą się do salda i nadzoru, ale nie są fakturą i nie trafiają do księgowości. Zobacz [Salda początkowe sprzed Tillor](/producten/product-aanmaken#beginsaldi-van-voor-tillor).
- Pakiet produktów jest teraz kodem: każdy krok ma produkt, ilość i opcjonalną **Formułę** w TypeScript, która przy zapisie faktury określa, czy krok trafia na fakturę, z jaką ilością albo dokładnie jakie pozycje (własny opis, cena, metoda dostępu). Formuła odczytuje klienta, zajęcie miejsca, działkę i pozycję główną, wraz z polami niestandardowymi, oraz listy liczników i metod dostępu. Stałe wybory dla licznika, tagu NFC i psa zniknęły; to, co robiły, jest w instrukcji jako przykładowa formuła. Zobacz [Formuła dla kroku](/producten/bundel-velden#formule-per-stap).
- Nadzoruj saldo klienta na koncie księgi głównej, na przykład dla kaucji. Tillor pokazuje saldo na fakturze i odrzuca fakturę, która sprowadza je poniżej zera. Dzięki osobnemu uprawnieniu możesz mimo to zaksięgować, z uzasadnieniem na osi czasu. Zobacz [Nadzorowanie salda klienta](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
- Na karcie **Fakturowanie** klienta jest nowa tabela **Konta**: saldo dla każdej księgi głównej, na którą coś zaksięgowano, a pod nią zaksięgowane faktury i bieżące konto. Jeśli masz nadzorowane księgi główne, domyślnie widzisz tylko je; filtrem zobaczysz wszystkie. Zobacz [Nadzorowanie salda klienta](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

### Faktury i płatności [#facturen-en-betalingen]

- Przyciskiem **Link do płatności częściowej** w menu zaksięgowanej faktury tworzysz link do zapłaty części kwoty pozostałej do zapłaty. Zobacz [Tworzenie linku do płatności częściowej](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).
- Podpisany mandat SEPA jest opieczętowany, dzięki czemu czytnik PDF pokazuje każdą późniejszą zmianę. Zobacz [Mandat SEPA](/betalingsverwerking/mandaat).

### Użytkownicy i uprawnienia [#gebruikers-en-rechten]

- Grupa może zezwalać na uprawnienia lub je odmawiać wszystkim swoim członkom; odmowa zawsze wygrywa. W **Edytuj uprawnienia** widzisz przy każdym uprawnieniu, czy pochodzi bezpośrednio, czy przez grupę. Zobacz [Uprawnienia grupy](/gebruikers/groepen#groepsrechten).

### Park i technika [#park-en-techniek]

- Kontroler może znać wiele sieci wifi, w kolejności, którą sam określasz. Zobacz [Ustawienia kontrolera](/controllers/settings).
- Przy liczniku **Zużycie i trendy** pokazuje zużycie na godzinę dla jednego dnia, z nowym wyborem okresu. Zobacz [Zarządzanie licznikami](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).

### Zadania [#taken-1]

- Wydrukuj zadanie na A4 lub na drukarce paragonów z menu zadania; wydruk pokazuje też powiązane elementy i blokady. W tym samym menu jest **Usuń**, z wyjątkiem zadań, które może zakończyć tylko automatyzacja. Zobacz [Szczegóły zadania](/taken/taakdetails#het-menu-van-de-taak).
- Dodawaj podzadania podczas tworzenia zadania. Zobacz [Tworzenie zadania](/taken/taakdetails#een-taak-aanmaken).
- Widok może ukrywać ukończone zadania po dniu, tygodniu lub miesiącu. Zobacz [Ukrywanie ukończonych zadań](/taken/indelingen#voltooide-taken-verbergen).

## Październik 2026 [#oktober-2026]

### Działki [#terreinen]

- **Obliczona taryfa** działki podąża teraz za formułą, którą piszesz sam dla swojej organizacji w <UIPath>Ustawienia > Taryfa parceli</UIPath>, z tymi samymi zmiennymi `{terrain.…}` co w automatyzacjach. Formułę od razu wypróbowujesz na działce, a każda nazwana część dostaje kolumnę w eksporcie działek. Wynik jest zapisywany przy działce i podąża za każdą zmianą działki lub formuły. Zobacz [Formuła taryfy](/terreinen#tariefformule).

### Podpisy [#handtekeningen-1]

- Pozwól klientom, osobom kontaktowym, współpracownikom i stronom zewnętrznym po kolei podpisywać online plik PDF, taki jak umowa najmu. Podpisany plik PDF ze stroną dowodową trafia do dokumentów klienta. Zobacz [Podpisy](/handtekeningen).
- Podpisujący może swój podpis lub parafkę także wpisać zamiast narysować. Zobacz [Jak ktoś podpisuje](/handtekeningen/ondertekenen).
- W edytorze wybierasz w **Pola dla**, dla kogo umieszczasz pola, a umieszczone pole przestawiasz przez **Podpisujący** na kogoś innego. Pola umieszczasz, stukając lub przeciągając. Zobacz [Umieść pola](/handtekeningen/handtekening-vragen).

### Logowanie [#inloggen]

- Jeśli Twój adres e-mail jest nadal **Niezweryfikowany**, weryfikujesz go jednym kliknięciem ze strony **Konto** lub ze strony logowania. Dopiero potem Tillor łączy drugą metodę logowania z Twoim kontem. Zobacz [Potwierdzanie adresu e-mail](/inloggen#je-e-mailadres-verifiëren).

### Automatyzacje [#automatiseringen]

- Krokiem **Uruchom kod** piszesz fragment TypeScript na zmiennych flow, na przykład aby określić, jakie podzadania dostaje zadanie. Wynik odczytujesz w późniejszych krokach jako `{result}`. Zobacz [Uruchom kod](/automatiseringen/logica#code-uitvoeren).
- Flow może najpierw **Synchronizuj transakcje bankowe**, a potem wysłać przypomnienie o płatności, dzięki czemu faktura, która właśnie została zapłacona, nie dostaje przypomnienia. Zapisz tę automatyzację z sieci biura, a Tillor zapamięta IP dla połączenia z bankiem. Zobacz [Synchronizacja transakcji bankowych](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren).
- Wyłącz automatyczne upomnienia dla klienta lub dla jednej faktury. Flow przypomnień pomija klientów, którzy mają to już włączone. Zobacz [Wyłączenie automatycznych przypomnień dla klienta](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant).
- Przy **Utwórz zadanie** możesz ustawić, że zadanie kończy tylko flow. Za pomocą **Usuń zadanie** usuwasz to zadanie później. Zobacz [Zadania](/automatiseringen/acties/taken).
- Przy akcji zadania możesz włączyć **Poproś o potwierdzenie**. Współpracownik najpierw potwierdza wybór, a potem flow idzie dalej.
- Buduj automatyzacje sam na kanwie: wybierz wyzwalacz, dodaj kroki, warunki i czasy oczekiwania i sprawdzaj dla każdego uruchomienia, co się stało. Zobacz [Automatyzacje](/automatiseringen).
- Automatyzacja może mieć wiele wyzwalaczy. Tillor blokuje pętle, w których automatyzacja ciągle sama się uruchamia.
- Oczekiwanie może teraz trwać do stałego momentu, przez określoną liczbę godzin lub minut albo do zamknięcia Twojej organizacji.
- Uruchom automatyzację w dacie z rekordu, wyzwalaczem zaplanowanym albo z własnego systemu przez [przychodzący webhook](/ontwikkelaars/automatiseringen).
- Krokiem **Poproś o decyzję** sam budujesz przyciski na zadaniu, z własnym kolorem i ikoną, ewentualnie z obowiązkową notatką lub potwierdzeniem. Każdy przycisk jest wyjściem z kroku. Zobacz [Poproś o decyzję](/automatiseringen/logica#vraag-om-een-beslissing).
- Wyzwalacz **Wybrano akcję zadania** uruchamia automatyzację, gdy ktoś wybierze powiązany przycisk na zadaniu. Przy przychodzącym webhooku zapobiegasz opcją **Ignoruj powtórzenia** temu, aby to samo wywołanie dwa razy uruchomiło flow. Zobacz [Wyzwalacze](/automatiseringen/triggers).
- **Czekaj na zdarzenie** ma wyjście **Usunięto** na wypadek, gdy rekord flow zniknie. Zobacz [Logika](/automatiseringen/logica#wachten-op-een-gebeurtenis).
- W edytorze testujesz na prawdziwym rekordzie, ustawiasz **Ramki** wokół kroków i przywracasz wcześniejszą wersję przez **Historia**. Zobacz [Pierwsze kroki](/automatiseringen/aan-de-slag#de-editor).

### Zadania [#taken-2]

- Na liście zadań widzisz wszystkie powiązane rekordy i filtrujesz według rodzaju przez **Powiązane z**. Zobacz [Filtrowanie](/taken/filteren).
- E-maile o zadaniach pokazują podgląd zadania. Zadania znajdziesz też przez [Wyszukiwanie](/zoeken).
- Zanim zadanie prywatne stanie się widoczne dla całej organizacji, Tillor pyta, czy chcesz je upublicznić. Zobacz [Zadania prywatne](/taken/prive-taken).
- Zadania prywatne, widok kalendarza i timer, który działa dalej, gdy pracujesz. Zobacz [Zadania](/taken).
- Udostępnij widok jako stronę tylko do odczytu albo jako link do kalendarza. Zobacz [Udostępnianie zadań](/taken/delen).
- Statusy oczekiwania zostały połączone w jeden status **Oczekuje na odpowiedź**.
- Przypisz zadanie do grupy i udostępnij widok grupom współpracowników. Zobacz [Kto widzi widok](/taken/weergaven#wie-ziet-een-weergave).
- Zadanie może mieć przyciski wyboru, ewentualnie z obowiązkową notatką lub potwierdzeniem. Zobacz [Zadania z przyciskami wyboru](/taken/taakdetails#taken-met-keuzeknoppen).
- Wklej plik w oknie zadania, aby dodać go jako załącznik. Pola niestandardowe zadań są też w tym oknie.

### Skrzynka odbiorcza [#inbox]

- E-mail z przypomnieniem z czatu na stronie otwiera teraz rozmowę także na innym urządzeniu lub w innej przeglądarce. Zobacz [Przypomnienie e-mailem](/inbox/website-chat-instellingen#herinnering-per-e-mail).

### Powiadomienia [#meldingen]

- Wybierz dla każdego powiadomienia, czy Tillor dociera do Ciebie e-mailem czy przez push. Ustawiasz to w **Konto** w sekcji **Powiadomienia**, a dla współpracownika przez **Ustawienia powiadomień** przy członkach organizacji. Zobacz [Użytkownicy](/gebruikers).

### Tablety i kioski [#tablets-en-kiosken]

- Każdy tablet lub kiosk ma własną stronę urządzenia z akcjami zdalnymi, diagnostyką, historią i ustawieniami. Zobacz [Tablety i kioski](/mobiele-app/tablets-en-kiosken).
- Blokada kiosku, tryb nocny i powiadomienia dla każdego urządzenia dla tabletów z Androidem.

### Faktury i płatności [#facturen-en-betalingen-1]

- Wybierz na pozycji faktury z okresem działkę na mapie. Przy księgowaniu Tillor tworzy rezerwację i melduje gościa, zależnie od produktu. Zobacz [Faktury](/facturen/aanmaken-en-bewerken#periode-en-terrein-kiezen).
- Szkice raportów płatności dla bieżącego dnia. Zobacz [Raporty płatności](/boekhouden/betalingsrapporten).
- Jeśli Mollie zatrzymuje rezerwę salda na wypłacie, Tillor księguje ją jako *Rezerwa salda* na dostawcy Mollie zamiast na koncie zawieszonym, a przy zwolnieniu znika stamtąd. Zobacz [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#balansreserve).
- Klienci dostają przypomnienie o podpisaniu mandatu SEPA, zanim wygaśnie.

### Klienci i pliki [#klanten-en-bestanden]

- Załączniki, dokumenty i e-maile z Outlooka przeglądasz w jednej przeglądarce plików, bez pobierania. Filmy możesz odtwarzać; przesyłane pliki mogą mieć do 250 MB.
- Przegląd klientów pokazuje aktywne i zaległe pobyty. Automatyczne fakturowanie wstrzymuje się przy nietypowo wysokim zużyciu wody.
- Na działce widzisz historię zajęć miejsc, z linkiem do klienta.

### Pola niestandardowe [#eigen-velden-1]

- Dodawaj własne pola do klientów, działek, zajęć miejsc, liczników, zadań, produktów, dokumentów, rezerwacji i metod dostępu w <UIPath>Ustawienia > Pola niestandardowe</UIPath>. Umieszczasz je między polami standardowymi, pokazujesz pod warunkiem i określasz, kto je widzi lub edytuje. Zobacz [Pola niestandardowe](/eigen-velden).

### Produkty [#producten]

- Zaplanuj nową cenę od daty przez **Zaplanowane ceny**; Tillor stosuje ją tego dnia i wysyła Ci e-mail. **Kalkulator VAT** przelicza cenę lub zmienia ją o procent. Zobacz [Planowanie zmiany ceny](/producten/prijzen-plannen).

### Klienci [#klanten]

- Na górze klienta jest karta z najważniejszymi danymi, z przypiętymi uwagami. Urodziny klientów i partnerów są oznaczone. Zobacz [Zarządzanie klientami](/klantenbeheer).
- Adres wpisujesz w polach **Ulica**, **Nr** i **Lokal**, z podpowiedziami adresów podczas pisania. Zobacz [Zarządzanie klientami](/klantenbeheer#adres-invullen).

### Kontrola dostępu [#toegangscontrole]

- Przy przepustce QR widzisz, w jakim portfelu się znajduje, a przez **Synchronizuj kartę Wallet** przygotowujesz przepustkę od nowa. Zobacz [Kontrola dostępu](/toegangscontrole).

### Integracje [#integraties]

- Połącz Partoo, aby automatycznie przekazywać godziny otwarcia, sezony i wyjątki do swojego obiektu. Zobacz [Partoo](/integraties/partoo).

## Wrzesień 2026 [#september-2026]

### Płatności [#betalingen]

- Mandaty SEPA podpisujesz w samym Tillor, zdalnie lub na tablecie w recepcji. Zobacz [Mandat SEPA](/betalingsverwerking/mandaat).
- Nowa strona płatności z własnym wyborem metody płatności, kodem QR i przekierowaniem do aplikacji Bancontact. Tillor ostrzega, gdy metoda płatności ma awarię.

### Kontrola dostępu [#toegangscontrole-1]

- Nowa metoda dostępu: kod PIN. Kod PIN może być automatycznie zamieniony na tablicę rejestracyjną. Zobacz [Kontrola dostępu](/toegangscontrole#toegangsmethoden-beheren-via-het-klantprofiel).

### Zadania [#taken-3]

- Zapisane widoki z konstruktorem filtrów, udostępnianie współpracownikom i kanał kalendarza dla każdego widoku. Zobacz [Widoki](/taken/weergaven).
- Zależności między zadaniami, priorytet **Pilny** i etykiety tworzone w locie.
- Powiąż zadanie z wieloma klientami albo z działkami, licznikami, fakturami i rezerwacjami.

### Park i komunikacja [#park-en-communicatie]

- Koloruj działki na mapie według typu i eksportuj mapę jako PDF w formacie A4. Zobacz [Mapa](/kaart).
- Dla telefonii Voys: routing według klienta i automatyczna poczta głosowa. Zobacz [Voys Telefonie](/communicatie/providers/voys).
- Eksportuj przegląd faktur klienta do Excela.


# Wyszukiwanie w Tillor (/pl-PL/zoeken)

Za pomocą wyszukiwarki znajdziesz od razu klienta, fakturę, zajęcie miejsca, rezerwację, połączenie telefoniczne, działkę, licznik, zadanie lub raport płatności, z każdej strony. Nie musisz więc najpierw przechodzić do odpowiedniej części aplikacji. Wynik otwiera od razu właściwą stronę.

<Callout type="info" title="Warto wiedzieć">
- Przy opcji **Wszystkie wyniki** Tillor pobiera maksymalnie dziesięć trafień w każdej kategorii i pokazuje trzy najlepsze. Wybierz kategorię, aby zobaczyć do stu.
- W przypadku klientów Tillor znajduje też trafienia z drobną literówką, więc "Jansen" znajdzie również "Janssen".
- Notatki do połączeń telefonicznych są zaszyfrowane i nie są przeszukiwane. Szukaj po numerze telefonu.
- Tagi NFC i tablice rejestracyjne nie mają własnej kategorii. Znajdziesz je w kategorii **Klienci**.
</Callout>

## Wyszukiwanie i otwieranie wyniku [#zoeken-en-een-resultaat-openen]

<Steps>
<Step>
### Otwórz okno wyszukiwania [#open-het-zoekvenster]
Kliknij **Szukaj** w nagłówku (na wąskim ekranie lupę) albo naciśnij **⌘K** (Mac) lub **Ctrl+K** (Windows). Tym samym skrótem zamkniesz okno.

<DocScreenshot src="/screenshots/zoeken/search-dialog-open.png" alt="Otwarte globalne wyszukiwanie" />
</Step>
<Step>
### Wpisz szukaną frazę [#typ-je-zoekterm]
Wyniki pojawiają się, gdy na chwilę przestaniesz pisać. Są pogrupowane według kategorii, a kategoria z najlepszym trafieniem jest na górze: górny wiersz to więc zawsze najlepsze trafienie. Dobre dopasowanie w tytule liczy się bardziej niż dopasowanie w opisie. W każdej kategorii widzisz trzy najlepsze trafienia, a przyciskiem **Pokaż … więcej** otwierasz całą kategorię. Na dole widać, w których kategoriach nic nie znaleziono.

<DocScreenshot src="/screenshots/zoeken/search-results.png" alt="Wyniki wyszukiwania dla Jonas według kategorii, z kategorią najlepszego trafienia na górze" />
</Step>
<Step>
### Zawęź do jednej kategorii (opcjonalnie) [#beperk-tot-één-categorie-optioneel]
Jeśli szukasz tylko w jednym rodzaju danych, wybierz go przyciskiem **Wszystko** na początku pola wyszukiwania, na przykład **Klienci**. Możesz to zrobić przed wpisaniem lub po nim; pole wyszukiwania pokazuje wtedy **Szukaj w: Klienci…**. Możesz też kliknąć nazwę kategorii w wynikach.

Z klawiatury:
- **Shift+Tab** otwiera listę kategorii.
- Klawisze od **⌥1** do **⌥9** (od **Alt+1** do **Alt+9** w systemie Windows) od razu wybierają kategorię, w kolejności z tej listy. Cyfra jest też obok nazwy każdej kategorii w wynikach.
- **Tab** przechodzi między kategoriami, które mają wyniki.

Powrót do wszystkiego: wybierz **Wszystko** na liście albo naciśnij **Backspace** w pustym polu wyszukiwania.
</Step>
<Step>
### Otwórz wynik [#open-het-resultaat]
Użyj klawiszy strzałek, aby wybrać wynik, i naciśnij **Enter**. Z **Ctrl+Enter** (**⌘+Enter** na Macu) wynik otworzy się w nowej karcie. Można też kliknąć myszą. **Escape** zamyka okno.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Wybrany wynik otwiera klienta, fakturę lub inną stronę w tej samej karcie. Z **Ctrl+Enter** (**⌘+Enter** na Macu) otworzy się w nowej karcie.
- Twoje dane się nie zmieniają: wyszukiwanie tylko odczytuje.
- Przy wyniku widać, po czym został znaleziony, na przykład **Telefon:** lub **Faktura:** z pasującą wartością.

## Co przeszukuje Tillor [#wat-tillor-doorzoekt]

| Kategoria | Po czym możesz szukać |
|-----------|-----------------------|
| **Klienci** | Nazwa, numer klienta, e-mail, telefon, adres i miejscowość, numer VAT, uwagi, osoby kontaktowe (nazwa, e-mail, telefon) oraz metody dostępu, takie jak karta NFC lub tablica rejestracyjna |
| **Faktury** | Numer faktury (z prefiksem lub bez, z rokiem i separatorami lub bez), kwota całkowita, ID z linku do faktury oraz notatki (publiczne i wewnętrzne) |
| **Zajęcia miejsc** | Nazwa działki, imię i nazwisko klienta oraz ID zajęcia miejsca |
| **Rezerwacje** | Numer rezerwacji (na przykład `RES/2026/0001`, z prefiksem i rokiem lub bez, albo w zwartej postaci `20260001`), notatka, nazwa klienta i ID z linku |
| **Połączenia telefoniczne** | Numer przychodzący i wychodzący, ID rozmowy i zewnętrzne odniesienie |
| **Działki** | Nazwa, opis, ID i numer licznika gazu działki |
| **Liczniki** | Nazwa, numer seryjny i ID licznika |
| **Zadania** | Tytuł, opis i ID. Trafienie pokazuje także powiązanego klienta lub działkę |
| **Raporty płatności** | Numer raportu |

<Callout type="info" title="NFC i tablica rejestracyjna">
Nie ma osobnej kategorii dla tagów NFC. Karty NFC i inne wartości dostępu należą do kategorii **Klienci** i pojawiają się tam, gdy pasują do szukanej frazy.
</Callout>

## Ile wyników widzisz? [#hoeveel-resultaten-zie-je]

Jeśli w kategorii jest dziesięć lub więcej trafień, obok nazwy tej kategorii widać **10+**. W przeglądzie widzisz trzy najlepsze trafienia w każdej kategorii. Wybierz kategorię albo kliknij **Pokaż … więcej**, aby zobaczyć do stu trafień. W przypadku rezerwacji i faktur tolerancja literówek działa głównie przy numerach i notatkach.

## Wskazówki do wyszukiwania [#zoektips]

- **Tablica rejestracyjna, NFC lub kod QR**: szukaj po wartości zapisanej przy kliencie. Klienta znajdziesz w kategorii **Klienci**.
- **Numer faktury lub rezerwacji**: wpisz numer tak, jak widnieje na dokumencie, albo jego część. Dla `RES/2026/0042` działają też `2026/0042` i `20260042`.
- **Kwota**: fakturę znajdziesz także po kwocie całkowitej, na przykład `120,50`.
- **Kto jest gdzie**: w kategorii **Zajęcia miejsc** szukaj po nazwie działki lub klienta.
- **Częściowe nazwy**: w przypadku klientów zwykle wystarczy część nazwy. W przypadku rezerwacji pomaga słowo z notatki.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Widzisz komunikat Nie znaleziono żadnych wyników">
Sprawdź pisownię i spróbuj krótszej części frazy. Jeśli wybrano kategorię, Tillor szuka tylko w niej. Jeśli w innej kategorii są wyniki, okno o tym informuje. Wybierz **Wszystko** przyciskiem na początku pola wyszukiwania albo kliknij **Usuń filtr**.
</Accordion>
<Accordion title="Widzisz komunikat Wyszukiwanie niedostępne">
Podczas wyszukiwania coś poszło nie tak. Kliknij **Spróbuj ponownie**. Jeśli błąd się powtarza, sprawdź [status systemu](https://status.tillor.eu).
</Accordion>
<Accordion title="Nie mogę znaleźć klienta po tablicy rejestracyjnej lub karcie NFC">
Szukaj dokładnie po wartości zapisanej przy kliencie. Klienta znajdziesz w kategorii **Klienci**, a nie w osobnej kategorii.
</Accordion>
<Accordion title="Nie mogę znaleźć rezerwacji">
Wpisz numer tak, jak widnieje na dokumencie, albo jego część: dla `RES/2026/0042` działają też `2026/0042` i `20260042`. Możesz też poszukać po nazwie klienta.
</Accordion>
<Accordion title="Nie można znaleźć połączenia telefonicznego po notatce">
Notatki do połączeń telefonicznych są zapisane w postaci zaszyfrowanej, więc nie są przeszukiwane. Szukaj po numerze telefonu.
</Accordion>
<Accordion title="Skrót klawiszowy nie działa">
Niektóre przeglądarki lub rozszerzenia same używają Ctrl+K lub ⌘K. Wtedy kliknij **Szukaj** w nagłówku.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Zarządzanie klientami" />
  <Card title="Zajęcia miejsc" href="/bezettingen" description="Klient na działce" />
  <Card title="Rezerwacje" href="/reserveringen" description="Zarządzanie rezerwacjami" />
  <Card title="Faktury" href="/facturen" description="Zarządzanie fakturami" />
</Cards>


# Dziennik aktywności (/pl-PL/activiteitenlog)

W dzienniku aktywności widzisz, co w Tillor się zmieniło, kiedy i przez kogo. Otwierasz go przy kliencie, fakturze, zadaniu lub innym rekordzie, a centralnie przez **Dziennik audytu**, jeśli masz do tego uprawnienia. To ślad tylko do odczytu, którego używasz, aby coś sprawdzić lub udowodnić.

<Callout type="info" title="Warto wiedzieć">
- Wpisu nie można edytować ani usunąć
- Eksport domyślnie obejmuje ostatnie 30 dni, a najwyżej rok
- Wielokrotne otwarcie tego samego dokumentu w ciągu dziesięciu minut jest odnotowane jeden raz
- Czasy są pokazywane w Twojej strefie czasowej
- Są w nim także działania automatyzacji, klucza API lub systemu, z rodzajem aktora
</Callout>

## Przeglądanie dziennika aktywności [#activiteitenlog-bekijken]

W aplikacji nazywa się to zwykle **Zdarzenia** lub **Aktywność**, zależnie od miejsca. Kto ma uprawnienie *Przeglądaj dziennik audytu*, może dodatkowo otworzyć centralny przegląd przez *Dziennik audytu* w panelu bocznym (nad Ustawieniami), z filtrami według użytkownika, rodzaju zdarzenia i daty.

| Gdzie | Nawigacja | Etykieta w aplikacji |
|------|-----------|-----------------|
| Klient (cała powiązana aktywność) | *Klienci > klient > Wydarzenia* | Wydarzenia |
| Faktura | *Administracja > Faktury > faktura* | Zdarzenia |
| Rezerwacja | *Klienci > klient > Rezerwacje > rezerwacja* | Aktywność |
| Działka | *Park > Działki > działka* | Zdarzenia |
| Licznik | *Park > Liczniki > licznik* | Aktywność |
| Produkt | *Administracja > Produkty > produkt* | Zdarzenia |
| Zadanie | *Zadania > zadanie* lub *Klienci > klient > Zadania > zadanie* | Aktywność |
| Tag NFC | *Kontrolery > Tagi NFC > tag* | Aktywność |
| Tablet, kiosk lub telefon | *Ustawienia > Tablety i kioski > urządzenie* | Historia |
| Organizacja (centralnie) | *Dziennik audytu* (nad Ustawieniami, uprawnienie *Przeglądaj dziennik audytu*) | Dziennik audytu |
| Raport płatności | *Administracja > Raporty płatności > raport* | Dziennik zdarzeń |

Dla każdej aktywności widzisz na osi czasu:

- **Tytuł** - rodzaj zdarzenia (np. "Faktura zaksięgowana", "Klient zaktualizowany")
- **Użytkownik** - współpracownik, który wykonał działanie (lub Tillor przy działaniach automatycznych)
- **Czas** - data i czas względny
- **Opis** - dodatkowe szczegóły; czasem z odnośnikami do powiązanych faktur lub innych rekordów
- **Przed / po** (czasem) - przy tworzeniu, zmianie lub usuwaniu danych klienta, kontaktu, faktury, płatności, mandatu płatności, grupy płatności, dokumentu, metody dostępu, punktu dostępu, kontrolera, działki, licznika, odczytu licznika, produktu, zajęcia miejsca, zadania lub reakcji, a także przy skanowaniu, przypisywaniu lub odłączaniu dokumentu tożsamości oraz przy zmianach ustawień, uprawnień członków, fakturowania lub NFC: które pola zostały zmienione. Kody PIN punktów dostępu i dane osobowe z dokumentu tożsamości nie są zapisywane w dzienniku
- **Załączniki** (czasem) - pliki do pobrania, na przykład przy nieudanych integracjach
- **Logowanie / wylogowanie** - kiedy współpracownik się loguje lub wylogowuje, widoczne w centralnym przeglądzie dziennika audytu
- **Aplikacje OAuth i zgoda** - tworzenie, zmiana, usuwanie lub rotacja sekretu aplikacji OAuth, a także udzielona, odrzucona lub cofnięta zgoda; widoczne w centralnym przeglądzie dziennika audytu. Sekrety klienta nie są zapisywane w dzienniku
- **Zarządzanie i bezpieczeństwo** - zmiany profilu organizacji (nazwa, dane prawne, VAT, IBAN, logo, tryb konserwacji), zaproszenia i nowi członkowie, osobiste klucze API (tworzenie, zmiana, odnawianie, usuwanie), zakończone sesje, webhooki, automatyzacje, grupy współpracowników, typy działek, szafki licznikowe, grupy kontrolerów, zainstalowane lub usunięte integracje oraz zaakceptowanie umowy powierzenia przetwarzania; widoczne w centralnym przeglądzie dziennika audytu. Klucze, sekrety webhooków i ustawienia integracji nie są zapisywane; przy integracji widzisz tylko, które ustawienia zostały zmienione
- **Wgląd w dane osobowe** - kto otworzył lub pobrał dokument, obejrzał lub pobrał obrazy albo pliki dokumentu tożsamości, albo otworzył PDF faktury lub wysłał go na tablet. Wielokrotne otwarcie w ciągu dziesięciu minut jest odnotowane jeden raz; każde pobranie dokumentu tożsamości jest odnotowane osobno

## Aktywność przy każdym rekordzie [#activiteiten-per-record]

Na stronach szczegółów widzisz oś czasu z aktywnością danego rekordu. Na karcie **Wydarzenia** przy kliencie są wszystkie aktywności powiązane z tym klientem (faktury, płatności, zajęcia miejsc itd.).


<DocScreenshot src="/screenshots/activiteitenlog/customer-events.png" alt="Wydarzenia w profilu klienta Jonas Maes" />

Dla **rezerwacji** obejmuje to między innymi tworzenie, zameldowanie i wymeldowanie, anulowania i związane z nimi cofnięcia oraz aktualizację danych rezerwacji.

Dla **grup płatności** widzisz też, które płatności zostały dodane do grupy lub z niej usunięte, a dla **kontrolerów**, które wnioski o przejęcie zostały zatwierdzone lub odrzucone.

Dla **raportów płatności** obejmuje to między innymi utworzenie raportu, sfinalizowanie raportu roboczego i wysłanie go do księgowości.

Dla **próśb o podpis** widzisz każdy krok: utworzona i zmieniona, wysłana, link (ponownie) wysłany, przypomnienie, strona podpisu otwarta, kod wysłany lub błędnie wpisany, podpisana, odrzucona, cofnięta do wersji roboczej, anulowana, wygasła i zakończona. Zobacz [Dowód i ważność](/handtekeningen/bewijs-en-geldigheid).

Dla **powiadomień zewnętrznych** widzisz, kiedy powiązany system zaktualizował lub usunął zarejestrowane przez siebie powiadomienie.

<Callout type="info">
Dziennik aktywności jest tylko do odczytu. Wpisów nie można edytować ani usuwać.
</Callout>

## Kto to zrobił? [#wie-heeft-het-gedaan]

Każdy wiersz pokazuje obok użytkownika także **jakiego rodzaju aktor** wykonał działanie: zalogowany użytkownik, klucz API, połączenie OAuth, automatyzacja, konektor Tillor lub sam system. Przy kluczu API lub połączeniu OAuth id tego klucza lub połączenia jest w szczegółach, dzięki czemu przy wycieku klucza dokładnie widzisz, co z nim zrobiono. Jeśli widzisz **Nieznany**, Tillor nie mógł ustalić aktora; to celowo coś innego niż "System".

## Zdarzenia bezpieczeństwa [#beveiligingsgebeurtenissen]

Nieudane logowania, odrzucone klucze API i tokeny OAuth, odmowa dostępu (brakujące uprawnienia), przekroczone limity żądań oraz otwarcie Twojej organizacji przez administratora Tillor są również pokazywane w dzienniku aktywności, z adresem IP i przeglądarką. Członkowie z uprawnieniem **Alerty bezpieczeństwa** co godzinę dostają powiadomienie, gdy zmieniono webhooki, klucze API lub automatyzacje albo gdy dostęp był wielokrotnie odmawiany.

Dostęp do konta, który dajesz [Tillie](/vraag-het-tillie#tillie-in-je-account-laten-kijken) lub cofasz, oraz każda zmiana potwierdzona przez Tillie również są tu widoczne.

## Eksport na potrzeby audytu [#exporteren-voor-een-audit]

Przyciskiem **Eksportuj** w dzienniku aktywności pobierasz wszystkie wiersze z wybranego okresu (domyślnie ostatnie 30 dni, maksymalnie rok) jako ZIP z plikiem danych (CSV lub JSON Lines), plikiem `manifest.json` z liczbą wierszy, okresem, osobą eksportującą i sumą kontrolną SHA-256 pliku danych oraz plikiem `CHECKSUMS.sha256`, który możesz sprawdzić poleceniem `sha256sum -c`. Sam eksport jest również zapisywany w dzienniku, z tą samą sumą kontrolną. Zapisywane jest także otwarcie pełnego dziennika aktywności oraz masowe eksporty danych klientów (lista klientów, dziennik dostępu, działki, liczniki).

Wszystkie czasy są przechowywane w **UTC** na serwerach z synchronizacją czasu NTP i pokazywane w Twojej strefie czasowej; eksport zawiera czasy ISO 8601 w UTC.

## Do czego służy dziennik? [#waarvoor-gebruik-je-de-log]

- **Kontrola** - sprawdzenie, który współpracownik zaksięgował fakturę lub zmienił klienta
- **Rozwiązywanie problemów** - ustalenie, kiedy wystąpił błąd
- **Audyty** - prowadzenie pełnego śladu na potrzeby kontroli wewnętrznych lub zewnętrznych

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Użytkownicy" href="/gebruikers" description="Zarządzanie użytkownikami i uprawnieniami" />
  <Card title="Faktury" href="/facturen" description="Przeglądanie historii faktur" />
</Cards>


# Pierwsze kroki (/pl-PL/automatiseringen/aan-de-slag)

Na tej stronie zbudujesz swoją pierwszą automatyzację i poznasz edytor, czyli ekran, na którym rysujesz przepływy. Potrzebujesz uprawnienia **Zarządzanie automatyzacjami** albo **Wszystkie uprawnienia**. Tło znajdziesz w [Przeglądzie](/automatiseringen).

## Przegląd [#het-overzicht]

Przejdź do **Administrator > Automatyzacje**. Zobaczysz listę z jednym wierszem na automatyzację:

- nazwa i etykieta, na przykład **2 problemy**, jeśli z przepływem nadal coś jest nie tak (zobacz [Problemy i włączanie](/automatiseringen/problemen))
- opis
- wybrany wyzwalacz, liczba kroków i osoba, która utworzyła automatyzację (**autor**)
- rząd słupków z ostatnimi uruchomieniami, a obok czas ostatniego uruchomienia lub **Jeszcze nie uruchomiono**. Czerwony słupek to nieudane uruchomienie
- przełącznik do włączania i wyłączania automatyzacji oraz menu z trzema kropkami

<DocScreenshot src="/screenshots/automatiseringen/overview.png" alt="Przegląd automatyzacji z listą, filtrami i polem wyszukiwania" />

Na górze listy filtrujesz opcjami **Wszystkie**, **Włączone** i **Wstrzymane**. Jeśli jakaś automatyzacja ma problemy, pojawia się też filtr **Problemy**. Przez **Szukaj automatyzacji** szukasz po nazwie lub opisie.

Kliknij nazwę, aby otworzyć edytor. Przełącznikiem włączasz lub wyłączasz automatyzację. Włączenie nie jest możliwe, dopóki są problemy. Menu **Akcje automatyzacji** ma dwie opcje:

| Opcja | Co robi |
|---|---|
| **Duplikuj** | Tworzy kopię o nazwie *[nazwa] (kopia)*. Kopia jest wstrzymana |
| **Usuń** | Usuwa automatyzację i historię uruchomień. Tillor najpierw prosi o potwierdzenie |

Uruchomienia, które w tej chwili czekają na opóźnienie, zatrzymują się, gdy usuniesz automatyzację.

## Tworzenie nowej automatyzacji [#een-nieuwe-automatisering-maken]

Kliknij **Nowa automatyzacja**. Otworzy się galeria z sześcioma punktami startowymi. Każdy krok możesz potem zmienić.

| Punkt startowy | Co robi |
|---|---|
| **Zacznij od zera** | Pusty przepływ z samym wyzwalaczem |
| **Sprawdź działkę po wyjeździe** | Tworzy zadanie kontrolne dla działki, gdy kończy się zajęcie miejsca, z wysokim priorytetem i przypisane osobie, która zakończyła zajęcie |
| **Monitoruj nieopłacone faktury** | Czeka do upływu terminu płatności, wysyła przypomnienie o płatności, a tydzień później tworzy zadanie zadzwonienia do klienta, jeśli faktura nadal jest otwarta |
| **Przekazuj rezerwacje do innego systemu** | Dla każdej nowej rezerwacji wysyła własny payload na Twój endpoint webhooka i tworzy zadanie, jeśli dostarczenie się nie powiedzie |
| **Sprawdź licznik, który przestał liczyć** | Tworzy zadanie dla recepcji, gdy licznik stoi w miejscu, mimo że działka była używana, z podzadaniami do sprawdzenia na miejscu |
| **Wywołaj Tillor API** | Dodaje komentarz do każdego nowego zadania przez Tillor API |

<DocScreenshot src="/screenshots/automatiseringen/gallery.png" alt="Galeria Nowa automatyzacja z punktami startowymi" />

Gdy wybierzesz, Tillor tworzy automatyzację i otwiera edytor. Automatyzacja jest wstrzymana, dopóki jej nie włączysz.

## Edytor [#de-editor]

Edytor wypełnia cały ekran i ma trzy części: po lewej listę kroków, pośrodku płótno, a po prawej panel. Nazwa automatyzacji jest na górze w ścieżce nawigacji i możesz ją tam od razu zmienić.

<DocScreenshot src="/screenshots/automatiseringen/editor.png" alt="Edytor z listą kroków po lewej, płótnem pośrodku i panelem po prawej" />

Najedź na znaczki ℹ, aby zobaczyć krótkie wyjaśnienie każdej części.

**Lista kroków (po lewej).** Krok znajdziesz przez **Szukaj kroków**. Na górze jest grupa **Narzędzia** z pozycjami **Komentarz** i **Ramka** (zobacz [Komentarze i ramki](#opmerkingen-en-kaders)). Pod nią kroki w sześciu grupach, z grupą **Dokumenty** pośrodku:

- **Logika**: wyzwalacz **Gdy to się wydarzy** oraz warunki, czekanie, wyszukiwanie i przechodzenie w pętli, takie jak **Jeśli / w przeciwnym razie**, **Rozgałęzienie**, **Opóźnienie**, **Teraz otwarte?**, **Wyszukaj rekord**, **Dla każdego** i **Poproś o decyzję**. Zobacz [Warunki, rozgałęzienia i opóźnienia](/automatiseringen/logica)
- **Zadania**: tworzenie, wyszukiwanie i aktualizowanie zadań
- **Dokumenty**: wyszukiwanie i aktualizowanie dokumentów
- **Goście i wiadomości**: wiadomości do gości i współpracowników, komentarze, skrzynka odbiorcza, klienci i rezerwacje
- **Faktury i płatności**: faktury, linki do płatności, mandaty i zużycie
- **Dostęp i urządzenia**: środki dostępu, szlabany, prąd, tagi NFC i tablety
- **Integracje**: **Wyślij webhook** i **Żądanie API**

Co robi każda akcja, opisano w [Akcjach](/automatiseringen/acties). Na dole jest **Poproś o krok**, jeśli brakuje Ci jakiegoś kroku.

**Płótno (pośrodku).** Tu widzisz przepływ. Na górze jest wyzwalacz, pod nim kroki z liniami między nimi. W lewym dolnym rogu przybliżasz i oddalasz.

**Panel (po prawej).** Na górze jest przełącznik **Aktywna**, przy problemach przycisk taki jak **1 problem**, przycisk **Uporządkuj**, który ustawia kroki równo jeden pod drugim (komentarze zostają tam, gdzie są), oraz przycisk **Ukryj panel**. Jeśli ukryjesz panel, **Pokaż panel** przywraca go. Pod spodem wybierasz kartę:

| Karta | Co na niej robisz |
|---|---|
| **Konfiguruj** | Zmieniasz wybrany krok. Jeśli nic nie zaznaczysz, możesz wpisać **Opis** automatyzacji |
| **Uruchomienie testowe** | Wypróbowujesz przepływ, zobacz [Testowanie i uruchomienia](/automatiseringen/testen-en-uitvoeringen) |
| **Uruchomienia** | Sprawdzasz, co zrobiły prawdziwe uruchomienia |
| **Historia** | Przeglądasz i przywracasz wcześniejsze zapisane wersje, zobacz [Wcześniejsze wersje](#eerdere-versies) |

Jeśli wprowadzisz zmiany, na dole panelu pojawia się **Niezapisane zmiany** z przyciskami **Przywróć** i **Zapisz**. **Przywróć** cofa przepływ do ostatniej zapisanej wersji. Jeśli panel jest ukryty, te przyciski są w prawym górnym rogu płótna.

Dopóki nie zaznaczysz kroku, pod opisem widać, kto utworzył automatyzację. Nieudane uruchomienia są wysyłane e-mailem do tej osoby, najwyżej raz na godzinę na automatyzację.

Na telefonie panel jest najpierw ukryty, aby płótno zajmowało cały ekran. Dotknij kroku lub **Pokaż panel**, aby go otworzyć.

### Dodawanie i łączenie kroków [#stappen-toevoegen-en-verbinden]

Krok możesz dodać na cztery sposoby:

- Kliknij krok na liście po lewej. Pojawi się pośrodku płótna
- Przeciągnij krok z listy na płótno
- Kliknij plusik pod wyjściem, które nigdzie jeszcze nie prowadzi (**Dodaj krok po "[wyjście]"**) i wybierz krok. Nowy krok jest od razu połączony
- Przeciągnij krok na linię. Znajdzie się wtedy między dwoma krokami (**Wstaw krok tutaj**)

Aby połączyć kroki, przeciągnij od wyjścia pod krokiem do innego kroku. Obowiązuje przy tym:

- Każde wyjście prowadzi do jednego kroku. Jeśli połączysz wyjście ponownie, nowa linia zastępuje starą
- Linia, która utworzyłaby pętlę, jest odrzucana. Jeśli mimo to jest pętla, nie możesz włączyć automatyzacji. Uruchomienie zatrzymuje się, gdy miałoby powtórzyć krok
- Krok bez linii przychodzącej nigdy nie jest wykonywany. Tillor zgłasza to jako problem (**Brak połączenia, więc ten krok nigdy się nie uruchomi.**)
- Wyzwalacz możesz zmieniać, duplikować i dodawać kolejne z listy po lewej. Ostatniego wyzwalacza nie możesz usunąć. Wyzwalacz nie należy na linii: rozpoczyna własne uruchomienie

Nadaj krokowi własną nazwę w polu **Nazwa kroku**. Pomaga to, gdy przepływ się rozrasta. Przyciskami **Duplikuj krok** i **Usuń krok** u góry panelu kopiujesz lub usuwasz zaznaczony krok.

### Komentarze i ramki [#opmerkingen-en-kaders]

Komentarzem wyjaśniasz na płótnie, co robi część przepływu, na przykład dlaczego jest tam warunek. **Ramka** to przerywana linia z nazwą, którą umieszczasz wokół grupy kroków.

- W grupie **Narzędzia** kliknij **Komentarz** lub **Ramka** i wpisz tekst
- Przeciągnij komentarz lub ramkę do kroków, które wyjaśniają. Zaznacz je, aby powiększyć lub pomniejszyć za pomocą rogów
- Komentarz usuniesz przez **Usuń komentarz**, a ramkę przez **Usuń ramkę**, albo zaznacz je i naciśnij Delete
- Komentarze i ramki nigdy nie są wykonywane i nie liczą się do problemów. Możesz ich umieścić łącznie najwyżej 50. Są zapisywane przez **Zapisz**, tak jak kroki, a Ctrl/Cmd + Z cofa zmianę

### Wcześniejsze wersje [#eerdere-versies]

Przy każdym zapisaniu zmiany Tillor zachowuje poprzednią wersję. Na karcie **Historia** widzisz wersje z informacją, co się zmieniło, na przykład **Dodano 1 krok** lub **Zmieniono układ lub połączenia**, oraz przez kogo lub co pochodziła zmiana (na przykład **Przez API**). Przyciskiem **Przywróć** umieszczasz wersję na płótnie. Liczy się to jako niezapisana zmiana: zapisz, aby zachować wersję, albo cofnij.

### Skróty klawiszowe [#sneltoetsen]

| Klawisz | Co robi |
|---|---|
| Ctrl/Cmd + S | Zapisz |
| Ctrl/Cmd + Z | Cofnij |
| Ctrl/Cmd + Shift + Z lub Ctrl/Cmd + Y | Ponów |
| Ctrl/Cmd + C, Ctrl/Cmd + V | Kopiuj i wklej zaznaczone kroki |
| Ctrl/Cmd + D | Duplikuj zaznaczone kroki |
| Ctrl/Cmd + A | Zaznacz wszystko |
| Delete lub Backspace | Usuń zaznaczone kroki lub linie |
| Esc | Usuń zaznaczenie |

## Zapisywanie i włączanie [#opslaan-en-inschakelen]

Tillor nie zapisuje automatycznie. Kliknij **Zapisz** (lub naciśnij Ctrl/Cmd + S), aby zachować zmiany. Przycisk jest aktywny, gdy coś zostało zmienione, a nazwa nie jest pusta.

<Callout type="warn">
Jeśli automatyzacja jest włączona, możesz zapisać tylko wtedy, gdy nie ma już problemów. Działający przepływ musi zawsze pozostać prawidłowy. Rozwiąż problemy albo najpierw wstrzymaj automatyzację.
</Callout>

Przełącznikiem **Aktywna** włączasz automatyzację. To też od razu zapisuje przepływ. Przełącznik nie działa, dopóki są problemy, z wyjaśnieniem **Najpierw rozwiąż otwarte problemy**. Potem automatyzacja uruchamia się przy każdym pasującym zdarzeniu. Dotarcie zmiany wszędzie może potrwać pół minuty.

Jeśli później zmienisz włączony przepływ, zmiany dotyczą tylko nowych uruchomień. Uruchomienia, które już trwają lub czekają na opóźnienie, kończą się z przepływem takim, jaki był, gdy się rozpoczęły.

## Twoja pierwsza automatyzacja: zadanie po wyjeździe [#je-eerste-automatisering-een-taak-na-vertrek]

Ten przykład tworzy zadanie, gdy kończy się zajęcie miejsca.

1. Kliknij **Nowa automatyzacja** i wybierz **Sprawdź działkę po wyjeździe**
2. Kliknij wyzwalacz. Przy **Zdarzenie** jest `occupation:ended`
3. Kliknij krok **Utwórz zadanie**. Zmień **Tytuł**, **Opis** i **Priorytet** albo wybierz przy **Dodaj do tablicy** tablicę i **Kolumna**
4. Otwórz kartę **Uruchomienie testowe** i kliknij **Uruchom test**. Zobaczysz, które kroki przepływ by przeszedł
5. Kliknij **Zapisz** i włącz **Aktywna**
6. Zakończ zajęcie miejsca i sprawdź na karcie **Uruchomienia**, co się stało

## Prośba o krok lub zdarzenie [#een-stap-of-gebeurtenis-aanvragen]

Brakuje Ci wyzwalacza, warunku lub akcji? Kliknij **Poproś o krok** pod listą kroków. Na liście zdarzeń wyzwalacza jest też link **Brakuje zdarzenia? Poproś o nie**.

1. Wybierz przy **Czego potrzebujesz?** jedno z: **Wyzwalacz lub zdarzenie**, **Warunek lub filtr**, **Akcja** lub **Coś innego**
2. Opisz przy **Co powinien robić?**, co chcesz zautomatyzować. Napisz co najmniej 10 znaków, najwyżej 1000
3. Kliknij **Wyślij prośbę**

Twoja prośba trafia do zespołu Tillor razem z Twoim imieniem i nazwą Twojej organizacji. Dostaniesz powiadomienie, że prośba została wysłana.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Nowa automatyzacja jest wstrzymana. Nic się nie dzieje, dopóki nie włączysz **Aktywna**.
- Po włączeniu automatyzacja uruchamia się przy każdym pasującym zdarzeniu. Dotarcie zmiany wszędzie może potrwać pół minuty.
- Każde uruchomienie to jedno wykonanie. Widzisz je na karcie **Uruchomienia**, ze statusem **Zakończone**, **Oczekuje**, **Niepowodzenie** lub **Anulowane**.
- Jeśli uruchomienie się nie powiedzie, osoba, która utworzyła automatyzację, dostaje e-mail, najwyżej jeden na godzinę na automatyzację.
- Jeśli zmienisz działający przepływ, zmiany dotyczą tylko nowych uruchomień. To, co już trwa lub czeka, kończy się ze starym przepływem.
- Zadania i komentarze utworzone przez automatyzację są na nazwisko **Przepływ pracy**. Zobacz [Kto uruchamia automatyzację?](/automatiseringen/workflow-gebruiker).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Przełącznik Aktywna nie działa">
Tillor pokazuje **Najpierw rozwiąż otwarte problemy**. Kliknij na górze panelu przycisk z liczbą problemów i je rozwiąż. Zobacz [Problemy i włączanie](/automatiseringen/problemen).
</Accordion>
<Accordion title="Nie mogę zapisać">
Przycisk **Zapisz** jest aktywny dopiero, gdy coś zostało zmienione, a nazwa nie jest pusta. Jeśli automatyzacja jest włączona, możesz zapisać tylko bez problemów. Rozwiąż je albo najpierw wstrzymaj.
</Accordion>
<Accordion title="Mój krok nigdy się nie uruchamia">
Tillor zgłasza **Brak połączenia, więc ten krok nigdy się nie uruchomi.** Przeciągnij od wyjścia wcześniejszego kroku do tego kroku.
</Accordion>
<Accordion title="Nie mogę połączyć linii">
Linia, która utworzyłaby pętlę, jest odrzucana. Przepływ może iść tylko do przodu.
</Accordion>
<Accordion title="Nie widzę Automatyzacji w menu">
Menu pojawia się tylko wtedy, gdy masz uprawnienie **Wyświetlanie automatyzacji**. Budowanie i zmienianie wymaga **Zarządzanie automatyzacjami**. Poproś administratora o zmianę uprawnień.
</Accordion>
<Accordion title="Przepływ nie reaguje na moje działanie">
Przejdź punkty z [Dlaczego moja automatyzacja się nie uruchamia?](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
</Accordions>

## Następne kroki [#volgende-stappen]

<Cards>
  <Card
    title="Wyzwalacze"
    href="/automatiseringen/triggers"
    description="Wybierz, kiedy automatyzacja się uruchamia"
  />
  <Card
    title="Akcje"
    href="/automatiseringen/acties"
    description="Wszystko, co może robić automatyzacja"
  />
  <Card
    title="Przykład: kontrola przyczepy do wynajęcia"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Kompletny przepływ z wyszukiwaniem, rozgałęzieniem i podzadaniami"
  />
</Cards>


# Dokumenty (/pl-PL/automatiseringen/acties/documenten)

Tymi akcjami pracujesz z dokumentami klienta, takimi jak dowód opłacenia ubezpieczenia. Typ i data ważności dokumentu znajdują się w danych dokumentu. W przepływie odczytujesz je jako `{document.userMetadata.documentType}` i `{document.userMetadata.insuranceExpiryDate}`.

## Znajdź dokument [#document-zoeken]

Wyszukuje najnowszy dokument klienta. Krok ma dwa wyjścia: **Znaleziono** i **Nie znaleziono**.

| Pole | Co wpisujesz |
|---|---|
| **Klient** | ID klienta, na przykład `{document.customerId}` lub `{customer.id}`. Wymagane |
| **Typ** | Na przykład **Dowód opłacenia ubezpieczenia**. Zostaw puste dla każdego typu |
| **Pomiń zarchiwizowane dokumenty** | Domyślnie włączone |
| **Tylko dokumenty, które nie wygasły** | Data ważności musi być po chwili obecnej. Dokumenty bez daty ważności nie są wtedy brane pod uwagę. Domyślnie wyłączone |

Jeśli pasuje kilka dokumentów, krok bierze najnowszy. Przez **Znaleziono** kolejne kroki mogą używać `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}` i `{foundDocument.userMetadata.insuranceExpiryDate}`.

W ten sposób sprawdzasz na przykład przy wygasłym ubezpieczeniu, czy klient ma już nowy, ważny dowód opłacenia: szukaj z **Typ** *Dowód opłacenia ubezpieczenia* i włączonym **Tylko dokumenty, które nie wygasły**, i idź dalej tylko przez **Nie znaleziono**.

## Zaktualizuj dokument [#document-bijwerken]

Zmienia typ dokumentu albo go archiwizuje lub przywraca. Puste pola pozostają bez zmian.

| Pole | Co wpisujesz |
|---|---|
| **Dokument** | ID dokumentu. Domyślnie `{document.id}`. Wymagane |
| **Nowy typ** | Zostaw puste, aby zachować typ |
| **Status** | **Aktywny** lub **Zarchiwizowany**. Zostaw puste, aby zachować status |

Typ, który wymaga daty ważności, taki jak **Dowód opłacenia ubezpieczenia**, kończy się niepowodzeniem, jeśli dokument nie ma daty ważności. Akcja zwraca `{updatedDocument.id}`.


# Faktury i płatności (/pl-PL/automatiseringen/acties/facturen-en-betalingen)

Te kroki znajdują się w grupie **Faktury i płatności**. Jak działają wyjścia, przeczytasz w [Wyjścia akcji](/automatiseringen/acties#uitgangen-van-een-actie).

## Wyślij przypomnienie o płatności [#betalingsherinnering-versturen]

Wysyła klientowi przypomnienie o płatności faktury, tak samo jak przycisk przypomnienia na fakturze.

| Pole | Co wpisujesz |
|---|---|
| **Faktura** | ID faktury. Domyślnie `{invoice.id}`. Wymagane |

Uwaga: pole oczekuje wewnętrznego ID faktury (`{invoice.id}`), a nie numeru faktury (`{invoice.displayId}`).

Krok kończy się niepowodzeniem, jeśli:

- faktura nie jest zaksięgowana
- nic już nie jest otwarte, czyli faktura jest już opłacona
- klient nie ma adresu e-mail, numeru telefonu i pełnego adresu pocztowego

Uruchomienie dostaje wtedy status **Niepowodzenie**, a reszta przepływu nie jest wykonywana. Dlatego przed przypomnieniem umieść **Jeśli / w przeciwnym razie**, który sprawdza, czy faktura nadal jest otwarta, jak w szablonie **Monitoruj nieopłacone faktury**.

Krok pomija też fakturę, jeśli została wyłączona z automatycznych przypomnień albo klient ma włączone **Wyklucz z automatycznych upomnień**.

## Synchronizuj transakcje bankowe [#banktransacties-synchroniseren]

Pobiera nowe transakcje bankowe i czeka, aż import się zakończy. Umieść ten krok przed **Wyślij przypomnienie o płatności**, aby faktura, która właśnie została opłacona, nie dostała przypomnienia. Jeśli Ponto nie jest połączone, krok jest pomijany.

Zapisz automatyzację z sieci biura. Tillor zapamięta wtedy IP potrzebne połączeniu z bankiem. Bez tego IP synchronizacja nie może się rozpocząć.

## Wyłącz automatyczne przypomnienia dla klienta [#automatische-herinneringen-uitschakelen-voor-klant]

Włącza **Wyklucz z automatycznych upomnień** w ustawieniach fakturowania klienta. Przepływy przypomnień pomijają potem wszystkie jego faktury. Ręczne upomnienie nadal jest możliwe.

| Pole | Co wpisujesz |
|---|---|
| **Klient** | ID klienta. Wymagane |

## Wyłącz automatyczne przypomnienia dla faktury [#automatische-herinneringen-uitschakelen-voor-factuur]

Wyłącza jedną fakturę z przepływów przypomnień o zaległościach i z automatycznych przypomnień. Współpracownicy nadal mogą ręcznie wysłać przypomnienie.

| Pole | Co wpisujesz |
|---|---|
| **Faktura** | ID faktury. Wymagane |

## Wyślij fakturę [#factuur-versturen]

Wysyła fakturę klientowi, tak samo jak przycisk wysyłania na fakturze.

| Pole | Co wpisujesz |
|---|---|
| **Faktura** | ID faktury. Domyślnie `{invoice.id}`. Wymagane |

Krok kończy się niepowodzeniem, jeśli faktura nie jest zaksięgowana lub klient nie ma adresu e-mail, numeru telefonu i pełnego adresu pocztowego.

## Zaksięguj fakturę [#factuur-boeken]

Księguje fakturę roboczą, aby dostała swój numer faktury.

| Pole | Co wpisujesz |
|---|---|
| **Faktura** | ID faktury. Domyślnie `{invoice.id}`. Wymagane |

Jeśli faktura jest już zaksięgowana, nic się nie dzieje i przepływ idzie dalej przez **Pominięto**. Po zaksięgowaniu akcja zwraca `{bookedInvoice.displayId}`, czyli numer faktury. Możesz go użyć w wiadomości lub zadaniu. Połącz ten krok z **Wyślij fakturę**, aby zaksięgować i wysłać fakturę roboczą za jednym razem.

## Drukuj fakturę [#factuur-afdrukken]

Drukuje fakturę albo pokazuje ją na tablecie w recepcji.

| Pole | Co wpisujesz |
|---|---|
| **Faktura** | ID faktury. Domyślnie `{invoice.id}`. Wymagane |
| **Gdzie** | **Drukarka A4** (domyślnie), **Drukarka paragonów** lub **Tablet** |

Drukarki ustawiasz w [Ustawieniach drukowania](/printer/afdrukinstellingen). Faktura, którą wydrukujesz tym krokiem po raz drugi, po prostu zostanie wydrukowana ponownie.

## Utwórz link do płatności [#betaallink-aanmaken]

Tworzy internetowy link do płatności na kwotę, która nadal jest otwarta na fakturze.

| Pole | Co wpisujesz |
|---|---|
| **Faktura** | ID faktury. Domyślnie `{invoice.id}`. Wymagane |
| **Metoda płatności** | **Pozwól klientowi wybrać** (domyślnie), **Bancontact**, **iDEAL**, **Karta kredytowa** lub **Payconiq** |

Link jest tylko dla zaksięgowanej faktury, z której coś jeszcze jest otwarte. Jeśli faktura nie jest zaksięgowana lub jest już opłacona, przepływ idzie dalej przez **Pominięto**. Potem akcja zwraca `{paymentLink.url}`. Umieść go w tekście, na przykład w wiadomości przez [Napisz do gościa](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen).

## Poproś o upoważnienie SEPA [#sepa-mandaat-aanvragen]

Wysyła klientowi e-mailem prośbę o podpisanie upoważnienia SEPA albo przypomnienie o prośbie, która nadal jest otwarta. Samo upoważnienie opisuje [Mandat](/betalingsverwerking/mandaat).

| Pole | Co wpisujesz |
|---|---|
| **Klient** | ID klienta. Domyślnie `{customer.id}`. Wymagane |
| **Wyślij** | **Nową prośbę** (domyślnie) lub **Przypomnienie** |

Nowa prośba jest pomijana, jeśli jedna już jest otwarta. Przypomnienie jest pomijane, jeśli nie ma otwartej prośby albo prośba wygasła. W obu przypadkach przepływ idzie dalej przez **Pominięto**.

## Pobierz poleceniem zapłaty [#innen-via-domiciliëring]

Pobiera to, co nadal jest otwarte na fakturze, za pomocą aktywnego upoważnienia SEPA klienta.

| Pole | Co wpisujesz |
|---|---|
| **Faktura** | ID faktury. Domyślnie `{invoice.id}`. Wymagane |
| **Po dniach** | Ile dni Tillor czeka z pobraniem. Przy 0 pobiera od razu. Maksimum to 7 dni, wyższa liczba staje się 7. Domyślnie 0 |

Krok pobiera całą otwartą kwotę. Jeśli faktura nie jest zaksięgowana lub jest już opłacona albo klient nie ma aktywnego upoważnienia, nic się nie dzieje i przepływ idzie dalej przez **Pominięto**. Jeśli klient ma więcej niż jedno aktywne upoważnienie, krok używa najnowszego.

## Zafakturuj zużycie [#verbruik-factureren]

Fakturuje otwarte zużycie liczników klienta, księguje fakturę i ją wysyła.

| Pole | Co wpisujesz |
|---|---|
| **Klient** | ID klienta. Domyślnie `{occupation.customerId}`. Wymagane |
| **Wyślij e-mailem** | Domyślnie włączone |
| **Wyślij SMS-em** | Domyślnie wyłączone |

Jeśli nie ma nic otwartego do zafakturowania, faktura nie jest tworzona, a przepływ idzie dalej przez **Pominięto**. W przeciwnym razie akcja zwraca `{consumptionInvoice.id}`. Jak śledzone jest zużycie, opisuje [Zarządzanie licznikami](/meterbeheer).

## Robocza faktura przedłużenia [#conceptfactuur-voor-verlenging]

Tworzy fakturę roboczą, która przedłuża zajęcie miejsca, gotową do sprawdzenia. Faktura nie jest jeszcze zaksięgowana. To ten sam rodzaj faktury, który dostajesz przez **Przedłuż zajęcie miejsca (faktura)** w profilu klienta.

| Pole | Co wpisujesz |
|---|---|
| **Zajęcie miejsca** | ID zajęcia miejsca. Domyślnie `{occupation.id}`. Wymagane |
| **Dodaj otwarte zużycie** | Umieszcza otwarte zużycie liczników klienta na tej samej fakturze. Domyślnie wyłączone |

Akcja zwraca `{extendInvoice.id}`. Jeśli chcesz od razu zaksięgować i wysłać fakturę, użyj potem **Zaksięguj fakturę** i **Wyślij fakturę** z `{extendInvoice.id}` jako fakturą.


# Goście i wiadomości (/pl-PL/automatiseringen/acties/gasten-en-berichten)

Te kroki znajdują się w grupie **Goście i wiadomości**. Jak działają wyjścia, przeczytasz w [Wyjścia akcji](/automatiseringen/acties#uitgangen-van-een-actie).

## Napisz do gościa [#gast-een-bericht-sturen]

Wysyła Twój własny tekst do klienta e-mailem, SMS-em lub przez WhatsApp. Użyj tego do wiadomości, które nie mają stałego szablonu Tillor, takich jak wiadomość powitalna w dniu przyjazdu.

| Pole | Co wpisujesz |
|---|---|
| **Klient** | ID klienta, na przykład `{reservation.customerId}`. Wymagane |
| **Temat** | Tylko dla e-maila. Puste używa nazwy Twojej organizacji |
| **Wiadomość** | Tekst, bez formatowania. Zmienne są uzupełniane. Wymagane |
| **Wyślij e-mailem** | Domyślnie włączone |
| **Wyślij SMS-em** | Domyślnie wyłączone |
| **Wyślij przez WhatsApp** | Domyślnie wyłączone |

Zwróć uwagę na to:

- Klienci, którzy nie akceptują komunikacji, nic nie dostają. Przepływ idzie wtedy dalej przez **Pominięto**
- Poza 24-godzinnym oknem WhatsApp Tillor wysyła Twój tekst jako zatwierdzony szablon. W tym oknie idzie jako zwykła wiadomość
- Jeśli klient nie istnieje, krok kończy się niepowodzeniem

## Powiadom współpracowników [#collegas-verwittigen]

Wysyła współpracownikom powiadomienie push, e-mail lub jedno i drugie.

| Pole | Co wpisujesz |
|---|---|
| **Współpracownicy** | Wybierz jednego lub więcej współpracowników |
| **Powiadom też osobę, która wywołała zdarzenie** | Powiadamia także współpracownika, który wywołał zdarzenie. Jeśli zdarzenie wywołał system, nikt nie jest dodawany |
| **Tytuł** | Nagłówek powiadomienia. Wymagane |
| **Tekst** | Treść powiadomienia |
| **Wyślij jako powiadomienie push** | Domyślnie włączone |
| **Wyślij e-mailem** | Domyślnie wyłączone |

Użytkownik **Przepływ pracy** sam nigdy nie dostaje powiadomienia. Jeśli nie ma współpracowników do powiadomienia, krok nic nie robi, a przepływ po prostu idzie dalej.

## Dodaj komentarz [#opmerking-toevoegen]

Umieszcza [komentarz](/notities) na nazwisko **Przepływ pracy**.

| Pole | Co wpisujesz |
|---|---|
| **Komentarz** | Tekst komentarza. Wymagane |
| **Przy** | **Rekordy zdarzenia** (domyślnie) lub **Zadanie** |
| **Zadanie** | Tylko przy **Zadanie**: ID zadania, na przykład `{createdTask.id}`. Wymagane |

Zwróć uwagę na to:

- Wspomnij współpracownika przez `@{triggeredBy.name}({triggeredBy.id})`. Ten współpracownik dostaje wtedy powiadomienie, tak jak przy komentarzu, który wpisujesz sam. Działa to tylko wtedy, gdy zdarzenie wywołał współpracownik
- Przy **Rekordy zdarzenia** komentarz trafia do klienta, faktury, rezerwacji, płatności, działki, licznika i zadania, których dotyczy zdarzenie. Jeśli zdarzenie nie ma żadnego z tych rekordów, krok kończy się niepowodzeniem
- Akcja zwraca `{createdComment.id}`

## Odpowiedz w skrzynce [#antwoorden-in-de-inbox]

Wysyła odpowiedź w rozmowie ze skrzynki, tym samym kanałem, którym napisał gość.

| Pole | Co wpisujesz |
|---|---|
| **Rozmowa** | ID rozmowy. Domyślnie `{threadId}`. Wymagane |
| **Odpowiedź** | Tekst, bez formatowania. Zmienne są uzupełniane. Dłuższy niż 4096 znaków zostaje obcięty. Wymagane |
| **Pozostaw asystenta AI aktywnego** | Domyślnie wyłączone |

Zwróć uwagę na to:

- `{threadId}` istnieje przy zdarzeniach dotyczących wiadomości w skrzynce, takich jak `inbox:message-created`
- To zdarzenie dotyczy każdej nowej wiadomości, także Twojej własnej odpowiedzi. Dlatego najpierw sprawdź, czy wiadomość pochodziła od gościa, inaczej Twoja odpowiedź uruchomi przepływ od nowa. Umieść przed tym krokiem [Wyszukaj rekord](/automatiseringen/logica#record-opzoeken) ustawiony na **Wiadomość w skrzynce** z `{messageId}` oraz **Jeśli / w przeciwnym razie**, który sprawdza, czy `foundInboxMessage.direction` jest równe `INBOUND`
- Domyślnie Twoja odpowiedź wycisza [asystenta AI](/inbox/inbox-ai-assistant) w tej rozmowie, tak samo jak gdy sam odpowiada współpracownik. Z **Pozostaw asystenta AI aktywnego** asystent dalej prowadzi rozmowę. Jeśli rozmowa jest wtedy zarchiwizowana, krok kończy się niepowodzeniem

## Oznacz lub zarchiwizuj rozmowę [#gesprek-taggen-of-archiveren]

Nadaje rozmowie w skrzynce tagi, archiwizuje ją albo jedno i drugie.

| Pole | Co wpisujesz |
|---|---|
| **Rozmowa** | ID rozmowy. Domyślnie `{threadId}`. Wymagane |
| **Dodaj tagi** | Wybierz jeden lub więcej tagów. Są dodawane, istniejące tagi zostają |
| **Zarchiwizuj rozmowę** | Domyślnie wyłączone |

## Zaktualizuj klienta [#klant-bijwerken]

Zmienia status klienta lub dodaje notatkę. Pozostałe dane klienta pozostają bez zmian.

| Pole | Co wpisujesz |
|---|---|
| **Klient** | ID klienta, na przykład `{invoice.customerId}`. Wymagane |
| **Status** | **Pozostaw bez zmian** (domyślnie), **Domyślny**, **Preferowane**, **VIP**, **Ostrzeżenie** lub **Zablokowany** |
| **Dodaj do notatek** | Tekst, który trafia w nowym wierszu pod istniejące notatki. Puste nic nie dodaje |

## Zamelduj, wymelduj lub anuluj [#inchecken-uitchecken-of-annuleren]

Przestawia rezerwację do jej następnego statusu.

| Pole | Co wpisujesz |
|---|---|
| **Rezerwacja** | ID rezerwacji. Domyślnie `{reservation.id}`. Wymagane |
| **Akcja** | **Zamelduj** (domyślnie), **Wymelduj** lub **Anuluj** |

Rezerwacja musi mieć do tego odpowiedni status. **Zamelduj** i **Anuluj** działają przy rezerwacji ze statusem **Zarezerwowana**, **Wymelduj** przy rezerwacji ze statusem **Zameldowana**. Jeśli ma inny status, nic się nie dzieje i przepływ idzie dalej przez **Pominięto**.


# Przegląd (/pl-PL/automatiseringen/acties)

Akcje to kroki, które naprawdę coś robią. Znajdziesz je na liście kroków w grupach **Zadania**, **Dokumenty**, **Goście i wiadomości**, **Faktury i płatności**, **Dostęp i urządzenia** oraz **Integracje**. Kroki w grupie **Logika** sterują samym przepływem. Opisano je w [Warunki, rozgałęzienia i opóźnienia](/automatiseringen/logica). Wszystkie akcje są wykonywane przez [użytkownika **Przepływ pracy**](/automatiseringen/workflow-gebruiker) Twojej organizacji.

| Grupa | Akcja | Co robi |
|---|---|---|
| Zadania | [Utwórz zadanie](/automatiseringen/acties/taken#taak-aanmaken) | Tworzy zadanie, ewentualnie z podzadaniami, na tablicy i powiązane z klientem, działką lub fakturą |
| Zadania | [Ustaw status](/automatiseringen/acties/taken#taakstatus-zetten) | Zmienia status istniejącego zadania |
| Zadania | [Znajdź zadanie](/automatiseringen/acties/taken#taak-zoeken) | Szuka zadania po tytule i idzie dalej przez **Znaleziono** lub **Nie znaleziono** |
| Zadania | [Ustaw priorytet zadania](/automatiseringen/acties/taken#taakprioriteit-zetten) | Podwyższa, obniża lub wybiera priorytet istniejącego zadania |
| Zadania | [Zaktualizuj zadanie](/automatiseringen/acties/taken#taak-bijwerken) | Zmienia nazwę zadania, dodaje osoby lub etykiety albo przesuwa termin |
| Zadania | [Usuń zadanie](/automatiseringen/acties/taken#taak-verwijderen) | Usuwa zadanie, na przykład zadanie utworzone przez ten przepływ |
| Dokumenty | [Znajdź dokument](/automatiseringen/acties/documenten#document-zoeken) | Szuka najnowszego dokumentu klienta i idzie dalej przez **Znaleziono** lub **Nie znaleziono** |
| Dokumenty | [Zaktualizuj dokument](/automatiseringen/acties/documenten#document-bijwerken) | Zmienia typ dokumentu albo go archiwizuje lub przywraca |
| Goście i wiadomości | [Napisz do gościa](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen) | Wysyła własny tekst do klienta e-mailem, SMS-em lub przez WhatsApp |
| Goście i wiadomości | [Powiadom współpracowników](/automatiseringen/acties/gasten-en-berichten#collegas-verwittigen) | Wysyła współpracownikom powiadomienie push lub e-mail |
| Goście i wiadomości | [Dodaj komentarz](/automatiseringen/acties/gasten-en-berichten#opmerking-toevoegen) | Umieszcza komentarz przy rekordach zdarzenia lub przy zadaniu |
| Goście i wiadomości | [Odpowiedz w skrzynce](/automatiseringen/acties/gasten-en-berichten#antwoorden-in-de-inbox) | Wysyła odpowiedź w rozmowie ze skrzynki |
| Goście i wiadomości | [Oznacz lub zarchiwizuj rozmowę](/automatiseringen/acties/gasten-en-berichten#gesprek-taggen-of-archiveren) | Dodaje tagi do rozmowy w skrzynce lub ją archiwizuje |
| Goście i wiadomości | [Zaktualizuj klienta](/automatiseringen/acties/gasten-en-berichten#klant-bijwerken) | Zmienia status klienta lub dodaje notatkę |
| Goście i wiadomości | [Zamelduj, wymelduj lub anuluj](/automatiseringen/acties/gasten-en-berichten#inchecken-uitchecken-of-annuleren) | Przestawia rezerwację do jej następnego statusu |
| Faktury i płatności | [Wyślij przypomnienie o płatności](/automatiseringen/acties/facturen-en-betalingen#betalingsherinnering-versturen) | Wysyła klientowi przypomnienie o płatności faktury |
| Faktury i płatności | [Synchronizuj transakcje bankowe](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren) | Pobiera nowe transakcje bankowe, zanim przepływ pójdzie dalej |
| Faktury i płatności | [Wyłącz automatyczne przypomnienia dla klienta](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant) | Pomija wszystkie faktury klienta w automatycznych upomnieniach |
| Faktury i płatności | [Wyłącz automatyczne przypomnienia dla faktury](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-factuur) | Wyłącza jedną fakturę z automatycznych przepływów przypomnień |
| Faktury i płatności | [Wyślij fakturę](/automatiseringen/acties/facturen-en-betalingen#factuur-versturen) | Wysyła fakturę klientowi |
| Faktury i płatności | [Zaksięguj fakturę](/automatiseringen/acties/facturen-en-betalingen#factuur-boeken) | Księguje fakturę roboczą |
| Faktury i płatności | [Drukuj fakturę](/automatiseringen/acties/facturen-en-betalingen#factuur-afdrukken) | Drukuje fakturę lub pokazuje ją na tablecie |
| Faktury i płatności | [Utwórz link do płatności](/automatiseringen/acties/facturen-en-betalingen#betaallink-aanmaken) | Tworzy internetowy link do płatności na to, co nadal jest otwarte |
| Faktury i płatności | [Poproś o upoważnienie SEPA](/automatiseringen/acties/facturen-en-betalingen#sepa-mandaat-aanvragen) | Prosi klienta o podpisanie upoważnienia albo wysyła przypomnienie |
| Faktury i płatności | [Pobierz poleceniem zapłaty](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring) | Pobiera to, co jest otwarte, za pomocą aktywnego upoważnienia klienta |
| Faktury i płatności | [Zafakturuj zużycie](/automatiseringen/acties/facturen-en-betalingen#verbruik-factureren) | Fakturuje otwarte zużycie liczników klienta |
| Faktury i płatności | [Robocza faktura przedłużenia](/automatiseringen/acties/facturen-en-betalingen#conceptfactuur-voor-verlenging) | Tworzy fakturę roboczą, która przedłuża zajęcie miejsca |
| Dostęp i urządzenia | [Utwórz metodę dostępu](/automatiseringen/acties/toegang-en-toestellen#toegangsmiddel-aanmaken) | Daje klientowi dostęp przez kod QR, tablicę rejestracyjną, PIN lub NFC |
| Dostęp i urządzenia | [Zaktualizuj dostęp](/automatiseringen/acties/toegang-en-toestellen#toegang-bijwerken) | Blokuje, odblokowuje lub przedłuża środki dostępu |
| Dostęp i urządzenia | [Wyślij lub wydrukuj kod QR](/automatiseringen/acties/toegang-en-toestellen#qr-code-versturen-of-afdrukken) | Wysyła klientowi kod QR dostępu lub go drukuje |
| Dostęp i urządzenia | [Otwórz lub zamknij szlaban](/automatiseringen/acties/toegang-en-toestellen#slagboom-openen-of-sluiten) | Otwiera lub zamyka szlaban albo bramę |
| Dostęp i urządzenia | [Przełącz zasilanie](/automatiseringen/acties/toegang-en-toestellen#stroom-schakelen) | Włącza lub wyłącza prąd w inteligentnym liczniku |
| Dostęp i urządzenia | [Zaktualizuj tagi NFC](/automatiseringen/acties/toegang-en-toestellen#nfc-tags-bijwerken) | Blokuje, odblokowuje lub doładowuje tagi NFC klienta |
| Dostęp i urządzenia | [Steruj tabletem lub kioskiem](/automatiseringen/acties/toegang-en-toestellen#tablet-of-kiosk-bedienen) | Wybudza tablet lub kiosk, usypia go albo ładuje ponownie |
| Dostęp i urządzenia | [Ustaw pokaz slajdów](/automatiseringen/acties/toegang-en-toestellen#diavoorstelling-instellen) | Ustawia zdjęcia na tabletach i kioskach, z listy lub z wcześniejszej prośby |
| Integracje | [Wyślij webhook](/automatiseringen/acties/integraties#webhook-versturen) | Dostarcza własną wiadomość na jeden z Twoich endpointów webhooka |
| Integracje | [Żądanie API](/automatiseringen/acties/integraties#api-verzoek) | Wywołuje Tillor API lub inną stronę |

We wszystkich polach tekstowych możesz używać [zmiennych](/automatiseringen/variabelen), takich jak `{invoice.displayId}`. W prawym górnym rogu każdego pola jest przycisk **Zmienna**, aby ją wstawić. Pola, w których wymagany jest klient, faktura lub inny rekord, oczekują wewnętrznego ID tego rekordu, takiego jak `{invoice.id}`. Numer faktury lub nazwa więc nie zadziałają.

## Wyjścia akcji [#uitgangen-van-een-actie]

Pod krokiem jest jedno lub więcej wyjść. Każde wyjście łączysz z krokiem następnym. Jeśli zostawisz wyjście niepołączone, uruchomienie kończy się w tym miejscu.

| Wyjście | Przy których akcjach | Kiedy |
|---|---|---|
| **Dalej** | Większość akcji | Krok się powiódł |
| **Gotowe** i **Pominięto** | Akcje, które czasem nie mają nic do zrobienia | **Gotowe**, jeśli krok wykonał swoją pracę. **Pominięto**, jeśli nie było nic do zrobienia, na przykład dlatego, że faktura była już zaksięgowana. To nie jest błąd |
| **Znaleziono** i **Nie znaleziono** | **Znajdź zadanie** | Czy zadanie istnieje |
| **Znaleziono** i **Nie znaleziono** | **Znajdź dokument** | Czy klient ma taki dokument |
| **Powodzenie** i **Niepowodzenie** | **Wyślij webhook** i **Żądanie API** | Czy druga strona przyjęła wiadomość |

**Gotowe** i **Pominięto** są przy **Napisz do gościa**, **Zamelduj, wymelduj lub anuluj**, **Zaksięguj fakturę**, **Utwórz link do płatności**, **Poproś o upoważnienie SEPA**, **Pobierz poleceniem zapłaty** i **Zafakturuj zużycie**. Przy każdej z nich pod akcją jest opisane, kiedy krok jest pomijany.

### Kontynuuj, gdy ten krok się nie powiedzie [#doorgaan-als-deze-stap-mislukt]

Jeśli akcja się nie powiedzie, uruchomienie zwykle zatrzymuje się ze statusem **Niepowodzenie**. Jeśli chcesz sam zdecydować, co się wtedy stanie, włącz na dole ustawień kroku **Kontynuuj, gdy ten krok się nie powiedzie**. Jest to możliwe przy każdej akcji z wyjątkiem **Wyślij webhook** i **Żądanie API**, które mają już własne wyjście **Niepowodzenie**.

Krok dostaje wtedy dodatkowe wyjście **Błąd**. Jeśli akcja się nie powiedzie, przepływ idzie dalej przez **Błąd** zamiast się zatrzymać. Kolejne kroki mogą używać tych zmiennych:

| Zmienna | Zawartość |
|---|---|
| `{error.message}` | Komunikat o błędzie. Może być po angielsku |
| `{error.step}` | Nazwa kroku, który się nie powiódł, tak jak wpisano ją w **Nazwa kroku** |

Kilka rzeczy, które warto wiedzieć:

- Jeśli akcja się powiodła lub została pominięta, nic się nie zmienia, a **Błąd** nie jest używany
- Jeśli zostawisz **Błąd** niepołączony, uruchomienie kończy się w tym miejscu bez dalszych kroków. Uruchomienie dostaje wtedy status **Zakończone**, ale sam krok jest na karcie **Uruchomienia** ze swoim komunikatem o błędzie
- Drugi nieudany krok w tym samym przepływie zastępuje `{error.message}` i `{error.step}` pierwszego

Przykład: pozwól, aby **Napisz do gościa** szedł dalej, gdy się nie powiedzie, i utwórz przez **Błąd** zadanie z `{error.message}` w opisie. Wtedy współpracownik sam podejmie rozmowę z gościem.

## Gdy krok się nie powiedzie [#als-een-stap-mislukt]

Są trzy sposoby, w jakie przebiega niepowodzenie.

- **Wyjście Niepowodzenie.** Dzieje się tak przy **Wyślij webhook** i **Żądanie API**, gdy druga strona zwróci błąd. Przepływ idzie dalej przez wyjście **Niepowodzenie**. Połącz je z kontynuacją, taką jak zadanie dla współpracownika. Jeśli zostawisz wyjście niepołączone, uruchomienie po prostu kończy się w tym miejscu
- **Wyjście Błąd.** Jeśli przy innej akcji włączysz **Kontynuuj, gdy ten krok się nie powiedzie**, krok dostaje wyjście **Błąd** i możesz użyć powodu przez `{error.message}`. Zobacz [Kontynuuj, gdy ten krok się nie powiedzie](#doorgaan-als-deze-stap-mislukt)
- **Krok zatrzymuje uruchomienie.** Jeśli po uzupełnieniu zmiennych brakuje wartości, nie można wysłać faktury, endpoint już nie istnieje albo JSON jest nieprawidłowy, uruchomienie dostaje status **Niepowodzenie**. Kroki po nim nie są wykonywane, a Tillor nie próbuje kroku ponownie. Dzieje się tak tylko wtedy, gdy nie włączono **Kontynuuj, gdy ten krok się nie powiedzie**

Komunikat o błędzie jest przy kroku na karcie **Uruchomienia**. Te komunikaty mogą być po angielsku.

<Callout type="idea" title="Nie przegap niepowodzeń">
Chcesz, aby niepowodzenie nigdy nie przeszło bez echa? Połącz wyjście **Niepowodzenie** w **Żądanie API** lub **Wyślij webhook**, albo wyjście **Błąd** innej akcji, z krokiem [Utwórz zadanie](/automatiseringen/acties/taken#taak-aanmaken). Wtedy współpracownik może się tym zająć.
</Callout>

## Grupy [#groepen]

<Cards>
  <Card title="Zadania" href="/automatiseringen/acties/taken" description="Tworzenie, wyszukiwanie i aktualizowanie zadań" />
  <Card title="Goście i wiadomości" href="/automatiseringen/acties/gasten-en-berichten" description="Wiadomości, komentarze, skrzynka i rezerwacje" />
  <Card title="Faktury i płatności" href="/automatiseringen/acties/facturen-en-betalingen" description="Przypomnienia, faktury i płatności" />
  <Card title="Dostęp i urządzenia" href="/automatiseringen/acties/toegang-en-toestellen" description="Dostęp, prąd, NFC i tablety" />
  <Card title="Integracje" href="/automatiseringen/acties/integraties" description="Webhooki i żądania API" />
</Cards>


# Integracje (/pl-PL/automatiseringen/acties/integraties)

Te kroki znajdują się w grupie **Integracje**. Nieudane dostarczenie idzie dalej przez **Niepowodzenie**. W przypadku innych akcji przeczytaj [Gdy krok się nie uda](/automatiseringen/acties#als-een-stap-mislukt).

## Wyślij webhook [#webhook-versturen]

Dostarcza własną wiadomość do jednego z punktów końcowych webhooków Twojej organizacji. Przydaje się, żeby powiadomić inny system, na przykład kasę albo stronę internetową.

| Pole | Co wpisujesz |
|---|---|
| **Punkt końcowy** | Wybierz jeden ze swoich punktów końcowych webhooków. Rozpoznasz je po adresie. Wymagane |
| **Nazwa zdarzenia** | Nazwa dołączana do wiadomości, żeby odbiorca mógł ją rozpoznać, na przykład `automation.invoice_unpaid`. Wymagane |
| **Ładunek** | Treść wiadomości w formacie JSON. Zmienne są uzupełniane przed wysłaniem wiadomości. Wymagane |

Punkty końcowe tworzysz i zarządzasz nimi w menu profilu w sekcji **Dla deweloperów**. Punkt końcowy musi istnieć i być włączony. Jeśli tak nie jest, krok się nie udaje i wykonanie zostaje zatrzymane.

Wiadomość jest podpisywana własnym kluczem punktu końcowego, dokładnie tak jak inne webhooki, które ten punkt odbiera. Tillor ponawia próbę kilka razy, jeśli Twój serwer nie odpowie poprawnie. Punkt końcowy nie musi śledzić nazwy Twojego zdarzenia: wiadomość i tak dotrze.

Krok ma dwa wyjścia:

| Wyjście | Kiedy |
|---|---|
| **Powodzenie** | Twój serwer odpowiedział statusem sukcesu |
| **Niepowodzenie** | Dostarczenie nie udało się po wszystkich próbach. Potem wiadomość jest jeszcze ponawiana w tle, tak jak zwykły webhook |

Szablon **Przekazuj rezerwacje do innego systemu** używa wyjścia **Niepowodzenie**, żeby utworzyć zadanie, które ktoś podejmie.

Ładunek wygląda na przykład tak:

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

Tekst ujmij w cudzysłów, a liczby wpisz bez niego. Daty w JSON trafiają jako międzynarodowa data i godzina, na przykład `2026-10-05T08:00:00.000Z`. Szczegóły przeczytasz w [Zmienne i szablony](/automatiseringen/variabelen#hoe-waarden-worden-ingevuld). Stronę techniczną, na przykład budowę wiadomości, opisano w [Dla deweloperów > Automatyzacje](/ontwikkelaars/automatiseringen).

## Żądanie API [#api-verzoek]

Wywołuje API Tillor Twojej własnej organizacji albo inny adres w internecie. Dzięki temu zrobisz prawie wszystko, co potrafi Tillor, i wyszukasz dane, żeby coś z nimi zrobić.

W polu **Wyślij do** wybierasz między **Tillor API** a **Własny URL**. W polu **Metoda** wybierasz **GET** (pobieranie), **POST** (tworzenie), **PUT** lub **PATCH** (zmienianie) albo **DELETE** (usuwanie).

### Tillor API [#tillor-api]

| Pole | Co wpisujesz |
|---|---|
| **Ścieżka** | Część adresu po API Twojej organizacji, na przykład `/tasks` albo `/tasks/{task.id}`. Musi zaczynać się od `/`. Wymagane |
| **Treść** | Dane, które wysyłasz, w formacie JSON. Zostaw puste, jeśli nic nie wysyłasz |

Na górze pola znajduje się **Wybierz punkt końcowy API**. Kliknij go i szukaj na liście, na przykład *tasks*. Gdy wybierzesz punkt końcowy, Tillor uzupełnia metodę i ścieżkę. Jeśli **Treść** jest jeszcze pusta, dostajesz też przykład tego, czego punkt końcowy oczekuje. Nazwy w nawiasach klamrowych w ścieżce zastąp zmiennymi z wcześniejszych kroków. Jeśli są parametry zapytania, zobaczysz je pod polem.

Wywołanie odbywa się jako użytkownik **Przepływ pracy** i nigdy nie może wyjść poza Twoją organizację. Automatyzacja nie może zarządzać automatyzacjami, więc wywołania, które dotyczą automatyzacji lub ich wykonań, są odrzucane.

### Własny URL [#eigen-url]

| Pole | Co wpisujesz |
|---|---|
| **URL** | Adres. Musi zaczynać się od `https://`. Wymagane |
| **Nagłówki** | Dodatkowe dane dla odbiorcy, na przykład klucz. Kliknij **Dodaj nagłówek** i wypełnij **Nazwa** oraz **Wartość** |
| **Treść** | Dane, które wysyłasz, w formacie JSON. Zostaw puste, jeśli nic nie wysyłasz |

Obowiązują tu te zasady:

- Adresy bez `https://` są odrzucane
- Adresy prywatne i wewnętrzne są odrzucane, także gdy wskazuje na nie zwykła nazwa
- Przekierowania nie są śledzone. Jeśli serwer odpowie przekierowaniem, liczy się to jako **Niepowodzenie**
- Nagłówki są zapisywane w formie zaszyfrowanej. Możesz więc wpisać w nich klucz lub token
- Przy **GET** i **DELETE** treść nie jest wysyłana

### Wyjścia i odpowiedź [#uitgangen-en-antwoord]

Żądanie ma dwa wyjścia: **Powodzenie** (serwer odpowiedział statusem sukcesu) i **Niepowodzenie** (serwer odpowiedział statusem błędu). Jeśli Tillor w ogóle nie dotrze do serwera, na przykład przez przekroczenie czasu po 15 sekundach albo odrzucony adres, wykonanie zatrzymuje się ze statusem **Niepowodzenie**.

Dla kolejnych kroków są trzy zmienne:

| Zmienna | Zawartość |
|---|---|
| `{response.status}` | Kod statusu, na przykład 200 |
| `{response.body}` | Odpowiedź jako tekst, skrócona do pierwszych 4000 znaków |
| `{response.data}` | Odpowiedź jako dane, dzięki czemu możesz wyciągać z niej pola, na przykład `{response.data.items.0.id}` |

Jak z tego korzystać, opisano w [Używanie odpowiedzi API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). Pełny przykład z wyszukiwaniem znajdziesz w [Kontrola przyczepy do wynajęcia](/automatiseringen/voorbeeld-nalopen).


# Zadania (/pl-PL/automatiseringen/acties/taken)

Tymi krokami automatyzacja tworzy i aktualizuje zadania, żeby ktoś z zespołu się nimi zajął. Znajdują się w grupie **Zadania**. Jak działają wyjścia, przeczytasz w [Wyjścia akcji](/automatiseringen/acties#uitgangen-van-een-actie).

## Jak to się łączy? [#hoe-hangt-dit-samen]

Zadanie z automatyzacji jest zwykłym zadaniem: znajdziesz je na stronie zadań, w widokach, do których pasuje, oraz przy kliencie lub rekordzie, do którego jest przypięte.

```mermaid
flowchart LR
  A["Krok Utwórz zadanie"] --> T["Zadanie na stronie zadań<br/>w imieniu Przepływu pracy"]
  T --> V["Widoki pokazują je,<br/>jeśli pasuje lub jest na liście"]
  T --> C["Kolega się nim zajmuje"]
  C -- "Zmienia się status lub przypisanie" --> E["Może na tym wystartować inna automatyzacja"]
  D["Krok Poproś o decyzję"] --> T2["Zadanie z przyciskami wyboru"]
  T2 -- "Kolega wybiera przycisk" --> F["Automatyzacja idzie dalej przez tę opcję"]
```

Więcej o tym, co widzą i robią koledzy, znajdziesz w [Zadania](/taken) i [Zadania z przyciskami wyboru](/taken/taakdetails#taken-met-keuzeknoppen).

## Utwórz zadanie [#taak-aanmaken]

Tworzy zadanie w systemie zadań. Zadanie jest zapisane w imieniu **Przepływ pracy**.

<DocScreenshot src="/screenshots/taken/automation-task-create-step.png" alt="Automatyzacja z zaznaczonym krokiem Utwórz zadanie i ustawieniami po prawej" />


| Pole | Co wpisujesz |
|---|---|
| **Tytuł** | Nazwa zadania. Wymagane |
| **Opis** | Wyjaśnienie do zadania |
| **Przypisz do** | Wybierz jednego lub kilku kolegów. Kliknij nazwisko, żeby je włączyć lub wyłączyć |
| **Przypisz do grup** | Wybierz jedną lub kilka [grup](/gebruikers/groepen). Zadanie obowiązuje wtedy wszystkich, którzy w danej chwili należą do grupy |
| **Etykiety** | Wybierz jedną lub kilka [etykiet](/taken/labels) |
| **Przypisz też osobę, która wywołała zdarzenie** | Przypisuje zadanie także koledze, który wywołał zdarzenie, na przykład zakończył obłożenie. Jeśli zdarzenie wywołał system, nikt nie jest dodawany |
| **Priorytet** | **Niski**, **Średni**, **Wysoki** lub **Pilny**. Domyślnie **Średni** |
| **Dodaj do tablicy** | Wybierz tablicę, na której pojawi się zadanie, albo zostaw puste |
| **Kolumna** | Wybierz kolumnę z powyższej tablicy. Lista pokazuje kolumny jako *[tablica] · [kolumna]* |
| **Podzadania** | Jedno podzadanie w wierszu albo dokładnie jedna zmienna z listą, na przykład `{result}` z [Uruchom kod](/automatiseringen/logica#code-uitvoeren) |
| **Termin po** | Ile minut, godzin, dni lub tygodni po wykonaniu kroku przypada termin. Przy 0 zadanie nie dostaje terminu. Domyślnie 1 dzień |
| **Powiąż z rekordami** | Wiąże zadanie z rekordami poniżej oraz z ich klientem, działką, fakturą, rezerwacją lub licznikiem. Domyślnie włączone |
| **Powiąż z** | Pojawia się, gdy **Powiąż z rekordami** jest włączone. Wybierz, przy których rekordach pojawi się zadanie. Domyślnie zaznaczone jest wszystko, co zna krok: rekordy wyzwalacza i to, co znalazł wcześniejszy krok wyszukiwania |
| **Tylko przepływ może ją zakończyć** | Koledzy nie mogą zakończyć zadania ani go usunąć. Dalej dodaj krok **Usuń zadanie** albo **Ustaw status**, żeby je zakończyć |

Zwróć uwagę na to:

- Jeśli nie wybierzesz nikogo w **Przypisz do** ani **Przypisz do grup** i zostawisz wyłączone **Przypisz też osobę, która wywołała zdarzenie**, zadanie nie ma przypisanego kolegi. **Przepływ pracy** nigdy nie jest przypisywany sam
- Podzadania mają taki sam tytuł, jaki wpisujesz, nie mają przypisanego kolegi ani terminu. Puste wiersze są pomijane. W wierszach możesz używać zmiennych
- W **Powiąż z** chodzi o klientów, działki, faktury, rezerwacje i liczniki. Przy kończącym się obłożeniu zadanie jest więc domyślnie powiązane z działką, klientem i rezerwacją. Jeśli usuniesz rekord z listy, zadanie pozostanie poza nim. Rekordów, które pojawią się później w przepływie, Tillor nie dodaje automatycznie po tym, jak sam zmienisz listę. Jeśli wybierzesz wszystko od nowa, krok znów podąża za wszystkimi dostępnymi rekordami
- Jeśli zadanie jest tylko na tablicy osobistej, widzą je tylko zainteresowani. Zobacz [Zadania prywatne](/taken/prive-taken)

Dla kolejnych kroków akcja zwraca `{createdTask.id}` i `{createdTask.name}`. Dzięki nim możesz na przykład potem ustawić status.

Jeśli nie chcesz drugiego zadania, gdy dla tej samej działki lub tego samego klienta jest już otwarte zadanie, dodaj najpierw krok [Znajdź zadanie](#taak-zoeken) i utwórz zadanie tylko przez **Nie znaleziono**. Robi tak [przykład Kontrola przyczepy do wynajęcia](/automatiseringen/voorbeeld-nalopen).

Jeśli włączysz **Tylko przepływ może ją zakończyć**, na zadaniu pojawi się **Kończy ją automatyzacja**. Koledzy nie mogą go zakończyć ani usunąć.

## Usuń zadanie [#taak-verwijderen]

Usuwa zadanie, na przykład to, które utworzył ten przepływ, gdy nie jest już potrzebne.

| Pole | Co wpisujesz |
|---|---|
| **Zadanie** | Id zadania. Domyślnie `{createdTask.id}`. Wymagane |

Zadanie, którego już nie ma, jest pomijane. Przepływ idzie wtedy dalej.

## Ustaw status [#taakstatus-zetten]

Zmienia status istniejącego zadania, na przykład żeby je zakończyć.

| Pole | Co wpisujesz |
|---|---|
| **Zadanie** | Id zadania. Domyślnie `{task.id}`. Wymagane |
| **Status** | **Oczekująca**, **W toku**, **Oczekuje na odpowiedź** lub **Ukończona**. Domyślnie **Ukończona** |

`{task.id}` działa, gdy automatyzacja startuje na zdarzeniu zadania, takim jak `task:created`. Po kroku **Utwórz zadanie** używasz `{createdTask.id}`. Akcja zwraca `{updatedTask.id}` i `{updatedTask.status}`.

## Znajdź zadanie [#taak-zoeken]

Wyszukuje istniejące zadanie po tytule. Krok ma dwa wyjścia: **Znaleziono** i **Nie znaleziono**. Dzięki temu możesz zaktualizować zadanie, jeśli już istnieje, a w przeciwnym razie utworzyć nowe.

| Pole | Co wpisujesz |
|---|---|
| **Tytuł** | Tytuł, jaki zadanie musi mieć dokładnie, na przykład `Nalopen {occupation.terrain.name}`. Zmienne są najpierw uzupełniane. Wymagane |
| **Powiązane z rekordami zdarzenia** | Tylko zadania powiązane z co najmniej jednym z tych samych rekordów, takim jak działka lub klient. Domyślnie włączone |
| **Tylko zadania nieukończone** | Pomija ukończone zadania. Domyślnie włączone |
| **Pomiń podzadania** | Szuka tylko zadań głównych. Domyślnie włączone |

Jeśli pasuje kilka zadań, krok bierze najnowsze. Jeśli **Powiązane z rekordami zdarzenia** jest włączone, ale zdarzenie nie ma klienta, działki, faktury, rezerwacji ani licznika, przepływ idzie przez **Nie znaleziono**.

Przez **Znaleziono** kolejne kroki mogą używać `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}` i `{foundTask.status}`.

## Ustaw priorytet zadania [#taakprioriteit-zetten]

Zmienia priorytet istniejącego zadania.

| Pole | Co wpisujesz |
|---|---|
| **Zadanie** | Id zadania. Domyślnie `{foundTask.id}`. Wymagane |
| **Zmiana** | **O jeden poziom wyżej** (domyślnie), **O jeden poziom niżej** lub **Na stały priorytet** |
| **Priorytet** | Tylko przy **Na stały priorytet**: **Niski**, **Średni**, **Wysoki** lub **Pilny** |
| **Podnieś maksymalnie do** | Tylko przy **O jeden poziom wyżej**: najwyższy priorytet, jaki krok może nadać. Domyślnie **Wysoki**. Zadanie, które ma już taki lub wyższy priorytet, zostaje bez zmian |

Kolejność to **Niski**, **Średni**, **Wysoki**, **Pilny**. Obniżanie zatrzymuje się na **Niski**. Jeśli nic się nie zmienia, krok po prostu się udaje, nie zmieniając zadania. Akcja zwraca `{updatedTask.id}` i `{updatedTask.priority}`.

## Zaktualizuj zadanie [#taak-bijwerken]

Zmienia istniejące zadanie. Pola, które zostawisz puste, pozostają bez zmian.

| Pole | Co wpisujesz |
|---|---|
| **Zadanie** | Id zadania. Domyślnie `{foundTask.id}`. Wymagane |
| **Nowy tytuł** | Nowa nazwa zadania. Puste zostawia tytuł bez zmian |
| **Osoby przypisane** | Wybierz jednego lub kilku kolegów |
| **Grupy** | Wybierz jedną lub kilka [grup](/gebruikers/groepen) |
| **Przypisz też osobę, która wywołała zdarzenie** | Dodaje także kolegę, który wywołał zdarzenie. Jeśli zdarzenie wywołał system, nikt nie jest dodawany |
| **Osoby przypisane** | **Dodaj do obecnych** (domyślnie) lub **Zastąp obecne** |
| **Dodaj etykiety** | Wybierz jedną lub kilka [etykiet](/taken/labels). Dochodzą do istniejących, a dotychczasowe etykiety zostają |
| **Termin po** | Ustawia termin na tyle minut, godzin, dni lub tygodni po wykonaniu kroku. Przy 0 termin zostaje bez zmian |

Zwróć uwagę na to:

- Jeśli wybierzesz **Zastąp obecne** i nikogo nie podasz, zadanie nie ma potem nikogo przypisanego
- Jeśli zadanie już nie istnieje, krok się nie udaje
- Akcja zwraca `{updatedTask.id}`


# Dostęp i urządzenia (/pl-PL/automatiseringen/acties/toegang-en-toestellen)

Te akcje dotyczą samego parku: kto może wjechać, które liczniki mają prąd i co robią tablety. Tło dotyczące metod dostępu znajdziesz w [Kontroli dostępu](/toegangscontrole). Jak działają wyjścia, przeczytasz w [Wyjścia akcji](/automatiseringen/acties#uitgangen-van-een-actie).

## Utwórz metodę dostępu [#toegangsmiddel-aanmaken]

Daje klientowi dostęp przez kod QR, numer rejestracyjny, kod PIN lub NFC.

| Pole | Co wpisujesz |
|---|---|
| **Klient** | Id klienta, na przykład `{reservation.customerId}`. Wymagane |
| **Typ** | **Kod QR** (domyślnie), **Numer rejestracyjny**, **Kod PIN** lub **NFC** |
| **Wartość** | Numer rejestracyjny lub numer NFC. Zostaw puste dla kodu QR lub kodu PIN, bo Tillor tworzy je sam |
| **Ważne od** | Zmienna daty, na przykład `{reservation.checkIn}`. Puste oznacza brak limitu |
| **Ważne do** | Zmienna daty, na przykład `{reservation.checkOut}`. Puste oznacza brak limitu |

Przy **Numer rejestracyjny** i **NFC** pole **Wartość** jest wymagane. Akcja zwraca `{createdAccessMethod.id}` i `{createdAccessMethod.value}`. Wartość to kod QR albo kod PIN. Dzięki id możesz potem wysłać kod przez **Wyślij lub wydrukuj kod QR**.

## Zaktualizuj dostęp [#toegang-bijwerken]

Blokuje, odblokowuje lub przedłuża metodę dostępu albo wszystkie metody dostępu klienta.

| Pole | Co wpisujesz |
|---|---|
| **Które** | **Jedna metoda dostępu** (domyślnie) lub **Wszystkie metody klienta** |
| **Metoda dostępu** | Tylko przy **Jedna metoda dostępu**: id, na przykład `{createdAccessMethod.id}`. Wymagane |
| **Klient** | Tylko przy **Wszystkie metody klienta**: id klienta, na przykład `{occupation.customerId}`. Wymagane |
| **Status** | **Pozostaw bez zmian** (domyślnie), **Aktywny**, **Miękko zablokowany**, **Zablokowany** lub **Nieaktywny** |
| **Ważne do** | Zmienna daty. Puste zachowuje obecną datę końca |

Zwróć uwagę na to:

- Jeśli zostawisz **Status** na **Pozostaw bez zmian**, a **Ważne do** puste, krok nic nie robi
- Przy **Wszystkie metody klienta** metody dostępu z ustawieniem **Nie przedłużaj automatycznie** zachowują datę końca, tak jak dzieje się, gdy klient opłaci fakturę. Ich status się jednak zmienia. Przy **Jedna metoda dostępu** krok zmienia też datę końca, nawet gdy ta metoda ma ustawienie **Nie przedłużaj automatycznie**

## Wyślij lub wydrukuj kod QR [#qr-code-versturen-of-afdrukken]

Wysyła klientowi kod dostępu QR, drukuje go albo robi jedno i drugie.

| Pole | Co wpisujesz |
|---|---|
| **Metoda dostępu** | Id metody dostępu. Domyślnie `{createdAccessMethod.id}`. Wymagane |
| **Wyślij e-mailem** | Domyślnie włączone |
| **Wyślij SMS-em** | Domyślnie wyłączone |
| **Wyślij przez WhatsApp** | Domyślnie wyłączone |
| **Druk** | **Nie drukuj** (domyślnie), **Drukarka etykiet** lub **Drukarka paragonów** |

Jeśli wyłączysz wszystkie trzy kanały i wybierzesz **Nie drukuj**, krok nic nie robi.

## Otwórz lub zamknij szlaban [#slagboom-openen-of-sluiten]

Otwiera lub zamyka szlaban albo bramę.

| Pole | Co wpisujesz |
|---|---|
| **Punkt dostępu** | Wybierz jeden ze swoich punktów dostępu. Wymagane |
| **Akcja** | **Otwórz** (domyślnie) lub **Zamknij** |

## Przełącz zasilanie [#stroom-schakelen]

Włącza lub wyłącza prąd w inteligentnym liczniku. Na przykład żeby wyłączyć prąd, gdy kończy się obłożenie.

| Pole | Co wpisujesz |
|---|---|
| **Które liczniki** | **Każdy przełączalny licznik działki** (domyślnie) lub **Jeden licznik** |
| **Działka** | Tylko przy **Każdy przełączalny licznik działki**: id działki. Domyślnie `{occupation.terrainId}`. Wymagane |
| **Licznik** | Tylko przy **Jeden licznik**: wybierz licznik. Wymagane |
| **Zasilanie** | **Wł.** lub **Wył.**. Domyślnie **Wył.** |

Zwróć uwagę na to:

- Przy **Każdy przełączalny licznik działki** krok przełącza tylko liczniki, które to potrafią. Jeśli działka ich nie ma, nic się nie dzieje
- Jeśli przełączenie licznika się nie uda, krok się nie udaje. Przy **Jeden licznik** dzieje się tak również, gdy licznik nie może się przełączyć. Liczniki, które zostały przełączone wcześniej, pozostają przełączone

## Zaktualizuj tagi NFC [#nfc-tags-bijwerken]

Aktualizuje wszystkie [tagi NFC](/nfc/nfc-tags) klienta.

| Pole | Co wpisujesz |
|---|---|
| **Klient** | Id klienta, na przykład `{occupation.customerId}`. Akcja dotyczy każdego tagu NFC tego klienta. Wymagane |
| **Akcja** | **Zablokuj** (domyślnie), **Odblokuj**, **Doładuj** lub **Wyślij wiadomość o niskim saldzie** |
| **Kwota** | Tylko przy **Doładuj**: kwota w euro, na każdy tag. Musi być większa od 0. Wymagane |

Jeśli klient ma dwa tagi i wpiszesz 20, każdy tag dostaje 20 euro więcej. Bez tagów krok nic nie robi. Przy kwocie, która nie jest liczbą większą od 0, krok się nie udaje.

## Steruj tabletem lub kioskiem [#tablet-of-kiosk-bedienen]

Wysyła polecenie do [tabletu lub kiosku](/mobiele-app/tablets-en-kiosken).

| Pole | Co wpisujesz |
|---|---|
| **Urządzenie** | Wybierz urządzenie. Wymagane |
| **Polecenie** | **Wybudź** (domyślnie), **Uśpij**, **Przeładuj**, **Identyfikuj** lub **Odtwórz dźwięk testowy** |

## Ustaw pokaz slajdów [#diavoorstelling-instellen]

Ustawia pokaz slajdów na każdym tablecie i kiosku albo na jednym urządzeniu. Pozostałe ustawienia urządzenia zostają. Jeśli ten sam pokaz slajdów już tam jest, urządzenie jest pomijane.

Cogodzinny wyzwalacz, potem [żądanie API](/automatiseringen/acties/integraties#api-verzoek) do kanału z aktywnościami, a następnie ten krok: w ten sposób zastępujesz osobną synchronizację. Połącz krok z wyjściem **Powodzenie** żądania.

| Pole | Co wpisujesz |
|---|---|
| **Urządzenia** | **Każdy tablet i kiosk** (domyślnie) lub **Jedno urządzenie** |
| **Urządzenie** | Tylko przy **Jedno urządzenie**. Wymagane |
| **Tryb** | **Wygaszacz** (domyślnie, po pewnym czasie bez dotyku) lub **Tło** |
| **Sekundy na zdjęcie** | Jak długo jedno zdjęcie jest widoczne. Domyślnie 10. Od 3 do 600 |
| **Czekanie przed startem** | Tylko przy **Wygaszacz**: sekundy bez dotyku. Domyślnie 15 |
| **Dopasowanie** | **Wypełnij** lub **Dopasuj** |
| **Zdjęcia** | **Z wcześniejszego żądania** (domyślnie) lub **Adresy** |
| **Adresy obrazów** | Tylko przy **Adresy**: jeden adres https w wierszu. Wymagane |
| **Lista** | Ścieżka listy JSON, bez nawiasów klamrowych. Po żądaniu API to `response.data`. Wymagane |
| **Pole obrazu** | Nazwa pola z adresem https, na przykład `signage_image`. Wymagane |
| **Pole id** | Dzięki temu to samo zdjęcie zachowuje to samo id, więc niezmieniona lista nie wysyła nowej wiadomości do urządzenia |
| **Pole statusu** i **Status** | Tylko wiersze, w których to pole ma tę wartość, na przykład `CONFIRMED` |
| **Pomiń gdy wypełnione** | Wiersze, w których to pole ma wartość, odpadają, na przykład `deleted_at` |
| **Pole daty** i **Pole daty końca** | Wiersz zostaje, dopóki ten moment nie minął. Jeśli data końca jest pusta, liczy się data |
| **Pole sortowania** | Sortuje listę rosnąco, na przykład według `date` |
| **Maksymalna liczba zdjęć** | Domyślnie 5, co najwyżej 20 |

Adres, który nie zaczyna się od `https://`, nie jest uwzględniany. Jeśli lista nie jest tablicą JSON, krok się nie udaje, a obecny pokaz slajdów pozostaje.


# Przegląd (/pl-PL/automatiseringen)

Dzięki automatyzacjom Tillor robi coś za Ciebie, a nikt z zespołu nie musi o tym pamiętać. Zapisujesz regułę: *gdy to się wydarzy, zrób to*. Kilka przykładów:

- Kończy się obłożenie przyczepy stacjonarnej, więc Tillor tworzy zadanie kontrolne z podzadaniami i przypisuje je koledze, który zakończył obłożenie
- Faktura jest przeterminowana, więc Tillor wysyła przypomnienie o płatności, a tydzień później tworzy zadanie z telefonem do klienta, jeśli faktura nadal jest otwarta
- Wpływa nowa rezerwacja, więc Tillor przekazuje jej dane do Twojego własnego systemu
- W każdy poniedziałek o 08:00 Tillor tworzy zadanie na cotygodniową kontrolę
- Wpływa nowa rezerwacja, więc Tillor tworzy dla gościa kod QR i wysyła go e-mailem

Automatyzację budujesz sam na planszy, bez kodu. Wybierasz moment startu, dodajesz kroki i łączysz je liniami.

## Prostymi słowami [#in-gewone-woorden]

Automatyzacja składa się z trzech rodzajów klocków. Szczegółów technicznych musisz się nauczyć dopiero wtedy, gdy będą Ci potrzebne.

- **Moment startu (wyzwalacz)** to "kiedy". W Tillor dzieje się coś, na przykład kończy się obłożenie, albo nadchodzi określona godzina lub data. Zobacz [Wyzwalacze](/automatiseringen/triggers)
- **Logika** to "jeśli". Tu przepływ patrzy na dane i wybiera drogę albo czeka, aż coś się wydarzy. Przykład: *czy faktura po tygodniu nadal nie jest opłacona?* Zobacz [Warunki, rozgałęzienia i opóźnienia](/automatiseringen/logica)
- **Akcje** to "zrób to". Utworzenie zadania, wysłanie wiadomości, zaksięgowanie faktury. Zobacz [Akcje](/automatiseringen/acties)

Oprócz tego **zmienne** to dane z danej chwili, takie jak nazwa działki albo klienta. Wstawiasz je w nawiasach klamrowych do tekstu, a Tillor uzupełnia prawdziwą wartość. Zobacz [Zmienne i szablony](/automatiseringen/variabelen).

## Kto może z tego korzystać [#wie-kan-het-gebruiken]

<Callout type="warn" title="Tylko dla administratorów">
Automatyzacje działają z pełnymi uprawnieniami w Twojej organizacji. Do przeglądania potrzebujesz uprawnienia **Wyświetlanie automatyzacji**, a do tworzenia i zmieniania **Zarządzanie automatyzacjami**. Administratorzy z uprawnieniem **Wszystkie uprawnienia** mają oba. Zobacz [Kto może korzystać z automatyzacji?](/automatiseringen/veelgestelde-vragen#wie-kan-automatiseringen-gebruiken).
</Callout>

Stronę znajdziesz w menu bocznym w <UIPath>Administrator > Automatyzacje</UIPath>.

## Jak to się łączy? [#hoe-hangt-dit-samen]

Każda automatyzacja składa się z kroków, które łączysz w przepływ. Automatyzacja współpracuje z zadaniami: tworzy zadania, czeka, aż kolega wybierze przycisk, albo startuje, gdy zadanie się zmieni. Zobacz [Zadania](/taken#hoe-hangt-dit-samen). Każde uruchomienie automatyzacji nazywamy wykonaniem. Wykonanie zaczyna się od momentu startu i podąża liniami w dół.

| Element | Co robi |
|---|---|
| **Gdy to się wydarzy** (wyzwalacz) | Moment startu. Zdarzenie w Tillor, webhook, wybrana akcja na zadaniu, przeterminowana faktura, data, na przykład przyjazd gościa, stała godzina albo własny harmonogram. Przepływ może mieć kilka wyzwalaczy. Każdy wyzwalacz uruchamia osobne wykonanie |
| **Tylko gdy** | Filtr na wyzwalaczu. Automatyzacja startuje tylko wtedy, gdy dane się zgadzają, na przykład tylko dla przyczep stacjonarnych |
| **Jeśli / w przeciwnym razie** | Dzieli przepływ na **Tak** i **Nie** na podstawie jednego lub kilku warunków |
| **Rozgałęzienie** | Dzieli przepływ na kilka gałęzi, zależnie od wartości pola |
| **Opóźnienie** i inne kroki oczekiwania | Każą przepływowi czekać na czas, datę, godziny otwarcia, warunek, zdarzenie albo decyzję kolegi |
| **Teraz otwarte?**, **Wyszukaj rekord**, **Dla każdego** | Sprawdzają, czy jesteś otwarty, pobierają rekord albo wykonują kolejne kroki dla każdego elementu listy |
| **Akcje** | Naprawdę coś robią: zadania, wiadomości do gości i kolegów, faktury, płatności i mandaty, dostęp, liczniki i urządzenia, webhooki i żądania API |

Kroki z kilkoma wyjściami, takie jak **Tak** i **Nie**, **Gotowe** i **Pominięto** albo **Powodzenie** i **Niepowodzenie**, pozwalają wybrać inną kontynuację dla każdego wyniku. Przy każdej akcji możesz też włączyć wyjście **Błąd**, żeby przepływ szedł dalej, gdy krok się nie uda.

```mermaid
flowchart TD
  A["Gdy to się wydarzy<br/>Faktura jest przeterminowana"] --> B["Wyślij przypomnienie o płatności"]
  B --> C["Opóźnienie<br/>7 dni"]
  C --> D{"Jeśli / w przeciwnym razie<br/>jeszcze nieopłacona?"}
  D -- Tak --> E["Utwórz zadanie<br/>zadzwonić do klienta"]
  D -- Nie --> F["Koniec"]
```

## Zmienne [#variabelen]

Pola tekstowe w kroku przyjmują zmienne w nawiasach klamrowych, takie jak `{occupation.terrain.name}`. Tillor wstawia tam nazwę działki powiązanej ze zdarzeniem. Dzięki temu tworzysz wiadomości i zadania, które w każdym przypadku wyglądają inaczej. Więcej o tym w [Zmienne i szablony](/automatiseringen/variabelen).

## Szybki start [#snel-aan-de-slag]

1. Przejdź do **Administrator > Automatyzacje** i kliknij **Nowa automatyzacja**
2. Wybierz szablon albo **Zacznij od zera**
3. Ustaw wyzwalacz i kroki, a potem kliknij **Zapisz**
4. Wypróbuj przepływ na karcie **Uruchomienie testowe**. Nic nie zostanie wtedy naprawdę wysłane ani utworzone
5. Włącz **Aktywna**, gdy będziesz zadowolony

Nowa automatyzacja jest wstrzymana, dopóki sama jej nie włączysz. Instrukcja krok po kroku jest w [Pierwszych krokach](/automatiseringen/aan-de-slag).

<Callout type="info" title="Warto wiedzieć">
- Nowa automatyzacja jest wstrzymana, dopóki sam jej nie włączysz
- Automatyzacja ma co najwyżej 100 kroków. Uwagi i ramki na planszy liczą się osobno, co najwyżej 50
- **Rozgałęzienie** ma co najwyżej 8 gałęzi, a **Poproś o decyzję** co najwyżej 8 opcji
- Harmonogramy i daty są sprawdzane co minutę. Zdarzenie startuje od razu
- Zmiany mogą potrzebować pół minuty, zanim zaczną obowiązywać wszędzie
- Nieudane wykonanie jest wysyłane e-mailem do osoby, która stworzyła automatyzację, co najwyżej raz na godzinę
- Na karcie **Uruchomienia** widać ostatnie 20 wykonań
- Przepływ nie może uruchomić siebie ani innego przepływu przez to, co sam tworzy
</Callout>

<Callout type="info" title="Automatyzacje naprawdę coś robią">
Włączona automatyzacja wysyła prawdziwe przypomnienia i tworzy prawdziwe zadania. Użyj karty **Uruchomienie testowe** i sprawdź pierwsze wykonania na karcie **Uruchomienia**, zanim nabierzesz pewności, że wszystko się zgadza.
</Callout>

## Elementy [#onderdelen]

<Cards>
  <Card
    title="Pierwsze kroki"
    href="/automatiseringen/aan-de-slag"
    description="Przegląd, szablony i edytor oraz sposób zapisania i włączenia automatyzacji"
  />
  <Card
    title="Wyzwalacze"
    href="/automatiseringen/triggers"
    description="Zdarzenia, daty, przeterminowane faktury i harmonogramy, a także filtry i jednorazowy start"
  />
  <Card
    title="Warunki, rozgałęzienia i opóźnienia"
    href="/automatiseringen/logica"
    description="Dzielenie i wstrzymywanie przepływu, wyszukiwanie rekordów, przechodzenie po listach i pytanie o decyzję"
  />
  <Card
    title="Akcje"
    href="/automatiseringen/acties"
    description="Wszystko, co może zrobić automatyzacja, ze wszystkimi polami"
  />
  <Card
    title="Zmienne i szablony"
    href="/automatiseringen/variabelen"
    description="Używanie danych ze zdarzenia we własnych tekstach"
  />
  <Card
    title="Kto uruchamia automatyzację?"
    href="/automatiseringen/workflow-gebruiker"
    description="Dlaczego zadania i uwagi z automatyzacji są zapisane na stałego użytkownika systemowego"
  />
  <Card
    title="Testy i wykonania"
    href="/automatiseringen/testen-en-uitvoeringen"
    description="Wykonanie testowe i przeglądanie prawdziwych wykonań"
  />
  <Card
    title="Problemy i włączanie"
    href="/automatiseringen/problemen"
    description="Dlaczego automatyzacji nie da się włączyć i co oznaczają komunikaty"
  />
  <Card
    title="Przykład: kontrola przyczepy do wynajęcia"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Kompletny przepływ zbudowany krok po kroku"
  />
  <Card
    title="Najczęstsze pytania"
    href="/automatiseringen/veelgestelde-vragen"
    description="Limity, wyjaśnienie wstrzymywania i co robić, gdy nic się nie dzieje"
  />
  <Card
    title="Dla deweloperów"
    href="/ontwikkelaars/automatiseringen"
    description="Żądanie API, koperta webhooka, podpisywanie i zarządzanie przez API"
  />
</Cards>

<Cards>
  <Card title="Przykłady z praktyki" href="/praktijk" description="Rozbudowane przykłady z praktyki" />
</Cards>

## Pojęcia [#begrippen]

- **Automatyzacja**: reguła typu "gdy to się wydarzy, zrób to", zbudowana jako przepływ
- **Przepływ**: plansza jednej automatyzacji z krokami i liniami
- **Wyzwalacz**: moment startu przepływu
- **Wykonanie**: jedno uruchomienie automatyzacji, w którym przepływ jest przechodzony od początku do końca
- **Akcja**: krok, który naprawdę coś robi, na przykład tworzy zadanie
- **Zmienna**: dana z danej chwili, w nawiasach klamrowych w tekście
- **Uruchomienie testowe**: próba, w której nic nie jest naprawdę wysyłane ani tworzone
- **Przepływ pracy**: użytkownik, w imieniu którego działa automatyzacja

Więcej pojęć znajdziesz w [słowniku pojęć](/begrippen).


# Warunki, rozgałęzienia i opóźnienia (/pl-PL/automatiseringen/logica)

Krokami z grupy **Logika** decydujesz, w którą stronę idzie przepływ i kiedy: to "jeśli" i to "poczekaj chwilę". Przykład: *jeśli faktura po tygodniu nadal jest otwarta, utwórz zadanie*. Kroki te sterują akcjami, które następują po nich. Tylko [Poproś o decyzję](#vraag-om-een-beslissing) sam coś tworzy, czyli zadanie.

| Krok | Co robi | Wyjścia |
|---|---|---|
| [Jeśli / w przeciwnym razie](#als--anders) | Rozdziela przepływ według warunków | **Tak**, **Nie** |
| [Rozgałęzienie](#schakel) | Wybiera gałąź według wartości pola | Jedno na gałąź i **Domyślne** |
| [Opóźnienie](#vertraging) | Czeka określony czas albo do daty | **Dalej** |
| [Teraz otwarte?](#nu-open) | Sprawdza, czy jesteś teraz otwarty | **Otwarte**, **Zamknięte** |
| [Czekaj do otwarcia](#wachten-tot-open) | Czeka do najbliższej godziny otwarcia | **Dalej** |
| [Czekaj do zamknięcia](#wachten-tot-gesloten) | Czeka do najbliższej godziny zamknięcia | **Dalej** |
| [Najwyżej raz na okres](#hoogstens-één-keer-per-periode) | Powstrzymuje powtórzenia | **Kontynuuj**, **Już wykonano** |
| [Wyszukaj rekord](#record-opzoeken) | Pobiera rekord po jego ID | **Znaleziono**, **Nie znaleziono** |
| [Dla każdego](#voor-elk) | Wykonuje kolejne kroki dla każdego elementu listy | **Dla każdego**, **Gotowe** |
| [Czekaj, aż](#wachten-tot) | Czeka, aż warunki zostaną spełnione | **Spełniono**, **Przekroczono czas** |
| [Czekaj na zdarzenie](#wachten-op-een-gebeurtenis) | Czeka, aż w Tillor coś się wydarzy | **Odebrano**, **Przekroczono czas**, czasem **Usunięto** |
| [Poproś o decyzję](#vraag-om-een-beslissing) | Pozwala koledze wybrać jedną z Twoich opcji | Jedno na opcję i **Przekroczono czas** |

## Jeśli / w przeciwnym razie [#als--anders]

Rozdziela przepływ na dwie drogi na podstawie danych. To ta sama zasada co filtr w **Tylko gdy** wyzwalacza, tyle że w środku przepływu.

Krok ma dwa wyjścia: **Tak** (warunki są spełnione) i **Nie** (nie są spełnione).

1. Dodaj krok **Jeśli / w przeciwnym razie**
2. Przy **Warunki** kliknij **Dodaj warunek**
3. Wybierz pole przyciskiem **Zmienna** albo wpisz ścieżkę samodzielnie, na przykład `invoice.paymentStatus`
4. Wybierz porównanie (**jest**, **nie jest**, **zawiera**, **jest większe niż**, **jest mniejsze niż**, **jest jednym z**, **jest puste** albo **nie jest puste**) i wpisz wartość
5. Połącz wyjście **Tak** i ewentualnie **Nie** z kolejnym krokiem

Krok **Jeśli / w przeciwnym razie** potrzebuje co najmniej jednego warunku. W przeciwnym razie Tillor pokazuje **Dodaj warunek.** Przy kilku warunkach wybierasz między **Wszystkie muszą być spełnione** a **Wystarczy jeden spełniony**. Porównania działają tak, jak opisano przy [Tylko gdy](/automatiseringen/triggers#alleen-wanneer).

Nie musisz łączyć obu wyjść. Jeśli wyjście prowadzi donikąd, wykonanie kończy się w tym miejscu. Przepływ, który coś robi tylko przy **Tak**, jest więc w porządku.

Możesz też używać pól z wcześniejszych kroków. Po [Żądaniu API](/automatiseringen/acties/integraties#api-verzoek) możesz na przykład sprawdzić `response.status` albo `response.data.paymentStatus`.

## Rozgałęzienie [#schakel]

Wybierz **Rozgałęzienie**, gdy potrzebujesz więcej niż dwóch dróg. Krok patrzy na wartość jednego pola i wybiera pasującą gałąź.

1. Przy **Pole** wybierz pole, któremu chcesz się przyjrzeć, na przykład `occupation.occupationType`
2. Przy **Gałęzie** kliknij **Dodaj gałąź**. Wpisz **Gałąź** (nazwę, która pojawi się na wyjściu) i **Równa się** (wartość, jaką ma mieć pole)
3. Powtórz to dla każdej gałęzi
4. Połącz każde wyjście z kolejnym krokiem

Każda gałąź dostaje własne wyjście pod krokiem. Poza tym zawsze jest wyjście **Domyślne**. Jest używane, gdy żadna gałąź nie pasuje.

- Pole musi dokładnie odpowiadać wartości, łącznie z wielkością liter
- Jeśli pasuje więcej niż jedna gałąź, wygrywa pierwsza na liście
- Gałąź bez wartości przy **Równa się** się nie liczy
- Możesz ustawić maksymalnie 8 gałęzi, plus **Domyślne**
- Jeśli pole jest puste albo nie istnieje, przepływ idzie przez **Domyślne**

Wartości pól wyboru mają zapis używany w Tillor. Zajęcie typu przyczepa do wynajęcia ma na przykład wartość `RENTAL_CARAVAN`, a opłacona faktura `PAID`.

<Callout type="info">
Lista przy **Pole** pokazuje pola zdarzenia i wcześniejszych kroków. Pola z odpowiedzi Żądania API pojawiają się na liście dopiero wtedy, gdy Tillor zna przykład tej odpowiedzi. Zobacz [Używanie odpowiedzi API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).
</Callout>

## Opóźnienie [#vertraging]

Krokiem **Opóźnienie** każesz przepływowi poczekać, zanim pójdzie dalej. Używasz go do rzeczy takich jak *sprawdź jeszcze raz po tygodniu*.

Przy **Czekaj** wybierasz jeden z dwóch sposobów.

### Przez określony czas [#een-vaste-tijd]

Wybierz **Przez określony czas** i wpisz przy **Czas trwania** liczbę oraz jednostkę: **sekundy**, **minuty**, **godziny**, **dni** albo **tygodnie**. Sekundy nie są dokładne. Przepływ może ruszyć kilka sekund później.

Opóźnienie równe 0 nic nie robi, dlatego Tillor pokazuje **Opóźnienie równe 0 nic nie robi.**

### Do daty [#tot-een-datum]

Wybierz **Do daty**, gdy czas oczekiwania zależy od daty z danych, takiej jak termin płatności faktury albo data zakończenia rezerwacji.

| Pole | Co wpisujesz |
|---|---|
| **Data** | Pole z datą, na przykład `invoice.dueDate`. Lista pokazuje tylko pola, które są datami |
| **Względem tej daty** | **Przed** albo **Po** |
| **Przesunięcie** | Ile czasu przed tą datą albo po niej, w minutach, godzinach, dniach lub tygodniach. Przy 0 przepływ rusza dokładnie w tym dniu |

Przykłady:

- **Data** `invoice.dueDate`, **Po**, **Przesunięcie** 1 dzień: przepływ rusza dzień po terminie płatności
- **Data** `reservation.checkIn`, **Przed**, **Przesunięcie** 2 dni: przepływ rusza dwa dni przed przyjazdem

Jeśli ta chwila jest już w przeszłości albo data jest pusta, przepływ rusza od razu.

### Co dzieje się podczas czekania [#wat-er-tijdens-het-wachten-gebeurt]

- Wykonanie dostaje status **Oczekuje**. Na karcie **Uruchomienia** widać, kiedy ruszy dalej (**Wznowienie …**). Długie czasy oczekiwania, na przykład tygodnie, nie są problemem
- Po opóźnieniu Tillor czyta dane ponownie, żeby kolejne kroki widziały aktualny stan. Zobacz niżej
- Jeśli wstrzymasz automatyzację podczas czekania, wykonanie zatrzyma się po upływie czasu oczekiwania. Nie pójdzie dalej i dostanie status **Anulowane**. Jeśli włączysz automatyzację, zanim czas oczekiwania minie, wykonanie normalnie ruszy dalej
- Jeśli usuniesz automatyzację, oczekujące wykonania się zatrzymają
- Jeśli zmienisz przepływ, gdy wykonanie czeka, to wykonanie dokończy się według przepływu takiego, jaki był w chwili startu

### Dane są czytane ponownie [#gegevens-worden-opnieuw-gelezen]

Wykonanie zapamiętuje dane z chwili zdarzenia, ale przed ruszeniem dalej czyta ponownie powiązane z nimi rekordy. Chodzi o rekord zdarzenia (na przykład fakturę) i rekordy, do których ten rekord się odwołuje (na przykład klienta).

Przykład: automatyzacja wysyła przypomnienie o fakturze, czeka 7 dni, a potem sprawdza krokiem **Jeśli / w przeciwnym razie**, czy `invoice.paymentStatus` nie jest `PAID`. Jeśli faktura została opłacona w ciągu tego tygodnia, warunek zobaczy opłaconą fakturę i przepływ pójdzie przez **Nie**.

Są dwa wyjątki:

- Jeśli rekord już nie istnieje, na przykład dlatego, że zajęcie zostało usunięte, wykonanie zachowuje kopię z chwili zdarzenia
- Dane, które zwrócił wcześniejszy krok, takie jak odpowiedź Żądania API, nie są pobierane ponownie. Jeśli chcesz mieć takie dane odświeżone po opóźnieniu, wykonaj nowe Żądanie API

<Callout type="info" title="W teście nic nie jest czytane ponownie">
[Uruchomienie testowe](/automatiseringen/testen-en-uitvoeringen) pomija opóźnienia i pracuje na danych przykładowych, które sam wpisujesz. To, co dzieje się po prawdziwym opóźnieniu, zobaczysz dopiero w prawdziwym wykonaniu.
</Callout>

## Teraz otwarte? [#nu-open]

Sprawdza, czy Twoja organizacja jest w tej chwili otwarta, i rozdziela przepływ na **Otwarte** i **Zamknięte**. Nie ma tu nic do ustawienia. Tillor korzysta z godzin w <UIPath>Ustawienia > Godziny otwarcia</UIPath>, z okresami sezonowymi, świętami i wyjątkami. Zobacz [Ustawienia organizacji](/gebruikers/organisaties#openingsuren).

Użyj tego na przykład, żeby poza godzinami otwarcia wysłać inny tekst albo utworzyć zadanie. Jeśli wolisz poczekać, aż znów będziesz otwarty, użyj [Czekaj do otwarcia](#wachten-tot-open). Jeśli chcesz poczekać do zamknięcia, użyj [Czekaj do zamknięcia](#wachten-tot-gesloten).

## Czekaj do otwarcia [#wachten-tot-open]

Zatrzymuje przepływ do najbliższej godziny otwarcia, a potem idzie dalej. Twoja organizacja jest już otwarta? Wtedy przepływ rusza od razu. Nie ma tu nic do ustawienia.

- Godzina otwarcia pochodzi z <UIPath>Ustawienia > Godziny otwarcia</UIPath>, w strefie czasowej Twojej organizacji
- Jeśli w ciągu następnego miesiąca nie ma żadnej godziny otwarcia, przepływ rusza od razu zamiast czekać w nieskończoność
- Podczas czekania wykonanie dostaje status **Oczekuje**. Co się wtedy dzieje, opisano przy [Opóźnieniu](#wat-er-tijdens-het-wachten-gebeurt)

## Czekaj do zamknięcia [#wachten-tot-gesloten]

Zatrzymuje przepływ do najbliższej godziny zamknięcia, a potem idzie dalej. Twoja organizacja jest już zamknięta? Wtedy przepływ rusza od razu. Nie ma tu nic do ustawienia.

- Godzina zamknięcia pochodzi z <UIPath>Ustawienia > Godziny otwarcia</UIPath>, w strefie czasowej Twojej organizacji
- Bloki, które łączą się ze sobą, na przykład 9:00–12:00 i 12:00–17:00, liczą się jako jeden odcinek. Przepływ czeka do końca tego odcinka
- Podczas czekania wykonanie dostaje status **Oczekuje**. Co się wtedy dzieje, opisano przy [Opóźnieniu](#wat-er-tijdens-het-wachten-gebeurt)

## Najwyżej raz na okres [#hoogstens-één-keer-per-periode]

Przepuszcza przepływ tylko wtedy, gdy dla tego samego rekordu nie przeszedł on przez ten krok w danym okresie. Dzięki temu nie wyślesz klientowi codziennie tego samego przypomnienia.

| Pole | Co wpisujesz |
|---|---|
| **Okres** | Jak długo liczą się wcześniejsze wykonania, w minutach, godzinach, dniach lub tygodniach. Domyślnie 1 dzień |
| **Na** | Według czego liczysz. Puste oznacza: na rekord, od którego przepływ wystartował, na przykład fakturę albo rezerwację. Wpisz zmienną, na przykład `{customer.id}`, żeby liczyć na klienta albo na działkę |

Krok ma dwa wyjścia: **Kontynuuj**, jeśli przepływ nie przeszedł tędy w tym okresie, i **Już wykonano**, jeśli przeszedł. Połącz **Już wykonano** z innym krokiem albo zostaw je puste, żeby wykonanie kończyło się w tym miejscu.

Zwróć uwagę na to:

- Liczą się tylko wykonania tej samej automatyzacji i tylko wtedy, gdy przeszły przez ten krok wyjściem **Kontynuuj**
- Jeśli nie połączysz **Usunięto** z niczym, Tillor zatrzyma oczekujące przepływy tego rekordu i usunie zadania, które przepływ utworzył i które tylko on mógł zakończyć. Jeśli połączysz to wyjście, przepływ pójdzie tam dalej
- Jeśli przepływ startuje bez rekordu, na przykład przy **Codziennie o danej godzinie**, wpisz zmienną samodzielnie przy **Na**. Bez tej wartości każde wykonanie jest nowe i krok niczego nie powstrzymuje
- Wykonanie, które właśnie trwa, samo się nie liczy

Przykład: **Okres** 7 dni i **Na** `{invoice.customerId}` przepuszcza przypomnienie najwyżej raz w tygodniu na klienta, nawet jeśli ten klient ma kilka przeterminowanych faktur.

## Wyszukaj rekord [#record-opzoeken]

Ładuje rekord na podstawie jego ID, żeby kolejne kroki mogły używać jego pól. Przydaje się, gdy zdarzenie przekazuje tylko ID, jak wiadomość w rozmowie skrzynki.

| Pole | Co wpisujesz |
|---|---|
| **Typ rekordu** | **Klient**, **Rezerwacja**, **Zajęcie**, **Faktura**, **Płatność**, **Działka**, **Zadanie**, **Dokument**, **Metoda dostępu**, **Tag NFC**, **Licznik**, **Rozmowa w skrzynce** albo **Wiadomość w skrzynce**. Domyślnie **Wiadomość w skrzynce** |
| **ID** | ID rekordu, na przykład `{messageId}`. Wymagane |

Krok ma dwa wyjścia: **Znaleziono** i **Nie znaleziono**. Jeśli rekord nie istnieje albo ID jest puste, przepływ idzie przez **Nie znaleziono**.

Po **Znaleziono** pola rekordu są w zmiennych zaczynających się od `found` i typu: `{foundCustomer.firstName}`, `{foundInvoice.displayId}`, `{foundReservation.checkIn}`, `{foundTerrain.name}`, `{foundInboxMessage.direction}`. Pozostałe typy nazywają się `foundOccupation`, `foundPayment`, `foundTask`, `foundAccessMethod`, `foundNfcTag`, `foundMeter` i `foundInboxThread`. Dołączone są też rekordy, do których się odwołuje, na głębokość jednego poziomu, jak `{foundReservation.customer.firstName}`. Wszystko jest na liście pod przyciskiem **Zmienna**.

Drugie wyszukiwanie tego samego typu zastępuje pierwsze. Uważaj przy **Zadanie**: używa ono tej samej nazwy `foundTask` co [Znajdź zadanie](/automatiseringen/acties/taken#taak-zoeken), a wygrywa ostatnie z nich. To samo dotyczy **Dokument** i `foundDocument` z [Znajdź dokument](/automatiseringen/acties/documenten#document-zoeken).

## Mapuj zmienne [#variabelen-mappen]

Kopiuje wartości do nowych nazw zmiennych, żeby późniejsze kroki mogły używać jednej postaci. To przydatne, gdy jeden przepływ startuje przez **Webhook przychodzący** (`{body.…}`) i przez **Faktura przeterminowana** (`{invoice.…}`).

| Pole | Co wpisujesz |
|---|---|
| **Mapowania** | Wiersze z **Zmienna docelowa** (np. `invoice`) i **Źródło** (np. `{foundInvoice}` albo `{body.invoiceId}`) |

Krok ma jedno wyjście: **Dalej**. Jeśli źródło to dokładnie jedna zmienna w nawiasach klamrowych, na przykład `{foundInvoice}`, Tillor kopiuje cały rekord (obiekt). W przeciwnym razie Tillor wstawia źródło jako tekst, jak `Faktura {foundInvoice.displayId}` w `meta.label`.

Typowy test webhooka: **Webhook przychodzący** → **Wyszukaj rekord** (Faktura, ID `{body.invoiceId}`) → **Mapuj zmienne** (`invoice` ← `{foundInvoice}`) → te same warunki i zatwierdzenie co przy wyzwalaczu harmonogramu.

## Uruchom kod [#code-uitvoeren]

Wykonuje fragment TypeScriptu na zmiennych przepływu i zapisuje to, co zwróci, jako nową zmienną. Służy do logiki, której nie da się zmieścić w polach i warunkach: jakie podzadania mają powstać, obliczenie kwoty albo daty, przekształcenie treści webhooka.

| Pole | Co wpisujesz |
|---|---|
| **Kod** | TypeScript. Zmienne zapisujesz tak jak w tekstach, w nawiasach klamrowych: `{customer.firstName}` jest czytane jako wartość, a nie wstawiane jako tekst. Zakończ przez `return`. Wymagane |
| **Zmienna wyjściowa** | Nazwa, pod którą późniejsze kroki odczytają wynik, na przykład `result` (wtedy `{result}`) albo `result.names`. Domyślnie `result` |

Krok ma jedno wyjście: **Dalej**. Działa to tak:

- Kod widzi tylko zmienne, które wymienia. Zmienna, której przepływ nie ma, jest `null`, a data przychodzi jako tekst (`2026-07-01T10:00:00.000Z`)
- Formatowanie i przesunięcia dat (`{bedrag|currency}`, `{datum + 1 day}`) tu nie działają: oblicz je w kodzie
- Zwróć listę, tekst, liczbę albo obiekt. Obiekt czytasz potem pole po polu: `{result.total}`
- Kod nie może niczego pobierać ani wysyłać: nie ma internetu ani bazy danych. Tylko liczy. Zbyt długie liczenie (ponad 50 ms) zostaje przerwane
- Jeśli kod zgłosi błąd, wykonanie kończy się tym błędem i numerem wiersza. Zobaczysz je na karcie **Uruchomienia**
- Po prawej stronie kodu od razu widać, co zwraca on na przykładzie. Przy testowaniu uruchamia się razem z całością

Przykład: po wyjeździe chcesz podzadania zależne od działki. Dodaj krok **Uruchom kod** z:

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

Potem przy **Utwórz zadanie** wpisz w polu **Podzadania** wyłącznie `{result}`: każdy tekst z listy staje się podzadaniem.

## Dla każdego [#voor-elk]

Wykonuje kroki po **Dla każdego** raz dla każdego elementu listy, na przykład dla każdej otwartej faktury klienta. Sam przepływ idzie dalej przez **Gotowe**.

| Pole | Co wpisujesz |
|---|---|
| **Lista** | **Metody dostępu klienta**, **Tagi NFC klienta**, **Otwarte faktury klienta**, **Potwierdzone rezerwacje klienta**, **Zajęcia miejsc klienta**, **Dokumenty klienta** (tylko aktywne) albo **Liczniki działki**. Domyślnie **Metody dostępu klienta** |
| **Dla** | Klient albo działka, której listy chcesz, na przykład `{customer.id}` albo `{occupation.terrainId}`. Wymagane |

Krok ma dwa wyjścia o własnym znaczeniu:

- **Dla każdego** prowadzi do kroków, które chcesz wykonać dla każdego elementu
- **Gotowe** to droga, którą idzie sam przepływ

Działa to tak:

- Każdy element dostaje własne wykonanie, które przechodzi kroki po **Dla każdego** do końca tej gałęzi. Widzisz je na karcie **Uruchomienia**, która pokazuje tylko ostatnie 20
- Element jest w zmiennej `item`, na przykład `{item.id}`. Zmienne zdarzenia i wcześniejszych kroków pozostają dostępne
- Przepływ nie czeka, aż elementy się skończą. Zaraz po ich uruchomieniu idzie dalej przez **Gotowe**. Wyniku elementu nie możesz więc użyć w krokach po **Gotowe**
- Przetwarzanych jest najwyżej 100 elementów, od najstarszych. Jeśli na liście jest ich więcej, pozostałe nie są przetwarzane
- Jeśli lista jest pusta albo pole **Dla** jest puste, nic nie startuje i przepływ od razu idzie dalej przez **Gotowe**
- **Otwarte faktury klienta** to zaksięgowane faktury, z których coś jeszcze pozostaje do zapłaty. **Potwierdzone rezerwacje klienta** to rezerwacje ze statusem **Zarezerwowane**

Przykład: faktura przeterminowuje się i chcesz utworzyć link do płatności dla każdej otwartej faktury tego klienta. Wybierz **Otwarte faktury klienta**, wpisz `{invoice.customerId}` przy **Dla** i dodaj po **Dla każdego** krok **Utwórz link do płatności** z `{item.id}` jako fakturą.

## Czekaj, aż [#wachten-tot]

Sprawdza warunki raz za razem, aż zostaną spełnione, albo przestaje po jakimś czasie. Użyj tego, gdy nie wiesz, kiedy coś się wydarzy, ale wiesz, na co czekasz, na przykład aż faktura zostanie opłacona.

| Pole | Co wpisujesz |
|---|---|
| **Aż** | Jeden lub więcej warunków, tak samo jak przy [Jeśli / w przeciwnym razie](#als--anders) |
| **Sprawdzaj co** | Jak często Tillor patrzy ponownie, w minutach, godzinach, dniach lub tygodniach. Co najmniej 5 minut. Domyślnie 1 godzina |
| **Przestań czekać po** | Jak długo krok czeka najwyżej. Domyślnie 7 dni |

Krok ma dwa wyjścia: **Spełniono** (warunki są spełnione) i **Przekroczono czas** (czas oczekiwania minął, a warunki nie zostały spełnione).

Zwróć uwagę na to:

- Pierwsze sprawdzenie odbywa się od razu. Jeśli warunki są już spełnione, przepływ od razu idzie dalej przez **Spełniono**. Jeśli nie wpiszesz żadnego warunku, jest on zawsze spełniony
- Przy każdym sprawdzeniu Tillor czyta rekordy zdarzenia ponownie, tak jak przy [opóźnieniu](#gegevens-worden-opnieuw-gelezen). Warunek taki jak `invoice.paymentStatus` jest `PAID` zobaczy więc płatność, gdy tylko się pojawi
- Interwał krótszy niż 5 minut zostaje zamieniony na 5 minut
- Podczas czekania wykonanie dostaje status **Oczekuje**. Wstrzymywanie i zmiana przepływu działają tak samo jak przy [Opóźnieniu](#wat-er-tijdens-het-wachten-gebeurt)

## Czekaj na zdarzenie [#wachten-op-een-gebeurtenis]

Zatrzymuje przepływ, aż w Tillor coś się wydarzy, na przykład aż faktura zostanie opłacona.

| Pole | Co wpisujesz |
|---|---|
| **Zdarzenie** | Na co czekasz. Ta sama lista co przy [wyzwalaczu](/automatiseringen/triggers#als-er-iets-gebeurt). Wymagane |
| **Tylko dla tego samego rekordu** | Idzie dalej tylko wtedy, gdy zdarzenie dotyczy rekordu, od którego przepływ wystartował. Domyślnie włączone |
| **Przestań czekać po** | Jak długo krok czeka najwyżej. Domyślnie 7 dni |

Krok ma dwa wyjścia: **Odebrano** (zdarzenie nadeszło) i **Przekroczono czas** (czas oczekiwania minął bez zdarzenia). Jeśli **Tylko dla tego samego rekordu** jest włączone, dochodzi trzecie wyjście, **Usunięto**. Używasz go, gdy rekord przepływu został usunięty w trakcie czekania.

Zwróć uwagę na to:

- Przy włączonym **Tylko dla tego samego rekordu** liczy się na przykład tylko płatność faktury, od której przepływ wystartował. Jeśli to wyłączysz, każde zdarzenie tego typu pozwala przepływowi iść dalej
- Jeśli nie połączysz **Usunięto** z niczym, Tillor zatrzyma oczekujące przepływy tego rekordu i usunie zadania, które przepływ utworzył i które tylko on mógł zakończyć. Jeśli połączysz to wyjście, przepływ pójdzie tam dalej
- Jeśli przepływ startuje bez rekordu, na przykład przy **Codziennie o danej godzinie**, liczy się każde zdarzenie tego typu
- Liczy się też zdarzenie, które wywołał sam krok automatyzacji. Oczekujące przepływy idą więc dalej także wskutek pracy **Przepływu pracy**
- Po **Odebrano** dane zdarzenia, na które czekałeś, są w zmiennych, bez kolegi, który je wywołał. Jeśli czekasz na `invoice:paid`, to `{invoice.paymentStatus}` zwraca potem nowy stan
- Podczas czekania wykonanie dostaje status **Oczekuje**. Wstrzymywanie i zmiana przepływu działają tak samo jak przy [Opóźnieniu](#wat-er-tijdens-het-wachten-gebeurt)

## Poproś o decyzję [#vraag-om-een-beslissing]

Tworzy zadanie z przyciskami, które sam określasz, i czeka, aż ktoś wybierze któryś z nich. Dzięki temu wbudowujesz moment, w którym człowiek patrzy na sprawę, na przykład zanim przepływ zablokuje klienta albo zaksięguje fakturę. Każda opcja to przycisk w zadaniu i wyjście kroku.

| Pole | Co wpisujesz |
|---|---|
| **Tytuł zadania** | Tytuł zadania. Wymagane |
| **Opis** | Powiedz koledze, co trzeba rozstrzygnąć |
| **Opcje** | Przyciski w zadaniu. Zobacz niżej. Co najmniej jedna |
| **Przypisz do** | Wybierz jednego lub więcej kolegów |
| **Przypisz do grup** | Wybierz jedną lub więcej grup |
| **Powiąż z** | Rekordy, przy których pojawia się zadanie, takie jak klient albo faktura. Wstępnie wypełnione rekordami znanymi przy tym kroku |
| **Przestań czekać po** | Jak długo krok czeka najwyżej. Domyślnie 3 dni |

### Ustawianie opcji [#opties-instellen]

1. Przy **Opcje** kliknij **Dodaj opcję** i wpisz nazwę, na przykład **Zatwierdź**. Ta nazwa jest na przycisku i na wyjściu
2. Kliknij kolorowe pole po lewej stronie nazwy (**Ikona i kolor**), aby wybrać kolor i ikonę. Ikona nie jest wymagana
3. Włącz **Poproś o notatkę**, jeśli kolega ma przy tym wyborze wpisać powód
4. Włącz **Poproś o potwierdzenie**, jeśli kolega ma najpierw potwierdzić. Wpisujesz wtedy **Tytuł potwierdzenia** i **Treść potwierdzenia** oraz wybierasz przy **Poziom** jedną z opcji **Info**, **Ostrzeżenie** albo **Destrukcyjny**. W tych tekstach możesz używać zmiennych
5. Powtórz to dla każdej opcji. Możesz utworzyć maksymalnie 8 opcji

Jeśli lista jest jeszcze pusta, przycisk **Zatwierdź / Odrzuć** od razu przygotowuje dwie opcje: zielone **Zatwierdź** i czerwone **Odrzuć**. Każda opcja potrzebuje nazwy, inaczej Tillor pokazuje **Każda opcja musi mieć nazwę.** Bez opcji Tillor pokazuje **Dodaj co najmniej jedną opcję.**

### Wyjścia [#uitgangen]

Krok ma jedno wyjście na opcję, z nazwą i kolorem tej opcji, oraz zawsze **Przekroczono czas**.

| Wyjście | Kiedy |
|---|---|
| Nazwa opcji | Ktoś wybrał ten przycisk w zadaniu |
| **Przekroczono czas** | Czas oczekiwania minął bez wyboru albo zadanie zostało usunięte |

Zwróć uwagę na to:

- Przyciski są na karcie zadania, na liście zadań i w samym zadaniu. Takie zadanie nie ma haczyka: nie możesz go po prostu ukończyć, możesz tylko wybrać przycisk. Po wyborze zadanie ma status **Ukończone** i widać, którą opcję wybrano. Zobacz [Zadania z przyciskami wyboru](/taken/taakdetails#taken-met-keuzeknoppen)
- Wybrać może osoba przypisana do zadania, także przez grupę, oraz administratorzy. Jeśli nikogo nie przypiszesz, wybrać może każdy, kto widzi zadanie
- Zadanie dostaje priorytet **Wysoki**. Jest na nazwisko **Przepływ pracy**
- Jeśli zadanie zostanie usunięte, zanim ktoś wybierze, przepływ idzie dalej przez **Przekroczono czas**. Po **Przekroczono czas** wskutek upływu czasu oczekiwania zadanie pozostaje
- Późniejsze kroki mogą używać `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}` i `{approval.decidedBy.name}`. `{approval.label}` to nazwa wybranej opcji, a `{approval.note}` to notatka, którą wpisał kolega
- Podczas czekania wykonanie dostaje status **Oczekuje**. Wstrzymywanie i zmiana przepływu działają tak samo jak przy [Opóźnieniu](#wat-er-tijdens-het-wachten-gebeurt)

<Callout type="info" title="W teście sam wybierasz wyjście">
[Uruchomienie testowe](/automatiseringen/testen-en-uitvoeringen) nie może wiedzieć, czy jesteś otwarty, co zdecyduje kolega i czy rekord istnieje. Dlatego pod **Co dzieje się w tych krokach?** sam wybierasz wyjście kroków **Teraz otwarte?**, **Najwyżej raz na okres**, **Wyszukaj rekord**, **Dla każdego**, **Czekaj, aż**, **Czekaj na zdarzenie** i **Poproś o decyzję**. Przy **Dla każdego** test idzie przez wybrane wyjście, **Dla każdego** albo **Gotowe**, a nie przez oba.
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Wyjście, którego nie połączysz, kończy w tym miejscu wykonanie.
- Przy kroku czekania wykonanie dostaje status <Status tone="info">Oczekuje</Status> i rusza dalej później. Wstrzymana automatyzacja zatrzymuje oczekujące wykonania po upływie czasu oczekiwania.
- Po czasie oczekiwania Tillor czyta dane ponownie, żeby kroki widziały aktualny stan.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pokazuje Dodaj warunek">
Krok **Jeśli / w przeciwnym razie** potrzebuje co najmniej jednego warunku. Kliknij **Dodaj warunek**.
</Accordion>
<Accordion title="Tillor pokazuje Opóźnienie równe 0 nic nie robi">
Wpisz przy **Czas trwania** liczbę większą niż 0.
</Accordion>
<Accordion title="Przepływ zawsze idzie przez Domyślne">
**Rozgałęzienie** porównuje wartość dokładnie, łącznie z wielkością liter. Wartości wyboru mają zapis używany w Tillor, jak `RENTAL_CARAVAN`. Jeśli pole jest puste, przepływ też idzie przez **Domyślne**.
</Accordion>
<Accordion title="Tillor pokazuje Dodaj co najmniej jedną opcję albo Każda opcja musi mieć nazwę">
Krok **Poproś o decyzję** potrzebuje co najmniej jednej opcji z nazwą. Kliknij przy **Opcje** **Dodaj opcję**.
</Accordion>
<Accordion title="Wykonanie wciąż ma status Oczekuje">
Przepływ czeka na czas, warunek, zdarzenie albo decyzję. Na karcie **Uruchomienia** widać, kiedy ruszy dalej albo kiedy upłynie czas. Przy **Czekaj, aż** jest to domyślnie po 7 dniach, przy **Poproś o decyzję** po 3 dniach.
</Accordion>
<Accordion title="Zadanie z kroku Poproś o decyzję zniknęło">
Jeśli zadanie zostanie usunięte, zanim ktoś wybierze, przepływ idzie dalej przez **Przekroczono czas**. Zobacz [Zadania z przyciskami wyboru](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
</Accordions>


# Problemy i włączanie (/pl-PL/automatiseringen/problemen)

Tillor stale sprawdza Twój przepływ, gdy go budujesz. Dopóki są otwarte problemy, nie możesz włączyć automatyzacji. Dzięki temu przepływ, który nie może działać, nie próbuje wysyłać prawdziwych przypomnień ani tworzyć zadań.

## Gdzie widzisz problemy [#waar-zie-je-de-problemen]

- Na każdym kroku z problemem jest mała liczba ostrzegawcza
- W panelu po prawej problemy zaznaczonego kroku są w pomarańczowym bloku nad ustawieniami
- Na górze panelu jest przycisk z sumą, na przykład **3 problemy**. Kliknij go, aby zobaczyć listę, i kliknij komunikat, aby przejść do kroku
- W przeglądzie automatyzacji przy nazwie jest etykieta taka jak **3 problemy** oraz filtr **Problemy**

<DocScreenshot src="/screenshots/automatiseringen/issues.png" alt="Przycisk 1 problem na górze panelu z komunikatem Tytuł jest wymagany" />

## Dlaczego nie mogę włączyć [#waarom-kan-ik-niet-inschakelen]

Przełącznik **Aktywna** nie działa, dopóki są problemy, i pokazuje tekst **Najpierw rozwiąż otwarte problemy**. W przeglądzie nie możesz więc włączyć przełącznika automatyzacji.

Jeśli automatyzacja jest już włączona, nie możesz zapisać zmian z problemami. Przepływ, który działa, musi pozostać poprawny. Rozwiąż problemy albo najpierw wstrzymaj automatyzację.

## Co oznaczają komunikaty [#wat-de-meldingen-betekenen]

| Komunikat | Co się dzieje | Co robisz |
|---|---|---|
| **Dodaj wyzwalacz, aby zacząć.** | Przepływ nie ma wyzwalacza | Przepływ zawsze potrzebuje co najmniej jednego wyzwalacza. Przeciągnij **Gdy to się wydarzy** z listy po lewej na płótno |
| **To zdarzenie już nie istnieje. Wybierz inne.** | Zdarzenia wyzwalacza już nie ma | Wybierz przy **Zdarzenie** inne |
| **Brak połączenia, więc ten krok nigdy się nie uruchomi.** | Do kroku nie prowadzi żadna linia | Połącz krok z wyjściem innego kroku albo go usuń |
| **Ten krok jest częścią pętli. Przepływ może iść tylko do przodu.** | Linia wraca do wcześniejszego kroku | Usuń linię, która wskazuje wstecz. Przepływ nie może krążyć w kółko |
| **Pole [Pole] jest wymagane.** | Wymagane pole jest puste, na przykład **Tytuł** zadania | Wypełnij pole. Pola wymagane mają gwiazdkę |
| **[Pole]: zmienna [zmienna] nie jest dostępna w tym kroku.** | Używasz zmiennej, która w tym kroku nie istnieje | Wybierz zmienną z listy pod przyciskiem **Zmienna**. Sprawdź też, czy krok, który daje tę zmienną, jest w przepływie wcześniej |
| **Pole [Pole] nie zawiera poprawnego JSON.** | **Ładunek** albo **Treść** nie są poprawnym JSON | Sprawdź nawiasy klamrowe, przecinki i cudzysłowy. Zmienne są dozwolone |
| **Dodaj co najmniej jedną opcję.** | Krok **Poproś o decyzję** nie ma opcji | Kliknij przy **Opcje** **Dodaj opcję** |
| **Każda opcja musi mieć nazwę.** | Opcja kroku **Poproś o decyzję** nie ma nazwy | Wpisz nazwę albo usuń opcję |
| **Dodaj warunek.** | Krok **Jeśli / w przeciwnym razie** nie ma warunków | Kliknij **Dodaj warunek** |
| **Warunek nie ma poprawnego pola.** | Pole warunku jest puste albo nieznane | Wybierz albo wpisz pole, które jest na liście pod **Zmienna** |
| **Wpisz wartość dla [zmienna].** | Warunek ma porównanie, ale jeszcze nie ma wartości | Wpisz wartość albo wybierz porównanie, takie jak **jest puste**, które jej nie potrzebuje |
| **[Pole]: [zmienna] nie jest znanym formatem.** | Po `\|` używasz formatu, który nie istnieje | Użyj `currency`, `number`, `date`, `datetime`, `time`, `upper` albo `lower`. Zobacz [Formatowanie wartości](/automatiseringen/variabelen#een-waarde-opmaken) |
| **[Pole]: [zmienna] nie jest jednostką.** | Zapisujesz przesunięcie daty z jednostką, która nie istnieje | Użyj `minutes`, `hours`, `days`, `weeks` albo `months` |
| **[Pole]: pole niestandardowe [zmienna] nie istnieje.** | Używasz pola niestandardowego, które nie istnieje (już) | Wybierz istniejące pole z listy pod przyciskiem **Zmienna** |
| **[Pole]: [zmienna] ma format albo przesunięcie daty, a to działa tylko w tekstach.** | Używasz formatu w polu kodu kroku **Uruchom kod** | Oblicz to w kodzie |
| **[Pole]: [zmienna] nie jest nazwą zmiennej.** | Nazwa wyniku zawiera niedozwolone znaki | Użyj liter, cyfr i kropek, jak `result` albo `result.names` |
| **Opóźnienie równe 0 nic nie robi.** | Opóźnienie jest ustawione na 0 | Wpisz czas trwania większy niż 0 |
| **Ścieżka musi zaczynać się od / i pozostawać w obrębie API Twojej organizacji.** | **Ścieżka** Żądania API jest niedozwolona | Zacznij ścieżkę od jednego `/` i nie wpisuj w niej `..` ani `\` |
| **URL musi zaczynać się od https://.** | **URL** Żądania API nie jest bezpieczny | Użyj adresu, który zaczyna się od `https://` |
| **Wyrażenie cron jest niepoprawne. Użyj pięciu pól, na przykład 0 8 * * 1.** | Wyrażenie cron jest niepoprawne | Zobacz [Według wyrażenia cron](/automatiseringen/triggers#volgens-een-cron-expressie) |

## Czego Tillor nie może sprawdzić z góry [#wat-tillor-niet-vooraf-kan-controleren]

Niektóre błędy wychodzą na jaw dopiero wtedy, gdy przepływ naprawdę działa.

- URL złożony ze zmiennych można sprawdzić dopiero po jego uzupełnieniu
- Przy zdarzeniach, których dane nie są opisane, Tillor nie sprawdza zmiennych
- To, czy rekord istnieje, czy fakturę da się wysłać i czy inny serwer jest osiągalny, okazuje się dopiero w trakcie wykonania

Przepływ bez komunikatów nie musi więc być przepływem, który zawsze się uda. Przetestuj go przez [Testy i uruchomienia](/automatiseringen/testen-en-uitvoeringen) i sprawdź pierwsze prawdziwe wykonania.

<Callout type="info" title="Zdarzenie, które znika">
Jeśli zmieni się zdarzenie albo pole, na którym opiera się Twój przepływ, zobaczysz to jako komunikat przy danym kroku. Popraw krok, zanim ponownie włączysz automatyzację.
</Callout>


# Testy i uruchomienia (/pl-PL/automatiseringen/testen-en-uitvoeringen)

W edytorze masz dwie karty do sprawdzania, czy przepływ robi to, co chcesz: **Uruchomienie testowe** do próby i **Uruchomienia** do tego, co naprawdę się wydarzyło. Otwierasz je po prawej w panelu. Czwarta karta, **Historia**, pokazuje wcześniejsze wersje przepływu, zobacz [Wcześniejsze wersje](/automatiseringen/aan-de-slag#eerdere-versies).

## Uruchomienie testowe [#een-testuitvoering]

Wybierz kartę **Uruchomienie testowe**. Test przechodzi przepływ na danych przykładowych i pokazuje, jakie kroki by wykonał.

<Callout type="info" title="Nic prawdziwego się nie dzieje">
Uruchomienie testowe niczego nie wysyła, niczego nie tworzy i niczego nie zmienia. Opóźnienia są pomijane, żebyś od razu zobaczył wynik końcowy. Akcje pokazują tylko to, co by zrobiły, z tekstem **Nie wykonano w teście.**
</Callout>

<DocScreenshot src="/screenshots/automatiseringen/test-run.png" alt="Karta Uruchomienie testowe z danymi przykładowymi i wynikiem dla każdego kroku" />

### Dane przykładowe [#voorbeeldgegevens]

Na górze jest **Testuj na prawdziwym rekordzie**. Przy każdym rekordzie wyzwalacza, takim jak **Zajęcie**, wybierz rekord przez **Wybierz rekord** (szukaj po nazwie albo numerze). Tillor ładuje rekord takim, jaki jest teraz, razem z rekordami, do których się odwołuje, do danych przykładowych. Test nadal niczego nie wysyła, nie tworzy ani nie zmienia.

Pod **Przykładowe dane zdarzenia** są dane, na których pracuje test, w formie JSON. Jeśli automatyzacja już kiedyś naprawdę wystartowała, test zaczyna od danych ostatniego prawdziwego wykonania. W przeciwnym razie Tillor wstawia przykład o kształcie zdarzenia: tekst staje się *example*, liczba 1, a data bieżącą chwilą.

Zmień wartości, aby wypróbować inne przypadki, na przykład inny typ działki albo fakturę z innym statusem. Jeśli tekst nie jest poprawnym JSON, pojawia się **Dane przykładowe nie są poprawnym JSON.** i nie możesz uruchomić testu.

Jeśli przepływ zawiera **Żądanie API**, jest też pole **Przykładowa odpowiedź API**. Wklej tam odpowiedź, jakiej oczekujesz od żądania. Dzięki temu test może przejść kroki po żądaniu, a Tillor wskazuje pola odpowiedzi jako zmienne. Zobacz [Używanie odpowiedzi API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).

### Co dzieje się w tych krokach [#wat-gebeurt-er-bij-deze-stappen]

Przy niektórych krokach wynik zależy od świata zewnętrznego: **Wyślij webhook**, **Żądanie API**, akcje z wyjściem **Pominięto** albo **Błąd** oraz logika, taka jak **Teraz otwarte?**, **Wyszukaj rekord**, **Czekaj na zdarzenie** i **Poproś o decyzję**. Pod **Co dzieje się w tych krokach?** wybierasz dla każdego kroku, którym wyjściem test idzie dalej. W ten sposób sprawdzasz także drogę na wypadek, gdy coś pójdzie źle.

### Wynik [#het-resultaat]

Kliknij **Uruchom test**. Zobaczysz kroki po kolei, a przy każdym z nich:

- wpisane wartości, na przykład tytuł zadania taki, jaki zostałby utworzony
- przy warunku dla każdego wiersza, co porównywano i czy się zgadzało. Zielone oznacza spełniony, czerwone nie, z wartością, która faktycznie tam była (*było …*)
- którym wyjściem poszedł przepływ (**Dalej przez: Tak**)
- przy opóźnieniu, do kiedy trzeba by czekać

Po uruchomieniu przycisk nazywa się **Uruchom ponownie**. Test odtwarza kroki jeden po drugim (**Krok 2 z 5…**). Przyciskiem **Pokaż wszystko** pomijasz to odtwarzanie. Na płótnie koloruje się droga, którą poszedł test, a kroki, które nie doszły do głosu, są przyciemnione. Kliknij nazwę kroku w wyniku, aby do niego przejść. Na dole jest **Zakończono po 5 krokach.**

Jeśli filtr przy **Tylko gdy** nie pasuje do Twoich danych przykładowych, zobaczysz **Filtr wyzwalacza nie pasuje do tych danych, więc przepływ by się nie uruchomił.** Sprawdź wtedy, który warunek jest czerwony. Przyciskiem **Wyczyść** zdejmujesz wynik z płótna.

### Czego test nie pokazuje [#wat-een-test-niet-laat-zien]

- Czy fakturę naprawdę da się wysłać, czy endpoint jest osiągalny i czy ścieżka API istnieje
- Jak rekordy wyglądają po opóźnieniu. Test pracuje na Twoich danych przykładowych i niczego nie czyta ponownie
- Błędów, które występują dopiero przy prawdziwych danych, takich jak puste pole

Dlatego pierwsze prawdziwe wykonania zawsze obejrzyj na karcie **Uruchomienia**.

## Prawdziwe wykonania [#echte-uitvoeringen]

Na karcie **Uruchomienia** jest ostatnich 20 prawdziwych wykonań tej automatyzacji, najnowsze na górze. Lista odświeża się sama mniej więcej co 15 sekund. Dopóki nic nie wystartowało, widać **Brak uruchomień. Włącz automatyzację i poczekaj na jej zdarzenie.**

Każde wykonanie pokazuje czas startu, liczbę kroków albo (przy czekaniu) kiedy ruszy dalej, oraz status.

| Status | Co oznacza |
|---|---|
| **W toku** | Wykonanie trwa w tej chwili |
| **Oczekuje** | Wykonanie jest w [opóźnieniu](/automatiseringen/logica#vertraging), czeka na zdarzenie albo na zatwierdzenie i ruszy dalej później |
| **Zakończone** | Przepływ został przejdziony do końca |
| **Niepowodzenie** | Krok nie mógł zostać wykonany. Komunikat jest obok jako **Niepowodzenie: …** |
| **Anulowane** | Wykonanie zatrzymało się, bo automatyzacja została wstrzymana albo usunięta w trakcie czekania |

Kliknij wykonanie, aby je otworzyć. Zobaczysz wtedy:

- wszystkie wykonane kroki, z czasem i tym, co krok zrobił
- wpisane wartości, na przykład tytuł, który zadanie naprawdę dostało
- przy warunku, które wiersze były spełnione
- przy nieudanym kroku komunikat o błędzie, który może być po angielsku

Na płótnie koloruje się droga, którą poszło to wykonanie. Kroki, które nie doszły do głosu, są przyciemnione. Kliknij nazwę kroku, aby do niego przejść.

Pod krokami jest przycisk taki jak **3 zestawy danych**. Pokazuje dane, od których wykonanie wystartowało, i to, co dała każda akcja, takie jak ID utworzonego zadania albo odpowiedź Żądania API. W ten sposób sprawdzisz, jakie wartości miała zmienna.

Na dole otwartego wykonania jest też **Ślad**: kod z liter i cyfr. Jeśli z wykonaniem jest coś nie tak, podaj ten kod pomocy technicznej. Dzięki temu znajdziemy dokładnie to wykonanie.

<Callout type="info">
Zdarzenia, które nie przeszły filtra przy **Tylko gdy**, albo dla których automatyzacja już raz się uruchomiła przy **Uruchom raz na rekord**, nie startują wykonania i dlatego nie ma ich na liście.
</Callout>

W przeglądzie automatyzacji przy każdej automatyzacji jest czas ostatniego wykonania, a obok mały słupek dla każdego niedawnego wykonania.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Po uruchomieniu testowym w Tillor nic się nie zmieniło. Dopiero gdy włączysz **Aktywna**, automatyzacja naprawdę działa.
- Prawdziwe wykonania pozostają na karcie **Uruchomienia**. Pokazuje ona ostatnie 20.
- Nieudane wykonanie powoduje e-mail do osoby, która utworzyła automatyzację, najwyżej jeden na godzinę.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Dane przykładowe nie są poprawnym JSON">
Tillor pokazuje **Dane przykładowe nie są poprawnym JSON.** i nie pozwala uruchomić testu. Sprawdź nawiasy klamrowe, przecinki i cudzysłowy.
</Accordion>
<Accordion title="Filtr wyzwalacza nie pasuje do tych danych">
Z tymi danymi przykładowymi przepływ by się nie uruchomił. Zobacz, który warunek jest czerwony, i zmień dane albo warunek.
</Accordion>
<Accordion title="Nie widzę żadnych wykonań">
Tillor pokazuje **Brak uruchomień. Włącz automatyzację i poczekaj na jej zdarzenie.** Zdarzeń, które nie przeszły filtra, tam nie ma. Zobacz [Często zadawane pytania](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="Test się udaje, ale prawdziwe wykonanie kończy się niepowodzeniem">
Test niczego nie wysyła i nie czyta rekordów ponownie. To, czy fakturę da się wysłać albo czy adres jest osiągalny, okazuje się dopiero naprawdę. Otwórz wykonanie, aby zobaczyć komunikat o błędzie i dane dla każdego kroku. Potrzebujesz pomocy technicznej? Podaj kod **Ślad** tego wykonania.
</Accordion>
</Accordions>

## Wykonanie, które nie chce wystartować [#een-uitvoering-die-niet-wil-starten]

Zobacz [Często zadawane pytania](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet), gdzie jest lista kontrolna.


# Wyzwalacze (/pl-PL/automatiseringen/triggers)

Wyzwalacz to moment startu automatyzacji: to "kiedy". Stoi na samej górze każdego przepływu, pod nazwą **Gdy to się wydarzy**. Przykład: *uruchom, gdy zakończy się zajęcie*. Określa też, z jakich danych mogą korzystać kolejne kroki. Przepływ może mieć kilka wyzwalaczy. Każdy wyzwalacz uruchamia własne wykonanie, z własnym filtrem. Dodajesz go z listy po lewej. Ostatniego wyzwalacza nie możesz usunąć.

<DocScreenshot src="/screenshots/automatiseringen/trigger-settings.png" alt="Zaznaczony wyzwalacz z polami Startuje od i Zdarzenie, filtrem Tylko gdy oraz danymi, które dostarcza zdarzenie" />

## Od czego startuje automatyzacja [#waar-start-de-automatisering-op]

W polu **Startuje od** wybierasz jeden z siedmiu momentów startu.

| Wybór | Uruchamia się, gdy |
|---|---|
| **Gdy coś się wydarzy** | W Tillor dojdzie do zdarzenia, na przykład zakończy się zajęcie albo zostanie opłacona faktura |
| **Faktura przeterminowana** | Zaksięgowana faktura po terminie płatności nadal jest otwarta |
| **Webhook przychodzący** | Inny system wyśle wiadomość na własny adres automatyzacji |
| **Wybrano akcję zadania** | Ktoś na zadaniu wybierze przycisk wyboru powiązany z tą automatyzacją |
| **Nadeszła data** | Nadejdzie data rekordu, ewentualnie jakiś czas przed nią lub po niej. Na przykład dzień przed przyjazdem rezerwacji |
| **Codziennie o danej godzinie** | Jest wybrana godzina każdego dnia |
| **Według wyrażenia cron** | Nadejdzie czas według podanego przez Ciebie harmonogramu |

Wybierasz więc najpierw rodzaj momentu startu, a potem szczegóły. Jeśli wybierzesz inny moment startu, filtry w **Tylko gdy** zostaną wyczyszczone. Były napisane pod poprzedni wybór i już nie pasują.

## Gdy coś się wydarzy [#als-er-iets-gebeurt]

W polu **Zdarzenie** wybierz, co ma uruchomić automatyzację. Kliknij pole i wpisz, aby wyszukać, na przykład *occupation* albo *invoice*. Zdarzenia są zapisane w notacji Tillor, jak `occupation:ended`: najpierw czego dotyczy, potem co się stało.

Oto zdarzenia, których potrzebujesz najczęściej:

| Zdarzenie | Uruchamia się, gdy |
|---|---|
| `occupation:ended` | Zakończy się zajęcie |
| `reservation:created` | Zostanie utworzona rezerwacja |
| `reservation:updated` | Rezerwacja zostanie zmieniona |
| `customer:created` | Zostanie utworzony klient |
| `customer:updated` | Klient zostanie zmieniony |
| `invoice:created` | Zostanie utworzona faktura |
| `invoice:updated` | Faktura zostanie zmieniona |
| `invoice:paid` | Faktura zostanie opłacona |
| `payment:created` | Wpłynie płatność |
| `task:created` | Zostanie utworzone zadanie |
| `task:status-changed` | Zmieni się status zadania |
| `task:assigned` | Zadanie zostanie komuś przypisane |
| `task:action-chosen` | Ktoś wybierze przycisk wyboru na zadaniu |
| `integration-alarm:created` | Licznik zgłosi alarm |
| `comment:created` | Zostanie dodany komentarz |
| `document:created` | Zostanie dodany dokument |
| `signatureRequest:updated` | Prośba o podpis zostanie zaktualizowana |
| `signatureRequest:completed` | Wszyscy podpisujący prośbę o podpis podpiszą |
| `mandate-agreement:signed` | Klient podpisze mandat SEPA |
| `mandate-agreement:activated` | Mandat SEPA stanie się aktywny |
| `mandate-agreement:expired` | Wniosek o mandat SEPA wygaśnie bez podpisu |
| `mandate-agreement:failed` | Aktywacja mandatu SEPA zostanie odrzucona albo się nie powiedzie |
| `productPriceChange:applied` | Zacznie obowiązywać [zaplanowana cena produktu](/producten/prijzen-plannen) |

To ta sama lista co w [webhookach](/ontwikkelaars/events). Możesz więc użyć każdego zdarzenia, dla którego Tillor może wysłać webhook. Kilka zdarzeń występujących wyjątkowo często, takich jak fizyczny stan szlabanów, pisanie w skrzynce, logi kontrolerów i obecność pojazdów, nie ma na liście.

<Callout type="info" title="Brakuje Ci zdarzenia?">
Pod polem **Zdarzenie** jest link **Brakuje zdarzenia? Poproś o nie**. Zobacz [Poproś o krok lub zdarzenie](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).
</Callout>

### Jakie dane dostajesz [#welke-gegevens-krijg-je-mee]

Do większości zdarzeń należy rekord, taki jak zajęcie, faktura czy zadanie. Ten rekord oraz rekordy, do których się odwołuje, są potem dostępne jako zmienne w krokach. Przy `occupation:ended` możesz na przykład użyć:

- `{occupation.terrain.name}` dla nazwy terenu
- `{occupation.customer.firstName}` dla imienia klienta
- `{occupation.reservation.displayId}` dla numeru rezerwacji. Nie każde zajęcie ma rezerwację: wtedy to pole pozostaje puste

Poza tym zawsze są `{triggeredBy.name}` i `{triggeredBy.id}`: kolega, który wywołał zdarzenie. Jeśli zdarzenie wywołał system, na przykład synchronizacja bankowa, te pola są puste.

Pod ustawieniami wyzwalacza jest **Dane, które dostarcza to zdarzenie**. Tam widzisz dokładnie, jakich zmiennych możesz użyć. Przy zdarzeniu, którego dane nie są opisane, Tillor mówi, że nie ma czego wybierać. Zmienne, które wpiszesz samodzielnie, nadal działają. Zobacz [Zmienne i szablony](/automatiseringen/variabelen).

## Wybrano akcję zadania [#er-wordt-een-taakactie-gekozen]

Niektóre zadania mają przyciski wyboru zamiast haczyka, na przykład z kroku [Poproś o decyzję](/automatiseringen/logica#vraag-om-een-beslissing). Przycisk może być powiązany z automatyzacją. Z tym wyzwalaczem ta automatyzacja uruchamia się, gdy tylko ktoś wybierze ten przycisk. Zobacz też [Zadania z przyciskami wyboru](/taken/taakdetails#taken-met-keuzeknoppen).

Powiązania przycisku z automatyzacją nie robisz w edytorze przepływu. Jeśli tego potrzebujesz, poproś o to administratora Tillor albo support.

Kroki dostają dane zadania, na przykład `{task.name}` i `{task.id}`, a do tego `{action.label}` (nazwa wybranego przycisku) i `{note}` (notatka wpisana przez kolegę, jeśli przycisk o nią prosił). Pod **Dane, które dostarcza to zdarzenie** zobaczysz pełną listę.

## Faktura przeterminowana [#factuur-is-vervallen]

Ten wyzwalacz uruchamia się dla każdej faktury, która:

- jest zaksięgowana (szkice i anulowane faktury się nie liczą)
- nie jest notą kredytową
- ma jeszcze kwotę do zapłaty
- ma termin płatności przed dzisiejszym dniem

Dla każdej takiej faktury uruchamia się osobne wykonanie. Dane faktury i klienta są dostępne jako `{invoice.…}`, na przykład `{invoice.displayId}`, `{invoice.amountOutstanding}` i `{invoice.customer.firstName}`.

Jeśli wyłączysz **Uruchom raz na rekord**, automatyzacja uruchomi się dla tej samej faktury najwyżej raz dziennie, dopóki jest przeterminowana. Jeśli zostawisz to włączone, uruchomi się dla każdej faktury dokładnie raz. To zwykle jest to, czego chcesz przy przypomnieniu.

W polu **Do przypomnienia** wybierasz, jak długo faktura ma już być otwarta, według tej samej reguły co na liście faktur. Włącz **Pomiń klientów wyłączonych z automatycznych przypomnień**, aby pominąć klientów, którzy mają to ustawione w swoich ustawieniach fakturowania. Faktura, która sama została wyłączona z automatycznych przypomnień, również nie uruchamia przepływu.

## Webhook przychodzący [#inkomende-webhook]

Webhook to wiadomość, którą inny system wysyła na jakiś adres. Z tym wyzwalaczem ten system uruchamia automatyzację, na przykład Twoja strona, formularz albo platforma rezerwacyjna. Każda automatyzacja dostaje własny, tajny adres.

1. W polu **Startuje od** wybierz **Webhook przychodzący**
2. Zapisz automatyzację. W polu **Adres** pojawi się URL
3. Kliknij **Kopiuj** i ustaw ten adres w drugim systemie
4. Włącz automatyzację

Drugi system wysyła `POST` z JSON na ten adres. Treść jest potem dostępna jako `{body.…}`, na przykład `{body.email}` albo `{body.reservering.nummer}`, a parametry w adresie URL jako `{query.…}`. Za pomocą **Tylko gdy** możesz filtrować także po tych polach.

Dalej działa to tak:

- Tajemnicą jest adres. Kto go zna, może uruchomić automatyzację. Udostępnij go więc tylko systemowi, który go potrzebuje
- Jeśli adres wycieknie, kliknij **Nowy adres** i zapisz. Stary adres od tej chwili nie działa
- Wyłączona automatyzacja albo błędny adres daje błąd `404`
- Treść może mieć najwyżej 100 KB
- Każde wywołanie uruchamia jedno wykonanie na każdy wyzwalacz webhooka w przepływie. Adres należy do pierwszego wyzwalacza webhooka. **Nowy adres** na tym wyzwalaczu go zastępuje
- Nie jest z tym powiązany żaden rekord, więc **Uruchom raz na rekord** nie ma efektu

### Ignorowanie powtórzeń [#herhalingen-negeren]

Jeśli drugi system czasem wysyła to samo wywołanie dwa razy, za pomocą **Ignoruj powtórzenia** zapobiegasz dwukrotnemu uruchomieniu przepływu. Tillor zapamiętuje klucz wywołania. Jeśli ten sam klucz przyjdzie ponownie, nic się nie uruchamia.

| Wybór | Czym jest klucz |
|---|---|
| **Każde wywołanie uruchamia przepływ** | Nie ma klucza. Domyślnie |
| **Z nagłówka** | Wartość nagłówka, który wybierasz w polu **Nazwa nagłówka**, na przykład `Idempotency-Key` |
| **Z treści JSON** | Wartość pola w JSON, które wybierasz w polu **Pole**, na przykład `id` albo `data.eventId` |
| **Ta sama treść JSON** | Cała treść. Wywołanie z dokładnie taką samą treścią liczy się jako powtórzenie |

W polu **Pamiętaj klucz przez** wybierasz, jak długo klucz obowiązuje, w godzinach, dniach lub tygodniach. Po tym czasie ten sam klucz uruchamia przepływ ponownie. Przy 0 klucz obowiązuje, dopóki nie usuniesz automatyzacji. Wywołanie bez wybranego nagłówka albo bez wybranego pola jest odrzucane.

## Nadeszła data [#een-datum-is-bereikt]

Ten wyzwalacz uruchamia się w dniu będącym datą rekordu. W polu **Data** wybierasz dowolne pole daty rekordu, które Tillor wysyła też przy zdarzeniach, zapisane jako rekord i pole. Kilka przykładów:

| Data | Rekord |
|---|---|
| `reservation.checkIn` | Data przyjazdu rezerwacji |
| `reservation.checkOut` | Data wyjazdu rezerwacji |
| `invoice.dueDate` | Termin płatności faktury |
| `task.dueDate` | Termin zadania |
| `occupation.paidUntil` | Do kiedy zajęcie jest opłacone |
| `accessMethod.periodTo` | Koniec ważności kodu QR, tablicy rejestracyjnej lub innego środka dostępu |
| `nfcTag.activatedUntil` | Do kiedy tag NFC jest aktywowany |
| `mandateAgreement.expiresAt` | Kiedy wygasa prośba o podpisanie mandatu SEPA |
| `customer.birthday` | Data urodzenia klienta |
| `contact.birthday` | Data urodzenia osoby kontaktowej |

Domyślnie wyzwalacz uruchamia się jeden raz, w samym dniu daty. Włącz **Powtarzaj co roku**, aby liczyły się tylko dzień i miesiąc: wtedy przepływ uruchamia się co roku od nowa, na przykład w urodziny przy `contact.birthday`. 29 lutego w innych latach przypada na 28 lutego.

Możesz też wybrać dane zapisane przy rekordzie jako dodatkowe pola. `document.userMetadata.insuranceExpiryDate` to termin ważności dokumentu, takiego jak dowód opłacenia ubezpieczenia. Taka data bez godziny liczy się jako północ (UTC, międzynarodowy czas standardowy). Za pomocą **Tylko gdy** ograniczasz wtedy wyzwalacz do jednego typu, na przykład `document.userMetadata.documentType` **jest** `INSURANCE_PAYMENT_PROOF`, oraz do aktywnych dokumentów z `document.status` **jest** `ACTIVE`.

Za pomocą **Jak długo** i **Przed czy po** przesuwasz moment. *1 dzień* i **Przed** przy `reservation.checkIn` uruchamia przepływ dzień przed przyjazdem. Przy 0 uruchamia się w samym dniu daty. Data bez godziny liczy się jako północ.

Za pomocą **Czas** wybierasz, o której tego dnia przepływ się uruchamia. **Godzina z daty** używa momentu zapisanego w polu, takiego jak godzina przyjazdu rezerwacji. **Stała godzina dnia** uruchamia się w dniu daty o wybranej godzinie i minucie, w strefie czasowej Twojej organizacji. Tak `contact.birthday` z **Powtarzaj co roku** uruchamia się co roku o 09:00 w urodziny. **Jak długo** liczy się wtedy od tej godziny: *1 dzień* i **Przed** uruchamia się dzień wcześniej o 09:00, nawet jeśli tej nocy zmieni się czas.

Dla każdego rekordu uruchamia się osobne wykonanie, z danymi tego rekordu jako zmiennymi, na przykład `{reservation.displayId}` i `{reservation.customer.firstName}`. Za pomocą **Tylko gdy** to ograniczasz, na przykład tylko do rezerwacji ze statusem zarezerwowana.

Dalej działa to tak:

- Dla każdego rekordu i każdego momentu przepływ uruchamia się jeden raz. Jeśli data przesunie się na później, na przykład bo gość przyjedzie później, uruchomi się ponownie w nowym momencie
- Jeśli moment minął już w chwili, gdy zapisywałeś lub włączałeś automatyzację, nie uruchomi się już dla niego
- Pominięte momenty, na przykład podczas prac konserwacyjnych, Tillor nadrabia do godziny później

## Codziennie o danej godzinie [#elke-dag-op-een-uur]

W polu **Godzina** wybierz godzinę (od 0 do 23), a w polu **Minuta** minutę od 0 do 59. Czas jest czasem w strefie czasowej Twojej organizacji.

Kroki dostają `{now}`: moment, w którym wykonanie się uruchomiło.

## Według wyrażenia cron [#volgens-een-cron-expressie]

Wybierz rytm, taki jak codziennie, w każdy poniedziałek o 08:00 albo nieparzyste poniedziałki (1., 3. i 5.). W **Niestandardowy** ustawiasz odstęp, dni tygodnia i godzinę, co do minuty. W **Wyrażenie cron** harmonogram piszesz sam.

Wyrażenie cron to krótki zapis powtarzającego się czasu. Ma pięć części oddzielonych spacją: **minuta**, **godzina**, **dzień miesiąca**, **miesiąc** i **dzień tygodnia**.

| Wyrażenie | Znaczenie |
|---|---|
| `0 8 * * 1` | Co poniedziałek o 08:00 |
| `7 8 * * 1` | Co poniedziałek o 08:07 |
| `30 7 * * 1-5` | Każdego dnia roboczego o 07:30 |
| `0 9 1 * *` | Pierwszego dnia każdego miesiąca o 09:00 |
| `0 8 * * 1#1,1#3,1#5` | Co nieparzysty poniedziałek (1., 3. i 5. w miesiącu) o 08:00 |
| `0 8 * * 1L` | Ostatniego poniedziałku miesiąca o 08:00 |
| `0 8 * * 1 W2:2026-10-05` | Co dwa tygodnie w poniedziałek o 08:00, od tygodnia 5 października 2026 |
| `*/15 * * * *` | Co kwadrans |
| `* * * * *` | Co minutę |

W każdej części możesz użyć liczby, listy z przecinkami (`8,17`), zakresu (`1-5`), kroku (`*/15`) albo gwiazdki (`*`, każda wartość). Dzień tygodnia 0 i 7 to obydwa niedziela. `1#2` to drugi poniedziałek, `1L` ostatni. Szóste pole `W2:2026-10-05` powtarza co dwa tygodnie, licząc od tego tygodnia. Nazwy takie jak *MON* czy *JAN* nie działają. Jeśli wypełnisz zarówno dzień miesiąca, jak i dzień tygodnia, automatyzacja uruchomi się przy jednym z nich.

Jeśli wyrażenie jest nieprawidłowe, Tillor zgłasza to przy wyzwalaczu. Czasy obowiązują w strefie czasowej Twojej organizacji.

## O której dokładnie uruchamia się harmonogram [#hoe-laat-start-een-schema-precies]

<Callout type="warn" title="Harmonogram uruchamia się w minucie, w której przychodzi jego kolej">
Tillor co minutę sprawdza, które harmonogramy są na swoim miejscu. Automatyzacja, która ma ruszyć o 08:07, uruchamia się w tej minucie. Dotyczy to **Faktura przeterminowana**, **Nadeszła data**, **Codziennie o danej godzinie** i **Według wyrażenia cron**.
</Callout>

Na minutę harmonogram uruchamia się najwyżej raz. Kontrola, która działa dopiero w następnej minucie, nie nadrabia poprzedniej minuty.

Zdarzenia uruchamiają się od razu, bez tego opóźnienia.

## Tylko gdy [#alleen-wanneer]

Za pomocą **Tylko gdy** sprawiasz, że automatyzacja uruchamia się tylko wtedy, gdy dane się zgadzają. Tak uruchamiasz ją na przykład tylko dla przyczep stacjonarnych albo tylko dla faktur powyżej jakiejś kwoty. Zostaw puste, aby uruchamiać przy każdym zdarzeniu tego typu.

1. Kliknij **Dodaj warunek**
2. Wybierz pole przyciskiem **Zmienna** (albo wpisz ścieżkę, na przykład `invoice.status`)
3. Wybierz sposób porównania
4. Wpisz wartość. Przy polach o stałym wyborze, takich jak status, typ terenu czy kolega, wybierasz z listy

Możesz użyć następujących porównań:

| Wybór | Jest spełnione, gdy |
|---|---|
| **jest** | Pole jest równe wartości |
| **nie jest** | Pole nie jest równe wartości |
| **zawiera** | Wartość występuje gdzieś w polu |
| **jest większe niż** | Pole jest większe niż wartość (przy liczbach i datach) |
| **jest mniejsze niż** | Pole jest mniejsze niż wartość (przy liczbach i datach) |
| **jest jednym z** | Pole jest równe jednej z wybranych wartości |
| **jest puste** | Pole jest puste |
| **nie jest puste** | Pole nie jest puste |

Wielkość liter nie ma znaczenia. Liczby są porównywane jako liczby, więc 10 jest większe niż 9.

Jeśli masz więcej niż jeden warunek, wybierasz, jak współpracują: **Wszystkie muszą być spełnione** albo **Wystarczy jeden spełniony**.

<Callout type="info">
Zdarzenia zatrzymane przez filtr nie uruchamiają wykonania, więc nie zostawiają też śladu na karcie **Uruchomienia**. Jeśli chcesz sprawdzić, czy Twój filtr działa, użyj **Uruchomienie testowe**: zobaczysz tam dla każdego warunku, czy był spełniony.
</Callout>

## Uruchom raz na rekord [#eén-keer-per-record-uitvoeren]

Z **Uruchom raz na rekord** automatyzacja uruchamia się najwyżej raz na fakturę, rezerwację lub inny rekord, bez względu na to, jak często zdarzenie dla niego wystąpi.

Jest to przydatne zwłaszcza przy zdarzeniach, które często wracają, jak `invoice:updated`: faktura jest zmieniana dziesiątki razy, a Ty chcesz wysłać tylko jedno przypomnienie. Tillor zapamiętuje dla każdego rekordu, że automatyzacja już się uruchomiła. To zapamiętanie znika, gdy usuniesz automatyzację.

Działa to tylko przy zdarzeniach, do których należy rekord, oraz przy **Faktura przeterminowana** i **Nadeszła data**. Przy **Nadeszła data** oznacza to: nawet jeśli data później się przesunie, przepływ nie uruchomi się ponownie. Przy harmonogramie takim jak **Codziennie o danej godzinie** nie ma to efektu.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Za każdym razem, gdy nadchodzi moment startu i filtr się zgadza, uruchamia się wykonanie z danymi z tej chwili jako zmiennymi.
- Zdarzenie uruchamia się od razu. Data, godzina lub harmonogram uruchamia się w minucie, w której przychodzi jego kolej.
- Jeśli filtr nie pasuje, nic się nie uruchamia i na karcie **Uruchomienia** nie ma żadnego śladu.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Automatyzacja nie uruchamia się przy moim zdarzeniu">
Sprawdź, czy automatyzacja jest włączona, czy wybrano właściwe **Zdarzenie** i czy filtr w **Tylko gdy** nie jest zbyt ścisły. Przetestuj na danych prawdziwego przypadku na karcie **Uruchomienie testowe**. Więcej w [Często zadawane pytania](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="Tillor pisze Wyrażenie cron jest nieprawidłowe">
Użyj pięciu pól oddzielonych spacją, takich jak `0 8 * * 1`. Nazwy takie jak *MON* nie działają.
</Accordion>
<Accordion title="Webhook przychodzący zwraca błąd 404">
Automatyzacja jest wyłączona albo adres się nie zgadza. Włącz automatyzację i skopiuj adres ponownie.
</Accordion>
<Accordion title="Mój filtr zniknął, gdy wybrałem inny moment startu">
Przy innym momencie startu filtry w **Tylko gdy** są czyszczone, ponieważ były napisane pod poprzedni moment startu. Dodaj je ponownie.
</Accordion>
<Accordion title="Przepływ nie uruchamia się ponownie dla tej samej faktury">
Włączone jest **Uruchom raz na rekord**. Wtedy uruchamia się najwyżej raz na fakturę, rezerwację lub inny rekord.
</Accordion>
</Accordions>

## Czytaj dalej [#meer-lezen]

<Cards>
  <Card
    title="Warunki, rozgałęzienia i opóźnienia"
    href="/automatiseringen/logica"
    description="Rozdziel przepływ i każ mu czekać"
  />
  <Card
    title="Zmienne i szablony"
    href="/automatiseringen/variabelen"
    description="Używaj danych zdarzenia w swoich krokach"
  />
</Cards>


# Zmienne i szablony (/pl-PL/automatiseringen/variabelen)

Za pomocą zmiennych tworzysz teksty, które w każdym przypadku wyglądają inaczej. Zmienną piszesz w nawiasach klamrowych, a Tillor wstawia prawdziwą wartość, gdy tylko automatyzacja działa.

Przykład tytułu zadania:

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

Jeśli zajęcie kończy się na terenie 12, zadanie nazywa się *Controleer 12*.

## Wstawianie zmiennej [#een-variabele-invoegen]

Nad każdym polem tekstowym, w którym działają zmienne, jest przycisk **Zmienna**. Kliknij go, a zobaczysz listę wszystkich dostępnych danych, pogrupowanych według rekordu. Wpisz, aby wyszukać (**Szukaj zmiennych**), i kliknij wiersz. Tillor wstawia zmienną w miejscu kursora.

<DocScreenshot src="/screenshots/automatiseringen/variables-picker.png" alt="Przycisk Zmienna przy polu Tytuł z otwartą listą dostępnych zmiennych" />

Zmienną możesz też po prostu wpisać samodzielnie. Pod polem szary blok pokazuje, jak tekst wygląda z przykładowymi danymi, więc od razu widzisz, czy się zgadza.

Zmienne działają w polach tekstowych, takich jak tytuły, opisy, podzadania, wiadomości, ID klienta, faktury lub innego rekordu, ścieżka lub URL żądania API, treść, ładunek webhooka, nazwa zdarzenia webhooka i wartości nagłówków. Przy dwóch ostatnich brakuje przycisku **Zmienna**, ale zmienna wpisana samodzielnie jest uzupełniana. Tillor nie sprawdza tych dwóch pól pod kątem błędów i nie pokazuje przy nich podglądu.

W polach, w których wybierasz dane do porównania, zmienną piszesz bez nawiasów klamrowych. Dotyczy to **Tylko gdy**, **Jeśli / w przeciwnym razie** i **Aż** przy **Czekaj, aż** (na przykład `invoice.status`), pola **Pole** w **Rozgałęzienie** oraz **Data** w **Opóźnienie**.

## Jakie są zmienne [#welke-variabelen-zijn-er]

| Zmienna | Dostępna | Zawartość |
|---|---|---|
| `{occupation.…}`, `{invoice.…}`, `{task.…}`, `{reservation.…}` i inne | Po zdarzeniu | Pola rekordu, którego dotyczy zdarzenie. Nazwa rekordu jest też początkiem zmiennej |
| `{occupation.terrain.name}` | Po zdarzeniu | Pola rekordów, do których odwołuje się rekord, takich jak klient lub teren. Działa to na jeden poziom w głąb |
| `{triggeredBy.name}`, `{triggeredBy.id}` | Zawsze | Kolega, który wywołał zdarzenie. Puste, jeśli zrobił to system |
| `{invoice.…}` | Przy **Faktura przeterminowana** | Pola przeterminowanej faktury i klienta |
| `{reservation.…}`, `{task.…}` i inne | Przy **Nadeszła data** | Pola rekordu, którego data nadeszła, oraz rekordów, do których się odwołuje |
| `{now}`, `{today}` | Zawsze | Moment, w którym krok działa, i północ tego dnia w strefie czasowej organizacji. Razem z przesunięciem (poniżej) `{today + 1 day}` daje jutro |
| `{threadId}`, `{messageId}` | Przy zdarzeniach dotyczących wiadomości w skrzynce, takich jak `inbox:message-created` | ID rozmowy i wiadomości |
| Pola zdarzenia | Po **Czekaj na zdarzenie**, przez **Odebrano** | Dane zdarzenia, na które czekano. Zastępują dane tych samych rekordów z początku przepływu |
| `{createdTask.id}`, `{createdTask.name}` | Po **Utwórz zadanie** | Zadanie, które właśnie zostało utworzone |
| `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}`, `{foundTask.status}` | Po **Znajdź zadanie**, przez **Znaleziono** | Zadanie, które znalazł krok |
| `{updatedTask.id}`, `{updatedTask.status}` | Po **Ustaw status** | Zadanie, którego status został zmieniony |
| `{updatedTask.id}`, `{updatedTask.priority}` | Po **Ustaw priorytet zadania** | Zadanie, którego priorytet został zmieniony |
| `{updatedTask.id}` | Po **Zaktualizuj zadanie** | Zadanie, które zostało zmienione |
| `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}`, `{foundDocument.userMetadata.insuranceExpiryDate}` | Po **Znajdź dokument**, przez **Znaleziono** | Dokument, który znalazł krok |
| `{updatedDocument.id}` | Po **Zaktualizuj dokument** | Dokument, który został zmieniony |
| `{response.status}`, `{response.body}`, `{response.data.…}` | Po **Żądanie API** | Odpowiedź na żądanie |
| `{foundCustomer.…}`, `{foundInvoice.…}`, `{foundReservation.…}` i inne | Po **Wyszukaj rekord**, przez **Znaleziono** | Pola rekordu, który znalazł krok, oraz rekordów, do których się odwołuje. Nazwa to `found` plus typ rekordu: `foundCustomer`, `foundReservation`, `foundOccupation`, `foundInvoice`, `foundPayment`, `foundTerrain`, `foundTask`, `foundDocument`, `foundAccessMethod`, `foundNfcTag`, `foundMeter`, `foundInboxThread` lub `foundInboxMessage` |
| `{body.…}`, `{query.…}`, `{receivedAt}` | Po **Webhook przychodzący** | Treść JSON, parametry zapytania i moment odebrania wywołania webhooka |
| Każda nazwa celu z **Mapuj zmienne** | Po **Mapuj zmienne** | To, co wpiszesz w tym kroku jako cel, na przykład `{invoice.displayId}` po `invoice` ← `{foundInvoice}` |
| `{item.…}` | W krokach za **Dla każdego** | Pola elementu, dla którego krok właśnie działa, takie jak `{item.id}` |
| `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}`, `{approval.decidedBy.name}` | Po **Poproś o decyzję**, przez opcję | Zadanie, wybrana opcja, nazwa tej opcji, notatka i kolega, który wybrał |
| `{task.…}`, `{action.label}`, `{note}` | Przy **Wybrano akcję zadania** | Zadanie, wybrany przycisk i wpisana do niego notatka |
| `{createdComment.id}` | Po **Dodaj komentarz** | Komentarz, który właśnie został dodany |
| `{bookedInvoice.displayId}` | Po **Zaksięguj fakturę**, przez **Gotowe** | Numer zaksięgowanej faktury |
| `{paymentLink.url}` | Po **Utwórz link do płatności**, przez **Gotowe** | Link, którym klient może zapłacić online |
| `{consumptionInvoice.id}` | Po **Zafakturuj zużycie** | Faktura za zużycie licznika |
| `{extendInvoice.id}` | Po **Robocza faktura przedłużenia** | Robocza faktura, która przedłuża zajęcie |
| `{createdAccessMethod.id}`, `{createdAccessMethod.value}` | Po **Utwórz metodę dostępu** | Nowy środek dostępu i jego wartość, taka jak kod QR lub PIN |
| `{error.message}`, `{error.step}` | Po akcji z **Kontynuuj, gdy ten krok się nie powiedzie**, przez **Błąd** | Komunikat o błędzie i nazwa kroku, który się nie powiódł |

Jakie dokładnie pola ma rekord, widzisz na liście za przyciskiem **Zmienna**. Przy wyzwalaczu jest też przegląd **Dane, które dostarcza to zdarzenie**.

### Tylko to, co jest wcześniej w przepływie [#alleen-wat-eerder-in-de-flow-komt]

Krok może używać tylko zmiennych z wyzwalacza, który do niego dociera, i z kroków znajdujących się wcześniej na tej samej drodze. Jeśli do tego samego kroku docierają różne wyzwalacze, dostępne są tylko zmienne, które dostarcza każdy z nich. Pole z wcześniejszego kroku się liczy, jeśli każdy z tych wyzwalaczy też przechodzi przez ten krok. Jeśli użyjesz zmiennej, która w tym miejscu nie istnieje, Tillor zgłasza **[Pole]: zmienna [zmienna] nie jest dostępna w tym kroku.** Przepływu z takim komunikatem nie można włączyć.

Niektóre rekordy przechowują dodatkowe dane w jednym polu, jak dane dokumentu w `userMetadata`. Każdy klucz pod nim jest zmienną: `{document.userMetadata.documentType}`, `{document.userMetadata.insuranceExpiryDate}` albo inny klucz. Znane klucze, takie jak typ i termin ważności dokumentu, są też na liście i możesz je porównywać jako datę. Data bez godziny, taka jak `2026-10-07`, pojawia się w wiadomości jako `07-10-2026`.

Zmienne z **Dla każdego** (`{item.…}`) istnieją tylko w krokach za wyjściem **Dla każdego**, nie za **Gotowe**. Zmienne z wyjścia, którym nie poszedłeś, też nie istnieją: `{paymentLink.url}` jest tylko wtedy, gdy krok przeszedł przez **Gotowe**, a `{foundTask.id}` tylko po **Znaleziono**.

Przy zdarzeniach, których dane nie są opisane, Tillor nie może sprawdzić, jakie zmienne istnieją. Wtedy nie dostajesz tego komunikatu. Takie przepływy sprawdź więc szczególnie dokładnie uruchomieniem testowym.

### Nowa wartość zastępuje starą [#een-nieuwe-waarde-vervangt-de-oude]

Drugie **Żądanie API** w tym samym przepływie zastępuje `response` pierwszego. To samo dotyczy `createdTask` po drugim **Utwórz zadanie**, `foundTask` po drugim **Znajdź zadanie** lub **Wyszukaj rekord** dla **Zadanie** oraz `error` po drugim nieudanym kroku. Dane z odpowiedzi używaj więc w kroku, który następuje zaraz po niej.

## Jak wartości są uzupełniane [#hoe-waarden-worden-ingevuld]

Tillor dostosowuje notację do rodzaju pola.

**W zwykłym tekście** (tytuły, opisy, podzadania):

- Daty są w strefie czasowej Twojej organizacji, na przykład `05-10-2026`. Jeśli moment nie wypada dokładnie o północy, obok jest też godzina, na przykład `05-10-2026 14:30`
- Puste pole daje pusty tekst
- Zmienna, której Tillor nie zna, pozostaje tak, jak ją napisałeś, na przykład `{occupation.terain.name}`. Literówka od razu rzuca się w oczy w zadaniu lub wiadomości
- Jeśli powiązanego rekordu nie ma, zmienna pozostaje pusta. Zajęcie bez rezerwacji daje więc nic dla `{occupation.reservation.displayId}`, a zdarzenie wywołane przez system daje nic dla `{triggeredBy.name}`. Jeśli w takim przypadku chcesz innego tekstu, postaw przed tym **Jeśli / w przeciwnym razie** z **jest puste**

**W JSON** (**Ładunek** webhooka i **Treść** żądania API):

- Tekst jest wstawiany bezpiecznie. Cudzysłowy, nowe wiersze i inne znaki specjalne w wartości nie mogą zepsuć JSON
- Liczby i wartości tak/nie trafiają bez cudzysłowów, więc nie dodawaj ich wokół. Tekst natomiast ujmujesz w cudzysłowy
- Daty idą jako międzynarodowa data i godzina, taka jak `2026-10-05T08:00:00.000Z`, aby system odbierający dobrze sobie z nią radził

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

Jeśli po uzupełnieniu JSON nie jest prawidłowy, na przykład dlatego, że liczba jest pusta, wykonanie zatrzymuje się z komunikatem o błędzie.

**W ścieżce lub URL** (przy żądaniu API):

- Wartości są przekształcane tak, aby mieściły się w adresie. Nazwa ze spacją nie daje więc zepsutego adresu
- Daty też tutaj idą jako międzynarodowa data i godzina
- To, co wpiszesz sam, pozostaje takie, jak wpiszesz. Jeśli chcesz spację w wyszukiwanym haśle, wpisz sam `%20`

## Przesuwanie daty [#een-datum-verschuiven]

Za zmienną daty może stać przesunięcie: `{reservation.checkOut + 1 day}`, `{today - 2 weeks}`, `{invoice.dueDate + 3 hours|date}`. Jednostki to `minutes`, `hours`, `days`, `weeks` i `months` (liczba pojedyncza też jest dozwolona). Dni i tygodnie mają stałą długość, więc ważność trwa tyle samo mimo zmiany czasu letniego i zimowego; miesiące idą za kalendarzem, więc 31 stycznia plus miesiąc to 28 lub 29 lutego. Na wartości, która nie jest datą, przesunięcie nic nie robi, a nieistniejąca jednostka to błąd kroku. Pola dat, takie jak **Ważne do**, akceptują ten sam zapis.

## Formatowanie wartości [#een-waarde-opmaken]

Po zmiennej postaw `|` i format, na przykład `{invoice.amountOutstanding|currency}`. Bez formatu kwota wygląda surowo, jak `1295.3`. Z `|currency` staje się `€ 1.295,30`.

| Format | Przykład | Wynik |
|--------|-----------|-----------|
| `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` (stała liczba miejsc po przecinku) |
| `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` |

- Liczby i kwoty są zawsze w notacji belgijskiej: kropka dla tysięcy i przecinek dla ułamków
- Daty i godziny są w strefie czasowej Twojej organizacji
- Jeśli format nie może odczytać wartości, na przykład `|currency` na tekście, wartość po prostu pozostaje bez formatu
- Format, którego Tillor nie zna, pozostaje tak, jak go napisałeś, a edytor pokazuje o tym komunikat
- W JSON i w URL sformatowana wartość jest wstawiana jako tekst. W JSON ujmij ją więc w cudzysłowy

## Używanie odpowiedzi API [#een-api-antwoord-gebruiken]

Po [Żądanie API](/automatiseringen/acties/integraties#api-verzoek) możesz używać pól z odpowiedzi za pomocą `{response.data.…}`. Odpowiedź na wyszukiwanie zadań wygląda na przykład tak:

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

Wtedy `{response.data.items.0.id}` daje ID pierwszego zadania (pierwszy na liście ma numer 0), a `{response.data.items.0.priority}` jego priorytet.

Tillor może zaoferować pola odpowiedzi jako zmienne dopiero wtedy, gdy wie, jak odpowiedź wygląda. Możliwe są dwa sposoby:

- Pozwól automatyzacji raz naprawdę zadziałać. Tillor używa wtedy odpowiedzi z ostatniego wykonania
- Wklej przykład na karcie **Uruchomienie testowe**, w polu **Przykładowa odpowiedź API**. To pole pojawia się, gdy tylko przepływ zawiera **Żądanie API**. Pod nim są **Pola w tej odpowiedzi**. Kliknij pole, aby je skopiować, razem z nawiasami klamrowymi

Potem pola są na liście za przyciskiem **Zmienna** i na liście przy **Pole** w **Rozgałęzienie**.

Jeśli sam wpiszesz ścieżkę pod `response.data`, jest ona zawsze akceptowana, także bez przykładu. Poza tym:

- `{response.body}` zawiera pierwsze 4000 znaków odpowiedzi. Jeśli odpowiedź jest dłuższa, reszta jest obcinana
- `{response.data}` jest puste, jeśli odpowiedź nie jest JSON albo jest bardzo duża (ponad 100 000 znaków)
- Przy wyszukiwaniu bez wyniku `{response.data.items.0.id}` nie istnieje. **Rozgałęzienie** na takim polu idzie wtedy przez **Domyślne**

<Callout type="info" title="Przykład w teście">
Na karcie **Uruchomienie testowe** wpisujesz też przykładowe dane zdarzenia. Dzięki temu w uruchomieniu testowym widzisz, jakie wartości wstawiłby Tillor. Zobacz [Testowanie i uruchomienia](/automatiseringen/testen-en-uitvoeringen).
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Gdy tylko automatyzacja działa, Tillor zastępuje każdą zmienną prawdziwą wartością. Zmienna, której Tillor nie zna, pozostaje tak, jak ją napisałeś.
- Jeśli jakaś dana jest pusta, miejsce pozostaje puste. Jeśli wtedy chcesz innego tekstu, postaw przed tym **Jeśli / w przeciwnym razie** z **jest puste**.

## Problemy? [#problemen]

<Accordions>
<Accordion title="W moim zadaniu widzę {occupation.terain.name}">
Zmienna, której Tillor nie zna, pozostaje dosłownie. Zwykle to literówka. Wybierz zmienną przyciskiem **Zmienna**.
</Accordion>
<Accordion title="Tillor pisze, że zmienna nie jest dostępna w tym kroku">
Używasz danej, która w tym miejscu przepływu jeszcze nie istnieje, na przykład z kroku, który jest później, albo z wyjścia, którym nie poszedłeś. Przenieś krok dostarczający daną wcześniej w przepływie. Dopóki komunikat jest widoczny, nie możesz włączyć automatyzacji.
</Accordion>
<Accordion title="JSON się nie zgadza po uzupełnieniu">
Pusta liczba czyni JSON nieprawidłowym. Tekst ujmujesz w cudzysłowy, liczby nie. Sprawdź pola uruchomieniem testowym.
</Accordion>
<Accordion title="Nie widzę pól odpowiedzi API na liście">
Tillor nie zna jeszcze kształtu odpowiedzi. Pozwól automatyzacji raz naprawdę zadziałać albo wklej przykład w polu **Przykładowa odpowiedź API** na karcie **Uruchomienie testowe**.
</Accordion>
</Accordions>


# Często zadawane pytania (/pl-PL/automatiseringen/veelgestelde-vragen)

## Kto może korzystać z automatyzacji? [#wie-kan-automatiseringen-gebruiken]

Kto ma **Wyświetlanie automatyzacji**, widzi automatyzacje i ich uruchomienia. Kto ma **Zarządzanie automatyzacjami**, może je też tworzyć, zmieniać, włączać i usuwać. Administratorzy z **Wszystkie uprawnienia** mogą wszystko. Te uprawnienia nadajesz członkom swojej organizacji.

Uważaj z **Zarządzanie automatyzacjami**: automatyzacja działa ze wszystkimi uprawnieniami Twojej organizacji. Kto może budować przepływy, może więc za ich pomocą zrobić wszystko. Nadawaj to tylko osobom, którym to powierzasz. Kto nie ma żadnego z tych uprawnień, nie widzi pozycji menu **Administrator > Automatyzacje**.

## Dlaczego moja automatyzacja się nie uruchamia? [#waarom-start-mijn-automatisering-niet]

Przejdź po tych punktach.

1. **Czy jest włączona?** Automatyzacja z wyłączonym przełącznikiem (filtr **Wstrzymane**) się nie uruchamia. Jeśli są przy niej problemy, nie mogłeś jej włączyć. Zobacz [Problemy i włączanie](/automatiseringen/problemen)
2. **Czy to właściwe zdarzenie?** Nowa rezerwacja to `reservation:created`, zmiana to `reservation:updated`. Sprawdź też, czy zdarzenie rzeczywiście występuje przy czynności, którą wykonujesz
3. **Czy zatrzymuje ją filtr?** Zdarzenia, które nie przechodzą filtra w **Tylko gdy**, nie zostawiają wykonania. Użyj karty **Uruchomienie testowe** z danymi prawdziwego przypadku, aby zobaczyć, który warunek się nie zgadza. Zwróć uwagę na wartości pól wyboru: status faktury to na przykład `BOOKED`
4. **Czy włączone jest Uruchom raz na rekord?** Wtedy automatyzacja nie uruchamia się ponownie dla faktury lub rezerwacji, dla której już kiedyś działała. Zobacz [Uruchom raz na rekord](/automatiseringen/triggers#eén-keer-per-record-uitvoeren)
5. **Czy to harmonogram?** Wtedy uruchamia się w minucie, w której przychodzi jego kolej. Stała godzina i harmonogram używają strefy czasowej Twojej organizacji
6. **Czy właśnie ją włączyłeś lub zmieniłeś?** Zanim wszystko to zauważy, może minąć pół minuty
7. **Czy przychodzi wiele zdarzeń naraz?** Wtedy wykonania są obsługiwane jedno po drugim i może chwilę potrwać, zanim przyjdzie kolej na Twoje

Jeśli automatyzacja się uruchamia, ale potem coś idzie źle, zajrzyj na kartę **Uruchomienia**, aby zobaczyć, co się stało i gdzie wykonanie utknęło.

## Dlaczego mój harmonogram uruchamia się za późno? [#waarom-start-mijn-schema-te-laat]

Harmonogramy są sprawdzane co minutę. Automatyzacja, która startuje w dniu, o godzinie lub według harmonogramu, zaczyna w tej minucie. Zdarzenie uruchamia się od razu.

## Czy automatyzacja może uruchamiać się w kółko sama? [#kan-een-automatisering-zichzelf-blijven-starten]

W obrębie jednego przepływu nie. Jeśli połączysz wyjście tak, że przepływ wróciłby do wcześniejszego kroku, Tillor odrzuca tę linię. Przepływu z taką pętlą nie możesz włączyć. Jeśli wykonanie mimo to dotrze do kroku, który już wykonało, zatrzymuje się zamiast powtarzać ten krok.

Przez zdarzenia również nie. To, co robi krok, dzieje się jako użytkownik **Przepływ pracy**, a zdarzenia wywołane przez **Przepływ pracy** nie uruchamiają automatyzacji. Automatyzacja, która startuje przy `task:created` i wykonuje **Utwórz zadanie**, nie uruchomi się więc ponownie na zadaniu, które sama utworzyła. Dotyczy to także relacji między automatyzacjami: jedna nie może uruchomić drugiej.

Jeśli w krótkim czasie napłynie wiele zdarzeń, na przykład przez dużą wysyłkę, każde zdarzenie uruchamia wykonanie. Tillor obsługuje po kilka naraz. Nic nie ginie, ale może to chwilę potrwać.

## Jakie obowiązują granice? [#welke-grenzen-gelden-er]

| Co | Granica |
|---|---|
| Kroki w jednej automatyzacji | 100 |
| Gałęzie w **Rozgałęzienie** | 8, oprócz **Domyślne** |
| Połączenia z jednego wyjścia | 1 krok. Jeśli połączysz ponownie, nowa linia zastępuje starą |
| Długość nazwy | 120 znaków |
| Długość opisu | 500 znaków |
| Komentarze i ramki na kanwie | 50 łącznie |
| Opcje przy **Poproś o decyzję** | 8 |
| Czas oczekiwania na żądanie API | 15 sekund |
| Odpowiedź w `{response.body}` | Pierwsze 4000 znaków |
| Odpowiedź w `{response.data}` | Do 100 000 znaków, większa jest pusta |
| Opóźnienie w sekundach | Niedokładne, może być kilka sekund później |
| Harmonogramy | Kontrola co minutę |
| Elementy w **Dla każdego** | 100 na raz |
| Kontrola przy **Czekaj, aż** | Najwyżej co 5 minut |
| Treść webhooka przychodzącego | 100 KB |
| Wykonania na karcie **Uruchomienia** | Ostatnie 20 |

## Czy na to samo zdarzenie może uruchomić się kilka automatyzacji? [#kunnen-er-meerdere-automatiseringen-op-dezelfde-gebeurtenis-starten]

Tak. Każda włączona automatyzacja, której wyzwalacz i filtr pasują, uruchamia własne wykonanie. Nie licz na stałą kolejność.

## Czy po jednym wyjściu mogę kazać zrobić dwie rzeczy naraz? [#kan-ik-na-één-uitgang-twee-dingen-tegelijk-laten-doen]

Nie, wyjście prowadzi do jednego kroku. Ustaw akcje jedna za drugą albo utwórz drugą automatyzację z tym samym wyzwalaczem.

## Co dzieje się z trwającymi wykonaniami, gdy coś zmienię? [#wat-gebeurt-er-met-lopende-uitvoeringen-als-ik-iets-verander]

| Co robisz | Co dzieje się z wykonaniami |
|---|---|
| Zmieniasz przepływ i zapisujesz | Nowe wykonania używają nowego przepływu. Wykonania, które już trwają lub czekają, kończą się według przepływu w dawnej postaci |
| Wstrzymujesz automatyzację | Wykonania czekające w opóźnieniu zatrzymują się, gdy tylko czas oczekiwania minie, i dostają status **Anulowane**. To, co już trwa w tym momencie, kończy się. Jeśli włączysz ją ponownie przed upływem czasu oczekiwania, wykonanie po prostu idzie dalej |
| Usuwasz automatyzację | Wykonania i historia są usuwane. Czekające wykonania się zatrzymują |

## Co się dzieje, gdy krok się nie powiedzie? [#wat-gebeurt-er-als-een-stap-mislukt]

Wykonanie zatrzymuje się ze statusem **Niepowodzenie**, a kolejne kroki nie są wykonywane. Kto utworzył automatyzację, dostaje e-mail o nieudanym wykonaniu, najwyżej jeden na godzinę na automatyzację. Tillor nie ponawia kroku. Przy **Wyślij webhook** i **Żądanie API** możesz przechwycić niepowodzenie wyjściem **Niepowodzenie**. Przy innych akcjach włącz **Kontynuuj, gdy ten krok się nie powiedzie**: krok dostaje wtedy wyjście **Błąd**, a przepływ idzie tam dalej. Zobacz [Gdy krok się nie powiedzie](/automatiseringen/acties#als-een-stap-mislukt).

## Czy podczas testu naprawdę coś jest wysyłane? [#wordt-er-echt-iets-verstuurd-tijdens-een-test]

Nie. Uruchomienie testowe niczego nie wysyła, niczego nie tworzy i niczego nie zmienia. Zobacz [Testowanie i uruchomienia](/automatiseringen/testen-en-uitvoeringen).

## Czy moje dane są bezpiecznie przechowywane? [#zijn-mijn-gegevens-veilig-opgeslagen]

Twoje przepływy i historia wykonań, łącznie z nagłówkami z kluczami lub tokenami, są przechowywane w postaci zaszyfrowanej. Dla adresów w internecie dozwolone jest tylko `https`, a adresy wewnętrzne są odrzucane.

## Brakuje mi zdarzenia, warunku lub akcji [#ik-mis-een-gebeurtenis-voorwaarde-of-actie]

Użyj **Poproś o krok** w edytorze. Zobacz [Poproś o krok lub zdarzenie](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).

## Czy mogę zarządzać automatyzacjami także z własnego systemu? [#kan-ik-automatiseringen-ook-vanuit-mijn-eigen-systeem-beheren]

Tak, jeśli Twoje połączenie ma wszystkie uprawnienia. Zobacz [Dla programistów](/ontwikkelaars/automatiseringen).

<Callout type="idea" title="Zacznij od małego">
Zacznij od jednego wyzwalacza i jednej akcji, pozwól im działać przez kilka dni i przejrzyj wykonania. Dopiero potem rozbudowuj o warunki i opóźnienia.
</Callout>


# Przykład: kontrola po wynajmie przyczepy (/pl-PL/automatiseringen/voorbeeld-nalopen)

Ten przykład buduje przepływ z filtrem, **Znajdź zadanie**, **Ustaw priorytet zadania**, **Jeśli / w przeciwnym razie** i zadaniem z podzadaniami. Nie potrzebujesz do tego żądania API.

W środowiskach demo Tillor ten przepływ jest już gotowy jako wstrzymany przykład pod nazwą **Nalopen huurcaravan**. Możesz go tam oglądać, gdy budujesz razem z nami.

## Co robi przepływ [#wat-de-flow-doet]

Gość wyjeżdża z przyczepy stacjonarnej. Przyczepa musi zostać skontrolowana przed następnym gościem.

- Jeśli nie ma jeszcze otwartego zadania kontrolnego dla tego terenu, przepływ tworzy je, z pięcioma podzadaniami i terminem po 7 dniach. Zadanie trafia też do kolegi, który zatrzymał zajęcie
- Jeśli otwarte zadanie kontrolne już jest, na przykład dlatego, że przyczepa zwolniła się dwa razy w krótkim odstępie, przepływ nie tworzy drugiego zadania. Zamiast tego priorytet istniejącego zadania rośnie o jeden poziom

```mermaid
flowchart TD
  A["Bezetting gestopt<br/>alleen stacaravans"] --> F{"Open nalooptaak?"}
  F -- Gevonden --> P["Prioriteit een stap hoger<br/>tot Hoog"]
  F -- Niet gevonden --> B{"Door een collega gestopt?"}
  B -- Ja --> C["Nalooptaak maken<br/>met naam van de collega"]
  B -- Nee --> D["Nalooptaak maken"]
```

Dwa kroki zadań na dole są prawie takie same. Różni je tylko opis: jeśli zajęcie zakończył system, nie ma kolegi do wspomnienia.

## Czego potrzebujesz [#wat-je-nodig-hebt]

- Masz uprawnienie **Zarządzanie automatyzacjami** albo **Wszystkie uprawnienia**
- W Twojej organizacji istnieje typ terenu dla przyczep stacjonarnych, w tym przykładzie **Stacaravan**
- Opcjonalnie: tablica i kolumna dla zadań kontrolnych

## Budowanie przepływu [#de-flow-bouwen]

### 1. Utwórz pusty przepływ [#1-een-lege-flow-maken]

1. Przejdź do **Administrator > Automatyzacje** i kliknij **Nowa automatyzacja**
2. Wybierz **Zacznij od zera**
3. W okruszkach na górze wpisz nazwę **Nalopen huurcaravan**
4. Kliknij kanwę, obok kroków, i w panelu w polu **Opis** wpisz, do czego służy przepływ

### 2. Ustaw wyzwalacz [#2-de-trigger-instellen]

1. Kliknij wyzwalacz. Pozostaw **Startuje od** na **Gdy coś się wydarzy**
2. W polu **Zdarzenie** wybierz `occupation:ended`. Wpisz *occupation*, aby wyszukać
3. W polu **Nazwa kroku** nadaj krokowi nazwę *Bezetting gestopt*

Teraz przepływ uruchamia się przy każdym kończącym się zajęciu. Ty chcesz go tylko dla przyczep stacjonarnych:

1. W **Tylko gdy** kliknij **Dodaj warunek**
2. Kliknij **Zmienna** i wybierz `occupation.terrain.terrainTypeId`
3. Pozostaw porównanie na **jest**
4. Jako wartość wybierz typ terenu **Stacaravan**

<DocScreenshot src="/screenshots/automatiseringen/trigger-filter.png" alt="Wyzwalacz z warunkiem typ terenu jest Stacaravan" />

### 3. Znajdź otwarte zadanie kontrolne [#3-een-open-nalooptaak-zoeken]

1. Dodaj krok **Znajdź zadanie**, połącz z nim wyzwalacz i nadaj mu nazwę *Open nalooptaak?*
2. W polu **Tytuł** wpisz `Nalopen {occupation.terrain.name}`
3. Pozostaw włączone **Powiązane z rekordami zdarzenia**, **Tylko zadania nieukończone** i **Pomiń podzadania**

Krok szuka teraz zadania głównego, które nie jest jeszcze ukończone, nazywa się dokładnie *Nalopen* z nazwą terenu i jest powiązane z tym samym terenem, tym samym klientem lub tą samą rezerwacją. Potem przepływ idzie dalej przez **Znaleziono** albo **Nie znaleziono**.

### 4. Podnieś priorytet [#4-de-prioriteit-verhogen]

1. Dodaj krok **Ustaw priorytet zadania**, nadaj mu nazwę *Prioriteit verhogen* i połącz z nim wyjście **Znaleziono**
2. Pozostaw **Zadanie** na `{foundTask.id}`
3. Pozostaw **Zmiana** na **O jeden poziom wyżej**, a **Podnieś maksymalnie do** na **Wysoki**

### 5. Sprawdź, kto zatrzymał zajęcie [#5-nagaan-wie-de-bezetting-stopzette]

1. Dodaj krok **Jeśli / w przeciwnym razie**, połącz z nim wyjście **Nie znaleziono** z *Open nalooptaak?* i nadaj mu nazwę *Door een collega gestopt?*
2. Kliknij **Dodaj warunek** i w polu **Zmienna** wybierz `triggeredBy.id`
3. Wybierz porównanie **nie jest puste**

`{triggeredBy.id}` jest puste, jeśli zajęcie zakończył system, na przykład zaplanowane zadanie. Wtedy przepływ idzie przez **Nie**.

### 6. Utwórz zadanie [#6-de-taak-aanmaken]

Dodaj krok **Utwórz zadanie**, nadaj mu nazwę *Nalooptaak maken* i połącz z nim wyjście **Tak**. Wypełnij pola tak:

| Pole | Wartość |
|---|---|
| **Tytuł** | `Nalopen {occupation.terrain.name}` |
| **Opis** | `Automatisch gegenereerd.`, pusty wiersz i `Bezetting stopgezet door @{triggeredBy.name}({triggeredBy.id})` |
| **Priorytet** | **Niski** |
| **Termin po** | 7 dni |
| **Przypisz też osobę, która wywołała zdarzenie** | Włączone |
| **Powiąż z rekordami** | Włączone |
| **Podzadania** | Pięć wierszy: *Kuisen*, *Inboedel*, *Internet + TV*, *Kader QR code*, *Controleren op werkjes* |

Za pomocą `@{triggeredBy.name}({triggeredBy.id})` kolega jest wspomniany w opisie. Jeśli chcesz, aby zadanie trafiło na tablicę, wybierz w **Dodaj do tablicy** tablicę, a w **Kolumna** kolumnę. Osobę, która ma zawsze dostać zadanie, wybierasz w **Przypisz do**.

Zostaw tytuł taki sam jak w *Open nalooptaak?*. W przeciwnym razie krok wyszukiwania następnym razem nie znajdzie zadania.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Krok Nalooptaak maken z ustawieniami w panelu" />

### 7. Zadanie dla systemu [#7-de-taak-voor-het-systeem]

1. Kliknij krok *Nalooptaak maken*, a potem **Duplikuj krok**
2. Nadaj kopii nazwę *Nalooptaak maken (systeem)* i połącz z nią wyjście **Nie**
3. Ustaw **Opis** tylko na `Automatisch gegenereerd.`

### 8. Testowanie i włączanie [#8-testen-en-inschakelen]

1. Sprawdź, czy na górze panelu nie ma przycisku z problemami (takiego jak **1 problem**)
2. Otwórz kartę **Uruchomienie testowe** i kliknij **Uruchom test**. Zobaczysz, którą drogą idzie przepływ i jaki tytuł oraz opis dostałoby zadanie. Nic nie jest tworzone
3. Włącz przełącznik **Aktywna**

## Dlaczego dwa kroki zamiast jednego [#waarom-twee-stappen-in-plaats-van-één]

Kroków **Znajdź zadanie** i **Ustaw priorytet zadania** możesz też używać osobno. Jeśli na przykład nie chcesz nic robić, gdy zadanie już istnieje, po prostu nie łącz niczego z **Znaleziono**. Jeśli chcesz dodać do istniejącego zadania komentarz albo zmienić mu status, postaw za **Znaleziono** inny krok, taki jak **Ustaw status** z `{foundTask.id}`.

## Co dzieje się w praktyce [#wat-er-in-de-praktijk-gebeurt]

| Sytuacja | Co robi przepływ |
|---|---|
| Brak otwartego zadania kontrolnego dla tego terenu | Tworzy nowe zadanie z pięcioma podzadaniami |
| Otwarte zadanie z priorytetem **Niski** | Ustawia je na **Średni** |
| Otwarte zadanie z priorytetem **Średni** | Ustawia je na **Wysoki** |
| Otwarte zadanie z priorytetem **Wysoki** lub **Pilny** | Zostawia priorytet bez zmian |
| Zajęcie na innym typie terenu | Nie uruchamia się |

<Callout type="info" title="Jak zadanie wygląda w Tillor">
Zadanie jest na nazwisko [**Przepływ pracy**](/automatiseringen/workflow-gebruiker) i jest powiązane z terenem i klientem zajęcia oraz z rezerwacją, jeśli jest. Nie każde zajęcie ma rezerwację. Kolega, który zatrzymał zajęcie, jest na zadaniu osobą przypisaną.
</Callout>


# Kto wykonuje automatyzację? (/pl-PL/automatiseringen/workflow-gebruiker)

Automatyzacja nie działa pod Twoim nazwiskiem. Wszystkie kroki wykonuje stały użytkownik Twojej organizacji o nazwie **Przepływ pracy**.

## Co to dla Ciebie oznacza [#wat-je-ervan-merkt]

- Zadanie utworzone przez automatyzację jest zapisane na **Przepływ pracy**
- Komentarz dodany przez automatyzację za pomocą [żądania API](/automatiseringen/acties/integraties#api-verzoek) również jest zapisany na **Przepływ pracy**
- W edytorze, w panelu po prawej stronie, dopóki nie wybierzesz żadnego kroku, widać przypomnienie, że kroki są wykonywane jako użytkownik **Przepływ pracy** Twojej organizacji, nigdy jako Ty

Dzięki temu zawsze jest jasne, co zrobił współpracownik, a co automatyzacja. Twoje imię i nazwisko nie pojawi się przy czymś, czego sam nie zrobiłeś.

## Czym jest **Przepływ pracy** [#wat-workflow-is]

- Użytkownikiem systemowym, a nie współpracownikiem. Nie można się nim zalogować i nie ma skrzynki e-mail
- W każdej organizacji jest jeden taki użytkownik. Istnieje tylko w Twojej organizacji i nigdzie indziej nie może nic zrobić
- Ma wszystkie uprawnienia w Twojej organizacji, tak jak administrator. Dlatego tylko administratorzy mogą tworzyć i zmieniać automatyzacje
- Nie jest członkiem organizacji w taki sposób, jak współpracownik

<Callout type="warn" title="Automatyzacja może dużo">
Ponieważ **Przepływ pracy** może wszystko, automatyzacja może też zrobić wszystko, na co pozwala API Tillor. **Żądanie API** może więc na przykład zmieniać lub usuwać dane. Dlatego twórz małe przepływy i dobrze je testuj.
</Callout>

## Czego **Przepływ pracy** nie może [#wat-workflow-niet-mag]

Automatyzacja nie może tworzyć, zmieniać, włączać ani usuwać automatyzacji ani przeglądać ich uruchomień. Żądanie API w tym celu zostanie odrzucone. Dzięki temu przepływ nie może zmienić samego siebie ani innego przepływu.

## Zdarzenie wywołane przez **Przepływ pracy** [#gebeurtenis-veroorzaakt-door-workflow]

To, co robi **Przepływ pracy**, wywołuje zwykłe zdarzenia, na przykład nowe zadanie. Na osi czasu i w webhookach jako sprawca widnieje wtedy **Przepływ pracy**. Takie zdarzenia nie uruchamiają automatyzacji, więc przepływ nie może uruchomić samego siebie ani innego przepływu. Uruchomienie, które czeka w kroku **Czekaj na zdarzenie**, jest natomiast kontynuowane: nie może to uruchomić nowego przepływu, więc nie powstanie pętla. Więcej na ten temat znajdziesz w [Często zadawanych pytaniach](/automatiseringen/veelgestelde-vragen#kan-een-automatisering-zichzelf-blijven-starten).

## Kogo przypisać [#wie-wijs-je-toe]

**Przepływ pracy** nigdy nie jest sam przypisywany do zadania i nigdy nie dostaje powiadomienia z kroku **Powiadom współpracowników**. Jeśli chcesz, aby współpracownik zajął się zadaniem, wybierz go w polu **Przypisz do** albo zaznacz **Przypisz też osobę, która wywołała zdarzenie**.


# Rejestrowanie płatności (/pl-PL/betalingsverwerking/betaling-registreren)

Płatność rejestrujesz na zaksięgowanej fakturze z otwartym saldem. Ekran płatności jest taki sam dla wszystkich metod. Różnią się tylko pola pod **Metoda płatności**.

<Steps>
<Step>
### Otwórz fakturę [#open-de-factuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> albo otwórz fakturę z <UIPath>Klienci > klient > Fakturowanie</UIPath>. Faktura musi być zaksięgowana i mieć otwarte saldo.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Zaksięgowana faktura - Dokonaj płatności" />
</Step>
<Step>
### Kliknij Dokonaj płatności [#klik-op-maak-betaling]
Otworzy się ekran **Nowa płatność za** fakturę. Na górze widać sumę faktury i kwotę do zapłaty.
</Step>
<Step>
### Wybierz metodę płatności [#kies-de-betaalmethode]
W polu **Metoda płatności** wybierz, w jaki sposób wpływa płatność. To, jakie opcje widzisz, zależy od faktury i od ustawień Twojej organizacji.

- **Terminal** wysyła żądanie do terminala płatniczego. Zobacz [Terminal](/betalingsverwerking/terminal).
- **Gotówka**, **Przelew** i ewentualnie **Inni** rejestrują pieniądze, które wpłynęły poza Tillor. Zobacz [Gotówka i przelew](/betalingsverwerking/contant).
- **Przelew wewnętrzny** przenosi saldo na inną fakturę tego samego klienta. Zobacz [Przelew wewnętrzny](/betalingsverwerking/interne-overboeking).
- **Mandat SEPA** pobiera kwotę na podstawie aktywnego mandatu klienta. Zobacz [Pobranie kwoty z faktury](/betalingsverwerking/incasso).
</Step>
<Step>
### Wpisz kwotę [#vul-het-bedrag-in]
Pole **Kwota** domyślnie zawiera kwotę do zapłaty. Przyciskami 25%, 50%, 75% i 100% szybko wpiszesz część kwoty albo wpisz kwotę samodzielnie. Kwota nie może być wyższa niż kwota do zapłaty.
</Step>
<Step>
### Wykonaj płatność [#voer-de-betaling-uit]
Kliknij **Wykonaj płatność**.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Kwota do zapłaty i stan płatności faktury zostają zaktualizowane. Płatność widać na fakturze w sekcji **Płatności** oraz w <UIPath>Administracja > Płatności</UIPath>. Jak je znaleźć, opisano w [Wyszukiwaniu płatności](/betalingsverwerking/betalingen-bekijken).

Klient woli zapłacić sam? Wyślij wtedy fakturę przyciskiem **Wyślij powiadomienie**. Zobacz [Płatność online](/betalingsverwerking/online).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę przycisku Dokonaj płatności">
Przycisk pojawia się tylko na zaksięgowanej fakturze z otwartym saldem. Wersję roboczą faktury najpierw zaksięguj. W pełni opłacona faktura nie ma już przycisku.
</Accordion>
<Accordion title="Mandat SEPA jest wyszarzony">
Klient nie ma aktywnego mandatu, którego maksymalna kwota wystarcza na tę kwotę. Przy korekcie faktury ta metoda nie jest na liście. Zobacz [Pobranie kwoty z faktury](/betalingsverwerking/incasso).
</Accordion>
<Accordion title="Brakuje metody Terminal">
Terminal jest na liście tylko wtedy, gdy Mollie jest połączone, a Twoja organizacja może przyjmować płatności kartą. Zobacz [Terminal](/betalingsverwerking/terminal).
</Accordion>
</Accordions>


# Wyszukiwanie płatności (/pl-PL/betalingsverwerking/betalingen-bekijken)

Płatności zobaczysz w trzech miejscach: na samej fakturze, w przeglądzie wszystkich płatności i na ekranie szczegółów płatności.

## Przeglądanie płatności faktury [#betalingen-van-een-factuur-bekijken]

Otwórz fakturę i przewiń do sekcji **Płatności**. Zobaczysz tylko płatności przypisane do tej faktury.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Płatności na fakturze" />

## Przeszukiwanie wszystkich płatności [#alle-betalingen-doorzoeken]

Przejdź do <UIPath>Administracja > Płatności</UIPath>. Filtruj według daty, metody płatności, stanu lub klienta albo szukaj po nazwie klienta lub numerze faktury.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Przegląd płatności - wszystkie płatności" />

W menu akcji (trzy kropki) przy płatności możesz, zależnie od płatności, wybrać:

| Akcja | Co robi |
|---|---|
| **Szczegóły** | Otwiera ekran szczegółów |
| **PDF płatności** | Tworzy potwierdzenie płatności |
| **Synchronizuj** | Pobiera aktualny stan z Mollie. Tylko przy płatnościach Mollie, które już istnieją w Mollie |
| **Pomiń opóźnienie** | Wysyła zaplanowane pobranie do banku od razu. Zobacz [Pobranie kwoty z faktury](/betalingsverwerking/incasso) |
| **Odłącz od faktury** | Zdejmuje płatność z faktury |
| **Anuluj** | Anuluje płatność, która nie została jeszcze zakończona |
| **Usuń** | Usuwa płatność |

## Odczytywanie szczegółów płatności [#de-details-van-een-betaling-lezen]

Kliknij **Szczegóły**, aby otworzyć ekran **Szczegóły płatności**. Zobaczysz na nim kwotę, stan, metodę, fakturę i oś czasu.

- **Termin** pojawia się przy trwającym pobraniu SEPA. Stan pokazuje wtedy <Status tone="warning">Oczekiwane</Status> z tą datą.
- **Wyślij po** pojawia się przy pobraniu, którego Tillor nie wysłał jeszcze do banku.
- **Raport płatności** pokazuje raport, w którym znajdzie się płatność. Dopóki płatność nie jest w żadnym raporcie, widać numer raportu z dopiskiem **(oczekiwany)**. Przy płatności Mollie widać **Przy następnej wypłacie Mollie**, ponieważ raport jest znany dopiero przy wypłacie.

Więcej o raportach znajdziesz w [Raportach płatności](/boekhouden/betalingsrapporten).

## Etykiety stanu [#statuslabels]

| Stan | Znaczenie |
|---|---|
| <Status tone="warning">Aż do</Status> | Płatność jest jeszcze w toku |
| <Status tone="info">Upoważniony</Status> | Zatwierdzona, jeszcze niezakończona |
| <Status tone="success">Płatny</Status> | Zakończona |
| <Status tone="error">Przegrany</Status> | Nie udało się |
| <Status>Odwołany</Status> | Przerwana, zanim została ukończona |
| <Status>Wygasły</Status> | Sesja płatności wygasła |
| <Status>Zwrócono pieniądze</Status> i <Status>Częściowo zwrócony</Status> | Kwota została zwrócona w całości lub częściowo |
| <Status tone="error">Opłata zwrotna</Status> | Bank lub wydawca karty odebrał kwotę z powrotem |

## Śledzenie otwartych kwot [#openstaande-bedragen-opvolgen]

Przejdź do <UIPath>Administracja > Faktury</UIPath>. Karta **Faktury z saldem otwartym** pokazuje zaksięgowane faktury, które nie są jeszcze w pełni opłacone. W tabelach filtrujesz według stanu płatności **Wybitny** i sortujesz według terminu płatności.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Faktury z saldem otwartym" />

### Wysyłanie monitu [#een-aanmaning-versturen]

Monit wysyłasz dla każdej faktury osobno, nie zbiorczo.

<Steps>
<Step>
### Otwórz fakturę [#open-de-factuur]
Wybierz fakturę, która nadal jest otwarta.
</Step>
<Step>
### Wyślij monit [#verstuur-de-aanmaning]
Kliknij **Wyślij powiadomienie** i wybierz **Wyślij przypomnienie**. Potwierdź wysyłkę.
</Step>
</Steps>

Klient dostaje przypomnienie z linkiem do płatności online. Zobacz [Płatność online](/betalingsverwerking/online).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Stan nie zgadza się z Mollie">
Użyj **Synchronizuj** w menu akcji płatności. Tillor pobierze wtedy aktualne dane. Pomaga to zwłaszcza wtedy, gdy powiadomienie z Mollie zostało pominięte.
</Accordion>
<Accordion title="Nie widzę Synchronizuj">
Ta akcja jest tylko przy płatnościach Mollie, które mają już transakcję w Mollie. Przy pobraniu, którego Tillor jeszcze nie wysłał, nie ma czego pobrać.
</Accordion>
</Accordions>


# Rejestrowanie płatności gotówką i przelewem (/pl-PL/betalingsverwerking/contant)

Metodami **Gotówka**, **Przelew** i ewentualnie **Inni** zapisujesz, że klient zapłacił poza Tillor. Tillor niczego wtedy nie wysyła. Aktualizuje tylko otwarte saldo faktury.

- **Gotówka**: klient płaci gotówką w recepcji.
- **Przelew**: otrzymałeś przelew bankowy, który nie został automatycznie powiązany z fakturą.
- **Inni**: dla innych płatności z własnym opisem, na przykład czeku lub wymiany. Ta metoda jest dostępna tylko wtedy, gdy Twoja organizacja ją włączyła.

## Rejestrowanie płatności [#een-betaling-registreren]

<Steps>
<Step>
### Otwórz ekran płatności [#open-het-betaalscherm]
Otwórz zaksięgowaną fakturę z otwartym saldem i kliknij **Dokonaj płatności**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Okno płatności - Gotówka" />
</Step>
<Step>
### Wybierz metodę [#kies-de-methode]
W polu **Metoda płatności** wybierz **Gotówka** lub **Przelew**.
</Step>
<Step>
### Wpisz kwotę [#vul-het-bedrag-in]
Wpisz kwotę albo użyj przycisków 25%, 50%, 75% i 100%.
</Step>
<Step>
### Sprawdź datę otrzymania [#controleer-de-datum-van-ontvangst]
**Data otrzymania** domyślnie jest ustawiona na dziś. Zmień ją, jeśli pieniądze wpłynęły innego dnia.
</Step>
<Step>
### Dodaj w razie potrzeby komentarz [#voeg-eventueel-een-opmerking-toe]
W polu **Komentarz** możesz wpisać numer referencyjny lub notatkę. Przy **Inni** opis jest obowiązkowy.
</Step>
<Step>
### Wykonaj płatność [#voer-de-betaling-uit]
Kliknij **Wykonaj płatność**.
</Step>
</Steps>

<Callout type="idea" title="Data otrzymania">
Data decyduje o tym, w którym raporcie płatności znajdzie się płatność. Jeśli rejestrujesz dziś płatność z wczoraj, ustaw datę na wczoraj, aby uzupełnić właściwy raport.
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Płatność od razu pojawia się na fakturze i w <UIPath>Administracja > Płatności</UIPath>. Zobacz [Wyszukiwanie płatności](/betalingsverwerking/betalingen-bekijken).

Przy **Przelew** możesz też sprawić, że klient dostanie e-mail z podpowiedzią, aby przy kolejnych przelewach używał komunikatu strukturalnego. Pole wyboru **Wyślij przypomnienie dotyczące komunikacji strukturalnej** jest na ekranie płatności. Jest wyszarzone, jeśli klient nie ma adresu e-mail.

## Ustawienia płatności ręcznych [#instellingen-voor-handmatige-betalingen]

W <UIPath>Pomoc > Ustawienia > Płatności</UIPath> znajdziesz te ustawienia:

| Ustawienie | Co robi |
|---|---|
| **Pokaż metodę płatności „Inne”** | Dodaje metodę **Inni** na ekranie płatności |
| **Maksimum gotówki** | Najwyższa kwota gotówkowa na jedną płatność, domyślnie 2999 euro |
| **Domyślnie: przypomnienie o ręcznym przelewie bankowym** | Domyślnie zaznacza pole przypomnienia |
| **Maksimum gotówki** | Najwyższa kwota, jaką możesz zarejestrować jako płatność gotówkową, w pełnych euro (domyślnie 2999) |

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor odrzuca moją kwotę gotówkową">
Płatność gotówkowa nie może być wyższa niż **Maksimum gotówki** w <UIPath>Pomoc > Ustawienia > Płatności</UIPath> (domyślnie 2999 euro). Zarejestruj kwotę w częściach albo wybierz inną metodę.
</Accordion>
<Accordion title="Nie widzę metody Inni">
Metoda jest wyłączona. Włącz **Pokaż metodę płatności „Inne”** w <UIPath>Pomoc > Ustawienia > Płatności</UIPath>.
</Accordion>
<Accordion title="Nie widzę metod ręcznych">
Płatności ręczne nie są dostępne dla każdej faktury. Ekran wyświetla wtedy komunikat.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Rejestrowanie płatności" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" />
</Cards>


# Grupy płatności (/pl-PL/betalingsverwerking/groepen)

Grupa płatności łączy kilka wpływających płatności pod jedną nazwą, dzięki czemu możesz je przypisać naraz do zaksięgowanej faktury. Przydatne, gdy chcesz rozliczyć dopiero na koniec dnia lub wydarzenia.

Przykłady:

- **Zamknięcie zmiany kasowej**: wszystkie płatności kartą z dnia są w jednej grupie. Przypisujesz je do faktury dziennego obrotu.
- **Fakturowanie wydarzenia**: uczestnicy płacą z góry online. Przy księgowaniu przypisujesz całą grupę do faktury.
- **Rezerwacja z zaliczką i resztą kwoty**: zaliczka i płatność końcowa są razem w grupie i zostają przypisane naraz.

## Zasady [#de-regels]

- Grupa ma status <Status tone="info">Otwarta</Status> (jeszcze nieprzypisana) albo <Status tone="success">Przypisana</Status> (już przypisana do faktury).
- Grupa nie ma własnego klienta. Klient wynika z faktury, do której przypisujesz grupę.
- Płatności w grupie przenosisz tylko razem. Pojedynczej płatności z grupy nie możesz przypisać do innej faktury.
- Grupę możesz przypisać tylko do zaksięgowanej faktury. Wersje robocze faktur mogą się jeszcze zmienić lub zniknąć.

## Przypisywanie grupy do faktury [#een-groep-aan-een-factuur-koppelen]

<Steps>
<Step>
### Otwórz grupy płatności [#open-de-betalingsgroepen]
Przejdź do <UIPath>Administracja > Płatności</UIPath> i spójrz w sekcji **Grupy płatności**. Lista domyślnie pokazuje tylko otwarte grupy. Zmień filtr **Status**, aby zobaczyć także przypisane grupy.

<DocScreenshot src="/screenshots/betalingen/payment-groups.png" alt="Przegląd płatności - Grupy płatności" />
</Step>
<Step>
### Wybierz Przypisz [#kies-koppelen]
Otwórz menu akcji (trzy kropki) przy otwartej grupie i wybierz **Przypisz**.
</Step>
<Step>
### Wybierz fakturę [#kies-de-factuur]
Wybierz zaksięgowaną fakturę, do której ma trafić cała grupa.
</Step>
<Step>
### Potwierdź [#bevestig]
Kliknij **Przypisz** w oknie. Wszystkie płatności z grupy trafiają naraz do tej faktury, a grupa dostaje status <Status tone="success">Przypisana</Status>.
</Step>
</Steps>

Możesz to zrobić także z poziomu faktury. Wybierz tam w menu akcji **Przypisz płatność**, przejdź na kartę **Grupy płatności** i kliknij **Przypisz grupę**.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Przypisana grupa jest na PDF faktury jako jedna pozycja z sumą grupy. Poszczególne płatności rozwijasz w przeglądzie płatności faktury. Samą grupę widzisz w szczegółach każdej płatności, która w niej jest.

Jeśli grupa zawiera płatność Mollie, która już istnieje w Mollie, obok **Przypisz** pojawia się też **Synchronizuj**. Ta akcja pobiera naraz aktualne dane wszystkich odpowiednich płatności w grupie. Pomaga, gdy nie jesteś pewien stanu albo powiadomienie zostało pominięte. Pustą grupę możesz usunąć przyciskiem **Usuń**.

## Jak płatności trafiają do grupy? [#hoe-komen-betalingen-in-een-groep]

Twój system kasowy lub system wydarzeń może przy tworzeniu płatności Mollie podać nazwę grupy. Tillor sam tworzy wtedy grupę albo używa istniejącej otwartej grupy i umieszcza w niej płatność. Pola do tego opisano w [metadanych Mollie](/ontwikkelaars/mollie-metadata#ingestie-hints-voor-betalingsgroepen).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę przypisać grupy do mojej faktury">
Faktura jest jeszcze wersją roboczą. Najpierw ją zaksięguj, bo grupę mogą otrzymać tylko zaksięgowane faktury.
</Accordion>
<Accordion title="Chcę przenieść płatność z grupy na inną fakturę">
Nie jest to możliwe dla płatności, która jest jeszcze w grupie. Działaj na poziomie grupy.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Wyszukiwanie płatności" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Metadane Mollie" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Pobranie kwoty z faktury na podstawie mandatu (/pl-PL/betalingsverwerking/incasso)

Jeśli klient ma aktywny mandat, Tillor może pobrać kwotę faktury z jego rachunku bankowego. Sam wybierasz sposób: powiązujesz mandat z fakturą, aby pobranie ruszyło samo po zaksięgowaniu, albo uruchamiasz pobranie ręcznie przyciskiem **Dokonaj płatności**.

Mandat zlecasz w [Podpisanie mandatu SEPA](/betalingsverwerking/mandaat). Korekty faktury nie można pobrać.

## Automatyczne pobranie kwoty z faktury [#een-factuur-automatisch-laten-innen]

<Steps>
<Step>
### Otwórz fakturę [#open-de-factuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> i otwórz wersję roboczą lub zaksięgowaną fakturę klienta.
</Step>
<Step>
### Wybierz mandat [#kies-het-mandaat]
W polu **Mandat polecenia zapłaty** wybierz mandat klienta. Na liście są tylko aktywne mandaty. Wybierz **Żadnego mandatu**, aby usunąć powiązanie.

Pole podpowiada, co się stanie: Tillor od razu tworzy oczekującą płatność, a bank zostaje obciążony dwa dni po zaksięgowaniu. Do tego czasu możesz płatność anulować.
</Step>
<Step>
### Zaksięguj fakturę [#boek-de-factuur]
Po zaksięgowaniu przy fakturze pojawia się **Pobranie jest zaplanowane na** z datą. Tego dnia Tillor wysyła pobranie do banku.
</Step>
</Steps>

Jeśli faktura była już zaksięgowana, gdy powiązałeś mandat, obowiązuje ten sam termin dwóch dni liczony od tej chwili. Jeśli Tillor wysłał już pobranie do banku, nie możesz już zmienić mandatu na fakturze.

### Maksymalna kwota mandatu [#het-maximumbedrag-van-een-mandaat]

Każdy mandat ma maksymalną kwotę. Widać ją na liście mandatów jako **maks.** z kwotą. Jeśli faktura jest wyższa:

- mandat jest na liście wyszarzony, z komunikatem, że maksimum jest niższe niż kwota faktury;
- faktura pokazuje komunikat, że kwota faktury przekracza maksimum mandatu;
- Tillor nie może zaksięgować faktury z takim powiązanym mandatem.

Wybierz wtedy mandat z wyższym maksimum albo pozwól klientowi zapłacić w inny sposób.

## Ręczne uruchomienie pobrania [#een-incasso-handmatig-starten]

<Steps>
<Step>
### Otwórz ekran płatności [#open-het-betaalscherm]
Otwórz zaksięgowaną fakturę i kliknij **Dokonaj płatności**.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Zaksięgowana faktura - Dokonaj płatności" />
</Step>
<Step>
### Wybierz Mandat SEPA [#kies-sepa-mandaat]
W polu **Metoda płatności** wybierz **Mandat SEPA**. Jeśli jest wyszarzony, klient nie ma aktywnego mandatu, który obsłuży tę kwotę.
</Step>
<Step>
### Wybierz mandat i opóźnienie [#kies-het-mandaat-en-de-vertraging]
Wybierz **Mandat**. Tillor sam wybiera pierwszy aktywny mandat, który obsłuży kwotę. W polu **Opóźnienie (dni)** wpisz od 0 do 7 dni. Przy 0 pobranie od razu trafia do banku, przy wyższej liczbie Tillor czeka tyle dni.
</Step>
<Step>
### Wykonaj płatność [#voer-de-betaling-uit]
Kliknij **Wykonaj płatność**.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Płatność jest przy fakturze i w <UIPath>Administracja > Płatności</UIPath>.

- Dopóki pobranie czeka, w szczegółach widać **Wyślij po** z datą. Wybierz **Pomiń opóźnienie** w menu akcji, aby wysłać je teraz do banku, albo **Anuluj**, aby je zatrzymać.
- Po wysłaniu płatność ma stan <Status tone="warning">Aż do</Status> z polem **Termin**. Pobranie SEPA trwa kilka dni. Potem staje się <Status tone="success">Płatny</Status> albo <Status tone="error">Przegrany</Status>, jeśli bank odrzuci pobranie.
- Trwające pobranie w księgowości już liczy się jako płatność w toku. Jeśli się nie powiedzie lub je anulujesz, znika ponownie z wersji roboczej. Zobacz [Raporty płatności](/boekhouden/betalingsrapporten).
- Klient widzi na stronie płatności **Pobierane poleceniem zapłaty** z kwotą i datą, a bez przycisków płatności. Dzięki temu nikt nie zapłaci podwójnie. PDF faktury i e-mail z fakturą podają kwotę i termin pobrania.

Niewielką pierwszą płatność, którą klient potwierdził swój mandat, Tillor odlicza od następnej faktury.

## Automatyczne pobieranie faktur za media [#nutsfacturen-automatisch-innen]

Faktury za zużycie wody, prądu i gazu możesz automatycznie pobierać na podstawie mandatu klienta.

- Jeśli klient przy podpisywaniu zaznaczy **Użyj tego mandatu także do automatycznego opłacania moich faktur za media (woda, prąd, gaz)**, Tillor ustawia ten mandat, gdy tylko stanie się aktywny. Pole jest domyślnie zaznaczone.
- Mandat możesz też wybrać samodzielnie w <UIPath>Klienci > klient > Fakturowanie</UIPath>, w karcie **Ustawienia faktury**, w polu **Mandat**.
- Na liście mandatów mandat dla mediów jest oznaczony jako **Media**.

Nowa faktura za zużycie dostaje wtedy ten mandat automatycznie jako **Mandat polecenia zapłaty**.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Mandat SEPA jest wyszarzony przy Dokonaj płatności">
Klient nie ma mandatu ze statusem <Status tone="success">Aktywny</Status>, którego maksimum jest wystarczająco wysokie. Sprawdź kartę **Mandaty** w <UIPath>Klienci > klient > Fakturowanie</UIPath>.
</Accordion>
<Accordion title="Nie mogę zaksięgować faktury">
Powiązany mandat ma niższe maksimum niż kwota faktury. Wybierz inny mandat albo usuń mandat z faktury.
</Accordion>
<Accordion title="Nie mogę już zmienić mandatu na fakturze">
Tillor wysłał już pobranie do banku. Śledź płatność w <UIPath>Administracja > Płatności</UIPath>.
</Accordion>
<Accordion title="Pobranie się nie powiodło">
Otwórz płatność, aby poznać powód. Faktura jest znów otwarta. Wybierz **Dokonaj płatności**, aby wykonać nowe pobranie lub użyć innej metody, albo wyślij klientowi link do płatności przyciskiem **Wyślij powiadomienie**.
</Accordion>
<Accordion title="Chcę jeszcze zatrzymać pobranie">
Dopóki płatność w <UIPath>Administracja > Płatności</UIPath> nadal pokazuje **Wyślij po**, możesz ją anulować. Jeśli została już wysłana, nie jest to już możliwe. Możesz natomiast odwołać mandat dla kolejnych faktur, zobacz [Odwołanie mandatu](/betalingsverwerking/mandaat-beheren).
</Accordion>
</Accordions>

Automatyzacje także mogą pobierać kwoty: krok [Pobieraj należności poleceniem zapłaty](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Podpisanie mandatu SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Odwołanie lub ponowne wysłanie mandatu" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Wyszukiwanie płatności" href="/betalingsverwerking/betalingen-bekijken" />
</Cards>


# Przegląd (/pl-PL/betalingsverwerking)

Płatność w Tillor zwykle jest przypisana do zaksięgowanej faktury. Klient może zapłacić online samodzielnie, Ty możesz zarejestrować płatność w recepcji albo Tillor automatycznie pobiera kwotę na podstawie mandatu SEPA. Na tej stronie zobaczysz, do czego służy która metoda.

<Callout type="info" title="Warto wiedzieć">
- Płatność jest przypisana do zaksięgowanej faktury. Na wersji roboczej nie można zapłacić.
- Płatność gotówkowa domyślnie może wynosić maksymalnie 2999 euro. Zmienisz to w **Maksimum gotówki** w <UIPath>Pomoc > Ustawienia > Płatności</UIPath>.
- Powyżej 2500 euro strona płatności ostrzega klienta, że bank lub karta mogą odrzucić płatność online. Klient dostaje wtedy IBAN i komunikat strukturalny do przelewu.
- Pobranie na podstawie mandatu trafia do banku dwa dni po zaksięgowaniu. Przy **Dokonaj płatności** sam wybierasz opóźnienie od 0 do 7 dni. Do chwili wysłania pobrania możesz je anulować.
- Jeśli faktura jest wyższa niż maksimum mandatu, nie można pobrać kwoty. Jeśli taki mandat jest na fakturze, nie można też zaksięgować faktury.
- Link do podpisania mandatu działa 14 dni. Tillor przypomina klientowi po 7 dniach, na 2 dni przed wygaśnięciem i w ostatnim dniu.
- Przelew wewnętrzny jest możliwy tylko między dwiema zaksięgowanymi fakturami tego samego klienta.
- Tillor nie może zwrócić klientowi pieniędzy. Zwrot załatwiasz poza Tillor, na przykład przelewem bankowym.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Każda metoda kończy się w tym samym miejscu: płatnością na fakturze. Potem trafia ona do raportu płatności i do Twojej księgowości.

```mermaid
flowchart LR
  F[Zaksięgowana faktura] --> M{Metoda płatności}
  M -- Online --> P[Płatność]
  M -- Terminal --> P
  M -- Gotówka lub przelew --> P
  M -- Pobranie SEPA --> P
  M -- Przelew wewnętrzny --> P
  P -- Stan i saldo --> F
  P -- Dziennie --> R[Raport płatności]
  R --> B[Księgowość]
```

Pobranie najpierw pozostaje <Status tone="warning">Aż do</Status>. Faktura jest wtedy już oznaczona jako opłacona (w toku). Jeśli pobranie się nie powiedzie, faktura znów jest otwarta. Raporty płatności i połączenie z oprogramowaniem księgowym opisano w [Księgowości](/boekhouden).

## Którą metodę wybrać? [#welke-methode-kies-je]

| Metoda | Kiedy | Jak płaci klient | Co księguje Tillor |
|---|---|---|---|
| [Płatność online](/betalingsverwerking/online) | Klient płaci sam, w domu lub w podróży | Przez link w e-mailu lub SMS-ie z fakturą, za pomocą iDEAL, Bancontact, karty kredytowej lub innej metody | Płatność, gdy tylko potwierdzi ją partner płatniczy, nawet jeśli klient już nic nie robi |
| [Terminal](/betalingsverwerking/terminal) | Klient stoi w recepcji | Kartą lub telefonem na terminalu płatniczym Mollie | Płatność, gdy tylko terminal ją zakończy |
| [Gotówka i przelew](/betalingsverwerking/contant) | Pieniądze otrzymane poza Tillor | Gotówka w recepcji lub przelew bankowy | Płatność, którą rejestrujesz, z datą otrzymania |
| [Mandat SEPA](/betalingsverwerking/incasso) | Faktury cykliczne lub wysokie, zużycie | Nie płaci. Tillor pobiera kwotę z rachunku bankowego | Płatność w toku, dopóki bank nie potwierdzi pobrania |
| [Przelew wewnętrzny](/betalingsverwerking/interne-overboeking) | Przeniesienie salda między dwiema fakturami tego samego klienta | Nie płaci. Żadne pieniądze nie wpływają | Dwie powiązane płatności, dodatnia i ujemna |

Płatności online, płatności kartą i pobrania przechodzą przez Mollie. Płatności gotówkowe i przelewy rejestrujesz samodzielnie.

<Cards>
  <Card title="Rejestrowanie płatności" href="/betalingsverwerking/betaling-registreren" icon={<ReceiptTextIcon />} description="Ekran płatności na zaksięgowanej fakturze" />
  <Card title="Wyszukiwanie płatności" href="/betalingsverwerking/betalingen-bekijken" icon={<SearchIcon />} description="Według faktury, w przeglądzie i w szczegółach" />
  <Card title="Płatność online" href="/betalingsverwerking/online" icon={<GlobeIcon />} description="Strona płatności, którą widzi klient" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" icon={<MonitorSmartphoneIcon />} description="Płatności kartą w recepcji" />
  <Card title="Gotówka i przelew" href="/betalingsverwerking/contant" icon={<BanknoteIcon />} description="Rejestrowanie płatności poza Tillor" />
  <Card title="Przelew wewnętrzny" href="/betalingsverwerking/interne-overboeking" icon={<ArrowLeftRightIcon />} description="Przenoszenie salda między fakturami" />
  <Card title="Podpisanie mandatu SEPA" href="/betalingsverwerking/mandaat" icon={<FileSignatureIcon />} description="Zdalnie lub w recepcji" />
  <Card title="Pobranie kwoty z faktury" href="/betalingsverwerking/incasso" icon={<LandmarkIcon />} description="Automatyczne pobranie na podstawie mandatu" />
  <Card title="Grupy płatności" href="/betalingsverwerking/groepen" icon={<LayersIcon />} description="Łączenie płatności i przypisywanie ich naraz" />
  <Card title="Przykłady z praktyki" href="/praktijk" icon={<ReceiptTextIcon />} description="Rozbudowane przykłady z praktyki" />
</Cards>

## Pojęcia [#begrippen]

- **Płatność**: otrzymana lub trwająca kwota, z metodą, stanem i zwykle fakturą.
- **Mandat**: zgoda klienta na pobieranie faktur z jego rachunku bankowego. Zobacz [Mandat SEPA](/betalingsverwerking/mandaat).
- **Grupa płatności**: zbiór płatności, który później przypisujesz naraz do faktury. Zobacz [Grupy płatności](/betalingsverwerking/groepen).
- **Raport płatności**: dzienne zestawienie otrzymanych płatności dla księgowości. Zobacz [Raporty płatności](/boekhouden/betalingsrapporten).
- **Przelew wewnętrzny**: przeniesienie salda między dwiema fakturami tego samego klienta, bez wpływu pieniędzy.
- **Pobranie**: Tillor pobiera kwotę z rachunku bankowego klienta na podstawie jego mandatu.
- **Klient**: klient, do którego należy faktura. Zobacz [Klient](/begrippen#klant).


# Tworzenie przelewu wewnętrznego (/pl-PL/betalingsverwerking/interne-overboeking)

Za pomocą **Przelew wewnętrzny** przenosisz kwotę z jednej zaksięgowanej faktury na inną zaksięgowaną fakturę tego samego klienta. Żadne pieniądze nie wpływają. Tillor tworzy dodatnią płatność na fakturze, którą rozliczasz, i powiązaną ujemną płatność na fakturze docelowej.

To nie jest płatność gotówką, kartą ani przelewem. Te metody są osobno na ekranie płatności.

## Rejestrowanie przelewu wewnętrznego [#een-interne-overboeking-registreren]

<Steps>
<Step>
### Otwórz ekran płatności [#open-het-betaalscherm]
Otwórz zaksięgowaną fakturę z otwartym saldem i kliknij **Dokonaj płatności**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-internal-transfer.png" alt="Okno płatności - Przelew wewnętrzny z otwartą listą faktury docelowej" />
</Step>
<Step>
### Wybierz Przelew wewnętrzny [#kies-interne-overboeking]
W polu **Metoda płatności** wybierz **Przelew wewnętrzny**.
</Step>
<Step>
### Wybierz fakturę docelową [#kies-de-doelfactuur]
W polu **Faktura docelowa** wybierz zaksięgowaną fakturę, na którą trafi kwota. Lista pokazuje tylko zaksięgowane faktury tego samego klienta.
</Step>
<Step>
### Wpisz kwotę [#vul-het-bedrag-in]
Wpisz kwotę albo użyj przycisków 25%, 50%, 75% i 100%.
</Step>
<Step>
### Wykonaj płatność [#voer-de-betaling-uit]
W razie potrzeby wypełnij **Data otrzymania** i kliknij **Wykonaj płatność**.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tillor tworzy dwie powiązane płatności, **Przelew wewnętrzny z** i **Przelew wewnętrzny na konto**, każdą z numerem drugiej faktury.
- Otwarte saldo obu faktur zostaje zaktualizowane.
- Jeśli usuniesz jedną z tych dwóch płatności, Tillor usunie też drugą.

## Przelew wewnętrzny i księgowość [#interne-overboeking-en-boekhouding]

- Przelew wewnętrzny jest w raporcie płatności z dnia, w którym go rejestrujesz. Jeśli zarejestrujesz go dziś, od razu trafia do [wersji roboczej raportu](/boekhouden/betalingsrapporten#concept-en-definitief) z dzisiaj.
- Trafia do eksportu księgowego razem z płatnościami Mollie.
- Płatności gotówkowe, przelewy i rachunki bankowe nie trafiają do eksportu księgowego.

## Po stornowaniu faktury z przedłużeniem zajęcia miejsca [#na-het-omkeren-van-een-factuur-met-bezetting-verlengen]

Za pomocą **Stornuj fakturę** zamieniasz fakturę w korektę. Przelew wewnętrzny między tymi dwiema fakturami jest tylko rozliczeniem w księgowości. Nie przedłuża ani nie skraca zajęcia miejsca po raz kolejny.

Co to oznacza dla **Opłacone do**:

- Na pierwotnej fakturze **Opłacone do** się nie zmienia.
- Na korekcie **Opłacone do** cofa się tylko wtedy, gdy pierwotna faktura została już opłacona prawdziwą płatnością, na przykład gotówką, przelewem lub przez Mollie. Jeśli została tylko rozliczona przelewem wewnętrznym, **Opłacone do** pozostaje bez zmian.
- **Zafakturowane do** zostało już zmienione przy księgowaniu.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Faktury docelowej nie ma na liście">
Pojawiają się tylko zaksięgowane faktury tego samego klienta. Najpierw zaksięguj wersję roboczą faktury i nie wybieraj tej samej faktury, na której tworzysz płatność.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Rejestrowanie płatności" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Rachunki bankowe" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Odwołanie lub ponowne wysłanie mandatu (/pl-PL/betalingsverwerking/mandaat-beheren)

Wszystkie akcje dla mandatu są w menu (trzy kropki) na końcu wiersza w karcie **Mandaty**. Kartę znajdziesz w <UIPath>Klienci > klient > Fakturowanie</UIPath>. To, które akcje widzisz, zależy od statusu.

| Status | Akcje w menu |
|---|---|
| <Status tone="info">Oczekuje na podpis</Status> | **Pokaż na iPadzie**, **Wyślij przypomnienie**, **Wyślij ponownie link do podpisu**, **Anuluj prośbę** |
| <Status>Link wygasł</Status> | **Wyślij ponownie link do podpisu**, **Anuluj prośbę** |
| <Status tone="error">Aktywacja nie powiodła się</Status> | **Anuluj prośbę** |
| <Status tone="success">Aktywny</Status> | **Otwórz podpisane upoważnienie**, **Odwołaj upoważnienie** |
| <Status>Odwołany</Status> | **Otwórz podpisane upoważnienie** |

**Pokaż na iPadzie** pojawia się tylko wtedy, gdy aplikacja Tillor na urządzeniu Twojej organizacji jest online.

## Ponowne wysłanie otwartej prośby [#een-openstaande-aanvraag-opnieuw-versturen]

<Steps>
<Step>
### Otwórz menu przy prośbie [#open-het-menu-bij-de-aanvraag]
Znajdź prośbę ze statusem <Status tone="info">Oczekuje na podpis</Status> lub <Status>Link wygasł</Status>.
</Step>
<Step>
### Wybierz akcję [#kies-de-actie]
- **Wyślij przypomnienie** wysyła klientowi ponownie e-mail z nowym linkiem. Data końcowa się nie zmienia.
- **Wyślij ponownie link do podpisu** wysyła nowy link, który znów działa 14 dni.

Wcześniej wysłany link po obu akcjach przestaje działać.
</Step>
</Steps>

Tillor wyświetla **Przypomnienie wysłane** lub **Link do podpisu wysłany ponownie**. Klient dostaje e-mail. Jak działają automatyczne przypomnienia, opisano w [Podpisanie mandatu SEPA](/betalingsverwerking/mandaat#herinneringen-voor-het-tekenen).

## Anulowanie prośby [#een-aanvraag-annuleren]

Wybierz **Anuluj prośbę**, jeśli klient nie musi już podpisywać. Prośba dostaje status <Status>Anulowany</Status>. Jeśli jest na tablecie, znika stamtąd. Potem możesz rozpocząć nową prośbę.

## Odwołanie aktywnego mandatu [#een-actief-mandaat-intrekken]

Odwołaj mandat, gdy nie wolno już pobierać należności od klienta, na przykład po przeprowadzce, wypowiedzeniu umowy lub na prośbę klienta.

<Callout type="warn" title="Odwołania nie można cofnąć">
Do automatycznej płatności potrzebny będzie potem nowy mandat z nowym podpisem klienta.
</Callout>

<Steps>
<Step>
### Wybierz Odwołaj upoważnienie [#kies-mandaat-intrekken]
Otwórz menu przy aktywnym mandacie i wybierz **Odwołaj upoważnienie**.
</Step>
<Step>
### Potwierdź [#bevestig]
W oknie **Odwołać to upoważnienie?** kliknij **Odwołaj**. Tillor wyświetla **Upoważnienie odwołane**.
</Step>
</Steps>

Co dzieje się potem:

- Żadne faktury nie są już pobierane na podstawie tego mandatu. Pobrania, których Tillor nie wysłał jeszcze do banku, zostają anulowane.
- Status mandatu zmienia się na <Status>Odwołany</Status>.
- Podpisany dokument zostaje zachowany jako dowód, ale trafia do archiwum. W dokumentach klienta znajdziesz go w zakładce **Zarchiwizowane**, dzięki czemu lista pokazuje tylko mandaty, które nadal obowiązują.
- Klient dostaje e-mail, że mandat został odwołany, wraz z kopią podpisanego dokumentu.

Mandaty ustawione poza Tillor pokazują w menu tylko **Odwołaj upoważnienie**.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Odwołaj upoważnienie">
Ta akcja jest tylko przy mandacie ze statusem <Status tone="success">Aktywny</Status>. Prośbę, która nie została jeszcze podpisana, anulujesz przez **Anuluj prośbę**.
</Accordion>
<Accordion title="Pobranie było już w drodze do banku">
Odwołanie anuluje tylko pobrania, których Tillor nie wysłał jeszcze do banku. Pobranie, które już jest w drodze, śledzisz w <UIPath>Administracja > Płatności</UIPath>.
</Accordion>
<Accordion title="Chcę użyć innego mandatu dla faktury">
Wybierz mandat w polu **Mandat polecenia zapłaty** na fakturze. Zobacz [Pobranie kwoty z faktury](/betalingsverwerking/incasso).
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Podpisanie mandatu SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Pobranie kwoty z faktury" href="/betalingsverwerking/incasso" />
</Cards>


# Podpisanie mandatu SEPA (/pl-PL/betalingsverwerking/mandaat)

Mandatem SEPA klient zgadza się na automatyczne pobieranie faktur z jego rachunku bankowego. Klient podpisuje mandat w samym Tillor. Tillor przechowuje podpisany dokument przy kliencie, a potem możesz pobierać kwoty z faktur. Opisano to w [Pobraniu kwoty z faktury](/betalingsverwerking/incasso).

Zanim zaczniesz:

- Mandaty muszą być włączone dla Twojej organizacji. Jeśli nie są, przycisk **Utwórz mandat** informuje, że musisz skontaktować się z administratorem.
- Klient potrzebuje adresu e-mail.
- Klient może mieć otwartą tylko jedną prośbę naraz.

## Zlecanie mandatu [#een-mandaat-aanvragen]

<Steps>
<Step>
### Otwórz klienta [#open-de-klant]
Przejdź do <UIPath>Klienci > klient > Fakturowanie</UIPath>. Na dole jest karta **Mandaty** ze wszystkimi mandatami i prośbami klienta.
</Step>
<Step>
### Kliknij Utwórz mandat [#klik-op-mandaat-aanmaken]
Otworzy się menu z jedną lub dwiema opcjami. Wybierz, jak klient podpisze.
</Step>
</Steps>

<Tabs items={["Zdalnie", "W recepcji"]}>
<Tab value="Zdalnie">
Wybierz **Wyślij zaproszenie do upoważnienia**. Klient dostaje e-mail z linkiem do strony podpisu, a Tillor wyświetla **Upoważnienie wysłane do podpisu na** adres e-mail klienta.

Link działa 14 dni, włącznie z ostatnim dniem. Klient nie musi podawać numeru IBAN. Sam wybiera, jak potwierdzi mandat.
</Tab>
<Tab value="W recepcji">
Wybierz **Podpis na iPadzie w recepcji**. Mandat pojawia się na tablecie w recepcji, a Tillor wyświetla **Upoważnienie jest na iPadzie, klient może podpisać**.

Ta opcja jest w menu tylko wtedy, gdy aplikacja Tillor na urządzeniu Twojej organizacji jest online. Zobacz [Tablety i kioski](/mobiele-app/tablets-en-kiosken). Klient podpisuje palcem na tablecie. W podpisanym dokumencie zapisane jest, że został podpisany w recepcji i który współpracownik używał tabletu.

Prośba została już wysłana, a chcesz ją jednak pokazać na tablecie? Otwórz menu przy prośbie i wybierz **Pokaż na iPadzie**.
</Tab>
</Tabs>

## Co robi klient? [#wat-doet-de-klant]

Klient przechodzi przez kilka ekranów. Na tablecie są to te same ekrany, z kilkoma różnicami opisanymi poniżej.

<Steps>
<Step>
### Zobaczyć mandat [#het-mandaat-bekijken]
Strona **Podpisz upoważnienie SEPA dla** Twojej organizacji pokazuje, kto jest wierzycielem, dla kogo pobiera i jakiego rodzaju jest to płatność. Klient dotyka **Podpisz upoważnienie**.
</Step>
<Step>
### Zaakceptować treść [#de-tekst-accepteren]
Klient czyta podsumowanie albo przez **Przeczytaj pełną treść upoważnienia** cały tekst i zaznacza, że się zgadza.

Poniżej jest drugie pole wyboru, aby używać mandatu także do faktur za media (woda, prąd, gaz). To pole jest domyślnie zaznaczone. Zobacz [Pobranie kwoty z faktury](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
</Step>
<Step>
### Podpisać [#tekenen]
Klient podpisuje palcem lub myszą.
</Step>
<Step>
### Wybrać potwierdzenie [#de-bevestiging-kiezen]
Pod **Jak chcesz upoważnić?** klient wybiera jeden z dwóch sposobów potwierdzenia.

- **Mała pierwsza płatność** własnym bankiem lub kartą, na przykład przez iDEAL, Bancontact, kartę kredytową lub Apple Pay. Kwota wynosi od 0 do 1 euro, zależnie od metody. Bank potwierdza w ten sposób, że rachunek należy do klienta, a klient nie musi przepisywać numeru IBAN. Tillor odlicza tę kwotę od następnej faktury.
- **Konto bankowe (SEPA)**: klient wpisuje swój numer IBAN, potwierdza, że rachunek należy do niego, i wpisuje sześciocyfrowy kod. Kod przychodzi SMS-em na numer telefonu klienta albo e-mailem, jeśli numer nie jest znany.
</Step>
</Steps>

Na tablecie ścieżka z numerem IBAN działa tak samo: kod trafia SMS-em na telefon klienta. Jeśli klient wybierze pierwszą płatność, tablet pokazuje kod QR, który klient skanuje telefonem, aby zapłacić.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Mandat pojawia się na liście ze statusem <Status tone="warning">Podpisany, aktywacja</Status> albo <Status tone="warning">Oczekuje na pierwszą płatność</Status>, jeśli klient wybrał małą płatność.
- Gdy mandat stanie się ważny u partnera płatniczego, status zmienia się na <Status tone="success">Aktywny</Status>. Klient dostaje e-mailem kopię podpisanego mandatu.
- Tillor przechowuje podpisany dokument w dokumentach klienta. Otwierasz go przez menu przy mandacie opcją **Otwórz podpisane upoważnienie**. Dokument jest opieczętowany i opatrzony znacznikiem czasu, więc późniejsza zmiana w czytniku PDF jest widoczna. Zobacz [Pieczęć i znacznik czasu](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).
- Jeśli okno klienta zostało zamknięte, zanim pierwsza płatność się zakończyła, prośba pozostaje otwarta. Klient może spróbować ponownie tym samym linkiem albo przejść na numer IBAN.

## Statusy [#statussen]

| Status | Znaczenie |
|---|---|
| <Status tone="info">Oczekuje na podpis</Status> | Klient jeszcze nie podpisał |
| <Status tone="warning">Podpisany, aktywacja</Status> | Podpisany numerem IBAN, Tillor tworzy mandat |
| <Status tone="warning">Oczekuje na pierwszą płatność</Status> | Podpisany, mała płatność musi jeszcze się udać |
| <Status tone="success">Aktywny</Status> | Możesz używać mandatu do pobrań |
| <Status tone="error">Aktywacja nie powiodła się</Status> | Partner płatniczy odrzucił mandat. Tillor spróbuje później ponownie |
| <Status>Link wygasł</Status> | Klient nie podpisał w ciągu 14 dni |
| <Status>Anulowany</Status> | Anulowałeś prośbę |
| <Status>Odwołany</Status> | Aktywny mandat został odwołany |

Mandaty ustawione poza Tillor pokazują statusy <Status tone="warning">Aż do</Status>, <Status tone="success">Aktywny</Status>, <Status tone="error">Nieaktywny</Status> i <Status>Odwołany</Status>. Do pobrań możesz używać tylko aktywnego mandatu.

## Przypomnienia o podpisaniu [#herinneringen-voor-het-tekenen]

Tillor sam wysyła klientowi przypomnienia e-mailem, dopóki prośba jest otwarta: gdy zostało jeszcze 7 dni, dwa dni przed wygaśnięciem i w ostatnim dniu. Każde przypomnienie zawiera świeży link do podpisu.

Chcesz sam przypomnieć klientowi? Wybierz w menu przy prośbie **Wyślij przypomnienie**. Data końcowa pozostaje wtedy taka sama. Jeśli link wygasł albo chcesz dać kolejne 14 dni, wybierz **Wyślij ponownie link do podpisu**. Więcej o tych akcjach znajdziesz w [Odwołaniu lub ponownym wysłaniu mandatu](/betalingsverwerking/mandaat-beheren).

Chcesz, aby automatyzacja reagowała, gdy prośba wygaśnie? Służy do tego wyzwalacz **Wniosek o upoważnienie wygasł**, zobacz [Automatyzacje](/automatiseringen).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Przycisk Utwórz mandat jest wyszarzony">
Najedź na przycisk, aby poznać powód. Zwykle klient nie ma adresu e-mail albo mandaty nie są włączone dla Twojej organizacji. Dodaj adres e-mail klientowi albo poproś administratora o włączenie mandatów.
</Accordion>
<Accordion title="Tillor mówi, że mandat już czeka na podpis">
Dla jednego klienta może być otwarta tylko jedna prośba naraz. Wyślij istniejącą prośbę ponownie albo ją anuluj, a potem utwórz nową.
</Accordion>
<Accordion title="Brakuje opcji podpisu w recepcji">
Opcja pojawia się tylko wtedy, gdy aplikacja Tillor na urządzeniu Twojej organizacji niedawno łączyła się z Tillor. Otwórz aplikację na tablecie, poczekaj chwilę i spróbuj ponownie.
</Accordion>
<Accordion title="Klient nie dostaje kodu SMS">
Kod trafia na numer telefonu z profilu klienta. Sprawdź, czy jest poprawny. Jeśli klient nie ma numeru, kod przychodzi e-mailem. Klient może poprosić o nowy kod.
</Accordion>
<Accordion title="Klient widzi, że link wygasł">
Klient widzi **Ten link do podpisu wygasł**. Wybierz przy prośbie **Wyślij ponownie link do podpisu**.
</Accordion>
<Accordion title="Status pozostaje Aktywacja nie powiodła się">
Partner płatniczy odrzucił mandat. Tillor automatycznie spróbuje później ponownie. Jeśli to się nie uda na stałe, anuluj prośbę przez **Anuluj prośbę** i poproś klienta o ponowny podpis, ewentualnie z innym potwierdzeniem.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Pobranie kwoty z faktury" href="/betalingsverwerking/incasso" />
  <Card title="Odwołanie lub ponowne wysłanie mandatu" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Metody płatności" href="/betalingsverwerking" />
</Cards>


# Płatność online klienta (/pl-PL/betalingsverwerking/online)

Płatność online odbywa się na osobistej stronie płatności faktury. Klient otwiera stronę, wybiera metodę płatności i kończy płatność w swoim banku lub u wydawcy karty. Tillor współpracuje w tym celu z [Mollie](https://www.mollie.com), więc Mollie musi być połączone.

Nie ma osobnego przycisku wysyłania linku do płatności. Stronę udostępniasz przez powiadomienie albo osobisty adres URL faktury.

Zanim zaczniesz:

- Faktura jest zaksięgowana i ma otwartą kwotę. W przeciwnym razie klient nie ma czego płacić.
- Mollie jest połączone. Bez metod od Mollie klient widzi tylko przycisk płatności, zobacz [Problemy?](#problemen).
- Klient ma adres e-mail lub numer telefonu albo sam udostępniasz link.

## Wysyłanie klientowi linku do płatności [#de-betaallink-naar-de-klant-sturen]

<Steps>
<Step>
### Zaksięguj fakturę [#boek-de-factuur]
Płatność online jest możliwa tylko na zaksięgowanej fakturze z otwartym saldem.
</Step>
<Step>
### Wyślij powiadomienie [#verstuur-een-notificatie]
Kliknij **Wyślij powiadomienie** i wybierz kanał, na przykład e-mail lub SMS. Klient dostaje wiadomość z przyciskiem **Zobacz i zapłać online**.
</Step>
</Steps>

Wolisz udostępnić samodzielnie? Otwórz menu akcji (trzy kropki) na fakturze i wybierz **Osobisty URL**. Tillor kopiuje link do schowka. Monit z tym samym linkiem wysyłasz przyciskiem **Wyślij przypomnienie**, zobacz [Wyszukiwanie płatności](/betalingsverwerking/betalingen-bekijken#een-aanmaning-versturen). Klient chce zapłacić tylko część? Utwórz wtedy [link do płatności częściowej](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).

## Co widzi klient? [#wat-ziet-de-klant]

Klient otwiera stronę **Twoja faktura od** Twojej organizacji. Są na niej kwota do zapłaty, zestawienie pozycji faktury i przycisk do wyświetlenia faktury. Od tego ekranu klient przechodzi dalej w trzech krokach.

<Steps>
<Step>
### Zapłać [#betaal]
Klient dotyka **Zapłać** z kwotą. Jeśli jest przycisk Apple Pay, klient może nim zapłacić od razu.
</Step>
<Step>
### Wybierz metodę [#kies-een-methode]
Pod **Jak chcesz zapłacić?** są dostępne metody, takie jak iDEAL, Bancontact i karta kredytowa. Kolejność pochodzi od Mollie i dostosowuje się do języka klienta. Obowiązują przy tym te zasady:

- Metoda, której klient użył poprzednio na tym urządzeniu, ma dopisek **Ostatnio używane**.
- Dla klientów francuskojęzycznych Pay By Bank jest na górze z dopiskiem **Często najlepszy wybór**.
- Jeśli metoda ma awarię u Mollie, pojawia się przy niej ostrzeżenie, na przykład że metoda jest częściowo niedostępna lub w konserwacji. Klient nadal może spróbować tej metody, ale komunikat mówi, że może się nie udać. Treść awarii pochodzi od Mollie.
</Step>
<Step>
### Zakończ płatność [#rond-de-betaling-af]
To, co dzieje się potem, zależy od metody i urządzenia. Zobacz poniżej.
</Step>
</Steps>

### Kończenie na komputerze lub telefonie [#afronden-op-computer-of-telefoon]

<Tabs items={["Na komputerze", "Na telefonie"]}>
<Tab value="Na komputerze">
Przy iDEAL i Bancontact Tillor pokazuje kod QR pod **Zeskanuj, aby zapłacić przez**. Klient otwiera aplikację bankową na telefonie i skanuje kod. Strona sama przechodzi dalej, gdy tylko płatność wpłynie. Jeśli klient woli zapłacić na komputerze, może to zrobić przez **Zapłać w przeglądarce**.
</Tab>
<Tab value="Na telefonie">
Przy Bancontact Tillor pokazuje przycisk **Otwórz aplikację Bancontact**. Klient kończy płatność w aplikacji i wraca na stronę. Przez **Zapłać w przeglądarce** klient może też zapłacić na telefonie w przeglądarce.
</Tab>
</Tabs>

Przy innych metodach, takich jak karta kredytowa, Tillor przekierowuje klienta na stronę płatności partnera płatniczego, a potem sprowadza go z powrotem. Jeśli przekierowanie nie nastąpi samo, jest link, aby przejść dalej.

### Gdy się nie uda [#als-het-niet-lukt]

- **Wybierz inną metodę** przenosi klienta z powrotem na listę.
- **Zacznij od nowa** rozpoczyna nową płatność tą samą metodą. Przydatne, gdy klient anulował w aplikacji bankowej albo nic się nie stało.
- Przy nieudanej, anulowanej lub wygasłej płatności strona podaje wynik, a klient może wybrać inną metodę.

## Co jeszcze może pokazać strona [#wat-de-pagina-nog-meer-kan-tonen]

| Sytuacja | Co widzi klient |
|---|---|
| Faktura jest opłacona | **Opłacona w całości** z otrzymaną kwotą oraz potwierdzenie e-mailem |
| Bank rozpoczął przelew | **Potwierdzamy Twoją płatność**. Przy Pay By Bank trwa to zwykle kilka sekund, najdalej kilka dni roboczych |
| Pobranie SEPA jest zaplanowane | **Pobierane poleceniem zapłaty** z kwotą i datą. Klient nie musi nic robić. Opcji płatności tam nie ma, aby nikt nie zapłacił podwójnie |
| Kwota jest wyższa niż 2500 euro | Ostrzeżenie, że bank lub karta mogą odrzucić płatność online z powodu limitów, z numerem IBAN i komunikatem strukturalnym do przelewu |
| Płatność online nie jest możliwa dla tej faktury | **Zapłać przelewem** z danymi bankowymi |

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Osobisty link nie ma daty ważności. Klient może go więc otworzyć także później. Gdy tylko Mollie potwierdzi płatność, pojawia się ona na fakturze i w <UIPath>Administracja > Płatności</UIPath>. Faktura przechodzi w stan <Status tone="success">Płatny</Status>, gdy wpłynie cała kwota. Nie musisz niczego rejestrować samodzielnie. Zobacz [Wyszukiwanie płatności](/betalingsverwerking/betalingen-bekijken), aby poznać stany.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Klient nie widzi metod płatności">
Mollie nie przekazuje wtedy żadnych metod. Klient widzi tylko przycisk płatności i przechodzi nim bezpośrednio na stronę płatności Mollie. Jeśli tak zostaje, sprawdź połączenie z Mollie.
</Accordion>
<Accordion title="Klient zapłacił, ale faktura jest nadal otwarta">
Otwórz płatność w <UIPath>Administracja > Płatności</UIPath> i użyj **Synchronizuj**. Przy Pay By Bank potwierdzenie może trwać kilka dni roboczych.
</Accordion>
<Accordion title="Klient dostaje komunikat o awarii metody">
Mollie zgłasza, że metoda ma zakłócenia. Klient może wybrać inną metodę albo spróbować później.
</Accordion>
</Accordions>

Integrujesz własny system z płatnościami Mollie? Zobacz [Metadane Mollie](/ontwikkelaars/mollie-metadata).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Wyszukiwanie płatności" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mandat SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Płatność terminalem (/pl-PL/betalingsverwerking/terminal)

Metodą płatności **Terminal** wysyłasz kwotę pozostałą do zapłaty z faktury na terminal płatniczy przy recepcji. Klient płaci kartą lub telefonem, a Tillor księguje płatność, gdy tylko terminal ją zakończy.

Tillor jest wyłącznym partnerem technologicznym [Mollie](https://www.mollie.com) w zakresie płatności terminalem. Tillor dostarcza terminale Mollie i razem z Tobą konfiguruje Mollie Connect, urządzenie oraz powiązanie z fakturami. Pytania o płatności terminalem przy recepcji trafiają więc do Tillor.

<Callout type="info" title="Tylko terminale Mollie">
Tillor nie łączy terminali Worldline, CCV ani innych. Jeśli masz już taki terminal, otrzymasz od nas urządzenie Mollie. Dzięki temu płatności online, płatności terminalem i [raport płatności](/boekhouden/betalingsrapporten) tworzą jeden łańcuch.
</Callout>

## Rozpoczęcie płatności terminalem [#een-pinbetaling-starten]

<Steps>
<Step>
### Otwórz ekran płatności [#open-het-betaalscherm]
Otwórz zaksięgowaną fakturę z pozostałym saldem i kliknij **Dokonaj płatności**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-terminal.png" alt="Okno płatności - wybrana metoda płatności Terminal" />
</Step>
<Step>
### Wybierz Terminal [#kies-terminal]
W polu **Metoda płatności** wybierz opcję **Terminal**.
</Step>
<Step>
### Wybierz terminal [#kies-de-terminal]
Wybierz terminal przy swojej recepcji. Tillor pokazuje tylko terminale dostępne w danej chwili. Jeśli masz tylko jeden, jest już wybrany.
</Step>
<Step>
### Wpisz kwotę [#vul-het-bedrag-in]
Wpisz kwotę lub użyj przycisków 25%, 50%, 75% i 100%. Kwota częściowa przydaje się przy zaliczce albo gdy klient płaci część gotówką, a część kartą.
</Step>
<Step>
### Wyślij płatność [#stuur-de-betaling]
Kliknij **Wykonaj płatność**. Gdy Tillor wysyła prośbę do terminala, pojawia się ekran **Przetwarzanie płatności**.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Ekran na bieżąco śledzi płatność. Klient płaci na terminalu, a ekran przechodzi z **Płatność w toku** do **Płatność pomyślna**. Po kilku sekundach zamyka się sam, a saldo faktury do zapłaty jest już zaktualizowane.

Dopóki terminal czeka, możesz zaznaczyć dwa pola:

- **Drukuj A4 po opłaceniu** dodaje plik PDF faktury do kolejki drukarki A4, gdy tylko płatność się powiedzie. Opcja jest wyszarzona, jeśli żaden connector nie jest online.
- **Wyślij e-mail po płatności** wysyła fakturę e-mailem do klienta, gdy tylko płatność się powiedzie. Opcja jest wyszarzona, jeśli klient nie ma adresu e-mail.

Jeśli płatność się nie powiedzie lub wygaśnie, zobaczysz komunikat **Płatność nie powiodła się** albo **Płatność wygasła**. Kliknij **Wyślij ponownie do terminala**, aby spróbować jeszcze raz.

## Ustawienie domyślnego terminala [#de-standaardterminal-instellen]

Tillor aktywuje terminal za pomocą Waszego konta Mollie. Po połączeniu z Mollie Tillor sam wybiera terminal, jeśli jest dokładnie jeden aktywny terminal. Inny wybierzesz w <UIPath>Ustawienia > Integracje</UIPath> przy Mollie, w polu **Domyślny terminal** (obok **Profil główny**). Tillor będzie wtedy proponować ten terminal przy płatności terminalem.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Terminala w polu Metoda płatności">
Metoda pojawia się dopiero wtedy, gdy Mollie jest połączone, a do konta należy terminal. Sprawdź połączenie w <UIPath>Ustawienia > Integracje</UIPath>.
</Accordion>
<Accordion title="Terminala brakuje na liście">
Tillor pokazuje tylko terminale, które są online i aktywne. Sprawdź, czy terminal jest włączony i połączony, a następnie spróbuj ponownie.
</Accordion>
<Accordion title="Nadal jest stara płatność w toku">
Po ponownej próbie może pozostać stara płatność ze statusem <Status tone="warning">Oczekująca</Status>. Anuluj ją w <UIPath>Administracja > Płatności</UIPath> przez **Anuluj** w menu akcji, aby faktura się zgadzała.
</Accordion>
<Accordion title="Awaria lub dodatkowa recepcja">
Napisz na **support@tillor.eu**.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Rejestrowanie płatności" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Grupy płatności" href="/betalingsverwerking/groepen" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Zajęcia miejsc (/pl-PL/bezettingen)

Zajęcie miejsca określa, że klient korzysta z danej działki (miejsca kempingowego, słupka z prądem itp.). Dopóki zajęcie trwa, Tillor automatycznie przypisuje klientowi zużycie z liczników na tej działce. Zajęciami zarządzasz w profilu klienta. Zacznij od [Utworzenie zajęcia miejsca](#een-bezetting-aanmaken).

<Callout type="info" title="Warto wiedzieć">
- Działka może być zajęta tylko przez jednego klienta naraz. Działki z aktywnym zajęciem nie są na liście wyboru.
- **Opłacone do** akceptuje tylko dzisiejszą lub późniejszą datę.
- Działki zajęcia nie można potem zmienić. Gdy klient się przeprowadza, zakończ zajęcie i utwórz nowe.
- Usunięcia zajęcia miejsca nie można cofnąć, ale zużycie do daty zakończenia zostaje zachowane i nadal można je zafakturować.
- Przy **Przedłuż zajęcie miejsca (faktura)** szkic faktury dostaje termin płatności 14 dni po utworzeniu.
- Tylko pola **Typ**, **Częstotliwość czynszu** i **Cena** mają charakter informacyjny. Nie sterują automatycznie rejestracją liczników ani fakturowaniem.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Zajęcie miejsca łączy trzy rzeczy: klienta, działkę i liczniki na tej działce. Dzięki temu Tillor wie, na czyje nazwisko trafia zużycie.

```mermaid
flowchart LR
  K[Klient] --> B[Zajęcie miejsca]
  B --> T[Działka]
  T --> M[Liczniki na działce]
  M --> V[Okres zużycia klienta]
  V --> F[Faktura]
  B -->|Przedłuż zajęcie miejsca| F
```

Przy tworzeniu Tillor zapisuje początkowe odczyty liczników, a przy zakończeniu końcowe. Zużycie pomiędzy nimi należy do klienta. Nowe zajęcie na tej samej działce rozpoczyna nowy okres.

## Przeglądanie zajęć miejsc [#bezettingen-bekijken]

Otwórz profil klienta przez <UIPath>Klienci > Przegląd</UIPath> i przejdź do karty **Zawody** na zakładce **Przegląd**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Zajęcia miejsc w profilu klienta" />

- Tabela pokazuje dla każdego zajęcia **Działka**, **Typ**, **Częstotliwość czynszu**, **Cena**, **Status** i **Opłacone do**, ze względnym określeniem, np. „za 12 dni".
- Przy **Opłacone do** jest ikona informacji z **Zafakturowane do** w podpowiedzi, jeśli ta data jest wypełniona lub równa **Opłacone do**.
- Za pomocą **Filtruj zajęcia miejsca...** szukasz po nazwie działki.
- Akcje dla każdego zajęcia (edycja, przedłużenie, usunięcie) znajdują się w menu z trzema kropkami na końcu wiersza.

## Utworzenie zajęcia miejsca [#een-bezetting-aanmaken]

Zanim zaczniesz:

- Działka musi być wolna. Jeśli nie ma jej na liście, jest już zajęta. Zobacz Problemy na końcu.
- Jeśli działka ma liczniki, przygotuj początkowe odczyty. Jeśli niczego nie wpiszesz, Tillor przyjmie ostatni znany odczyt.

<Steps>
<Step>
### Otwórz profil klienta [#open-het-klantprofiel]
Przejdź do <UIPath>Klienci > Przegląd</UIPath>, otwórz klienta i przejdź do karty **Zawody**.
</Step>
<Step>
### Kliknij Utwórz zajęcie miejsca [#klik-op-bezetting-aanmaken]
Przycisk znajdziesz na pasku narzędzi tabeli. Otworzy się okno.
</Step>
<Step>
### Wpisz dane [#vul-de-gegevens-in]
Wymagana jest tylko **Działka**. Reszta jest opcjonalna.

- **Działka**: wybierz przez **Wybierz działkę**. Na liście są tylko dostępne działki. Jeśli żadna nie jest dostępna, zobaczysz **Nie znaleziono dostępnych działek.**
- **Opłacone do (opcjonalnie)**: do kiedy klient zapłacił z góry. Wybierasz dzisiaj lub później.
- **Zafakturowane do (opcjonalnie)**: zostaw puste, aby podążało za tą samą datą co **Opłacone do**, albo wybierz własną datę.
- **Typ**: **Własne zakwaterowanie** (domyślnie) lub **Wynajmowana przyczepa**.
- **Częstotliwość czynszu (opcjonalnie)**: jedna z opcji ustawionych przez Twoją organizację, każda z miesiącem początkowym i liczbą miesięcy (na przykład start w styczniu, 6 miesięcy). Wybierz **Bez częstotliwości**, jeśli nie chcesz jej zapisywać.
- **Opis (opcjonalnie)**: objaśnienie, na przykład ustalenia dotyczące stawek.
- **Cena**: zajęcie przejmuje cenę działki. Za pomocą **Nadpisz cenę dziedziczoną z działki** podajesz własną cenę.
- **Początkowe odczyty liczników (opcjonalnie)**: pojawia się, gdy działka ma liczniki. Jeśli nie ma liczników, zobaczysz **Brak powiązanych liczników**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu akcji zajęcia miejsca z opcjami Edytuj, Przedłuż i Usuń" />
</Step>
<Step>
### Potwierdź [#bevestig]
Kliknij **Utwórz zajęcie miejsca**, aby zapisać.
</Step>
</Steps>

### Wpisywanie odczytów liczników [#meterstanden-invullen]

<Tabs items={["Licznik ręczny", "Licznik automatyczny"]}>
<Tab value="Licznik ręczny">
Wpisz odczyt samodzielnie na zakładce **Ręcznie**. Pole pokazuje jako przykład ostatni znany odczyt. Jeśli są wcześniejsze odczyty, możesz też przez **Wybierz** wybrać istniejący odczyt.
</Tab>
<Tab value="Licznik automatyczny">
Licznik, który sam przesyła odczyty, nie pozwala na ręczne wpisywanie. Wybierz istniejący odczyt przez **Wybierz odczyt**.
</Tab>
</Tabs>

Jeśli wpiszesz odczyt niższy niż poprzednio zapisany, Tillor pokaże ostrzeżenie. Możesz mimo to potwierdzić niższą wartość lub poprawić wpis.

### Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Zajęcie miejsca jest od razu aktywne i widnieje w tabeli w profilu klienta.
- Tillor rozpoczyna dla każdego licznika na działce okres zużycia dla tego klienta. Nowe odczyty liczników liczą się odtąd jako zużycie klienta.
- Działka nie jest już dostępna dla innego zajęcia.

## Edycja zajęcia miejsca [#een-bezetting-bewerken]

<Steps>
<Step>
### Otwórz menu zajęcia [#open-het-menu-van-de-bezetting]
Kliknij menu z trzema kropkami przy zajęciu i wybierz **Edytuj**.
</Step>
<Step>
### Zmień pola [#pas-de-velden-aan]
Możesz zmienić **Typ**, **Częstotliwość czynszu**, **Opis**, **Opłacone do**, **Zafakturowane do** i **Cena**. **Działka** jest tylko do odczytu. Jeśli Twoja organizacja ma [pola niestandardowe](/eigen-velden) dla zajęć miejsc, znajdują się na dole okna.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-edit-dialog.png" alt="Okno Edytuj zajęcie miejsca" />
</Step>
<Step>
### Zapisz [#sla-op]
Kliknij **Zapisz zmiany**. Zmiana jest widoczna z zestawieniem przed/po na zakładce **Zdarzenia** klienta.
</Step>
</Steps>

## Zakończenie zajęcia miejsca [#een-bezetting-beëindigen]

Zakończenie usuwa powiązanie między klientem a działką. Działka znów staje się dostępna.

<Steps>
<Step>
### Wybierz Usuń [#kies-verwijderen]
Kliknij menu z trzema kropkami przy zajęciu i wybierz **Usuń**. Otworzy się okno **Usuń zajęcie miejsca**.
</Step>
<Step>
### Wybierz datę i końcowe odczyty liczników [#kies-de-datum-en-de-eindmeterstanden]
Jeśli działka ma liczniki, możesz wpisać **Końcowe odczyty liczników (opcjonalnie)**. Najpierw wybierz w polu **Data** dzień, w którym zajęcie się kończy (dzisiaj lub wcześniej). Potem dla każdego licznika pojawi się pole na odczyt końcowy. Licznik ręczny wpisujesz przez **Ręcznie** albo wybierasz przez **Wybierz**. Licznik automatyczny zawsze wymaga istniejącego odczytu przez **Wybierz odczyt**.
</Step>
<Step>
### Potwierdź [#bevestig-1]
Kliknij **Usuń**. Tego nie można cofnąć.
</Step>
</Steps>

### Co dzieje się potem? [#wat-gebeurt-er-daarna-1]

- Tillor zamyka otwarte okresy zużycia klienta. Zużycie do daty zakończenia zostaje zachowane i nadal można je zafakturować.
- Działka jest znów dostępna dla nowego zajęcia.
- Zajęcie znika z tabeli.

## Fakturowanie: przedłużenie zajęcia miejsca [#facturatie-bezetting-verlengen]

Za pomocą **Przedłuż zajęcie miejsca (faktura)** tworzysz szkic faktury na kolejny okres zajęcia, na przykład roczną opłatę za miejsce stałe. Możesz to zrobić dla jednego zajęcia albo dla wszystkich zajęć klienta naraz.

Zanim zaczniesz: musi istnieć co najmniej jeden produkt z akcją **Przedłuż zajęcie miejsca** (często opłata za miejsce stałe). Zobacz [Produkty](/producten).

<Steps>
<Step>
### Uruchom akcję [#start-de-actie]
<Tabs items={["Jedno zajęcie", "Wszystkie zajęcia"]}>
<Tab value="Jedno zajęcie">
Otwórz menu z trzema kropkami przy zajęciu i wybierz **Przedłuż zajęcie miejsca (faktura)**.
</Tab>
<Tab value="Wszystkie zajęcia">
Kliknij na pasku narzędzi **Przedłuż wszystkie**. Wszystkie zajęcia trafiają na jeden szkic faktury, z jedną pozycją główną dla każdego zajęcia.
</Tab>
</Tabs>
</Step>
<Step>
### Wybierz, czy fakturujesz też zużycie [#kies-of-je-verbruik-meefactureert]
Zaznacz **Zafakturuj zaległe zużycie dla tej działki** (przy **Przedłuż wszystkie**: **Zafakturuj zaległe zużycie (wszystkie działki)**), jeśli chcesz zafakturować na tym samym szkicu faktury także niezafakturowane zużycie. Jeśli na danych licznikach nic nie jest otwarte, pozostają tylko pozycje przedłużenia zajęcia.
</Step>
<Step>
### Utwórz szkic faktury [#maak-de-conceptfactuur]
Kliknij **Utwórz szkic faktury**. Tillor używa pierwszego produktu z akcją **Przedłuż zajęcie miejsca** (alfabetycznie według nazwy) i buduje pozycje za Ciebie. Następnie uzupełnij okres na fakturze i zaksięguj, gdy będziesz gotowy.
</Step>
</Steps>

### Co dzieje się potem? [#wat-gebeurt-er-daarna-2]

- U klienta czeka szkic faktury, z komunikatem **Gotowe** i opisem tego, co utworzono.
- Gdy zaksięgujesz fakturę, Tillor ustawia **Zafakturowane do** na moment końca pozycji.
- Po opłaceniu Tillor aktualizuje **Opłacone do**. **Zafakturowane do** przesuwa się do przodu tylko wtedy, gdy wcześniej było przed tym momentem końca.

<Callout type="warn" title="Uwaga przy istniejącym szkicu">
Jeśli istnieje już szkic faktury, który przedłuża tę działkę, Tillor pokazuje **Sprawdź przed kontynuacją**. Drugi szkic może dać zdublowane pozycje albo pominąć okres. Otwórz istniejący szkic przez **Otwórz szkic ...** albo wybierz **Utwórz szkic mimo to**.
</Callout>

## Opłacone do, typ, częstotliwość czynszu i cena [#betaald-tot-type-huurfrequentie-en-prijs]

| Pole | Znaczenie |
|---|---|
| **Opłacone do** | Do kiedy klient zapłacił z góry. Przy tworzeniu lub edycji wybierasz dzisiaj lub później. |
| **Zafakturowane do** | Do kiedy zafakturowano. Jeśli zostawisz puste, widok podąża za **Opłacone do**. |
| **Typ** | Odróżnia własny pobyt od wynajmu. |
| **Częstotliwość czynszu** | Zapisuje rytm najmu na potrzeby kontroli administracyjnej. |
| **Cena** | Domyślnie podąża za działką, ale można ją zmienić dla każdego zajęcia. |

## Typowe scenariusze [#veelvoorkomende-scenarios]

### Nowy gość się melduje [#een-nieuwe-gast-checkt-in]

1. Znajdź klienta lub dodaj go.
2. W profilu klienta utwórz zajęcie miejsca na działce.
3. Wpisz początkowy odczyt licznika albo pozwól, by Tillor przyjął ostatni odczyt.
4. Tillor od tej chwili przypisuje zużycie z liczników na tej działce temu klientowi.

### Gość wyjeżdża [#een-gast-vertrekt]

1. Przy zajęciu wybierz **Usuń**.
2. Wybierz datę wyjazdu i wpisz końcowe odczyty liczników.
3. Potwierdź. Tillor zamyka okresy zużycia, a działka jest znów dostępna.

### Klient przenosi się na inną działkę [#een-klant-verhuist-naar-een-ander-terrein]

1. Zakończ bieżące zajęcie, podając końcowe odczyty liczników starej działki.
2. Utwórz nowe zajęcie na nowej działce z początkowymi odczytami liczników.
3. Tillor prowadzi okresy zużycia osobno dla każdej działki.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Działki nie ma na liście wyboru">
Na liście są tylko działki bez aktywnego zajęcia. Jeśli działkę ma jeszcze inny klient, najpierw zakończ to zajęcie. Jeśli nic nie jest dostępne, zobaczysz **Nie znaleziono dostępnych działek.** Jeśli brakuje wszystkich działek i widzisz **Coś poszło nie tak podczas ładowania działek.**, odśwież stronę.
</Accordion>
<Accordion title="Nie można utworzyć zajęcia, bo działka jest już zajęta">
Inny użytkownik był szybszy i zajął działkę. Odśwież stronę klienta, wybierz inną działkę albo najpierw zakończ zajęcie innego klienta.
</Accordion>
<Accordion title="Nie mogę wybrać daty z przeszłości przy Opłacone do">
Tak ma być. Przy tworzeniu lub edycji **Opłacone do** akceptuje tylko dzisiaj lub później.
</Accordion>
<Accordion title="Końcowe odczyty liczników nie pojawiają się przy Usuń">
Najpierw wybierz w polu **Data** dzień, w którym zajęcie się kończy. Potem pojawi się pole dla każdego licznika. Jeśli działka nie ma liczników, nie ma pola.
</Accordion>
<Accordion title="Nie mogę wpisać odczytu przy liczniku">
To licznik, który sam przesyła odczyty. Wybierz istniejący odczyt przez **Wybierz odczyt**. Jeśli widnieje **Brak dostępnych odczytów**, licznik nie przesłał jeszcze żadnego odczytu.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się utworzyć faktury">
Najczęściej nie istnieje produkt z akcją **Przedłuż zajęcie miejsca**. Utwórz go, zobacz [Produkty](/producten), i spróbuj ponownie. Jeśli przedłużasz wszystkie zajęcia naraz, sprawdź też, czy należą do tego samego klienta.
</Accordion>
<Accordion title="Tillor pokazuje Sprawdź przed kontynuacją przy przedłużaniu">
Istnieje już szkic dla tej działki albo działka jest zafakturowana do daty, która nie jest jeszcze opłacona. Przeczytaj komunikat. Przez **Utwórz szkic mimo to** kontynuujesz świadomie, a przez **Otwórz szkic ...** najpierw sprawdzasz istniejący szkic.
</Accordion>
<Accordion title="Przypadkowo usunięto zajęcie miejsca">
Tego nie można cofnąć. Utwórz nowe zajęcie na tej samej działce. Zużycie do daty zakończenia starego zajęcia zostało zachowane.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Zajęcie miejsca**: klient na działce przez pewien okres. Zobacz [zajęcie miejsca](/begrippen#bezetting).
- **Działka**: samo miejsce, z ewentualnymi licznikami. Zobacz [działka](/begrippen#terrein).
- **Opłacone do**: data, do której klient zapłacił z góry.
- **Zafakturowane do**: data, do której już zafakturowano.
- **Okres zużycia**: okres, w którym zużycie licznika jest przypisywane jednemu klientowi. Zobacz [partia zużycia](/begrippen#verbruiksbatch).
- **Częstotliwość czynszu**: rytm najmu, na przykład rocznie lub co pół roku.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Dodawanie klientów i zarządzanie nimi" />
  <Card title="Zarządzanie licznikami" href="/meterbeheer" description="Jak liczniki są odczytywane i powiązane z zajęciami miejsc" />
  <Card title="Partie zużycia" href="/meterbeheer/consumptie-batches" description="Jak okresy zużycia są prowadzone i fakturowane" />
  <Card title="Przykłady z praktyki" href="/praktijk" />
  <Card title="Pozyskanie klienta sezonowego" href="/praktijk/seizoensklant-binnenhalen" />
  <Card title="Zwalnia się przyczepa stała" href="/praktijk/stacaravan-komt-vrij" />
</Cards>


# VAT i podatki (/pl-PL/boekhouden/belasting)

Tutaj dowiesz się, jak VAT trafia na Twoje faktury i jak Tillor sprawdza numer VAT klienta. Kontrola odbywa się przez VIES, europejską usługę, w której można zweryfikować numer VAT.

## Stawki VAT [#btw-tarieven]

Stawki VAT ustawia się dla każdego produktu. Przejdź do **Administracja > Produkty** i otwórz produkt, aby wybrać **VAT %** spośród dostępnych stawek (domyślnie 0%, 6%, 9%, 12% i 21%).

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Lista produktów - kolumna VAT przy każdym produkcie" />

## Odwrotne obciążenie i inne reżimy bez VAT [#btw-verlegd-en-andere-regimes-zonder-btw]

Czasem nie naliczasz VAT, ale nie jest to zwykła stawka 0%: klient musi sam rozliczyć VAT albo dostawa jest zwolniona. Dlatego na liście wyboru **VAT %** przy produkcie, pod stawkami, znajduje się pięć reżimów. Gdy wybierzesz któryś z nich, produkt ma stawkę 0%, a Tillor wie dlaczego.

| Reżim | Kiedy | Rubryka w deklaracji VAT |
|--------|------|----------------------------|
| **Odwrotne obciążenie (usługi UE)** | Usługa dla klienta będącego podatnikiem VAT w innym kraju UE | 44 |
| **Odwrotne obciążenie (współwykonawca)** | Roboty w nieruchomościach dla belgijskiego klienta będącego podatnikiem VAT, który składa okresowe deklaracje | 45 |
| **Dostawa wewnątrzwspólnotowa** | Towary wysyłane do klienta będącego podatnikiem VAT w innym kraju UE | 46 |
| **Eksport poza UE** | Towary opuszczające UE | 47 |
| **Zwolnione z VAT** | Dostawa zwolniona ze względu na swój charakter (art. 44 belgijskiego kodeksu VAT) | 00 |

Reżim robi cztery rzeczy, których zwykła stawka 0% nie robi:

- **Na fakturze** przy pozycji stoi `0%*`, a pod sumami znajduje się ustawowa adnotacja o reżimie, na przykład *Btw verlegd: de btw is verschuldigd door de afnemer*. Jeśli na jednej fakturze są dwa reżimy, drugi dostaje `**`.
- **Księgowanie jest możliwe tylko z numerem VAT** przy obu reżimach odwrotnego obciążenia i przy dostawie wewnątrzwspólnotowej. Wpisz numer w profilu klienta; pojawi się też na fakturze.
- **Do księgowości** pozycja trafia z kodem reżimu, dzięki czemu ląduje we właściwej rubryce deklaracji VAT. Zobacz [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#btw-regimes).
- **Przez Peppol** pozycja otrzymuje kategorię VAT odpowiadającą reżimowi.

<Callout type="warn" title="O tym, który reżim ma zastosowanie, decydujesz sam">
Tillor nie sprawdza, czy klient lub dostawa uprawniają do danego reżimu. W razie wątpliwości zapytaj swojego księgowego.
</Callout>

## Weryfikacja numeru VAT [#btw-nummer-validatie]

Gdy wpisujesz numer VAT w profilu klienta, Tillor automatycznie sprawdza go przez europejską usługę VIES, jak tylko wybierzesz kraj.

### Jak to działa [#hoe-het-werkt]

1. Otwórz **Klienci > klient** (sekcja **Dane klienta**)
2. Ustaw **kraj** i wpisz numer VAT (np. `NL123456789B01` lub `BE0123456789`)
3. Tillor automatycznie weryfikuje numer (po krótkiej przerwie)
4. Przy poprawnym numerze VAT pojawia się zielony znaczek; kliknij go, aby zobaczyć dane firmy z VIES
5. Chcesz przejąć nazwę i adres? Kliknij **Zastosuj adres firmy** w tym oknie (nazwa firmy trafia do pola imienia)
6. Przy niepoprawnym numerze VAT pojawia się czerwona ikona z wyjaśnieniem

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Profil klienta - Dane klienta z polami VAT" />

<Callout type="info">
Weryfikacja VAT działa dla wszystkich krajów UE. Dla firm spoza UE możesz wpisać numer VAT ręcznie, bez weryfikacji.
</Callout>

### Obsługiwane kraje [#ondersteunde-landen]

Weryfikacja obsługuje wszystkie państwa członkowskie UE, w tym Holandię (NL), Belgię (BE), Niemcy (DE), Francję (FR) i wszystkie pozostałe kraje UE.

### Kod kraju w PDF faktury [#landcode-op-de-factuur-pdf]

W PDF faktury Tillor automatycznie uzupełnia brakujący kod kraju dla państw, w których jest to zwyczajowy zapis: jeśli przy belgijskim kliencie wpiszesz `0123456789`, na fakturze będzie `BE0123456789`. Dla Hiszpanii, Włoch i Portugalii tak się nie dzieje, ponieważ krajowy numer podatkowy zapisuje się tam bez kodu kraju (hiszpański NIF taki jak `B04876793` pozostaje więc bez zmian). Jeśli wpiszesz kod kraju samodzielnie w polu, zawsze zostanie on przejęty.

## Belgijscy klienci i Peppol [#belgische-klanten-en-peppol]

Dla belgijskich klientów z numerem VAT na karcie **Fakturowanie** musi być podany **Identyfikator Peppolu**, zanim będzie można księgować faktury. To obowiązek prawny przy fakturowaniu B2B w Belgii.

Więcej informacji znajdziesz w [dokumentacji Peppol](/boekhouden/peppol).

## VAT na fakturach [#btw-op-facturen]

Wszystkie pozycje faktury automatycznie pokazują właściwą stawkę VAT na podstawie powiązanego produktu. Na fakturze widzisz **Suma częściowa**, **VAT** i **Razem**; w PDF faktury znajduje się dodatkowo zestawienie według stawek VAT.

<Callout type="info" title="Zmiana VAT dla pojedynczej pozycji">
Masz uprawnienia do zmiany ustawień organizacji? Przejdź do **Ustawienia > Fakturowanie** i włącz **Lista rozwijana stawki VAT na liniach szkicu faktury**. Na **szkicach faktur** pojawi się wtedy kolumna do wyboru stawki dla każdej pozycji (opcje zależą od stawek skonfigurowanych dla Waszej organizacji). Po wybraniu produktu wartością początkową pozostaje stawka domyślna z produktu. W tej samej kolumnie wybierzesz też [reżim bez VAT](#btw-verlegd-en-andere-regimes-zonder-btw) dla jednej pozycji.
</Callout>

## Problemy? [#problemen]

<Accordions>
<Accordion title="Numer VAT klienta ma czerwoną ikonę">
Tillor nie mógł potwierdzić numeru przez VIES. Sprawdź kraj i numer. Dla firmy spoza UE możesz wpisać numer także bez weryfikacji.
</Accordion>
<Accordion title="Nie mogę zaksięgować faktury z odwrotnym obciążeniem">
Klient nie ma numeru VAT. Odwrotne obciążenie i dostawa wewnątrzwspólnotowa istnieją tylko dla klienta będącego podatnikiem VAT. Wpisz numer w <UIPath>Klienci > klient</UIPath>, w sekcji **Dane klienta**, i zaksięguj ponownie.
</Accordion>
<Accordion title="Nie mogę wysłać faktury z dwoma reżimami przez Peppol">
Faktura Peppol może zawierać tylko jeden powód braku VAT. Umieść pozycje każdego reżimu na osobnej fakturze.
</Accordion>
<Accordion title="Brakuje mi stawki VAT przy produkcie">
Możesz wybierać tylko spośród dozwolonych stawek, domyślnie 0%, 6%, 9%, 12% i 21%.
</Accordion>
<Accordion title="Nie mogę wybrać stawki VAT na pozycji faktury">
Kolumna ze stawkami jest tylko na szkicach faktur i tylko wtedy, gdy włączona jest opcja **Lista rozwijana stawki VAT na liniach szkicu faktury**.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Produkty" href="/producten" description="Przypisywanie stawek VAT do produktów" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Fakturowanie elektroniczne w Belgii" />
  <Card title="Faktury" href="/facturen" description="Tworzenie i księgowanie faktur" />
</Cards>


# Metody płatności (/pl-PL/boekhouden/betalingsrapporten/betaalmethodes)

Raporty płatności zawierają płatności z różnych źródeł. Do księgowości trafiają tylko **Mollie** i **przeksięgowania wewnętrzne**.

| Metoda | W raporcie Tillor | Do księgowości |
|---------|-------------------|------------------|
| [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | Tak (przez rozliczenie Mollie) | Tak |
| [Rachunki bankowe](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | Tak (w dniu płatności) | Nie |
| [Przelew wewnętrzny](/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) | Tak | Tak |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Raport płatności - płatności z różnych źródeł" />

```mermaid
flowchart LR
  Mollie[Mollie] --> R[Raport Tillor]
  Bank[Rachunki bankowe] --> R
  Internal[Przelew wewnętrzny] --> R
  R --> BH[Księgowość]
  Mollie --> BH
  Internal --> BH
```

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Rachunki bankowe" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Przelew wewnętrzny" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Przelewy wewnętrzne (/pl-PL/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers)

Za pomocą **Przelewu wewnętrznego** przenosisz kwotę pozostałą do zapłaty z jednej faktury na inną **zaksięgowaną** fakturę **tego samego klienta**. Tillor tworzy dodatnią płatność na fakturze, którą opłacasz, oraz powiązaną ujemną płatność na fakturze docelowej.

Zobacz [Przelew wewnętrzny - rejestrowanie](/betalingsverwerking/interne-overboeking), gdzie znajdziesz proces rejestracji krok po kroku ze zrzutami ekranu.

## W raportach płatności [#in-betalingsrapporten]

- Przelewy wewnętrzne trafiają do raportu płatności Tillor z dnia, w którym je zarejestrujesz (czas brukselski).
- Trafiają **także** do eksportu księgowego: razem z płatnościami Mollie, a **nie** razem z rachunkami bankowymi ani innymi metodami ręcznymi (gotówka, przelew, ...).
- W eksporcie księgowym każda pozycja ma postać `Tillor - Interne overboeking - {factuurnummer}` i jest powiązana z odpowiednią fakturą i klientem.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Rejestrowanie" href="/betalingsverwerking/interne-overboeking" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Rachunki bankowe" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Mollie (/pl-PL/boekhouden/betalingsrapporten/betaalmethodes/mollie)

Płatności Mollie (iDEAL, karta kredytowa, Bancontact, terminal itd.) są synchronizowane w Tillor i łączone z raportami płatności przez **rozliczenie Mollie** (settlement).

## Połączenie w Tillor [#koppelen-in-tillor]

1. Przejdź do **Ustawienia > Integracje** i wybierz **Mollie** z listy.
2. Wykonaj kroki Mollie OAuth, jeśli integracja nie jest jeszcze aktywna.
3. Na stronie szczegółów wybierz w sekcji **Profil witryny** **Profil główny** (profil witryny Mollie do płatności i synchronizacji). Opcjonalnie wybierz **Domyślny terminal** (terminal płatniczy, który Tillor domyślnie proponuje przy fakturach).
4. Kliknij **Zapisz**. Bez profilu głównego płatności Mollie w Tillor nie działają; terminal jest potrzebny tylko do płatności terminalem.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-marketplace-install.png" alt="Ustawienia > Integracje - Mollie na liście" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-connection-settings.png" alt="Ustawienia Mollie - Profil główny i Domyślny terminal" />

### Ikony statusu na listach wyboru [#statusiconen-in-de-keuzelijsten]

Po lewej stronie nazwy profilu i terminala znajduje się kolorowa ikona. To status w Mollie, a nie sama nazwa.

| Ikona | Profil witryny | Terminal |
|-------|----------------|----------|
| Zielona (ptaszek) | Zweryfikowano - nadaje się do płatności na żywo | Aktywny - gotowy do płatności terminalem |
| Pomarańczowa (zegar) | Jeszcze niezweryfikowany w Mollie | Oczekujący - jeszcze nieaktywny |
| Czerwona (zakaz) | Zablokowany | - |
| Szara | - | Nieaktywny |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-profile-select-open.png" alt="Otwarty Profil główny - ikona statusu obok nazwy profilu" />

## Rozliczenia Mollie [#mollie-settlements]

Dopóki Mollie nie wypłaciło płatności, widnieje ona jako **zaliczka** w otwartym raporcie roboczym. Dopiero przy zatwierdzeniu ostatecznym rozliczenie decyduje, do którego raportu płatność należy; zobacz [Płatności Mollie w wersji roboczej](/boekhouden/betalingsrapporten#mollie-betalingen-op-het-concept).

Dla **dnia raportu D** Tillor szuka rozliczenia w tej kolejności:

1. Rozliczenie **utworzone w dniu D**
2. W przeciwnym razie rozliczenie **utworzone w dniu D+1** (zwykle: obrót z dnia D jest wypłacany następnego ranka)

```mermaid
flowchart TD
  D[Dzień raportu D] --> E{Rozliczenie utworzone w D?}
  E -- tak --> F[Powiąż z raportem D]
  E -- nie --> G{Rozliczenie utworzone w D+1?}
  G -- tak --> F
  G -- nie --> H[Jeszcze brak Mollie w tym raporcie]
  F --> I[Jeden identyfikator rozliczenia na raport]
```

**Ustalone zasady:**

- Każdy identyfikator rozliczenia trafia do **najwyżej jednego** raportu płatności.
- Raport ma już rozliczenie? To powiązanie **zostaje**; Tillor go nie zastępuje.
- Brakuje zarówno D, jak i D+1 (np. weekend): raport może już istnieć tylko z płatnościami ręcznymi lub z rachunków bankowych; gdy Mollie opublikuje rozliczenie, codzienna synchronizacja uzupełni Mollie.

## Przykłady [#voorbeelden]

| Dzień raportu D | Rozliczenie utworzone w Mollie | Wynik |
|--------------|----------------------------------|-----------|
| Wt 20 maja | Wt 20 maja (`stl_aaa`) | `PAYR/2026/0140` (20 maja) otrzymuje `stl_aaa` |
| Wt 20 maja | Śr 21 maja wcześnie rano (`stl_bbb`) | `PAYR/2026/0140` (20 maja) otrzymuje `stl_bbb` (reguła D+1) |
| Nd 18 maja | Pn 19 maja (`stl_ccc`) | `PAYR/2026/0138` (niedziela) otrzymuje `stl_ccc`, **nie** raport poniedziałkowy |
| Pn 19 maja | Pn 19 maja (`stl_ccc`) | Raport poniedziałkowy szuka własnego rozliczenia (`stl_ddd` we wtorek lub później), nie `stl_ccc` |
| So 17 maja | Brak rozliczenia w sob./niedz./pn. rano | Raport 17 maja: najpierw płatności ręczne i z rachunków bankowych; Mollie dojdzie, gdy pojawi się rozliczenie |
| Wt 20 maja | Raport istniał już bez rozliczenia | Następny przebieg o 09:00: rozliczenie zostaje powiązane z raportem z 20 maja, wraz z płatnościami |

**Konkretnie (D+1):** obrót z **wtorku 20 maja** znajduje się w rozliczeniu `stl_6necch`, utworzonym w **środę 21 maja** o 06:08. Tillor łączy `stl_6necch` z **`PAYR/2026/0140` (dzień raportu 20 maja)**, a nie z raportem z 21 maja.

**Istniejący raport:** czy `PAYR/2026/0140` był już w Tillor bez powiązanego rozliczenia Mollie i z dwiema pozycjami ręcznymi? Po synchronizacji `stl_6necch` zostanie powiązane; istniejące pozycje zostają; płatności Mollie z tego rozliczenia są dodawane.

**Już powiązany:** raport z **15 maja** ma już `stl_old`. Tillor **nie** zmienia tego identyfikatora. Pojedyncze płatności Mollie z tym samym identyfikatorem rozliczenia trafiają mimo to do raportu, który to rozliczenie już ma.

## Synchronizacja na istniejących raportach [#synchronisatie-op-bestaande-rapporten]

Po utworzeniu brakujących raportów Tillor szuka **wyłącznie raportów bez powiązanego rozliczenia Mollie** w przesuwającym się oknie od **jednego miesiąca kalendarzowego przed wczoraj** do wczoraj. Raporty, które mają już rozliczenie Mollie, **nie** są przy tym ponownie pobierane z listy rozliczeń Mollie.

```mermaid
flowchart TD
  start[Synchronizacja<br/>pn-sob 09:00] --> scope[Dzień raportu od<br/>miesiąca przed wczoraj do wczoraj]
  scope --> nullOnly[Tylko raporty<br/>bez rozliczenia Mollie]
  nullOnly --> U{Szukaj rozliczenia dla D lub D+1}
  U -- znaleziono --> V[Zapisz rozliczenie]
  U -- brak --> W[Brak kroku Mollie]
  V --> X[Powiąż niepowiązane płatności Mollie<br/>z rozliczenia]
  X --> Z[Płatności z tym samym<br/>identyfikatorem rozliczenia w tym raporcie]
```

Płatności, które mają już identyfikator rozliczenia z Mollie, ale nie są jeszcze w żadnym raporcie, trafiają do raportu z tym samym identyfikatorem rozliczenia.

## Płatności Mollie w Tillor [#mollie-betalingen-in-tillor]

Tillor pobiera płatności Mollie **co 15 minut** (dla każdej organizacji z aktywną integracją Mollie). Dodatkowo działają webhooki Mollie: płatność od razu otrzymuje status **Zapłacono**, **Zwrócono pieniądze** lub **Opłata zwrotna**, także gdy powstała poza Tillor (na przykład na terminalu). W razie wątpliwości lub pominiętego webhooka użyj **Synchronizuj** w menu akcji płatności.

Płatność trafia do raportu, jeśli:

- znajduje się w powiązanym **rozliczeniu** (lista z Mollie), lub
- płatność ma już identyfikator rozliczenia należący do raportu.

| Typ w raporcie | Znaczenie |
|-----------------|-----------|
| Znana | Płatność powiązana z fakturą w Tillor |
| Nieznana | Brak powiązania z fakturą w Tillor → konto przejściowe 499000, chyba że przesyłasz dane księgowe przez Mollie |

Płatności z rozliczenia, które **nie** istnieją w Tillor, pojawiają się w raporcie jako nieznana płatność Mollie.

W raporcie płatności powiązane płatności Mollie widzisz w tabeli **Płatności**:

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Szczegóły raportu płatności - płatności i Wyślij do księgowości" />

## Metadane Mollie [#mollie-metadata]

Masz kasę lub inny system, który sam tworzy płatności Mollie? Możesz sterować Tillor przez metadane tej płatności: powiązanie z fakturą lub [grupą płatności](/betalingsverwerking/groepen) albo bezpośrednio z księgowością. Pola opisano w [metadanych Mollie](/ontwikkelaars/mollie-metadata).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Raporty płatności" href="/boekhouden/betalingsrapporten" />
  <Card title="Grupy płatności" href="/betalingsverwerking/groepen" />
  <Card title="Rachunki bankowe" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Przelewy wewnętrzne" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Metadane Mollie (API)" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Rachunki bankowe (/pl-PL/boekhouden/betalingsrapporten/betaalmethodes/ponto)

Integracja bankowa łączy się z Twoim rachunkiem bankowym przez open banking i automatycznie pobiera transakcje.

## Jak to działa [#hoe-het-werkt]

1. **Transakcje**: co 5 minut Tillor pobiera transakcje bankowe z Twojego banku
2. **Komunikat strukturalny**: odczytywany jest +++123/4567/89002+++ lub numer faktury (INV/2024/0001)
3. **Powiązanie**: Tillor szuka pasującej faktury → płatność zostaje utworzona i powiązana
4. **Zdublowany przelew ręczny**: jeśli na tej samej fakturze jest już ręczny przelew na tę samą kwotę, zostaje usunięty, żeby płatność nie liczyła się podwójnie
5. W Tillor widzisz taką płatność jako **przelew bankowy**

## Połączenie [#koppelen]

Integracja nazywa się **Rachunki bankowe** i znajduje się w <UIPath>Ustawienia > Integracje > Rachunki bankowe</UIPath>. Wpisujesz **Identyfikator klienta** i **Client Secret**; administrator Tillor pomoże Ci w konfiguracji i poprowadzi przez wdrożenie.

## Przeglądanie transakcji bankowych [#banktransacties-bekijken]

Zaimportowane transakcje bankowe znajdziesz w **Administracja > Transakcje bankowe**. Ta strona jest widoczna tylko dla użytkowników z uprawnieniem **Wyświetlanie transakcji bankowych**. Bez tego uprawnienia nie zobaczysz strony w menu.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-list.png" alt="Lista transakcji bankowych z kolumną Faktura" />

W tabeli **Transakcje** kolumna **Faktura** znajduje się między **Data waluty** a **Tytuł przelewu**:

- Transakcja jest już przypisana do faktury? Zobaczysz numer faktury jako link (np. `INV/2026/0001`).
- Brak powiązania? Otwórz menu akcji (trzy kropki) na końcu wiersza i wybierz **Przypisz do faktury**. W razie potrzeby Tillor najpierw utworzy płatność i powiąże ją z transakcją. Potrzebujesz do tego uprawnienia **Przypisz płatność do faktury**; bez niego ta akcja nie pojawi się w menu.
- Transakcja jest już przypisana do faktury? Otwórz to samo menu akcji i wybierz **Odłącz od faktury**, aby usunąć powiązanie (zarówno ręczne, jak i automatycznie dopasowane).

Kliknij ikonę (i) przy IBAN, aby otworzyć panel szczegółów tej transakcji: kwota, data waluty, kontrahent i IBAN, komunikat, dane wyciągu z rachunku (referencja banku, referencja zleceniodawcy, numer karty, ...), powiązana faktura, płatność i raport płatności oraz referencje. Menu akcji znajduje się także na górze tego panelu.

W menu akcji wybierzesz ponadto:

- **Utwórz zadanie**, aby powiązać zadanie z transakcją, na przykład w celu ręcznego przetworzenia płatności. Zadanie pokazuje transakcję jako powiązany element; kliknij ją, aby otworzyć panel szczegółów. Zobacz [Powiązane elementy](/taken/taakdetails#gekoppelde-items).
- **Kopiuj link**, aby uzyskać link otwierający stronę **Transakcje bankowe** z panelem szczegółów tej transakcji, na przykład do wklejenia w komentarzu lub wiadomości.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-assign-dialog.png" alt="Okno Przypisz do faktury przy transakcji bankowej" />

Tę samą kolumnę **Faktura** zobaczysz w **raporcie płatności** w tabeli **Transakcje konta bankowego**, o ile masz prawo odczytu.

## Odłączanie [#ontkoppelen]

W **Administracja > Transakcje bankowe** (oraz w raporcie płatności w **Transakcje konta bankowego**) otwórz menu akcji na powiązanym wierszu i wybierz **Odłącz od faktury**. Działa to zarówno dla transakcji powiązanych ręcznie, jak i dopasowanych automatycznie.

W **Administracja > Płatności** opcja **Odłącz od faktury** jest tylko przy płatnościach, które ręcznie powiązano z fakturą lub przeniesiono. Dzięki temu nie usuniesz przypadkiem poprawnego automatycznego powiązania z poziomu przeglądu płatności.

<DocScreenshot src="/screenshots/betalingen/payment-unassign-menu.png" alt="Menu akcji płatności z opcją Odłącz od faktury" />

## Ręczna synchronizacja [#handmatig-synchroniseren]

W **Administracja > Transakcje bankowe** i w **raporcie płatności** (tabela **Transakcje konta bankowego**) jest przycisk **Synchronizuj konto bankowe**, jeśli integracja bankowa jest zainstalowana i masz uprawnienie **Synchronizacja transakcji bankowych**. Za jego pomocą zlecasz świeżą synchronizację bankową; Tillor importuje potem nowe transakcje i próbuje je powiązać z fakturami.

Bez integracji bankowej lub bez tego uprawnienia przycisk się nie pojawia. Tillor importuje nowe transakcje także automatycznie, co 5 minut.

Oba uprawnienia ustawisz w **Ustawienia > Użytkownicy i uprawnienia** (grupa **Transakcje bankowe**).

## W raportach płatności [#in-betalingsrapporten]

Przelewy bankowe **trafiają** do raportu płatności Tillor z dnia płatności (Bruksela), razem z płatnościami ręcznymi z tego dnia. **Nie** trafiają do eksportu księgowego: tylko Mollie i przelewy wewnętrzne. Integracja bankowa służy przede wszystkim do automatycznego powiązania z fakturami w Tillor.

<Callout type="idea" title="Automatyczne powiązanie">
Klient robi przelew z komunikatem strukturalnym → Tillor pobiera go z Twojego banku → faktura zostaje dopasowana → płatność + faktura opłacona.
</Callout>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Przelewy wewnętrzne" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Admisol (/pl-PL/boekhouden/betalingsrapporten/boekhoudsystemen/admisol)

Admisol to program księgowy, który Tillor obsługuje przy wysyłaniu raportów płatności. Raporty płatności są konwertowane do XML Admisol i wysyłane do Admisol automatycznie lub ręcznie.

## Instalacja [#installatie]

1. Przejdź do **Ustawienia** (oznaczenie **1** na zrzucie ekranu) i wybierz **Integracje**.
2. Znajdź **Admisol** na liście integracji (oznaczenie **2**) i otwórz stronę szczegółów.
3. Na stronie szczegółów wpisz **Identyfikator firmy** i **Klucz usługi internetowej** (dane z Admisol) i kliknij **Zainstaluj**.

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-marketplace-install.png" alt="Ustawienia > Integracje - Admisol na liście" />

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-credentials-dialog.png" alt="Szczegóły Admisol - Identyfikator firmy i Klucz usługi internetowej" />

## Automatyczne wysyłanie [#automatisch-versturen]

Gdy raport płatności **zmienia się merytorycznie** (na przykład po powiązaniu płatności lub po **Przelicz raport**):

1. Tillor sprawdza, czy Admisol jest zainstalowany dla organizacji
2. Raport jest konwertowany do XML Admisol
3. XML jest wysyłany do Admisol

Przy **codziennym tworzeniu** (09:00) Tillor przechodzi przez brakujące dni **od najstarszego do najnowszego**. Każdy nowy raport trafia do Admisol dopiero wtedy, gdy poprzedni raport otrzymał odpowiedź (akceptację lub odrzucenie). Jeśli wysłanie się nie uda, Tillor zatrzymuje się dla tej organizacji do następnego przebiegu.

[Raport roboczy](/boekhouden/betalingsrapporten#concept-en-definitief) bieżącego dnia trafia do Admisol już wtedy, gdy znajduje się w nim płatność Mollie lub przelew wewnętrzny, a potem tylko ponownie, gdy zmieni się księgowanie. Płatności gotówką w wersji roboczej nie powodują wysłania. Płatności Mollie w wersji roboczej są księgowane przeciwnie na dostawcę Mollie **bez odwołania do dokumentu**; Admisol księguje to jako **zaliczkę** („jeszcze do otrzymania"). Zwroty, których Mollie jeszcze nie potrąciło, stoją jako druga, osobna linia zaliczki na Mollie („jeszcze do potrącenia"). Przy wysłaniu ostatecznym zastępuje je prawdziwa wypłata z kosztami bankowymi, a płatności, których nie było w rozliczeniu, przechodzą jako zaliczka do następnej wersji roboczej. Dopóki raport jest wersją roboczą, w Admisol referencja dokumentu brzmi `PAYR/2026/0275 - Concept`; ten dopisek znika przy wysłaniu ostatecznym. Gdy raport zostaje zatwierdzony następnego dnia roboczego, Tillor wysyła go ponownie, teraz z rozliczeniem Mollie, pod **tym samym numerem dokumentu i tą samą datą księgowania**.

Przy nieudanym automatycznym wysłaniu otrzymasz powiadomienie, a na osi czasu zdarzeń raportu pojawi się wpis.

## Ręczne wysyłanie [#handmatig-versturen]

1. Przejdź do **Administracja > Raporty płatności**
2. Otwórz raport, który chcesz wysłać
3. Kliknij **„Wyślij do oprogramowania księgowego"**

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Raport płatności - Wyślij do oprogramowania księgowego" />

## Które płatności są wysyłane? [#welke-betalingen-gaan-mee]

Tylko płatności, w których:

- dostawcą jest **Mollie**, lub
- metodą płatności jest **Przelew wewnętrzny**.

Płatności z rachunków bankowych nie są wysyłane do księgowości.

## Częściowy zwrot (Mollie) [#gedeeltelijke-terugbetaling-mollie]

Jeśli powiązana płatność Mollie została częściowo lub w całości zwrócona, Tillor wysyła **pierwotną kwotę płatności** w raporcie płatności **rozliczenia Mollie, w którym płatność wpłynęła**. **Zwrot** trafia jako pozycja ujemna do raportu **rozliczenia, w którym Mollie potrąca zwrot** (etykieta *Terugbetaling*). Mogą to być późniejsze rozliczenia; każdy z kilku zwrotów ma własną pozycję w raporcie swojego rozliczenia. Dzięki temu raport zgadza się z tym, co Mollie faktycznie wypłaca. Ponieważ zwroty są księgowane tylko w dniu tego rozliczenia, nie powstaje dodatkowa pozycja na koncie przejściowym **499000** (*restant saldo*).

## Koszty bankowe na fakturę Mollie [#bankkosten-per-mollie-factuur]

Mollie potrąca swoje koszty z każdej wypłaty i fakturuje je raz w miesiącu. Dlatego Tillor księguje potrącone koszty **według okresu faktury**: każda pozycja nosi miesiąc, za który Mollie fakturuje koszty, na przykład *Bankkosten 01/2026*. Wypłata w pierwszych dniach miesiąca często zawiera jeszcze koszty z poprzedniego miesiąca; stoją one wtedy jako osobna pozycja w tym samym raporcie.

Wszystkie pozycje z tego samego okresu sumują się do kwoty faktury Mollie za ten miesiąc. Pozycje z bieżącego miesiąca pozostają otwarte, dopóki Mollie nie wystawi faktury.

### Na dostawcę Mollie [#op-de-leverancier-mollie]

Potrącone koszty nie są drugim kosztem: Mollie opłaca nimi własną fakturę. Dlatego Tillor księguje je na **dostawcę Mollie**, bez odwołania do dokumentu. Koszt i VAT trafiają do księgowości wyłącznie przez fakturę zakupu od Mollie. Co miesiąc na dostawcy Mollie rozliczasz fakturę z pozycjami *Bankkosten* z tego okresu; razem mają tę samą wartość. Korekta przez operację różną nie jest potrzebna.

Mollie zwykle potrąca koszty płatności już w chwili jej wpłynięcia, także jeśli wypłata następuje później. Raport roboczy księguje więc te koszty już według okresu faktury, a zaliczka na Mollie jest kwotą po kosztach. Płatność kartą, którą Mollie jeszcze wstrzymuje, nie ma jeszcze potrąconego kosztu: ten koszt pojawi się dopiero w raporcie z wypłatą. Do tego czasu miesiąc na dostawcy Mollie nie jest jeszcze kompletny.

**Nie rozliczaj w Admisol żadnych pozycji z raportu roboczego** (referencja dokumentu kończy się na *- Concept*). Przy wysłaniu ostatecznym Admisol zastępuje pozycje raportu, a rozliczenia na tych pozycjach mogą zniknąć. Może się to zdarzyć także wtedy, gdy ponownie wysyłasz raport ostateczny, nawet jeśli nic się nie zmieniło: sprawdź potem rozliczenia na dostawcy Mollie.

## Rezerwa salda [#balansreserve]

Mollie czasem zatrzymuje część wypłaty jako **rezerwę salda**: pieniądze, które Ci się należą, ale które Mollie tymczasowo wstrzymuje. Ponieważ nie jest to ani koszt, ani zwrot, Tillor księguje tę kwotę na **dostawcę Mollie** z etykietą *Balansreserve*, tak samo jak samą wypłatę. Dzięki temu pozostaje ona jako otwarta należność u Mollie, a nie na koncie przejściowym. Gdy Mollie później zwolni rezerwę, w raporcie tego rozliczenia pojawi się przeciwna pozycja *Balansreserve*, która ponownie zdejmuje należność. Nie musisz nic robić; na dostawcy Mollie obie pozycje się znoszą.

## Faktury już rozliczone w Admisol [#facturen-die-in-admisol-al-afgepunt-zijn]

Admisol odrzuca pozycję na fakturze lub korekcie, którą w Admisol ręcznie rozliczono z innym księgowaniem niż raport płatności. Tillor księguje wtedy pozycje tej jednej faktury na klienta **bez odwołania do dokumentu**, aby raport mimo to przeszedł. Kwoty i klient pozostają takie same; tylko powiązanie z fakturą rozliczasz ponownie samodzielnie w Admisol. Na osi czasu zdarzeń raportu w wysłanym XML widać, której faktury to dotyczy.

## Parametry księgowe [#boekhoudparameters]

Po instalacji parametry księgowe ustawiasz w **Ustawienia** w aplikacji Admisol (ten sam ekran co Identyfikator firmy i Klucz usługi internetowej). Znajdziesz tam m.in. typy dokumentów dla faktur i rozliczeń, kod dostawcy Mollie, domyślne konto księgi głównej dla pozycji faktur oraz domyślny dział. Brakujące pola otrzymują wartości domyślne Tillor.

Nieznane płatności Mollie są księgowane na konto przejściowe **499000**. Dla każdej płatności możesz też przekazać dział i rok obrotowy przez [metadane Mollie](/ontwikkelaars/mollie-metadata#directe-boekhoudmetadata-tillorbookkeeping).

### Reżimy VAT [#btw-regimes]

Pozycja faktury z [reżimem bez VAT](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) trafia do Admisol z własnym **profilem adresu podatkowego** i **kodem podatkowym**. Razem określają one, w której rubryce deklaracji VAT pozycja się znajdzie. Wartości domyślne to wartości nowego dossier Admisol:

| Reżim | Profil adresu podatkowego | Kod podatkowy | Rubryka |
|--------|------------------|----------|---------|
| Odwrotne obciążenie (usługi UE) | `EU` | `vd21` | 44 |
| Odwrotne obciążenie (współwykonawca) | `MED` | `v21` | 45 |
| Dostawa wewnątrzwspólnotowa | `EU` | `v21` | 46 |
| Eksport poza UE | `EXP` | `v21` | 47 |
| Zwolnione z VAT | `NA` | `v0` | 00 |

Jeśli Twoje dossier używa innych kodów, zmień je w parametrach księgowych: dla każdego reżimu jest pole na profil adresu podatkowego i pole na kod podatkowy. Kody swojego dossier znajdziesz w Admisol w **Instellingen > BTW-instellingen > Tax-relaties**. Karta klienta w Admisol zachowuje własny profil adresu podatkowego; tylko pozycja faktury otrzymuje profil z reżimu.

## Zobacz też [#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 (/pl-PL/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online)

Exact Online to program księgowy używany przez wiele holenderskich parków i ich biur. Tillor łączy z Exact Online **klientów**, **zaksięgowane faktury** i **raporty płatności**. Integracja jest **dostępna na zapytanie** - jeszcze nie jako samoobsługa w App Marketplace.

<Callout type="info" title="Na zapytanie">
Chcesz połączyć Tillor z Exact Online? Poproś o aktywację przez [demo](https://tillor.eu/demo) lub napisz na **support@tillor.eu**. Konfigurujemy integrację razem z Waszym księgowym.
</Callout>

## Co obejmuje integracja [#wat-de-koppeling-dekt]

Planowany eksport przebiega tym samym łańcuchem co w [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) i [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo). Dokładne mapowanie dzienników i kont przychodowych uzgadniamy przy aktywacji.

- **Klienci** z Tillor do Exact Online
- **Zaksięgowane faktury** (pozycje i VAT)
- **Raporty płatności** - tylko **Mollie** i **przelewy wewnętrzne**, tak jak w innych eksportach księgowych

Płatności z rachunków bankowych są w raporcie Tillor, ale nie trafiają do eksportu księgowego. Zobacz [systemy księgowe](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Jeszcze bez samoobsługi [#nog-geen-zelfbediening]

Exact Online nie znajdziesz jeszcze w **Ustawienia > Integracje**. Wybór administracji, mapowanie księgi głównej i pierwszy eksport odbywają się razem z supportem Tillor. Nie ma formularza instalacji do samodzielnego wypełnienia.

<Callout type="warn" title="Jeden aktywny system księgowy">
Tillor eksportuje do jednego programu księgowego na organizację. Jeśli używasz już Admisol lub Odoo, uzgodnimy, który system pozostaje aktywny.
</Callout>

## Zapytanie o integrację [#aanvragen]

1. Zanotuj swoją administrację w Exact Online (dywizję) i to, czy Twój księgowy ma wgląd.
2. Poproś o integrację przez [tillor.eu/demo](https://tillor.eu/demo) lub **support@tillor.eu**.
3. Tillor planuje aktywację i mapowanie dzienników oraz kont przychodowych.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Systemy księgowe" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Przegląd (/pl-PL/boekhouden/betalingsrapporten/boekhoudsystemen)

Tillor obsługuje integrację z oprogramowaniem księgowym w celu wysyłania raportów płatności. Raporty płatności są konwertowane do formatu Twojego programu księgowego (obecnie Admisol) i wysyłane automatycznie lub ręcznie. [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) jest dostępny na zapytanie.

## Obsługiwane systemy [#ondersteunde-systemen]

| System | Status |
|---------|--------|
| [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | Obsługiwany |
| [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | Klienci i zaksięgowane faktury |
| [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) | Na zapytanie |

## Informacje ogólne [#algemeen]

- **Automatycznie**: przy utworzeniu raportu płatności lub jego istotnej zmianie raport jest wysyłany do Admisol (tylko jeśli Admisol jest zainstalowany)
- **Ręcznie**: przez **Administracja > Raporty płatności** → otwórz raport → **Wyślij do księgowości**
- **Które płatności**: tylko **Mollie** i **przelewy wewnętrzne**. Rachunki bankowe są w raporcie Tillor, ale nie trafiają do eksportu księgowego.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Raport płatności - ręczne Wyślij do księgowości" />

## Zobacz też [#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 (/pl-PL/boekhouden/betalingsrapporten/boekhoudsystemen/odoo)

Integracja z Odoo w Tillor eksportuje do Odoo **klientów** i **zaksięgowane faktury**. Raporty płatności do Odoo pojawią się w jednym z kolejnych wydań. Do tego czasu użyj [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol), jeśli chcesz przekazywać raporty płatności automatycznie.

## Instalacja [#installatie]

1. Przejdź do **Ustawienia** i otwórz App Marketplace.
2. Znajdź kartę **Odoo** i kliknij **Zainstalować**.
3. Najpierw uzupełnij dane w sekcji **Połączenie**:
   - **Adres URL Odoo** - na przykład `https://mijnbedrijf.odoo.com` albo samo `mijnbedrijf` (Tillor sam dopisze adres `.odoo.com`)
   - **Nazwa użytkownika** - użytkownik z dostępem do API
   - **Klucz API** - klucz API (Odoo: profil użytkownika > Klucze API)
4. Kliknij **Przejdź do bazy danych**. Tillor pobierze dostępne bazy danych (albo pozwoli Ci wpisać nazwę ręcznie).
5. Wybierz bazę w polu **Baza danych** i dokończ instalację.

Przy zapisie Tillor testuje połączenie.

<Callout type="info" title="Jeden aktywny system księgowy">
Jeśli zainstalowane są jednocześnie Admisol i Odoo, Tillor używa do eksportu **Admisol** (stały priorytet). Instaluj Odoo tylko wtedy, gdy nie korzystasz już z Admisol.
</Callout>

## Parametry księgowe (aplikacja Odoo) [#boekhoudparameters-odoo-app]

Po instalacji ustawiasz parametry eksportu w **Ustawienia** aplikacji Odoo (obok adresu URL, bazy danych, użytkownika i klucza API). Tillor pobiera arkusze sprzedaży i konta przychodowe na żywo z Odoo; wybierasz je w polu wyszukiwania (kod i nazwa).

| Pole w aplikacji | Domyślnie | Znaczenie |
|---|---|---|
| **Kod arkusza sprzedaży** | INV | Arkusz sprzedaży w Odoo o tym kodzie |
| **Domyślne konto dochodów** | 700000 | Konto przychodowe, gdy pozycja faktury nie ma własnego numeru księgi głównej |
| **Publikuj faktury automatycznie** | wyłączone | Księgowanie w Odoo od razu po eksporcie |
| **Załącz fakturę w formacie PDF** | włączone | PDF faktury z Tillor jako załącznik faktury w Odoo |
| **Dołącz Peppol UBL** | włączone | Peppol UBL jako dodatkowy załącznik (tylko jeśli Tillor ma już ten UBL) |

Dla każdej pozycji faktury Tillor najpierw szuka w Odoo konta o tym samym kodzie co **numer księgi głównej** pozycji; jeśli go nie ma, używa domyślnego konta przychodowego. Dla VAT Tillor szuka w Odoo podatku sprzedaży o takiej samej stawce jak na pozycji.

### Reżimy VAT [#btw-regimes]

Pozycja faktury z [reżimem bez VAT](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), na przykład odwrotne obciążenie, potrzebuje w Odoo własnego podatku sprzedaży: zwykła stawka 0% trafia do niewłaściwej rubryki deklaracji. Dlatego w ustawieniach eksportu wpisz dla każdego używanego reżimu **nazwę podatku sprzedaży w Odoo**, dokładnie tak, jak jest w Odoo w **Księgowość > Konfiguracja > Podatki** (w belgijskim Odoo na przykład `0% EU S` dla usług UE). Pól jest pięć: odwrotne obciążenie (usługi UE), odwrotne obciążenie (współkontrahent), dostawa wewnątrzwspólnotowa, eksport poza UE i zwolnienie z VAT.

Jeśli pole reżimu jest puste albo podatek nie istnieje w Odoo, eksport tej faktury kończy się komunikatem o błędzie. Uzupełnij nazwę i wyślij fakturę ponownie.

## PDF faktury w Odoo [#factuur-pdf-in-odoo]

Przy włączonej opcji **Załącz fakturę w formacie PDF** (domyślnie włączona) Tillor przesyła ten sam PDF, który widzisz w Tillor. Przy nowym eksporcie dzieje się to **przed** zaksięgowaniem w Odoo, dzięki czemu podgląd po prawej stronie faktury można powiązać. Nazwa pliku odpowiada numerowi faktury z Tillor (np. `INV_2026_0001.pdf`). Tillor ustawia też ten PDF jako główny załącznik faktury w Odoo.

W **Zdarzenia** faktury z Tillor zobaczysz, czy eksport się udał, razem z klientem, fakturą, PDF i UBL.

- Jeśli faktura w Odoo już istnieje (ta sama referencja: numer faktury z Tillor), Tillor aktualizuje klienta, pozycje, daty i referencję płatności. Jeśli faktura była już zaksięgowana w Odoo, Tillor najpierw przywraca ją do wersji roboczej, zmienia dane i księguje ponownie, gdy opcja **Publikuj faktury automatycznie** jest włączona albo faktura była już zaksięgowana.
- Następnie załączniki PDF i UBL są zastępowane lub dodawane, o ile te opcje są włączone.
- Jeśli przesłanie nie powiedzie się po nowo utworzonej fakturze roboczej, ta faktura w Odoo jest usuwana, aby kolejny eksport mógł spróbować od nowa.

## Peppol UBL w Odoo [#peppol-ubl-in-odoo]

Przy włączonej opcji **Dołącz Peppol UBL** (domyślnie włączona) Tillor przesyła Peppol UBL jako dodatkowy załącznik faktury w Odoo. Nazwa pliku odpowiada numerowi faktury z Tillor (np. `INV_2026_0001.xml`).

- Tillor sam nie generuje UBL: plik jest dostępny dopiero po udanym dostarczeniu przez Peppol.
- Jeśli UBL nie jest jeszcze gotowy w chwili eksportu, Tillor pomija załącznik UBL; gdy tylko UBL się pojawi, zostanie dodany do istniejącej faktury w Odoo.
- Jeśli przesłanie UBL się nie powiedzie, cały eksport do Odoo **nie** kończy się błędem (w przeciwieństwie do PDF). Tylko błąd PDF po nowej fakturze cofa wersję roboczą w Odoo.

## Faktury [#facturen]

- Przy **księgowaniu** lub **ponownym księgowaniu** faktury Tillor eksportuje ją automatycznie do Odoo.
- Ręcznie: akcje faktury > eksport do księgowości (ten sam przycisk co w Admisol).
- Eksportowane są tylko faktury ze statusem **Zaksięgowano**.
- Jeśli w Odoo istnieje już faktura o tym samym numerze z Tillor, nie powstaje druga faktura. Tillor aktualizuje klienta, pozycje i daty na tej fakturze (na przykład po przeniesieniu do innego klienta albo ponownym zaksięgowaniu) i zastępuje załączniki PDF/UBL, gdy te opcje są włączone.
- Jeśli PDF faktury zmieni się po **płatności** (albo przy innej kwocie na dokumencie), Tillor zastępuje istniejący załącznik PDF w Odoo, gdy tylko nowy PDF będzie gotowy. Nie powstaje druga faktura w Odoo i żadna płatność nie jest księgowana w Odoo.

## Klienci [#klanten]

Klienci są w Odoo aktualizowani lub tworzeni z numerem klienta z Tillor jako referencją. Istniejący partnerzy z tym samym numerem są aktualizowani.

## Raporty płatności [#betalingsrapporten]

Automatyczne i ręczne wysyłanie raportów płatności do Odoo **nie jest jeszcze dostępne**. Codzienny proces raportów płatności pomija Odoo bez komunikatu o błędzie.

## Wymagania w Odoo [#vereisten-in-odoo]

- Arkusz sprzedaży o ustawionym kodzie (domyślnie `INV`)
- Konta księgi głównej o kodach zgodnych z pozycjami z Tillor albo domyślne konto przychodowe
- Opcjonalnie: stawki podatku sprzedaży w Odoo o tych samych procentach co w Tillor

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Systemy księgowe" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Przegląd (/pl-PL/boekhouden/betalingsrapporten)

**Raport płatności** to codzienne zestawienie płatności z jednego dnia kalendarzowego. Numeracja: `PAYR/YYYY/DDDD` (dzień roku, cztery cyfry; np. `PAYR/2026/0054`).

**Zawartość:** znane i nieznane płatności, wypłata z Mollie (jeśli dotyczy) oraz niepowiązane transakcje bankowe z Twoich rachunków bankowych. Wypłata z Mollie nazywa się w księgowości settlement: kwota, którą Mollie przelewa na Twój rachunek bankowy za serię płatności.

Z tymi raportami pracuje Twój księgowy. Nie musisz ich tworzyć ani zamykać. Zobacz też [Jak to się łączy?](/boekhouden#hoe-hangt-dit-samen).

## Wersja robocza i ostateczny [#concept-en-definitief]

Raport ma **status**:

| Status | Znaczenie |
|--------|-----------|
| **Wersja robocza** | Raport **bieżącego dnia**. Dzisiejsze płatności (przelewy wewnętrzne, gotówka, rachunki bankowe i Mollie) są już do niego przypisywane, a raport trafia już do księgowości. Płatności Mollie są w nim jako **zaliczka**: pieniądze, które Mollie jeszcze musi wypłacić. Nie ma jeszcze settlementu Mollie, a raport nie jest jeszcze automatycznie drukowany. |
| **Ostateczny** | Dzień jest zamknięty. Tillor powiązał settlement Mollie (jeśli dotyczy), wydrukował raport i wysłał wersję ostateczną do księgowości. |

Roboczy raport z dzisiaj powstaje automatycznie: podczas uruchomienia o 09:00 albo wcześniej, gdy tylko zarejestrujesz pierwszą ręczną płatność lub płatność z rachunku bankowego tego dnia. Nigdy nie musisz sam zamykać wersji roboczej; robi to Tillor przy najbliższym codziennym uruchomieniu po zakończeniu dnia.

Wersję roboczą poznasz po **szarym numerze raportu podkreślonym kropkami** i plakietce **Wersja robocza**, na liście (kolumna i filtr **Status**), na stronie szczegółów i wszędzie tam, gdzie jest link do raportu. PDF wersji roboczej ma w tytule **(wersja robocza)**. Numer raportu i data księgowania w księgowości pozostają takie same, gdy wersja robocza staje się ostateczna.

### Płatności Mollie w wersji roboczej [#mollie-betalingen-op-het-concept]

Każda opłacona płatność Mollie, którą Mollie jeszcze nie wypłaciło, trafia od razu do otwartego raportu roboczego. W księgowości suma widnieje jako **zaliczka u dostawcy Mollie**: dzięki temu w każdej chwili widzisz, ile jeszcze masz do odebrania od Mollie.

**Polecenie zapłaty SEPA, które jeszcze trwa**, liczy się tak samo, nawet gdy pobranie wyjdzie do Mollie dopiero za kilka dni. Faktura jest wtedy w Tillor już jako opłacona (w trakcie przetwarzania) i tak samo jest w księgowości. Jeśli pobranie się nie powiedzie albo zostanie anulowane, płatność znika z wersji roboczej.

Gdy wersja robocza staje się ostateczna, Tillor porównuje raport z settlementem Mollie:

- Płatności, które **są w settlemencie**, zostają w raporcie. Zaliczka zostaje zastąpiona prawdziwą wypłatą wraz z kosztami bankowymi.
- Płatności, których w nim **nie ma** (na przykład karta kredytowa z późniejszą wypłatą albo przychód po zamknięciu rozliczenia Mollie), przechodzą do **następnego raportu roboczego** i zostają tam jako zaliczka.
- Jeśli płatność z settlementu była już w późniejszej wersji roboczej, Tillor przenosi ją z powrotem do raportu tego settlementu.

Brane są pod uwagę tylko niedawne płatności: opłacone w ostatnim miesiącu i jeszcze bez settlementu w Mollie.

**Zwroty** liczą się od razu. Zwrot, którego Mollie nie potrąciło jeszcze z wypłaty, widnieje jako pozycja ujemna w otwartej wersji roboczej. W księgowości pozostają to dwie osobne zaliczki u Mollie: jedna za płatności do otrzymania i jedna za zwroty, które mają zostać potrącone; nie są one ze sobą kompensowane. Dotyczy to także sytuacji, gdy pierwotna płatność jest już w starszym, ostatecznym raporcie: Mollie potrąca wtedy kwotę z późniejszej wypłaty. Gdy settlement rozliczy zwrot, trafia on do raportu tego settlementu i znika z wersji roboczej.

<Callout type="info" title="Wersja robocza w księgowości">
Wersja robocza trafia do księgowości, gdy tylko znajdzie się w niej coś, co księgowość księguje (płatność Mollie albo przelew wewnętrzny). Potem Tillor wysyła ją ponownie tylko wtedy, gdy zmieni się księgowanie, za każdym razem pod tym samym numerem dokumentu. Zmiany są grupowane: wysyłka rusza około dziesięciu sekund po ostatniej zmianie, a najpóźniej po minucie, tak że na przykład przypisanie płatności do faktury daje jedną wysyłkę. Wersja robocza zawierająca tylko płatności gotówkowe albo płatności z rachunków bankowych nie jest więc wysyłana, a dodatkowa płatność gotówkowa nie wywołuje nowej wysyłki.
</Callout>

## Codzienne generowanie [#dagelijkse-generatie]

Każdego **dnia roboczego o 09:00** (od poniedziałku do soboty, strefa czasowa Europa/Bruksela) Tillor przetwarza wszystkie raporty od **1 stycznia do wczoraj**, których jeszcze brakuje albo które są jeszcze w wersji **roboczej**, **od najstarszego do najnowszego**: wersje robocze są zamykane, a brakujące dni od razu tworzone jako raport ostateczny. Przy każdym raporcie Tillor czeka na odpowiedź Admisol (sukces lub błąd), zanim przetworzy i wyśle kolejny. Następnie Tillor otwiera **raport roboczy z dzisiaj**. Dla każdej organizacji z aktywnym połączeniem z Mollie następuje potem **ograniczona** synchronizacja: raporty **bez** settlementu Mollie od **jednego miesiąca kalendarzowego przed wczoraj** do wczoraj (zobacz [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
```

### Co jest w raporcie? [#wat-zit-in-een-rapport]

| Źródło | Kiedy powiązane |
|------|-------------------|
| Płatności ręczne | Dzień kalendarzowy daty utworzenia (Bruksela) |
| Płatności z rachunków bankowych | Dzień kalendarzowy daty płatności (Bruksela) |
| Mollie | Settlement dla dnia raportu D (zobacz [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)) |

Płatności z rachunków bankowych **są** w raporcie Tillor za dany dzień, ale **nie** trafiają do eksportu księgowego (tylko Mollie i przelewy wewnętrzne).

### Wczoraj bez settlementu Mollie [#gisteren-zonder-mollie-settlement]

Raport z **wczoraj** ma jeszcze zostać zamknięty (albo dopiero utworzony), a Mollie nie ma jeszcze settlementu na wczoraj ani dzisiaj? Wtedy Tillor **czeka** do następnego dnia roboczego; do tego czasu raport pozostaje w wersji **roboczej**. Starsze dni bez settlementu dostają raport (ręczne płatności/rachunki bankowe); Mollie zostanie powiązane później przy synchronizacji.

<Callout type="warn" title="Weekend">
Przychód z soboty i niedzieli często dostaje settlement Mollie dopiero w poniedziałek rano. Należy on do raportu z **niedzieli** (reguła D+1), a nie do raportu z poniedziałku. Zobacz [przykłady na stronie Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).
</Callout>

## Przykłady [#voorbeelden]

| Sytuacja | Co widzisz |
|----------|-------------|
| Dzień roboczy, settlement następnego ranka | Raport z **wczoraj** dostaje Mollie z opóźnieniem (reguła D+1) |
| Dziś zarejestrowano przelew wewnętrzny | Jest od razu w **raporcie roboczym z dzisiaj** i trafia do księgowości |
| Dziś otrzymano płatność Mollie | Jest od razu w wersji roboczej, w księgowości jako zaliczka u Mollie |
| Płatność Mollie nie jest w settlemencie raportu | Przy zamykaniu przechodzi do następnej wersji roboczej |
| Raport z wczoraj jeszcze w wersji roboczej, brak settlementu | Tillor **czeka**, aż Mollie opublikuje (następny dzień roboczy 09:00); raport pozostaje wersją roboczą |
| Raport powstał bez Mollie | Kolejne uruchomienie o 09:00 uzupełni settlement i płatności |
| Raport miał już identyfikator settlementu | Identyfikator **zostaje**; można jeszcze powiązać tylko dodatkowe płatności |

Więcej przykładów z datami (weekend, podwójny settlement): [Mollie > Przykłady](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

## Otwieranie raportu płatności i nawigacja [#betalingsrapport-openen-en-navigeren]

1. Przejdź do **Administracja > Raporty płatności** (zielony znacznik **1** na zrzucie ekranu).
2. Otwórz raport z listy.
3. Na stronie szczegółów użyj strzałek na pasku akcji po prawej, aby przejść do poprzedniego lub następnego raportu.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Przegląd raportów płatności" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Szczegóły raportu płatności - przycisk do księgowości i strzałki nawigacji" />

Po najechaniu na strzałkę zobaczysz dodatkowy kontekst (numer raportu, datę i liczbę płatności) raportu, do którego przechodzisz.

Po prawej stronie szczegółów jest **Dziennik zdarzeń**. Zobaczysz tam, kiedy raport został utworzony, kiedy stał się ostateczny i czy został wysłany do księgowości.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Raport z wczoraj pozostaje Wersją roboczą">
Mollie nie opublikowało jeszcze wypłaty za wczoraj. Tillor czeka wtedy do następnego dnia roboczego o 09:00. Raport sam stanie się ostateczny, nie musisz nic robić.
</Accordion>
<Accordion title="Płatności nie ma w raporcie z dnia, którego się spodziewam">
Płatność trafia do raportu z dnia, w którym została otrzymana. Przy gotówce i przelewie jest to **Data otrzymania**, którą wpisano. Zmień tę datę przy rejestracji, zobacz [Gotówka i przelew](/betalingsverwerking/contant).
</Accordion>
<Accordion title="Płatność Mollie jest w następnym raporcie">
Płatność nie była w wypłacie tego raportu. Przechodzi do następnej wersji roboczej i zostaje tam jako zaliczka, dopóki Mollie nie wypłaci.
</Accordion>
<Accordion title="Raportu nie ma w mojej księgowości">
Wysyłane są tylko płatności Mollie i przelewy wewnętrzne. Raport zawierający wyłącznie płatności gotówkowe albo płatności z rachunków bankowych nie jest wysyłany. Błąd wysyłki znajdziesz w **Dzienniku zdarzeń** raportu.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Systemy księgowe" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Metody płatności" href="/boekhouden/betalingsrapporten/betaalmethodes" />
</Cards>

## Pojęcia [#begrippen]

- **Raport płatności**: dzienne zestawienie płatności z jednego dnia kalendarzowego, z numerem `PAYR/rok/dzień`.
- **Wersja robocza**: raport bieżącego dnia. Może się jeszcze zmienić.
- **Ostateczny**: dzień jest zamknięty, a raport został wysłany do księgowości.
- **Zaliczka**: płatność Mollie, której Mollie jeszcze nie wypłaciło.
- **Settlement**: wypłata od Mollie dla Ciebie.


# Przegląd (/pl-PL/boekhouden)

Tutaj przenosisz płatności i faktury z Tillor do swojego oprogramowania księgowego. Tillor zbiera płatności według dnia w raporcie płatności i przekazuje ten raport dalej, dzięki czemu Twój księgowy nie musi niczego przepisywać.

<Callout type="info" title="Warto wiedzieć">
- Na każdy dzień kalendarzowy powstaje jeden raport płatności. Raport z dzisiaj istnieje już jako **Wersja robocza** i staje się ostateczny, gdy tylko dzień się skończy.
- Tillor przetwarza raporty w każdy dzień roboczy (od poniedziałku do soboty) o 09:00 czasu belgijskiego.
- Do księgowości trafiają tylko płatności Mollie i przelewy wewnętrzne. Gotówka, przelewy i rachunki bankowe są w raporcie, ale nie są przekazywane dalej.
- Płatności Mollie są aktualizowane co 15 minut, rachunki bankowe co 5 minut.
- Mollie zwykle wypłaca następnego dnia. Weekend często dostaje wypłatę dopiero w poniedziałek rano.
- Tillor grupuje zmiany w wersji roboczej i wysyła ją około dziesięciu sekund po ostatniej zmianie, a najpóźniej po minucie.
- Belgijski klient z numerem VAT potrzebuje identyfikatora Peppol, zanim będzie można zaksięgować fakturę.
</Callout>

## Jak to się łączy? [#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]
```

- Płatność jest powiązana z fakturą. Zobacz [Faktury](/facturen).
- Każda płatność trafia do raportu z dnia, w którym została otrzymana.
- Płatność Mollie jest najpierw zaliczką w raporcie roboczym. Gdy Mollie wypłaci, ta zaliczka staje się prawdziwą wypłatą.
- Raport trafia do Twojego oprogramowania księgowego. Które systemy są obsługiwane, przeczytasz w [Systemy księgowe](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Co to robi? [#wat-doet-het]

- **Raporty płatności**: codzienne zestawienia z numerem `PAYR/YYYY/DDDD`, gdzie DDDD to dzień roku
- **Systemy księgowe**: połączenie z Admisol, Odoo dla klientów i faktur (raporty płatności do Odoo pojawią się później) oraz [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) na zapytanie
- **Metody płatności**: Mollie, rachunki bankowe i przelewy wewnętrzne

**Przykład:** przychód z **20 maja** zostaje wypłacony **21 maja** i jest w raporcie **`PAYR/2026/0140` (20 maja)**. Więcej przykładów: [przykłady Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

W aplikacji webowej płatności i faktury wyglądają jak poniżej.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Przegląd płatności - wszystkie płatności" />

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Przegląd faktur - wszystkie faktury" />

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Raporty płatności" href="/boekhouden/betalingsrapporten" />
  <Card title="Systemy księgowe" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Metody płatności" href="/boekhouden/betalingsrapporten/betaalmethodes" />
  <Card title="VAT i podatki" href="/boekhouden/belasting" />
  <Card title="Peppol" href="/boekhouden/peppol" />
  <Card title="Przykłady z praktyki" href="/praktijk" />
</Cards>

## Pojęcia [#begrippen]

- **Raport płatności**: dzienne zestawienie płatności z jednego dnia kalendarzowego.
- **Wersja robocza**: raport bieżącego dnia, który może się jeszcze zmienić.
- **Ostateczny**: zamknięty raport, który został wysłany do księgowości.
- **Wypłata (settlement)**: kwota, którą Mollie przelewa na Twój rachunek bankowy za serię płatności.
- **Zaliczka u Mollie**: pieniądze, które Mollie jeszcze musi Ci wypłacić, tak jak widnieją w księgowości.
- **Księga główna**: numer konta w Twojej księgowości. Zobacz [Produkty](/producten).
- **Peppol**: europejska sieć do wysyłania faktur bezpośrednio do systemu odbiorcy. Zobacz [Peppol](/boekhouden/peppol).


# Peppol (/pl-PL/boekhouden/peppol)

Przez Peppol wysyłasz fakturę bezpośrednio do systemu księgowego odbiorcy, bez PDF. Peppol to europejska sieć faktur elektronicznych. W Tillor dzieje się to automatycznie: jeśli klient ma identyfikator Peppol, faktura po zaksięgowaniu wychodzi sama.

## Kiedy używać Peppol? [#wanneer-gebruik-je-peppol]

Peppol jest obowiązkowy dla:

- **belgijskich faktur B2B** - wysyłania faktur do belgijskich firm z numerem VAT
- **zamówień publicznych** - fakturowania instytucji publicznych w większości krajów UE

Dla klientów holenderskich Peppol jest opcjonalny, ale obsługiwany.

<Callout type="warn">
Od 2026 roku Peppol jest obowiązkowy dla wszystkich faktur B2B w Belgii. Zadbaj o to, aby identyfikatory Peppol Twoich belgijskich klientów były poprawnie ustawione.
</Callout>

## Konfiguracja Peppol [#peppol-instellen]

### Peppol dla Twojej organizacji [#peppol-voor-je-organisatie]

Peppol używa **numeru VAT** i **adresu** Twojej organizacji. Sprawdź, czy te dane są poprawne w **Ustawienia**.

Przy pierwszej wysyłce przez Peppol Tillor automatycznie rejestruje Twoją organizację jako nadawcę w sieci Peppol.

<Callout type="info">
Skontaktuj się z supportem Tillor, jeśli Peppol nie jest jeszcze dostępny dla Twojej organizacji.
</Callout>

### Ustawianie identyfikatora Peppol dla klienta [#peppol-id-instellen-voor-een-klant]

Dla każdego klienta, któremu chcesz wystawiać faktury przez Peppol:

1. Przejdź do *Klienci > [klient] > Fakturowanie*
2. Otwórz **Ustawienia faktury**
3. Wpisz **Identyfikator Peppolu** albo wybierz odbiorcę za pomocą ikony wyszukiwania
4. Kliknij **Zapisz**

<Callout type="warn">
Masz belgijskiego klienta z numerem VAT? Wtedy nie zaksięgujesz faktury, dopóki nie ustawisz identyfikatora Peppol.
</Callout>

## Wyszukiwanie odbiorcy Peppol [#een-peppol-ontvanger-opzoeken]

Nie znasz identyfikatora Peppol klienta? Użyj ikony wyszukiwania po lewej stronie pola:

1. Przejdź do *Klienci > [klient] > Fakturowanie*
2. Kliknij ikonę wyszukiwania po lewej stronie **Identyfikatora Peppolu**
3. Tillor wyszukuje automatycznie na podstawie numeru VAT klienta
4. Wybierz właściwego odbiorcę z wyników

<Callout type="info">
Nie wszystkie firmy są zarejestrowane w sieci Peppol. Jeśli firma nie zostanie znaleziona, nadal możesz wysłać fakturę e-mailem.
</Callout>

## Wysyłanie faktur przez Peppol [#facturen-via-peppol-versturen]

Gdy klient ma ustawiony identyfikator Peppol, Tillor po zaksięgowaniu wysyła fakturę automatycznie przez Peppol:

1. Utwórz fakturę jak zwykle
2. Sprawdź, czy **Identyfikator Peppolu** klienta jest poprawnie ustawiony
3. Sprawdź pozycje i kwoty na fakturze roboczej, a następnie kliknij **Zaksięguj fakturę**

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Faktura robocza z przyciskiem Zaksięguj fakturę" />

4. Tillor wysyła fakturę automatycznie przez sieć Peppol (zwykle w ciągu kilku minut po zaksięgowaniu)

### Sprawdzanie statusu wysyłki [#verzendstatus-controleren]

Otwórz zaksięgowaną fakturę i zobacz **Zdarzenia** w prawym panelu. Zobaczysz tam, czy faktura została wysłana przez Peppol, czy wysyłka lub dostarczenie się nie powiodły.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Faktura jest wysyłana automatycznie, gdy ją księgujesz. Nie musisz niczego wysyłać.
- Faktura wysłana przez Peppol dostaje etykietę **Wysłane za pośrednictwem Peppolu** na liście w profilu klienta.
- Takiej faktury nie możesz już przywrócić do wersji roboczej ani przenieść do innego klienta. Korygujesz ją fakturą korygującą. Zobacz [Korygowanie faktury](/facturen/corrigeren).
- Jeśli wysyłka się nie powiedzie, zobaczysz to w **Zdarzenia** faktury, a w <UIPath>Komunikacja > Powiadomienia</UIPath> pojawi się komunikat. Wyślij wtedy fakturę e-mailem, zobacz [Wysyłanie faktury](/facturen/versturen).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Faktury nie można zaksięgować, bo klient nie ma identyfikatora Peppol">
Klient jest Belgiem i ma numer VAT. Wpisz identyfikator Peppol w <UIPath>Klienci > klient > Fakturowanie</UIPath>, **Ustawienia faktury**. Nie znasz identyfikatora? Użyj ikony wyszukiwania po lewej stronie pola.
</Accordion>
<Accordion title="Nie znajduję odbiorcy w wynikach wyszukiwania">
Nie wszystkie firmy są podłączone do Peppol. Wyślij wtedy fakturę e-mailem.
</Accordion>
<Accordion title="Faktura nie została wysłana przez Peppol">
Sprawdź, czy identyfikator Peppol klienta jest wpisany, zanim zaksięgujesz.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Faktury" href="/facturen" description="Tworzenie i księgowanie faktur" />
  <Card title="VAT i podatki" href="/boekhouden/belasting" description="Weryfikacja numerów VAT" />
  <Card title="Księgowość" href="/boekhouden" description="Przegląd finansowy" />
</Cards>


# Wysyłanie faktury lub przypomnienia (/pl-PL/communicatie/e-mails)

Przyciskiem **Wyślij powiadomienie** wysyłasz zaksięgowaną fakturę do klienta. Przyciskiem **Wyślij przypomnienie** przypominasz klientowi o nieopłaconej fakturze. Sam wybierasz e-mail, SMS, pocztę lub WhatsApp, a potem śledzisz dostarczenie w [Powiadomieniach](/notificaties).

Tillor nie wysyła tych wiadomości sam przy księgowaniu. To Ty decydujesz, kiedy klient coś dostanie. Chcesz, żeby działo się to automatycznie? Można to zrobić za pomocą [automatyzacji](/begrippen#automatisering).

Zanim zaczniesz:

- Faktura musi być **zaksięgowana**. Na fakturze roboczej nie ma tego przycisku.
- Klient ma co najmniej adres e-mail, numer telefonu albo pełny adres pocztowy (ulica, kod pocztowy i miejscowość). W przeciwnym razie nie zobaczysz **Wyślij powiadomienie**.
- Przy przypomnieniu musi jeszcze pozostać kwota do zapłaty. Opłacona faktura nie daje opcji **Wyślij przypomnienie**.
- Dla każdego kanału musi być znana odpowiednia dana. W przeciwnym razie kanał jest wyszarzony z komunikatem **Brak adresu e-mail w profilu**, **Brak numeru telefonu w profilu** lub **Brak adresu pocztowego w profilu**.

## Wysyłanie faktury [#een-factuur-versturen]

<Steps>
<Step>
### Otwórz fakturę [#open-de-factuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> i otwórz zaksięgowaną fakturę.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification-button.png" alt="Zaksięgowana faktura z przyciskiem Wyślij powiadomienie na pasku akcji" />
</Step>
<Step>
### Kliknij Wyślij powiadomienie [#klik-op-verstuur-notificatie]
Otworzy się okno **Wyślij powiadomienie**. Wybierz kanały, którymi klient dostanie fakturę.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification.png" alt="Okno Wyślij powiadomienie z opcjami E-mail, SMS i Poczta" />
</Step>
<Step>
### Wybierz kanały i kliknij Wyślij [#kies-de-kanalen-en-klik-op-versturen]
Tillor wyświetli **Powiadomienie wysłane**. Jeśli się nie uda, zobaczysz **Powiadomienie nie zostało wysłane**.
</Step>
</Steps>

Kanały działają tak:

| Kanał | Co dostaje klient |
|---|---|
| **E-mail** | Domyślnie włączony. Faktura jest w PDF dołączona do wiadomości, na adres e-mail z profilu klienta |
| **SMS** | Krótki tekst z osobistym linkiem do faktury |
| **Poczta** | Faktura jako list na adres pocztowy z profilu klienta. Domyślnie wyłączona. Tillor pokazuje orientacyjną kwotę opłaty pocztowej za list |
| **WhatsApp** | Pojawia się, jeśli połączono WhatsApp Business. Jeśli 24-godzinne okno klienta jest zamknięte, a nie masz metody płatności w Meta, Tillor blokuje wysyłkę |

## Wysyłanie przypomnienia [#een-aanmaning-versturen]

<Steps>
<Step>
### Otwórz menu obok Wyślij powiadomienie [#open-het-menu-naast-verstuur-notificatie]
Kliknij strzałkę obok przycisku i wybierz **Wyślij przypomnienie**.
</Step>
<Step>
### Wybierz kanały [#kies-de-kanalen]
Przy przypomnieniu **SMS** jest domyślnie włączony, jeśli klient ma numer telefonu. Jeśli wybierzesz **Pocztę**, klient dostanie list z przypomnieniem z fakturą w załączniku i kodem QR na liście. Zobacz [Wysyłanie faktury](/facturen/versturen).

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Wysyłanie przypomnienia z wyborem Poczty i listu poleconego" />
</Step>
<Step>
### Potwierdź [#bevestig]
Kliknij **Wyślij**. Jeśli wybrano też **List polecony z potwierdzeniem odbioru**, zobaczysz **Wyślij z dodatkowym kosztem**. Ta opcja istnieje tylko wtedy, gdy list polecony jest obsługiwany w kraju adresu pocztowego. Tillor obciąża Twoją organizację dodatkowymi kosztami.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Wiadomość pojawia się w <UIPath>Komunikacja > Powiadomienia</UIPath> z kanałem, statusem i linkiem do faktury. Widzisz ją także w profilu klienta.
- E-mail i SMS zaczynają jako <Status tone="info">Oczekujące</Status> i stają się <Status tone="success">Wysłane</Status>, gdy tylko zostaną dostarczone. Klient może przeczytać wiadomość i kliknąć link. Jedno i drugie zobaczysz w oknie szczegółów.
- Przy poczcie status <Status tone="success">Wysłane</Status> pojawia się, gdy poczta potwierdzi, że list jest w drodze lub został doręczony. Przy poczcie widzisz kwotę opłaty pocztowej w chwili wysyłki, a przy liście poleconym także kwotę dodatkową.
- Jeśli wiadomość utknie na dłużej niż 5 minut, Tillor spróbuje ponownie. Po 2 dniach bez wysyłki dostaje status <Status tone="error">Niepowodzenie</Status>.
- Jeśli wiadomość się nie uda, faktura pozostaje taka, jaka była. Zawsze możesz wysłać ponownie.

Chcesz, żeby Tillor sam zareagował, na przykład powiadamiając współpracownika, gdy przypomnienie się nie powiedzie? Do tego możesz utworzyć [automatyzację](/begrippen#automatisering).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę przycisku Wyślij powiadomienie">
Faktura jest jeszcze wersją roboczą albo klient nie ma adresu e-mail, numeru telefonu ani pełnego adresu pocztowego. Zaksięguj fakturę albo uzupełnij jedną z tych danych w profilu klienta.
</Accordion>
<Accordion title="Nie widzę Wyślij przypomnienie w menu">
Faktura jest już opłacona albo jeszcze niezaksięgowana. Przypomnienie można wysłać tylko dla zaksięgowanej faktury, od której pozostała kwota do zapłaty.
</Accordion>
<Accordion title="Kanał jest wyszarzony z komunikatem Brak adresu e-mail w profilu">
Tej danej brakuje w profilu klienta. Dodaj adres e-mail, numer telefonu lub adres pocztowy i otwórz okno ponownie.
</Accordion>
<Accordion title="Tillor zgłasza Powiadomienie nie zostało wysłane">
Otwórz <UIPath>Komunikacja > Powiadomienia</UIPath> i kliknij kanał wiadomości. W oknie szczegółów jest komunikat o błędzie. Zazwyczaj adres lub numer jest nieprawidłowy. Popraw go w profilu klienta i wyślij ponownie.
</Accordion>
<Accordion title="Nie widzę opcji List polecony przy Poczcie">
Wysyłka listem poleconym jest możliwa tylko na adresy pocztowe w krajach, w których Tillor to obsługuje. Dla innych adresów nadal możliwa jest zwykła poczta.
</Accordion>
<Accordion title="Klient mówi, że niczego nie otrzymał">
Sprawdź status w <UIPath>Komunikacja > Powiadomienia</UIPath>. Jeśli wiadomość ma status **Odrzucone**, adres nie istnieje. Jeśli ma **Wysłane**, poproś klienta o sprawdzenie spamu. Zobacz [Powiadomienia](/notificaties#problemen).
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Powiadomienia" href="/notificaties" description="Status dostarczenia wysłanych wiadomości" />
  <Card title="Typy powiadomień" href="/communicatie/notificatietypes" description="Wszystkie rodzaje wiadomości wysyłanych przez Tillor" />
  <Card title="Wysyłanie faktury" href="/facturen/versturen" description="Poczta, kod QR i listy z przypomnieniem" />
</Cards>


# Przegląd (/pl-PL/communicatie)

W sekcji Komunikacja śledzisz wszystko, co między Twoim parkiem a klientami zostaje powiedziane lub wysłane: rozmowy telefoniczne, wiadomości wysyłane przez Tillor i komentarze wewnętrzne. Tutaj decydujesz też, które wiadomości trafiają do klienta, i widzisz, czy dotarły. Rozmowy, które klienci rozpoczynają przez czat lub media społecznościowe, są w [skrzynce odbiorczej](/inbox).

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Przegląd rozmów telefonicznych w Komunikacji" />

<Callout type="info" title="Warto wiedzieć">
- Wiadomość z fakturą ani przypomnienie nigdy nie wychodzą same przy księgowaniu. Uruchamiasz je Ty albo [automatyzacja](/begrippen#automatisering)
- Jeśli wiadomość utknie na dłużej niż 5 minut, Tillor spróbuje ponownie. Po 2 dniach bez wysyłki ma status **Niepowodzenie**
- SMS z danymi organizacji możesz wysłać tylko podczas trwającej rozmowy, z panelu w prawym dolnym rogu
- Nowa wiadomość w skrzynce odbiorczej pojawia się jako karta w prawym dolnym rogu i znika po około dziesięciu sekundach
- Rozmowy telefoniczne pojawiają się dopiero po zainstalowaniu Voys i skierowaniu planu dzwonienia do Tillor
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Cała komunikacja z klientem zbiega się w profilu klienta. To, co wychodzi, i to, co przychodzi, idzie różnymi kanałami.

```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
```

- **Rozmowy** trafiają do Ciebie przez dostawcę telefonii i są powiązane z klientem przez numer telefonu.
- **Wiadomości od klientów** przez czat lub media społecznościowe trafiają do skrzynki odbiorczej.
- **Wiadomości do klientów** wysyłasz z faktury. Dostarczenie śledzisz w Powiadomieniach.
- **Komentarze** są wewnętrzne. Klienci ich nie widzą.

## Elementy [#onderdelen]

<Cards>
  <Card title="Skrzynka odbiorcza" href="/inbox" description="WhatsApp, Messenger, Instagram i czat na stronie w jednym miejscu" />
  <Card title="Połączenia telefoniczne" href="/communicatie/telefoongesprekken" description="Śledzenie rozmów, odsłuchiwanie nagrań i wysyłanie danych SMS-em" />
  <Card title="Wysyłanie faktury lub przypomnienia" href="/communicatie/e-mails" description="Samodzielne wysyłanie wiadomości do klienta" />
  <Card title="Powiadomienia" href="/notificaties" description="Podgląd statusu dostarczenia wysłanych wiadomości" />
  <Card title="Typy powiadomień" href="/communicatie/notificatietypes" description="Wszystkie rodzaje wiadomości i kiedy wychodzą" />
  <Card title="Komentarze" href="/notities" description="Komentarze wewnętrzne przy klientach, fakturach i innych rekordach" />
  <Card title="Dostawcy" href="/communicatie/providers" description="Voys i Twilio: kto dzwoni, a kto wysyła SMS-y" />
</Cards>

## Pojęcia [#begrippen]

- **Dostawca telefonii**: firma, która dostarcza Twoją linię telefoniczną, na przykład Voys.
- **Powiadomienie**: wiadomość, którą Tillor wysyła do klienta lub [użytkownika](/begrippen#gebruiker).
- **Kanał**: droga, którą idzie wiadomość, na przykład e-mail, SMS, poczta lub WhatsApp.
- **Skrzynka odbiorcza**: miejsce, w którym lądują wiadomości od klientów z czatu i mediów społecznościowych.
- **Komentarz**: wewnętrzna notatka przy [kliencie](/begrippen#klant), fakturze lub innym rekordzie.

Więcej pojęć znajdziesz w [liście pojęć](/begrippen).


# Typy powiadomień (/pl-PL/communicatie/notificatietypes)

Ta lista pokazuje każdy typ wiadomości, który możesz spotkać w [przeglądzie powiadomień](/notificaties), i kiedy Tillor go wysyła. Typ widzisz w kolumnie **Typ** i możesz po nim filtrować filtrem **Typ**. Nazwy odpowiadają tym na ekranie.

Wiadomości do klientów idą e-mailem, SMS-em, pocztą lub przez WhatsApp. Wiadomości do współpracowników idą przez push, e-mail lub telefon, zgodnie z preferencjami danego współpracownika. Zobacz [Powiadomienia w aplikacji](/notificaties#meldingen-in-de-app).

<Callout type="info" title="Wiadomości z fakturami nie wychodzą same">
Wiadomości takie jak **Nowa faktura** lub **Przypomnienie o fakturze** Tillor nie wysyła automatycznie przy księgowaniu faktury. Uruchamiasz je przyciskiem **Wyślij powiadomienie** lub **Wyślij przypomnienie** na fakturze. Zobacz [Wysyłanie faktury lub przypomnienia](/communicatie/e-mails).
</Callout>

## Faktury i płatności [#facturen-en-betalingen]

| Typ | Kiedy jest wysyłany |
|---|---|
| Nowa faktura | Do klienta, gdy wysyłasz fakturę. Faktura jest załącznikiem wiadomości |
| Faktura opłacona | Do klienta, gdy faktura została opłacona |
| Przypomnienie o fakturze | Do klienta, jako przypomnienie o nieopłaconej fakturze |
| Przypomnienie o przelewie bankowym | Do klienta, który płaci przelewem, z podpowiedzią, aby użyć komunikatu strukturalnego |
| Archiwum faktur | Na adres wsparcia Twojej organizacji, z Twoim księgowym w kopii, gdy archiwum faktur jest gotowe |
| Błąd wysyłki faktury Peppol | Gdy nie udało się wysłać faktury przez Peppol |
| Nie udało się wysłać faktury do oprogramowania księgowego | Gdy przekazanie faktury do Twojego oprogramowania księgowego się nie powiodło |
| Wysyłka faktury do oprogramowania księgowego przywrócona | Gdy to przekazanie po wcześniejszych komunikatach jednak się udało |
| Nie udało się wysłać raportu płatności do oprogramowania księgowego | Gdy przekazanie raportu płatności się nie powiodło |
| Przywrócone faktury ponownie zaksięgowane | Gdy przywrócone faktury zostały w nocy automatycznie ponownie zaksięgowane |
| Płatność bankowa nierozliczająca faktury | Gdy płatność bankowa została powiązana z fakturą, ale faktura potem nadal jest nieopłacona |
| Zużycie znacznie powyżej zwykłego, wstrzymane przy automatycznym fakturowaniu | Gdy klient nie został automatycznie zafakturowany, bo zużycie prądu lub wody jest znacznie powyżej zwykłego |
| Zastosowano zaplanowaną cenę produktu | Do Twojej organizacji, w dniu wejścia w życie [zaplanowanej ceny](/producten/prijzen-plannen). Stara i nowa cena są obok siebie |
| Automatyczny zwrot startu maszyny | Gdy płatność online za uruchomienie maszyny została zwrócona, bo maszyna nie wystartowała |
| Weryfikacja płatności NFC offline | Gdy po synchronizacji nie dało się zweryfikować płatności NFC offline |
| Niski saldo tagu NFC | Do klienta, gdy saldo tagu NFC jest niskie |

## Upoważnienia SEPA i podpisywanie [#sepa-mandaten-en-ondertekenen]

| Typ | Kiedy jest wysyłany |
|---|---|
| Prośba o podpisanie upoważnienia SEPA | Do klienta z linkiem do podpisania upoważnienia, także dla przypomnień przed wygaśnięciem linku |
| Kod weryfikacyjny upoważnienia SEPA | Do klienta z kodem, który wpisuje na stronie podpisu, SMS-em lub e-mailem |
| Kopia podpisanego upoważnienia SEPA | Do klienta, gdy upoważnienie stanie się aktywne |
| Upoważnienie SEPA odwołane | Do klienta, z podpisanym dokumentem jeszcze raz w załączniku |
| Prośba o podpis | Do osoby podpisującej, gdy przychodzi jej kolej, e-mailem albo SMS-em, jeśli nie ma adresu e-mail |
| Kod podpisu | Do osoby podpisującej z kodem do podpisania, SMS-em lub e-mailem |
| Podpisany dokument | Do wszystkich podpisujących z podpisanym PDF, gdy ostatnia osoba podpisze |
| Odmowa podpisu | Do współpracownika, który wysłał prośbę, gdy osoba podpisująca odmówi |
| Akceptacja DPA | Potwierdzenie akceptacji DPA, z podpisaną DPA w załączniku |
| Kod weryfikacyjny umowy powierzenia | SMS-em do osoby odpowiedzialnej z kodem do zaakceptowania umowy powierzenia przetwarzania danych |

## Liczniki, kontrolery i dostęp [#meters-controllers-en-toegang]

| Typ | Kiedy jest wysyłany |
|---|---|
| Alarm licznika lub kontrolera | Gdy licznik ma nowy alarm |
| Alarm licznika lub kontrolera rozwiązany | Gdy alarm licznika został usunięty |
| Usunięcie licznika | Gdy liczniki zostały usunięte |
| Liczniki wymagające uwagi | Zestawienie liczników, których pomiary nie przychodzą albo które od dawna mają alarm |
| Kontroler offline | Gdy kontroler nie daje znaku życia dłużej niż 5 minut |
| Przegrzany kontroler | Pilny komunikat, gdy kontroler robi się zbyt gorący |
| Konektor offline | Gdy konektor Twojego parku nie daje już znaku życia |
| Konektor ponownie online | Gdy konektor jest znów osiągalny |
| Brama HTTP konektora niedostępna | Gdy konektor nadal działa, ale kamery już się z nim nie łączą |
| Kamera LPR offline | Gdy kamera tablic rejestracyjnych nie reaguje dłużej niż 5 minut |
| Punkt dostępu otwarty zbyt długo | Gdy punkt dostępu jest otwarty dłużej, niż dozwolono |
| Podsumowanie wyjazdów wygasłych tablic | Zestawienie pojazdów z wygasłym okresem dostępu, które wyjechały, gdy recepcja była zamknięta |
| Kod QR dostępu | Do klienta z kodem QR dla dostępu |
| Tablet lub kiosk offline | Gdy tablet lub kiosk poza okresem uśpienia nie daje znaku życia |
| Niski poziom baterii tabletu lub kiosku | Gdy tablet lub kiosk jest prawie rozładowany i się nie ładuje |

## Zadania, komentarze i skrzynka odbiorcza [#taken-opmerkingen-en-inbox]

| Typ | Kiedy jest wysyłany |
|---|---|
| Przypisano zadanie | Do współpracownika, któremu przypisano zadanie |
| Cofnięto przydział zadania | Do współpracownika, któremu zadanie odebrano |
| Zadanie ukończone | Gdy zadanie zostało ukończone |
| Przypomnienie o zadaniu | Gdy nadejdzie moment przypomnienia o zadaniu |
| Termin zadania | Gdy zadanie osiąga termin bez ukończenia |
| Dzienne podsumowanie widoku | E-mailem, dzienne podsumowanie widoku zadań, który obserwujesz |
| Odpowiedź na komentarz | Ktoś odpowiedział na komentarz |
| Wzmianka w komentarzu | Ktoś o Tobie wspomniał w komentarzu |
| Komentarz rozwiązany | Komentarz został oznaczony jako rozwiązany |
| Odrzucona odpowiedź na komentarz | Gdy odpowiedź e-mailem na komentarz nie została opublikowana, bo adres nadawcy się nie zgadza |
| Wiadomość w skrzynce odbiorczej | Gdy w skrzynce odbiorczej pojawi się nowa wiadomość |
| Pilne przekazanie AI | Gdy asystent AI przekazuje Ci pilną rozmowę |
| Kontynuacja czatu na stronie | Do odwiedzającego stronę z nieprzeczytaną odpowiedzią, z linkiem do wznowienia rozmowy |

## Automatyzacje i integracje [#automatiseringen-en-integraties]

| Typ | Kiedy jest wysyłany |
|---|---|
| Wiadomość z automatyzacji | Tekst, który automatyzacja wysyła do klienta |
| Powiadomienie z automatyzacji | Powiadomienie, które automatyzacja wysyła do współpracownika, przez push, e-mail lub oba |
| Uruchomienie automatyzacji nie powiodło się | Do twórcy automatyzacji, gdy uruchomienie zakończyło się błędem |
| Dostarczanie webhooków nie powiodło się | Gdy dostarczanie do Twojego webhooka się nie udaje, a Tillor ponawia próby |
| Dostarczanie webhooków trwale nie powiodło się | Gdy Tillor po wszystkich próbach nie mógł dostarczyć zdarzenia webhooka |
| Powiadomienie zewnętrzne | Wiadomość, którą wysłał sam połączony system, zobacz [Powiadomienia zewnętrzne](/notificaties#externe-notificaties) |

Webhook to połączenie, dzięki któremu Tillor automatycznie przekazuje zdarzenie do innego systemu.

## Konto i organizacja [#account-en-organisatie]

| Typ | Kiedy jest wysyłany |
|---|---|
| Powitanie użytkownika | Wiadomość powitalna dla nowego użytkownika |
| Weryfikacja e-maila | Link do potwierdzenia adresu e-mail |
| Zaproszenie do organizacji | Zaproszenie dla osoby bez konta Tillor do dołączenia do Twojej organizacji |
| Dane organizacji | SMS do dzwoniącego z linkiem do danych Twojej organizacji |
| Zgłoszenie z formularza kontaktowego | Gdy ktoś wypełni formularz kontaktowy |
| Przypomnienie o godzinach w święto | Przypomnienie o uzupełnieniu godzin otwarcia na nadchodzące święto |
| Dokument usunięty | Do użytkownika, który usunął dokument |

## Powiadomienia zespołu Tillor [#meldingen-van-het-tillor-team]

Te wiadomości są przeznaczone dla zespołu Tillor i zwykle ich nie widzisz: **Incydent systemowy**, **Alert bezpieczeństwa**, **Alert Grafana** i **Awaria bramki LoRa**.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Powiadomienia" href="/notificaties" description="Status dostarczenia i powiadomienia w aplikacji" />
  <Card title="Wysyłanie faktury lub przypomnienia" href="/communicatie/e-mails" description="Samodzielne wysyłanie wiadomości" />
  <Card title="Automatyzacje" href="/automatiseringen" description="Wiadomości z automatyzacji" />
</Cards>


# Przegląd (/pl-PL/communicatie/providers)

Przez dostawcę telefonii, takiego jak Voys, Tillor widzi, kto dzwoni, i zapisuje rozmowy, nagrania i transkrypcje. Dostawcę łączysz w <UIPath>Ustawienia > Integracje</UIPath>. Twilio nie jest dostawcą telefonii: wysyła wiadomości SMS Tillor i zostało skonfigurowane przez samego Tillor.

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Ustawienia > Integracje" />

## Dostępni dostawcy [#beschikbare-providers]

<Cards>
  <Card
    title="Voys"
    href="/communicatie/providers/voys"
    description="Powiąż przychodzące rozmowy telefoniczne z profilami klientów"
  />
  <Card
    title="Twilio"
    href="/communicatie/providers/twilio"
    description="Dostarczanie SMS i WhatsApp przez ustawienie platformy"
  />
  <Card title="Skrzynka odbiorcza" href="/inbox" description="Messenger i WhatsApp Business dla skrzynki omnichannel" />
</Cards>


# Twilio (/pl-PL/communicatie/providers/twilio)

Twilio wysyła w imieniu Tillor wiadomości SMS oraz, jeśli jest to ustawione, powiadomienia WhatsApp. To nie jest dostawca telefonii taki jak Voys i nie instalujesz go samodzielnie: Tillor skonfigurował je dla całej platformy.

## Różnica w stosunku do Voys [#verschil-met-voys]

| | Voys | Twilio |
|---|---|---|
| Telefonia (dzwonienie, rozmowy) | Tak | Nie |
| Konfiguracja w Tillor | **Ustawienia > Integracje** | Nie - ustawienie platformy |
| Widoczne dla użytkowników | Rozmowy, nagrania, transkrypcje | Wysłane SMS-y i powiadomienia WhatsApp |

## Co robi Twilio w Tillor? [#wat-doet-twilio-in-tillor]

Gdy Twilio jest skonfigurowane, Tillor używa go między innymi do:

- wysyłania **powiadomień SMS** (na przykład przypomnień o płatnościach, potwierdzeń rezerwacji i powiadomień o fakturach)
- wysyłania **danych organizacji SMS-em** z **Komunikacja > Połączenia telefoniczne** (przycisk SMS z podpowiedzią **Wyślij dane organizacyjne do dzwoniącego za pomocą wiadomości SMS**)
- dostarczania **powiadomień WhatsApp**, gdy WhatsApp przez Twilio jest ustawiony na platformie
- używania **kodów weryfikacyjnych SMS** przy podpisywaniu umowy powierzenia przetwarzania danych (DPA)

Wysłane SMS-y i powiadomienia WhatsApp śledzisz w **Komunikacja > Powiadomienia**:

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Przegląd powiadomień - status dostarczenia wiadomości" />

<Callout type="info">
Twilio nie konfigurujesz sam w Tillor. Poproś administratora platformy albo support Tillor o właściwe połączenie dla Twojego środowiska.
</Callout>

## Brak instalacji w Integracjach [#geen-installatie-in-integraties]

W przeciwieństwie do Voys Twilio **nie** znajdziesz w **Ustawienia > Integracje**. Połączeniem zarządza administrator środowiska Tillor.

## Zobacz też [#zie-ook]

<Cards>
  <Card
    title="Telefonia Voys"
    href="/communicatie/providers/voys"
    description="Integracja telefonii dla rozmów"
  />
  <Card
    title="Połączenia telefoniczne"
    href="/communicatie/telefoongesprekken"
    description="Wysyłanie danych organizacji SMS-em"
  />
</Cards>


# Telefonia Voys (/pl-PL/communicatie/providers/voys)

Dzięki integracji z Voys Tillor widzi, kto dzwoni, i od razu pokazuje dane klienta. Rozmowy, nagrania i transkrypcje trafiają potem do sekcji [Połączenia telefoniczne](/communicatie/telefoongesprekken). Voys to dostawca telefonii dla firm.

Zanim zaczniesz:

- Potrzebujesz aktywnego konta Voys VoIP oraz dostępu do ustawień planu połączeń w Voys.
- Potrzebujesz uprawnienia **Zarządzanie integracjami**.
- Numer telefonu dzwoniącego musi być zapisany w profilu klienta lub u osoby kontaktowej, w przeciwnym razie Tillor nie powiąże rozmowy z klientem.

<DocScreenshot src="/screenshots/communicatie/providers/voys/incoming-call.png" alt="Połączenie przychodzące na pulpicie" />

## Konfiguracja Voys [#voys-instellen]

1. Przejdź do **Ustawienia** (pasek boczny, w sekcji **Pomoc**)

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-nav.png" alt="Przejście do Ustawień" />

2. Wybierz **Integracje** i otwórz **Voys** na liście
3. Na stronie szczegółów wpisz swoje dane Voys (`username`, `password`, `client_uuid`, `token`) i kliknij **Zainstalować**

Potrzebujesz aktywnego konta Voys VoIP.

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-voys.png" alt="Ustawienia > Integracje - Voys na liście" />

<Callout type="info">
Po instalacji i konfiguracji Tillor automatycznie powiązuje rozmowy z klientami, gdy numer telefonu zgadza się z numerem klienta lub kontaktu.
</Callout>

## Gdzie znaleźć adresy URL dla Voys [#urls-voor-voys-terugvinden]

Tillor i Voys komunikują się ze sobą przez adresy (URL). Na niektórych etapach Voys oczekuje odpowiedzi od Tillora, na przykład czy jesteście otwarci. Ta odpowiedź to **ACK** (tak, kontynuuj) lub **NAK** (nie, idź inną ścieżką). Webhook to taki adres, który Voys wywołuje w trakcie rozmowy.


Dla webhooków, wyszukiwania nazwy dzwoniącego i kodów dostępu używasz adresów URL, które Tillor generuje dla Ciebie.

1. Przejdź do **Ustawienia > Integracje** i otwórz **Voys**
2. Po instalacji na stronie szczegółów, w sekcji **Ustawienia**, znajdziesz blok **Adresy URL do skonfigurowania** - skopiuj stamtąd odpowiedni adres URL dla danego celu

Znajdziesz tam między innymi:

- **Powiadomienia o rozmowach** - adres URL webhooka dla zdarzeń rozmów
- **Webhook do wyszukiwania rozmówców** - adres URL do wyszukiwania nazwy dzwoniącego (caller name lookup) w planie połączeń Voys
- **Książka telefoniczna XML** - adres URL, z którego telefony VoIP pobierają książkę telefoniczną
- **Kody dostępu** - adres URL do obsługi punktu dostępu (szlaban, brama lub drzwi) przez plan połączeń
- **Webhook godzin otwarcia** - ACK, gdy Tillor jest otwarty, NAK, gdy Tillor jest zamknięty
- **Webhook dozwolonego dzwoniącego** - ACK, gdy dzwoniącego można połączyć, NAK, gdy dzwoniący ma trafić na pocztę głosową
- **Webhook routingu** - ACK z miejscem docelowym, NAK, gdy nie ustawiono miejsca docelowego

W planie połączeń Voys używaj tych samych zmiennych, które podano w Tillorze (takich jak `{callerid}`, `{did}`, `{callername}`, `{callid}` i `{code}`).

<DocScreenshot src="/screenshots/communicatie/providers/voys/config-urls-dialog.png" alt="Szczegóły Voys - Adresy URL do skonfigurowania na stronie" />

## Konfiguracja powiadomień o rozmowach w Voys [#gespreksnotificaties-in-voys-configureren]

1. Otwórz w Voys moduł [Powiadomienia o rozmowach](https://freedom.voys.nl/redirect/CallNotification)
2. Kliknij **Dodaj**
3. W polu package/service wybierz **Aangepast** (własne)
4. Wklej adres URL z Tillora z pozycji **Powiadomienia o rozmowach**
5. Zapisz

Dokumentacja Voys:

- [Powiadomienia o rozmowach](https://help.voys.nl/gespreksnotificaties)

## Konfiguracja nazw dzwoniących (caller lookup) w planie połączeń [#bellernamen-caller-lookup-in-call-plan-configureren]

Do wyszukiwania nazwy dzwoniącego używasz w Voys kroku webhook w planie połączeń.

1. Otwórz w Tillorze adres URL **Webhook do wyszukiwania rozmówców** (w **Ustawienia > Integracje > Voys**, w bloku **Adresy URL do skonfigurowania**) i skopiuj go
2. Otwórz w Voys moduł [Webhooks](https://help.voys.nl/webhooks) i utwórz webhook z tym szablonem URL
3. Aktywuj ten webhook w planie połączeń przez krok webhook
4. W szablonie URL używaj zmiennych obsługiwanych przez Voys (`{callerid}`, `{did}`, `{callername}` oraz w razie potrzeby `{code}`)
5. W routingu webhooka ustaw **Variabele bellernaam**, aby zwrócona nazwa była wyświetlana na urządzeniach

Webhooki godzin otwarcia i routingu nie wyszukują nazwy dzwoniącego. Do tego służy ten osobny krok.

Więcej informacji:

- [Webhooks](https://help.voys.nl/webhooks)
- [Czym są powiadomienia o rozmowach (różnica względem webhooków)](https://help.voys.nl/gespreksnotificaties)

## Godziny otwarcia i miejsca docelowe w planie połączeń [#openingsuren-en-bestemmingen-in-het-belplan]

Tillor jest źródłem godzin otwarcia, urlopów i wyjątków w dni świąteczne. Voys nie musi już sam znać tego kalendarza.

1. W **Ustawienia > Integracje > Voys** wybierz urządzenie Voys dla stanu **otwarte** oraz opcjonalnie dla stanu **zamknięte**
2. Skopiuj **Webhook godzin otwarcia** lub **Webhook routingu** z bloku **Adresy URL do skonfigurowania**
3. Utwórz w Voys [webhook](https://help.voys.nl/webhooks) z tym szablonem URL
4. Ustaw ten webhook jako krok w planie połączeń, **powyżej** ewentualnych menu wyboru
5. Pozostaw **Menu gebruiken** wyłączone

Dwa wzorce:

- **Webhook godzin otwarcia** - `status=ACK` prowadzi ścieżką **HTTP en menu gelukt** (otwarte), `status=NAK` prowadzi ścieżką **HTTP of menu mislukt** (zamknięte). Jeśli ustawiono miejsce docelowe dla stanu otwartego, trafia ono do ACK jako `destination`.
- **Webhook routingu** - Tillor wybiera miejsce docelowe. Ustaw w kroku udanym **Variabele eindbestemming**. ACK + `destination`, gdy jest miejsce docelowe, w przeciwnym razie NAK.

Przy błędzie lub przekroczeniu czasu Voys wybiera ścieżkę nieudaną. Traktuj to jako zamknięte.

Dokumentacja Voys: [Webhooks](https://help.voys.nl/webhooks).

## Automatyczne kierowanie dzwoniących na pocztę głosową [#bellers-automatisch-naar-voicemail-sturen]

Dzięki **Webhook dozwolonego dzwoniącego** pozwalasz Voys zdecydować dla każdego dzwoniącego, czy rozmowa zostanie połączona. Tillor sprawdza, czy numer dzwoniącego należy do klienta, który ma włączoną automatyczną pocztę głosową.

Najpierw skonfiguruj plan połączeń:

1. Skopiuj **Webhook dozwolonego dzwoniącego** z bloku **Adresy URL do skonfigurowania** w **Ustawienia > Integracje > Voys**
2. Utwórz w Voys [webhook](https://help.voys.nl/webhooks) z tym szablonem URL
3. Ustaw ten webhook jako krok w planie połączeń, **powyżej** kroków, które łączą rozmowę
4. Pozostaw **Menu gebruiken** wyłączone
5. Ścieżkę **HTTP en menu gelukt** skieruj do zwykłego routingu, a ścieżkę **HTTP of menu mislukt** do poczty głosowej
6. W **Ustawienia > Integracje > Voys**, w sekcji **Przekierowanie połączeń**, zaznacz **Automatyczna poczta głosowa w Voys**

Dopóki ta opcja jest wyłączona, nie zobaczysz **Kieruj połączenia na pocztę głosową** w profilu klienta.

Następnie włącz automatyczną pocztę głosową dla każdego klienta:

1. Otwórz profil klienta i przejdź do karty **Komunikacja**
2. W **Ustawienia komunikacji** zaznacz opcję **Kieruj połączenia na pocztę głosową**
3. Kliknij **Zapisz**

Tak działa odpowiedź:

- **ACK** - dzwoniący może zostać połączony. Dotyczy to także nieznanych numerów i dzwoniących z ukrytym numerem.
- **NAK** - numer należy do klienta z automatyczną pocztą głosową. Voys wybiera ścieżkę nieudaną.

Tillor porównuje numer dzwoniącego z numerem telefonu w profilu klienta, niezależnie od spacji i zapisu numeru kierunkowego kraju. Numery telefonów osób kontaktowych nie są brane pod uwagę.

<Callout type="warn">
Przy błędzie lub przekroczeniu czasu Voys również wybiera ścieżkę nieudaną. Wtedy wszyscy dzwoniący tymczasowo trafiają na pocztę głosową, a nie tylko zablokowani. Użyj więc miejsca docelowego poczty głosowej, w którym regularnie sprawdzasz wiadomości.
</Callout>

Ten webhook nie uwzględnia godzin otwarcia. Połącz go z webhookiem godzin otwarcia lub routingu, umieszczając oba jako osobne kroki w planie połączeń.

Dokumentacja Voys: [Webhooks](https://help.voys.nl/webhooks).

## Stałe przekierowanie dla dzwoniącego [#vaste-routering-per-beller]

Ten sam **Webhook routingu** może od razu przekierować dzwoniącego na wybrane urządzenie Voys, numer wewnętrzny lub numer telefonu. Dotyczy to tylko klientów, dla których wybrano miejsce docelowe, i tylko wtedy, gdy włączone jest **Stałe przekierowanie w Voys**.

1. Umieść **Webhook routingu** w planie połączeń, tak jak przy godzinach otwarcia
2. Ustaw w kroku udanym **Variabele eindbestemming**
3. W **Ustawienia > Integracje > Voys**, w sekcji **Przekierowanie połączeń**, zaznacz **Stałe przekierowanie w Voys**

Dopóki ta opcja jest wyłączona, nie zobaczysz **Stałe przekierowanie rozmów** w profilu klienta. Webhook używa wtedy tylko urządzenia dla stanu otwartego lub zamkniętego.

Następnie ustaw miejsce docelowe dla każdego klienta:

1. Otwórz profil klienta i przejdź do karty **Komunikacja**
2. W polu **Stałe przekierowanie rozmów** wybierz urządzenie Voys albo **Inne** dla numeru telefonu lub numeru wewnętrznego (na przykład 411)
3. Wybierz **Brak**, aby wyłączyć stałe przekierowanie
4. Kliknij **Zapisz**

Tak webhook routingu wybiera miejsce docelowe:

- Jeśli dla tego dzwoniącego ustawiono stałe miejsce docelowe, jest ono wartością `destination`.
- W przeciwnym razie `destination` to urządzenie Voys dla stanu otwartego lub zamkniętego.
- **NAK** - nie ma stałego miejsca docelowego ani urządzenia dla bieżącego stanu. Dotyczy to także nieznanych numerów i dzwoniących z ukrytym numerem, dopóki nie ustawiono urządzenia dla stanu otwartego lub zamkniętego.

Tillor porównuje numer dzwoniącego z numerem telefonu w profilu klienta, niezależnie od spacji i zapisu numeru kierunkowego kraju. Numery telefonów osób kontaktowych nie są brane pod uwagę.

Przy błędzie lub przekroczeniu czasu Voys wybiera ścieżkę nieudaną.

Dokumentacja Voys: [Webhooks](https://help.voys.nl/webhooks).

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Każda rozmowa przychodząca lub wychodząca znajduje się w <UIPath>Komunikacja > Połączenia telefoniczne</UIPath>, razem z klientem, jeśli numer się zgadza. Zobacz [Połączenia telefoniczne](/communicatie/telefoongesprekken).
- Przy rozmowie przychodzącej dzwoniący pojawia się jako karta w prawym dolnym rogu Tillora, wraz z danymi klienta.
- Nagrania i transkrypcje pojawiają się po zakończeniu rozmowy, jeśli nagrywanie rozmów jest włączone na Twoim koncie Voys.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę bloku Adresy URL do skonfigurowania">
Blok pojawia się dopiero po instalacji. Najpierw kliknij **Zainstalować** na stronie szczegółów Voys.
</Accordion>
<Accordion title="Rozmowy nie docierają do Tillora">
Voys przekazuje rozmowy dopiero wtedy, gdy moduł Powiadomienia o rozmowach używa adresu URL **Powiadomienia o rozmowach** z Tillora. Sprawdź w Voys, czy ten adres tam jest i czy pochodzi z bloku **Adresy URL do skonfigurowania**.
</Accordion>
<Accordion title="Nazwa dzwoniącego nie pojawia się na urządzeniu">
Sprawdź, czy webhook do wyszukiwania nazwy dzwoniącego jest w planie połączeń i czy w kroku udanym ustawiono **Variabele bellernaam**. Webhooki godzin otwarcia i routingu nie wyszukują nazw.
</Accordion>
<Accordion title="Nie widzę opcji Kieruj połączenia na pocztę głosową w profilu klienta">
Najpierw zaznacz **Automatyczna poczta głosowa w Voys** w <UIPath>Ustawienia > Integracje > Voys</UIPath>, w sekcji **Przekierowanie połączeń**. Dopiero potem opcja pojawi się na karcie **Komunikacja** klienta. To samo dotyczy **Stałe przekierowanie rozmów**.
</Accordion>
<Accordion title="Nagle wszyscy dzwoniący trafiają na pocztę głosową">
Przy błędzie lub przekroczeniu czasu webhooka Voys wybiera ścieżkę nieudaną. Sprawdź, czy Tillor jest osiągalny i czy adres URL w webhooku jest nadal poprawny. Zobacz ostrzeżenie w [Automatyczne kierowanie dzwoniących na pocztę głosową](#bellers-automatisch-naar-voicemail-sturen).
</Accordion>
<Accordion title="Rozmowa nie należy do klienta">
Tillor porównuje numer z numerem telefonu w profilu klienta. Numery osób kontaktowych są brane pod uwagę przy powiązywaniu rozmów, ale nie przy poczcie głosowej i stałym przekierowaniu.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card
    title="Połączenia telefoniczne"
    href="/communicatie/telefoongesprekken"
    description="Akcje rozmów, takie jak dane organizacji przez SMS"
  />
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Profile klientów i dane kontaktowe" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Jak wysyłane są wiadomości SMS" />
</Cards>


# Połączenia telefoniczne (/pl-PL/communicatie/telefoongesprekken)

W <UIPath>Komunikacja > Połączenia telefoniczne</UIPath> znajdziesz każdą rozmowę, która przychodzi lub wychodzi przez Twojego dostawcę telefonii, wraz z klientem, jeśli Tillor rozpozna numer. Z tej strony korzystasz, aby śledzić rozmowy i podczas trwającej rozmowy wysłać dzwoniącemu SMS-em dane swojej organizacji.

Zanim zaczniesz:

- Rozmowy pojawiają się dopiero po zainstalowaniu i skonfigurowaniu [Voys](/communicatie/providers/voys). Bez integracji lista pozostaje pusta.
- Nagrania i transkrypcje istnieją tylko wtedy, gdy nagrywanie rozmów jest włączone na Twoim koncie Voys.
- Przycisk SMS w trwającej rozmowie działa tylko wtedy, gdy wysyłanie SMS-ów jest skonfigurowane dla Twojego środowiska. Zobacz [Twilio](/communicatie/providers/twilio).

## Przeglądanie rozmów [#gesprekken-bekijken]

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Przegląd połączeń telefonicznych" />

W tabeli **Wszystkie połączenia** przy każdej rozmowie widzisz:

| Kolumna | Co widzisz |
|---|---|
| **Kierunek** | **Przychodzące** lub **Wychodzące** |
| **Rozpoczęto** | Data i godzina |
| **Od** i **Do** | Numery telefonów |
| **Czas trwania** | Długość rozmowy, po jej zakończeniu |
| **Klient** | Powiązany klient lub nazwa podana przez Voys (niezweryfikowana), jeśli nie ma przypisanego klienta |
| **Status** | Na jakim etapie jest rozmowa |

Tillor powiązuje rozmowę z klientem na podstawie numeru telefonu. Jeśli numer nie należy jeszcze do żadnego klienta, dodaj go do profilu klienta lub do osoby kontaktowej. Nowe rozmowy będą wtedy powiązywane automatycznie.

Rozmowa przechodzi przez te statusy:

| Status | Znaczenie |
|---|---|
| <Status tone="info">Utworzono</Status> | Rozmowa dopiero się rozpoczęła |
| <Status tone="info">Dzwonienie</Status> | Telefon dzwoni |
| <Status tone="warning">Odpowiedziano</Status> | Ktoś odebrał |
| <Status tone="warning">W toku</Status> | Rozmowa trwa |
| <Status tone="warning">Ciepły transfer</Status> i <Status tone="warning">Transfer na zimno</Status> | Rozmowa została przekazana, z zapowiedzią lub bez |
| <Status>Rozłączony</Status> i <Status>Zakończone</Status> | Rozmowa się skończyła |
| <Status tone="error">Niepowodzenie</Status> | Rozmowa nie doszła do skutku |

## Wysyłanie danych organizacji SMS-em [#organisatiegegevens-via-sms-versturen]

Dzwoniący prosi o Twój adres lub godziny otwarcia? Wyślij je SMS-em w kilka sekund, gdy rozmowa trwa.

<Steps>
<Step>
### Poczekaj, aż rozmowa się rozpocznie [#wacht-tot-het-gesprek-loopt]
Akcja znajduje się w panelu aktywnych rozmów w prawym dolnym rogu, nie na liście. Rozmowa musi mieć status **W toku**. Na telefonie najpierw dotknij ikony telefonu w prawym górnym rogu.
</Step>
<Step>
### Rozwiń rozmowę [#klap-het-gesprek-uit]
Jeśli rozmowa jest zwinięta, rozwiń ją.
</Step>
<Step>
### Kliknij ikonę wiadomości [#klik-op-het-berichtenpictogram]
Podpowiedź brzmi **Wyślij dane organizacyjne do dzwoniącego za pomocą wiadomości SMS**.
</Step>
<Step>
### Wybierz język [#kies-de-taal]
Tillor oznacza język rozpoznany u dzwoniącego jako *(wykryto)*. Wybierz język SMS-a.
</Step>
</Steps>

Dzwoniący otrzymuje krótki link do publicznej strony z danymi Twojej organizacji. Jeśli adres Twojej organizacji jest uzupełniony, na stronie są też przyciski nawigacji do **Waze**, **Google Maps** i **Apple Maps**. Przycisk e-mail na tej stronie ma już temat i treść wiadomości, a jeśli są znane, zawiera numer i godzinę rozmowy. Link do strony internetowej dostaje tagi śledzące, dzięki czemu możesz mierzyć, ilu dzwoniących w niego klika.

## Nagrania i transkrypcje [#opnames-en-transcripties]

<Steps>
<Step>
### Otwórz rozmowę [#open-het-gesprek]
Na liście kliknij przy rozmowie **Transkrypcja**. Otworzy się okno **Szczegóły rozmowy**.
</Step>
<Step>
### Wybierz kartę [#kies-een-tabblad]
Na karcie **Nagranie** rozmowa odtwarza się w przeglądarce. Na karcie **Transkrypcja** znajdziesz spisany tekst podzielony na rozmówców, a na karcie **Streszczenie** krótkie podsumowanie.
</Step>
</Steps>

Tillor sam tworzy transkrypcję i streszczenie, gdy tylko rozmowa się zakończy i istnieje nagranie. Chwilę to trwa. Przy rozmowie bez nagrania kart nie ma.

<Callout type="warn">
Nagrania rozmów mogą zawierać informacje wrażliwe pod względem prywatności. Zadbaj o zgodność z przepisami o ochronie danych (RODO) przy nagrywaniu rozmów i informuj dzwoniących, że rozmowy są nagrywane.
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Po zakończeniu rozmowa znajduje się na liście z czasem trwania, klientem oraz, jeśli jest nagranie, z transkrypcją i streszczeniem.
- Wysłany SMS z danymi organizacji znajdziesz w <UIPath>Komunikacja > Powiadomienia</UIPath> z typem **Dane organizacji**.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Lista rozmów jest pusta">
Sprawdź, czy Voys jest zainstalowany w <UIPath>Ustawienia > Integracje</UIPath> i czy powiadomienia o rozmowach w Voys wskazują adres URL z Tillora. Zobacz [Telefonia Voys](/communicatie/providers/voys).
</Accordion>
<Accordion title="Rozmowa nie należy do klienta">
Tillor porównuje numer dzwoniącego z numerem telefonu w profilu klienta lub u osoby kontaktowej. Dodaj numer, a nowe rozmowy zostaną powiązane. Rozmowy, które już wpłynęły, pozostają bez zmian.
</Accordion>
<Accordion title="Nie widzę przycisku SMS">
Przycisk znajduje się tylko w panelu aktywnych rozmów w prawym dolnym rogu i tylko wtedy, gdy rozmowa ma status **W toku**. Na liście na tej stronie go nie ma.
</Accordion>
<Accordion title="Nie widzę karty Nagranie">
Voys nie nagrał rozmowy. Włącz nagrywanie rozmów na swoim koncie Voys. Wcześniejszych rozmów nie można nagrać później.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Telefonia Voys" href="/communicatie/providers/voys" description="Instalacja Voys i konfiguracja planu połączeń" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Jak wysyłane są wiadomości SMS" />
  <Card title="Powiadomienia" href="/notificaties" description="Status doręczenia wysłanych wiadomości SMS" />
</Cards>


# Connector (/pl-PL/connector)

Tillor Connector to małe urządzenie w sieci Twojego parku. Łączy Tillor z urządzeniami na miejscu: drukarkami paragonów, szlabanami, kontrolerami dostępu i czytnikami dokumentów tożsamości. Bez connectora Tillor nie może obsługiwać tych urządzeń. Gdy jest wyłączony, drukowanie i obsługa szlabanów z poziomu Tillora nie działają. Jak sobie wtedy poradzić, opisujemy w sekcji [Problemy](#problemen).

Tillor dostarcza connector wstępnie skonfigurowany i monitoruje go zdalnie. Nie musisz niczego instalować ani aktualizować.

<Callout type="info" title="Warto wiedzieć">
- Każda organizacja ma jeden connector. Jeśli zarządzasz kilkoma parkami, każdy park (organizacja) dostaje własne urządzenie.
- Connector zgłasza się do Tillora co 15 sekund.
- Jeśli Tillor nie usłyszy od niego nic przez 3 minuty, zespół Tillor automatycznie otrzymuje powiadomienie.
- Aktualizacje instaluje sam Tillor, bez Twojego udziału.
- Connector sam nawiązuje zabezpieczone połączenie wychodzące. Nie musisz otwierać żadnych portów w routerze.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Connector stoi między Tillorem w internecie a urządzeniami w Twojej własnej sieci. Tillor wysyła polecenie do connectora, a connector wykonuje je na właściwym urządzeniu. W drugą stronę connector zgłasza, co się wydarzyło, na przykład odczytaną tablicę rejestracyjną.

```mermaid
flowchart LR
  T[Tillor] <-->|zabezpieczone połączenie przez internet| C[Connector w Twoim parku]
  C --> P[Drukarka paragonów]
  C --> S[Szlaban lub kontroler dostępu]
  C --> I[Czytnik dokumentów tożsamości]
```

Na przykład:

- Drukujesz paragon lub etykietę. Tillor wysyła ją do connectora, a ten przekazuje ją do Twojej drukarki.
- Nadajesz klientowi metodę dostępu. Tillor wysyła zmianę przez connector do kontrolerów dostępu, zobacz [Kontrola dostępu](/toegangscontrole#hoe-hangt-dit-samen).
- Gość skanuje dowód tożsamości przy zameldowaniu. Connector przekazuje skan do Tillora, zobacz [Skany tożsamości](/identiteitsscans).

## Co Tillor robi dla Ciebie [#wat-tillor-voor-je-doet]

- **Dostawa**: urządzenie przychodzi wstępnie skonfigurowane dla Twojej organizacji.
- **Instalacja i połączenie**: podczas uruchomienia łączymy Twoje drukarki, szlabany i skanery.
- **Aktualizacje**: nowe wersje są instalowane automatycznie, bez przerw.
- **Monitoring**: Tillor widzi, czy connector jest połączony, i sam reaguje na awarię.

## Czego potrzebujesz samodzielnie [#wat-je-zelf-nodig-hebt]

- Gniazdka w pobliżu sprzętu sieciowego
- Kabla sieciowego do routera lub switcha, w tej samej sieci co drukarki i szlabany
- Stabilnego połączenia z internetem

## Podłączone urządzenia [#gekoppelde-apparaten]

- **Drukarki**: zobacz [Drukarki](/printer), jak je skonfigurować i używać.
- **Szlabany, bramy i kontrolery dostępu**: zobacz [Kontrola dostępu](/toegangscontrole).
- **Czytniki dokumentów tożsamości**: zobacz [Skany tożsamości](/identiteitsscans), jak tworzyć klientów na podstawie skanu i jakie obowiązują okresy przechowywania.

<Callout type="info" title="Dla czytelnika technicznego">
W sieci Twojego parku możesz sprawdzić status connectora pod adresem `http://[adres-connectora]:3000/`. Zobaczysz tam połączenie z Tillorem, kolejkę wydruków i ostatnio odczytane tablice rejestracyjne. Adres poda Ci wsparcie Tillor podczas instalacji. Więcej o protokole znajdziesz w [MQTT](/ontwikkelaars/mqtt).
</Callout>

## Problemy? [#problemen]

<Accordions>
<Accordion title="Connector nie jest połączony">
Sprawdź, czy urządzenie ma zasilanie i czy kabel sieciowy jest dobrze podłączony. Zobacz, czy internet w Twoim parku działa. Następnie na chwilę wyjmij wtyczkę z urządzenia i włóż ją z powrotem. Jeśli problem nie znika, skontaktuj się ze wsparciem Tillor. Awarię zwykle widzimy sami.
</Accordion>
<Accordion title="Nie udaje się drukować ani obsługiwać szlabanu">
Najpierw sprawdź status connectora, zobacz wskazówkę techniczną powyżej. Sprawdź, czy urządzenie jest włączone i w tej samej sieci. Jeśli connector jest połączony i urządzenie jest osiągalne, ale nic się nie dzieje, skontaktuj się ze wsparciem.
</Accordion>
<Accordion title="Nowe metody dostępu nie docierają do bramy">
Zajrzyj do **Operacje kontrolera** na stronie Kontrola dostępu. Jeśli polecenie pozostaje w stanie **Oczekujące**, connector jest offline.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Connector**: urządzenie w Twoim parku, które łączy Tillor z Twoimi urządzeniami.
- **Kontroler dostępu**: urządzenie przy szlabanie, które odczytuje tagi i kody QR.
- **Rozwiązanie zarządzane**: Tillor dostarcza, konfiguruje i utrzymuje urządzenie za Ciebie.

Więcej wyjaśnień znajdziesz w [słowniku pojęć](/begrippen).

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Kontrolery" href="/controllers" description="Czytniki tagów przy prysznicach, drzwiach i punktach ładowania" />
  <Card title="Drukarki" href="/printer" description="Konfiguracja i używanie drukarek" />
  <Card title="Kontrola dostępu" href="/toegangscontrole" description="Szlabany i metody dostępu" />
  <Card title="Skany tożsamości" href="/identiteitsscans" description="Skanowanie dowodów tożsamości przy zameldowaniu" />
</Cards>


# Dokumenty (/pl-PL/documenten)

Dzięki zarządzaniu dokumentami przechowujesz pliki przy kliencie, takie jak polisy ubezpieczeniowe, dowody osobiste, umowy, zezwolenia i inne załączniki. Pliki, które nie należą jeszcze do nikogo, znajdują się na centralnej liście dokumentów, dopóki nie przypiszesz ich do klienta. Zacznij od [Dokumenty przy kliencie](#documenten-bij-een-klant) lub od [Centralna lista dokumentów](#de-centrale-documentenlijst).

<Callout type="info" title="Warto wiedzieć">
- Plik może mieć maksymalnie 250 MB.
- Możesz przesyłać pliki PDF, Word, wiadomości Outlook (.msg), Excel, PowerPoint, obrazy (JPEG, PNG, GIF) i pliki tekstowe.
- Obrazy Tillor po przesłaniu konwertuje do PDF. Pozostałe typy plików zostają bez zmian, a obok powstaje podgląd w PDF.
- Po usunięciu dokumentu otrzymasz na swój adres e-mail jego kopię jako załącznik, o ile udało się zabezpieczyć plik.
- Pliku PDF powiązanego z prośbą o podpis oraz podpisanego pliku PDF nie możesz usunąć, możesz je tylko zarchiwizować.
- Zarchiwizowany dokument zostaje zachowany, ale nie znajduje się już wśród aktywnych dokumentów.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  U[Przesłanie pliku lub e-mail] --> C[Centralna lista dokumentów]
  C -->|Przypisanie do klienta| K[Dokumenty klienta]
  K --> S[Prośba o podpis]
  S --> O[Podpisany PDF przy kliencie]
  M[Upoważnienie SEPA] --> K
```

Dokument znajduje się w jednym miejscu: albo na liście centralnej, albo przy kliencie. Jeśli przypiszesz go do klienta, znika z listy centralnej. Podpisane pliki PDF i podpisane upoważnienia trafiają do dokumentów klienta automatycznie.

## Dokumenty przy kliencie [#documenten-bij-een-klant]

### Przeglądanie dokumentów [#documenten-bekijken]

1. Przejdź do <UIPath>Klienci > Przegląd</UIPath> i otwórz profil klienta.
2. Kliknij kartę **Dokumenty**.
3. Zobaczysz dokumenty tego klienta, podzielone na **Aktywne** i **Zarchiwizowane**.
4. Kliknij dokument (lub ikonę oka), aby obejrzeć go po prawej w **Podgląd**. Ikoną pobierania zapiszesz go na dysku.

### Edycja, przenoszenie lub archiwizacja dokumentu [#een-document-bewerken-verplaatsen-of-archiveren]

Menu **…** przy dokumencie zawiera **Edytuj**, **Przenieś do klienta**, **Pobierz**, **Archiwizuj** (lub **Przywróć**) oraz **Usuń**.

### Usuwanie dokumentu [#een-document-verwijderen]

Zanim zaczniesz: dokumentu powiązanego z prośbą o podpis nie możesz usunąć. Zarchiwizuj go.

<Steps>
<Step>
### Wybierz Usuń [#kies-verwijderen]
Wybierz **Usuń** w menu **…** przy dokumencie.
</Step>
<Step>
### Potwierdź [#bevestig]
Potwierdź w oknie dialogowym przyciskiem **Usuń** lub anuluj przyciskiem **Anuluj**. Usunięcia nie można cofnąć.

<DocScreenshot src="/screenshots/documenten/document-delete-dialog.png" alt="Okno potwierdzenia usunięcia dokumentu" />
</Step>
</Steps>

Po usunięciu na adres e-mail Twojego konta przychodzi wiadomość z usuniętym dokumentem jako załącznikiem, dzięki czemu zwykle masz pod ręką kopię.

### Zlecanie podpisania dokumentu [#een-document-laten-ondertekenen]

Pod dokumentami klienta znajdują się **Prośby o podpis**. Przyciskiem **Poproś o podpisy** zlecasz podpisanie pliku PDF online klientowi, osobie kontaktowej, współpracownikowi lub podmiotowi zewnętrznemu. Podpisany PDF trafia do dokumentów jako **[tytuł] (podpisany)**, z typem **Podpisana umowa**, jeśli oryginalny PDF nie miał typu. Zobacz [Podpisy](/handtekeningen).

## Centralna lista dokumentów [#de-centrale-documentenlijst]

Oprócz dokumentów przy klientach Tillor ma listę centralną. Pojawiają się na niej pliki, które nie są jeszcze przypisane do klienta, na przykład dokumenty wpływające e-mailem. Przejdź do <UIPath>Administracja > Dokumenty</UIPath>.

<DocScreenshot src="/screenshots/documenten/documents-upload.png" alt="Centralna lista dokumentów ze strefą przesyłania" />

### Przesyłanie dokumentu [#een-document-uploaden]

<Tabs items={["Przeciągnij lub wybierz", "E-mailem"]}>
<Tab value="Przeciągnij lub wybierz">
Przeciągnij plik do obszaru przesyłania lub kliknij **Wybierz plik**. Plik zostanie zapisany automatycznie i pojawi się jako nowa pozycja na liście.
</Tab>
<Tab value="E-mailem">
W obszarze przesyłania znajduje się specjalny adres e-mail. Wyślij plik jako załącznik na ten adres, a pojawi się automatycznie na liście centralnej.
</Tab>
</Tabs>

### Przypisywanie dokumentu do klienta [#een-document-koppelen-aan-een-klant]

Każdy dokument na liście centralnej ma formularz edycji i panel podglądu.

<Steps>
<Step>
### Znajdź dokument [#zoek-het-document]
Przejdź do <UIPath>Administracja > Dokumenty</UIPath> i przewiń do dokumentu.
</Step>
<Step>
### Uzupełnij pola [#vul-de-velden-in]
- **Nazwa dokumentu**: nazwa dokumentu.
- **Przypisz do klienta**: klient, do którego należy ten dokument (opcjonalnie).
- **Typ dokumentu**: na przykład **Polisa ubezpieczeniowa**, **Dowód opłacenia ubezpieczenia**, **Dowód osobisty**, **Upoważnienie SEPA**, **Podpisana umowa** lub **Inne** (opcjonalnie).
- **Data wygaśnięcia ubezpieczenia**: data, w której ubezpieczenie lub zezwolenie wygasa. To pole pojawia się tylko przy typach dokumentów, które mogą mieć datę ważności.
- **Uwagi**: dowolne notatki do dokumentu (opcjonalnie).
</Step>
<Step>
### Zapisz [#sla-op]
Kliknij **Zapisz zmiany**.
</Step>
</Steps>

### Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Dokument znika z listy centralnej i znajduje się na karcie **Dokumenty** tego klienta.
- Jeśli uzupełniono **Data wygaśnięcia ubezpieczenia**, zobaczysz ją jako etykietę przy dokumencie.

## Sugestie AI przy dokumentach [#ai-suggesties-bij-documenten]

Gdy przesyłasz plik PDF, Tillor analizuje jego treść w tle. Jeśli Tillor rozpozna nazwę zgodną z klientem w Twojej administracji, obok **Przypisz do klienta** pojawia się przycisk sugestii z nazwą klienta i wartością procentową określającą, jak pewny jest Tillor. Taka sugestia może się pojawić także dla daty wygaśnięcia ubezpieczenia.

Kliknij przycisk, aby przyjąć sugestię, lub wybierz samodzielnie innego klienta. Sugestia jest zawsze tylko propozycją. Kliknij **Zapisz zmiany**, aby Twój wybór stał się ostateczny.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę usunąć dokumentu">
Jeśli dokument należy do prośby o podpis, jako oryginalny PDF lub podpisany PDF, Tillor odmawia usunięcia, ponieważ jest to dowód. Zarchiwizuj go przyciskiem **Archiwizuj** w menu **…**.
</Accordion>
<Accordion title="Tillor zgłasza: Archiwizacja nie powiodła się">
Komunikat brzmi **Nie udało się zarchiwizować dokumentu.** Spróbuj ponownie. To samo dotyczy **Przywracanie nie powiodło się** przy **Przywróć**.
</Accordion>
<Accordion title="Tillor zgłasza: Aktualizacja nie powiodła się">
Twoje zmiany w **Nazwa dokumentu**, kliencie, typie lub uwagach nie zostały zapisane. Sprawdź formularz i ponownie kliknij **Zapisz zmiany**.
</Accordion>
<Accordion title="Tillor zgłasza: Pobieranie nie powiodło się">
Nie udało się pobrać dokumentu. Spróbuj ponownie.
</Accordion>
<Accordion title="Brakuje pola Data wygaśnięcia ubezpieczenia">
To pole pojawia się tylko przy typach dokumentów, które mogą mieć datę ważności, takich jak **Polisa ubezpieczeniowa**. Najpierw wybierz właściwy typ w **Typ dokumentu**.
</Accordion>
<Accordion title="Mój plik nie jest akceptowany">
Sprawdź typ pliku (PDF, Word, wiadomość Outlook, Excel, PowerPoint, JPEG, PNG, GIF lub tekst) oraz rozmiar (maksymalnie 250 MB).
</Accordion>
<Accordion title="Dokumentu nie ma już na liście centralnej">
Gdy dokument zostanie przypisany do klienta, znajduje się już tylko przy tym kliencie w **Dokumenty**. Jeśli jest w archiwum, znajdziesz go w **Zarchiwizowane**.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Typ dokumentu**: rodzaj dokumentu, na przykład **Polisa ubezpieczeniowa** lub **Dowód osobisty**.
- **Zarchiwizowane**: dokument, który jest zachowany, ale nie znajduje się już wśród aktywnych dokumentów.
- **Centralna lista dokumentów**: pliki, które nie są jeszcze przypisane do klienta.
- **Prośba o podpis**: polecenie podpisania pliku PDF. Zobacz [prośba o podpis](/begrippen#ondertekenverzoek).
- **Klient**: rekord w Tillorze, do którego przypięty jest dokument. Zobacz [klient](/begrippen#klant).

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Zarządzanie klientami" href="/klantenbeheer" />
  <Card title="Podpisy" href="/handtekeningen" />
</Cards>


# Przegląd (/pl-PL/eigen-velden)

Dzięki polom niestandardowym samodzielnie dodajesz pola do rekordu. Pomyśl o numerze kaucji za butlę gazową u klienta, dopłacie przy stanowisku albo przewidywanej godzinie przyjazdu przy rezerwacji. Pole pojawia się w formularzu tego rekordu, tak samo jak pola, które Tillor dostarcza sam.

Zarządzasz nimi w <UIPath>Ustawienia > Pola niestandardowe</UIPath>.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-list.png" alt="Ustawienia > Pola niestandardowe z kartą Klienci i listą pól" />

<Callout type="info" title="Warto wiedzieć">
- Typu pola i klucza nie można zmienić po utworzeniu
- Tekst: domyślnie maksymalnie 1000 znaków, Długi tekst 10 000. Lista wyboru ma maksymalnie 200 opcji
- Grupa pól ma maksymalnie 30 podpól. Powtarzane wiersze: domyślnie maksymalnie 100 wierszy, nigdy więcej niż 500
- Pliki: domyślnie maksymalnie 20 na pole (nigdy więcej niż 50), każdy maksymalnie 50 MB
- Pole, które znika z powodu warunku, jest opróżniane przy zapisie rekordu
- Usunięte pole znika z formularzy. Wpisane wartości pozostają jednak na rekordach
- Wszystkie limity dla poszczególnych typów znajdziesz w [Typy pól i ustawienia](/eigen-velden/veldtypes)
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Pole tworzysz raz, a potem pojawia się wszędzie tam, gdzie wypełnia się ten rodzaj rekordu.

```mermaid
flowchart LR
  L[Lista wyboru z opcjami] -->|używana przez| V[Pole niestandardowe typu Wybór]
  V -->|znajduje się w formularzu| R[Klient, stanowisko, zajęcie, zadanie i inne rekordy]
  T[Dostęp: kto może widzieć i edytować] --> V
  R -->|wartości wracają w| E[Eksportach, filtrach i automatyzacjach]
```

- **Listy wyboru** tworzysz niezależnie od pól. Gdy zmienisz opcję, zmiana obowiązuje w każdym polu, które używa tej listy.
- **Pole** należy do jednego rodzaju rekordu. Typ i klucz są stałe.
- **Dostęp** ustawiasz dla każdego pola. Kto nie może zobaczyć pola, nigdy nie zobaczy wartości, także w eksportach ani automatyzacjach.

## Gdzie możesz dodawać pola niestandardowe [#waar-kun-je-eigen-velden-toevoegen]

Każdy rodzaj rekordu ma własną kartę. Za nazwą widnieje liczba pól.

| Karta | Rekord |
|---|---|
| **Klienci** | Profil klienta |
| **Stanowiska** | Stanowisko |
| **Zajęcia** | Zajęcie |
| **Liczniki** | Licznik |
| **Zadania** | Zadanie |
| **Produkty** | Produkt |
| **Dokumenty** | Dokument |
| **Rezerwacje** | Rezerwacja |
| **Metody dostępu** | Metoda dostępu |

Karta **Listy wyboru** nie ma rekordów. Tworzysz tam listy opcji, których używasz ponownie w polach wyboru.

## Co możesz z nimi zrobić [#wat-je-ermee-kunt]

- Dodać pole określonego typu, takiego jak tekst, liczba, kwota, data, wybór lub plik. Zobacz [Typy pól i ustawienia](/eigen-velden/veldtypes)
- Umieścić pole w formularzu wśród istniejących pól albo pokazywać je tylko wtedy, gdy inna wartość się zgadza
- Uczynić pole wymaganym, ewentualnie tylko pod warunkiem
- Określić, kto może widzieć pole, a kto je edytować. Zobacz [Widoczność i dostęp](/eigen-velden/zichtbaarheid-en-toegang)

Wartości są dostępne w eksporcie klientów i stanowisk oraz w automatyzacjach. Automatyzacja może też wypełnić pole niestandardowe krokiem **Ustaw pole niestandardowe**.

## Kto może z tego korzystać [#wie-kan-het-gebruiken]

<Callout type="info" title="Zarządzanie wymaga uprawnienia">
Tworzenie, zmienianie, zmiana kolejności i usuwanie pól jest możliwe z uprawnieniem **Zarządzanie polami niestandardowymi**. Kto go nie ma, może otworzyć stronę, jeśli wolno mu wyświetlać ustawienia, ale przyciski są wtedy wyłączone.
Pole na rekordzie może wypełnić każdy, kto może to pole widzieć i edytować.
</Callout>

## Elementy [#onderdelen]

<Cards>
  <Card
    title="Tworzenie pola niestandardowego"
    href="/eigen-velden/veld-aanmaken"
    description="Krok po kroku: dodaj pole, umieść je i dostosuj"
  />
  <Card
    title="Listy wyboru"
    href="/eigen-velden/keuzelijsten"
    description="Zapisz opcje dla typów Wybór i Wybór wielokrotny"
  />
  <Card
    title="Typy pól i ustawienia"
    href="/eigen-velden/veldtypes"
    description="Jakie ustawienia i ograniczenia ma każdy typ"
  />
  <Card
    title="Widoczność i dostęp"
    href="/eigen-velden/zichtbaarheid-en-toegang"
    description="Gdzie znajdują się wartości i kto może je widzieć lub edytować"
  />
</Cards>

## Pojęcia [#begrippen]

- **[Pole niestandardowe](/begrippen#eigen-veld)**: dodatkowe pole, które samodzielnie dodajesz do rekordu
- **Etykieta**: nazwa, którą współpracownicy widzą nad polem wprowadzania
- **Klucz**: stała nazwa pola, na przykład `gasMeterNumber`. Widzisz ją na liście i jest używana w eksportach i filtrach
- **Typ**: jaki rodzaj wartości przechowuje pole
- **[Lista wyboru](/begrippen#keuzelijst)**: lista opcji, której używasz w wielu polach wyboru

Więcej pojęć znajdziesz w [słowniku pojęć](/begrippen). Rozbudowany przykład znajdziesz w [Przykładach z praktyki](/praktijk).


# Tworzenie list wyboru (/pl-PL/eigen-velden/keuzelijsten)

Pole typu **Wybór** lub **Wybór wielokrotny** potrzebuje listy wyboru. Tworzysz listę raz i używasz jej w tylu polach, w ilu chcesz. Gdy zmienisz opcję, zmiana od razu obowiązuje wszędzie.

<Requires permission="Zarządzanie polami niestandardowymi" />

<Steps>
<Step>
### Otwórz kartę Listy wyboru [#open-het-tabblad-keuzelijsten]
Przejdź do <UIPath>Ustawienia > Pola niestandardowe</UIPath> i kliknij **Listy wyboru**. Każda lista pokazuje swoje opcje z kolorem i liczbą pól, które z niej korzystają.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enums.png" alt="Karta Listy wyboru z listą Rodzaj umowy" />
</Step>
<Step>
### Utwórz listę [#maak-een-lijst-aan]
Kliknij **Nowa lista wyboru**. Wpisz **Nazwa** i ewentualnie **Opis**. Tillor sam tworzy **Klucz**.
</Step>
<Step>
### Dodaj opcje [#voeg-opties-toe]
Kliknij **Dodaj opcję** i wpisz **Etykieta**, na przykład *Sezon*. Kropką koloru wybierz kolor. Lista potrzebuje co najmniej jednej opcji.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enum-dialog.png" alt="Okno Nowa lista wyboru" />
</Step>
<Step>
### Zapisz [#sla-op]
Kliknij **Zapisz**. Potem wybierz listę przy tworzeniu pola typu **Wybór** lub **Wybór wielokrotny**.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Lista jest dostępna przy tworzeniu pola typu **Wybór** lub **Wybór wielokrotny**.
- Jeśli później zmienisz etykietę lub kolor opcji, zmiana od razu obowiązuje w każdym polu, które używa tej listy.
- **Wartość** opcji jest stała od chwili, gdy zostanie użyta na rekordzie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę usunąć listy">
Listy, która jest jeszcze używana w polu, nie możesz usunąć. Tillor zgłasza, że lista jest nadal używana przez pole. Najpierw usuń listę z tych pól albo usuń te pola.
</Accordion>
<Accordion title="Przy moim polu wyboru widnieje Najpierw utwórz listę wyboru">
Nie ma jeszcze żadnej listy. Utwórz ją na karcie **Listy wyboru**, a potem wybierz ją w polu.
</Accordion>
<Accordion title="Nie mogę zapisać listy">
Lista potrzebuje co najmniej jednej opcji i ma ich maksymalnie 200. Dodaj opcję przyciskiem **Dodaj opcję**.
</Accordion>
</Accordions>


# Tworzenie pola niestandardowego (/pl-PL/eigen-velden/veld-aanmaken)

Polem niestandardowym zapisujesz dane, których Tillor sam nie zna, na przykład numer kaucji za butlę gazową u klienta. Tworzysz je w kilka minut, a po prawej stronie od razu widzisz, jak współpracownicy dostaną to pole. Potem wypełniasz je na samym rekordzie, zobacz [Widoczność i dostęp](/eigen-velden/zichtbaarheid-en-toegang).

Zanim zaczniesz:

- Potrzebujesz uprawnienia **Zarządzanie polami niestandardowymi**. Bez niego przycisk **Nowe pole** jest wyszarzony.
- Jeśli pole wymaga wyboru, najpierw utwórz [listę wyboru](/eigen-velden/keuzelijsten). W przeciwnym razie zobaczysz **Najpierw utwórz listę wyboru**.
- Typ wybierz starannie: potem nie możesz go już zmienić.

<Requires permission="Zarządzanie polami niestandardowymi" />

<Steps>
<Step>
### Otwórz Pola niestandardowe i wybierz kartę [#open-eigen-velden-en-kies-het-tabblad]
Przejdź do <UIPath>Ustawienia > Pola niestandardowe</UIPath> i otwórz kartę rekordu, do którego należy pole, na przykład **Klienci**. Kliknij **Nowe pole**.

Jeśli karta jest jeszcze pusta, w sekcji **Szybki start** zobaczysz kilka propozycji, takich jak **Liczba psów** przy klientach. Kliknij propozycję, aby otworzyć wypełniony już formularz. Propozycje z listą wyboru najpierw proszą o listę. Zobacz [Listy wyboru](/eigen-velden/keuzelijsten).
</Step>
<Step>
### Wypełnij pole [#vul-het-veld-in]
W sekcji **1. Pole** wybierasz w **Dotyczy** rodzaj rekordu, nadajesz polu **Etykieta** i wybierasz **Typ**. Każda karta typu ma krótkie wyjaśnienie.

Tillor sam tworzy **Klucz** z Twojej etykiety. W sekcji **3. Klucz** możesz go zmienić przyciskiem **Zmień**, zanim zapiszesz.

<DocScreenshot src="/screenshots/eigen-velden/field-new-form.png" alt="Nowe pole niestandardowe z kartami typów, ustawieniami i podglądem po prawej" />
</Step>
<Step>
### Dopracuj pole [#stel-het-veld-af]
W sekcji **2. Ustawienia** znajdują się opcje właściwe dla wybranego typu. Zobacz [Typy pól i ustawienia](/eigen-velden/veldtypes). Poza tym możesz wybrać:

- **Szerokość**: **Połowa** lub **Pełna szerokość** w formularzu
- **Pozycja w formularzu**: zostaw pole na dole (**Sekcja domyślna (na dole)**) albo wybierz istniejące pole formularza i umieść pole **Przed** lub **Po** tym polu
- **Wymagane**: rekordu nie można zapisać, dopóki pole jest puste
- **Widoczność**: pokaż pole tylko wtedy, gdy spełniony jest warunek
- **Wymagane gdy**: uczyń pole wymaganym tylko wtedy, gdy spełniony jest warunek
- **Reguły walidacji**: porównaj wartość z innym polem albo sprawdź ją wyrażeniem
- **Tekst pomocy**: krótkie wyjaśnienie pod polem wprowadzania
</Step>
<Step>
### Określ, kto ma dostęp [#bepaal-wie-erbij-mag]
W sekcji **4. Dostęp** domyślnie każdy może widzieć i edytować pole. Kliknij **Ogranicz**, aby to zmienić. Zobacz [Widoczność i dostęp](/eigen-velden/zichtbaarheid-en-toegang).
</Step>
<Step>
### Zapisz pole [#sla-het-veld-op]
Kliknij **Zapisz**. Tillor zgłasza **Pole zapisane** i wraca do listy. Pole od razu znajduje się w formularzu rekordu.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Pole od razu znajduje się w formularzu rekordu, w miejscu, które wybrano.
- Istniejące rekordy mają jeszcze pustą wartość. Jeśli pole jest wymagane, współpracownik musi je wypełnić, zanim ponownie zapisze taki rekord.
- Wartości trafiają do eksportu klientów i stanowisk oraz są dostępne w automatyzacjach.
- Kto może widzieć lub edytować pole, ustawiasz w **4. Dostęp**.

## Miejsce i warunki [#plaats-en-voorwaarden]

Za pomocą **Pozycja w formularzu** umieszczasz pole obok pól, do których należy, zamiast na dole. Za pomocą **Widoczność** pokazujesz pole tylko wtedy, gdy wymaga tego inna wartość. W tym przykładzie **Przechowywanie zimowe** pojawia się tylko przy stanowisku z **Rodzaj umowy** Sezon, tuż po **Opis**.

<DocScreenshot src="/screenshots/eigen-velden/field-edit-conditions.png" alt="Edycja pola z Pozycja w formularzu oraz warunkiem w Widoczność i Wymagane gdy" />

Warunek składa się z jednej lub kilku reguł. W **Typ warunku** wybierasz **Reguły** lub **Wyrażenie**. Wyrażenie jest przeznaczone na skomplikowane przypadki i wymaga kawałka kodu. Dla większości pól wystarczą reguły.

<Callout type="info" title="Ukryte pole jest opróżniane">
Jeśli pole znika, bo warunek przestał być spełniony, Tillor usuwa wartość przy zapisie rekordu. Gdy pole wróci, jest puste. Pole wymagane pod warunkiem jest wymagane tylko wtedy, gdy jest widoczne.
</Callout>

## Edycja, przenoszenie lub usuwanie pola [#een-veld-bewerken-verplaatsen-of-verwijderen]

Na liście każde pole ma cztery przyciski.

| Przycisk | Co robi |
|---|---|
| **W górę** i **W dół** | Zmienia kolejność pól w formularzu |
| **Edytuj pole** | Otwiera pole. Typ, klucz i rekord, do którego należy pole, są wtedy stałe |
| **Usuń** | Usuwa pole po potwierdzeniu |

Usunięte pole znika z formularzy. Wpisane wartości pozostają na rekordach, ale nie są już wyświetlane ani edytowane.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę kliknąć Nowe pole">
Przycisk jest wyłączony bez uprawnienia **Zarządzanie polami niestandardowymi**. Poproś administratora o nadanie uprawnienia.
</Accordion>
<Accordion title="Chcę zmienić typ lub klucz istniejącego pola">
Nie da się. Utwórz nowe pole z właściwym typem, a potem usuń stare. Wartości starego pola Tillor nie przenosi.
</Accordion>
<Accordion title="Moje pole nie znajduje się tam, gdzie oczekuję">
Sprawdź w **Pozycja w formularzu**, czy wybrano pole. Przy **Sekcja domyślna (na dole)** pole znajduje się po polach standardowych formularza. Jeśli ma warunek w **Widoczność**, jest tam tylko wtedy, gdy warunek jest spełniony.
</Accordion>
</Accordions>


# Typy pól i ustawienia (/pl-PL/eigen-velden/veldtypes)

Przy tworzeniu pola wybierasz typ. Potem nie możesz go już zmienić. W sekcji **2. Ustawienia** znajdują się opcje tego typu. Wszystkie opcje są opcjonalne, chyba że poniżej napisano inaczej.

Przy prawie każdym typie możesz też wpisać **Komunikat błędu**. Zastępuje on komunikat standardowy, gdy wartość jest niepoprawna. Za pomocą **Tekst zastępczy** określasz, co widnieje w pustym polu wprowadzania.

## Tekst i Długi tekst [#tekst-en-lange-tekst]

**Tekst** to jedna linia, **Długi tekst** to kilka linii.

| Ustawienie | Co robi |
|---|---|
| **Minimalna długość** i **Maksymalna długość** | Liczba znaków. Bez maksimum obowiązuje 1000 znaków przy Tekście i 10 000 przy Długim tekście |
| **Format** | **Dowolny tekst**, **Adres e-mail**, **Numer telefonu**, **Adres strony**, **IBAN**, **Kod pocztowy**, **Tylko cyfry** lub **Własny wzorzec** |
| **Wzorzec (wyrażenie regularne)** | Przy **Własny wzorzec**. Cała wartość musi pasować. Tillor odrzuca wzorce z zagnieżdżonymi powtórzeniami lub odwołaniami wstecznymi oraz wzorce dłuższe niż 200 znaków |

## Liczba i Kwota [#getal-en-bedrag]

**Kwota** używa waluty Twojej organizacji.

| Ustawienie | Dotyczy | Co robi |
|---|---|---|
| **Minimum** i **Maksimum** | Liczba, Kwota | Dolna i górna granica |
| **Tylko liczby całkowite** | Liczba | Bez miejsc po przecinku |
| **Wyświetlanie** | Liczba, tylko przy liczbach całkowitych | **Pole wprowadzania** lub **Licznik (− / +)** z przyciskami |
| **Krok** | Liczba | Wartość musi być minimum (lub 0) plus całkowitą liczbą kroków |
| **Maksymalna liczba miejsc po przecinku** | Liczba | Ogranicza miejsca po przecinku |

## Tak / nie [#ja--nee]

Przełącznik włącz/wyłącz. Dzięki **Musi być zaznaczone** rekord można zapisać tylko z zaznaczonym polem. Przydatne przy zgodzie.

## Data [#datum]

| Ustawienie | Co robi |
|---|---|
| **Najwcześniejsza data** i **Najpóźniejsza data** | Stałe granice |
| **Nie w przeszłości** i **Nie w przyszłości** | Porównanie z dniem dzisiejszym w strefie czasowej Twojej organizacji |
| **W ciągu dni od dzisiaj** | Najwyżej tyle dni przed lub po dzisiejszym dniu |

## Wybór i Wybór wielokrotny [#keuze-en-meerkeuze]

Wybierasz [listę wyboru](/eigen-velden/keuzelijsten). **Wybór** zapisuje jedną opcję, **Wybór wielokrotny** kilka. Przy Wyborze wielokrotnym ustawiasz **Minimalnie wybranych** i **Maksymalnie wybranych**. Lista ma maksymalnie 200 opcji.

## Powiązanie z rekordem [#koppeling-naar-record]

Pole wskazuje inny rekord w Tillorze.

| Ustawienie | Co robi |
|---|---|
| **Łączy z** | Klient, Stanowisko, Zajęcie, Licznik, Zadanie, Faktura, Rezerwacja, Raport płatności, Rozmowa telefoniczna, Osoba kontaktowa, Produkt, Szafka licznikowa, Płatność, Dokument, Tag NFC lub Metoda dostępu |
| **Wiele rekordów** | Zezwala na więcej niż jeden powiązany rekord. Możesz wtedy ustawić też minimum i maksimum |
| **Wyświetlanie** | **Lista wyboru** lub **Lista rozwijana** (jedna lista z wyszukiwaniem) |
| **Tylko rekordy tego klienta** | Ogranicza opcje do rekordów klienta, którego edytujesz. Tylko przy Osoba kontaktowa, Faktura, Rezerwacja, Zajęcie, Płatność, Dokument, Tag NFC i Metoda dostępu |
| **Tylko rekordy działki** | Ogranicza opcje do liczników stanowiska: przy zajęciu stanowisko tego zajęcia, przy stanowisku samo stanowisko. Tylko przy Licznik. Licznika z innego stanowiska nie można zapisać |
| **Filtruj opcje** | Opcjonalny TypeScript, który dla każdej opcji określa, czy trafia na listę, zobacz [Filtruj opcje](#opties-filteren). Przy Osoba kontaktowa, Produkt, Szafka licznikowa, Płatność, Dokument, Tag NFC, Metoda dostępu, Faktura, Rezerwacja, Zajęcie, Licznik i Stanowisko |

Jeśli powiązany rekord zostanie później usunięty, pole pokazuje **Usunięto**.

Jeśli do wyboru jest co najmniej 50 rekordów, najpierw wpisujesz 2 znaki, aby wyszukać. Jeśli jest ich mniej, na przykład liczniki jednego stanowiska, od razu widzisz je wszystkie.

### Filtruj opcje [#opties-filteren]

Za pomocą **Filtruj opcje** sam określasz, które rekordy oferuje pole. Piszesz TypeScript, tak jak w [formule stawki](/terreinen#tariefformule), który Tillor wykonuje dla każdej opcji. Jeśli zwróci `true`, opcja trafia na listę, w przeciwnym razie nie.

W filtrze odczytujesz pola w nawiasach klamrowych. Menu **Zmienna** pokazuje, co jest dostępne, łącznie z polami niestandardowymi:

| Zmienna | Co to jest |
|-----------|------------|
| `{option.…}` | Rekord, który możesz wybrać, na przykład `{option.type}` lub `{option.terrainId}` przy liczniku |
| `{occupation.…}`, `{terrain.…}`, … | Rekord, który edytujesz, pod nazwą jego typu, z `customFields` dla jego własnych pól |

Przykład: tylko liczniki prądu ze stanowiska zajęcia.

```ts
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};
```

### Własne etykiety [#eigen-labels]

Ten sam filtr może też określać, jak opcja nazywa się na liście. To, co zwrócisz, określa wynik:

| Zwracasz | Wynik |
|----------------|-----------|
| `true` | Opcja jest na liście pod własną nazwą |
| `false`, `null` lub pusty tekst | Opcji nie ma na liście |
| Tekst | Opcja jest na liście pod tym tekstem |
| `{ label, group }` | Opcja dostaje tę etykietę i trafia pod nagłówek `group`. Oba są opcjonalne |

Przykład: tylko liczniki ICY i Hydrodigit, z typem i pogrupowane według dostawcy.

```ts
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };
```

Etykieta obowiązuje na liście wyboru i na wybranych chipach w formularzu. W miejscach, które pokazują tylko wartość, takich jak strona szczegółów czy eksport, widnieje własna nazwa rekordu.

**Wstaw przykład** pod polem daje punkt wyjścia. Filtru, który się nie kompiluje, nie możesz zapisać; komunikat pod polem mówi, co jest nie tak.

Filtr nie ogranicza tylko listy. Jeśli przez API lub stary formularz wybierzesz jednak rekord, który filtr pomija, Tillor odmówi zapisu, podając nazwę pola. Automatyzacje i importy nie są sprawdzane, tak jak mogą wypełniać ukryte pola.

## Grupa pól [#groep-velden]

Stały zestaw podpól, które razem znajdują się w formularzu, takich jak **Psy** i **Inne zwierzęta** w **Zwierzęta**.

| Ustawienie | Co robi |
|---|---|
| **Dodaj podpole** | Każde podpole ma etykietę, typ i własne ustawienia. Kliknij **Więcej**, aby zobaczyć klucz, szerokość i warunki. Grupa może mieć maksymalnie 30 podpól |
| **Wyświetlanie** | **Ramka** (z obramowaniem) lub **W linii** (pola płynnie przechodzą w formularz) |
| **Kolumny** | Od 1 do 4 |
| **Szerokość w grupie** | Ile kolumn zajmuje dane podpole |

## Powtarzane wiersze [#herhalende-rijen]

Tabela, do której dodajesz wiersze przyciskiem **Dodaj wiersz**, na przykład kilka pojazdów. Podpola ustawiasz tak samo jak w grupie. Za pomocą **Minimalna liczba wierszy** i **Maksymalna liczba wierszy** ograniczasz listę. Bez maksimum obowiązuje 100 wierszy, a więcej niż 500 nie jest możliwe.

Grupa lub powtarzane wiersze mogą zawierać jeszcze jeden poziom głębiej kolejną grupę lub powtarzane wiersze, nie dalej.

## Pliki [#bestanden]

Dla dokumentów i zdjęć. Przesłany plik może otworzyć tylko ten, kto może widzieć pole.

| Ustawienie | Co robi |
|---|---|
| **Wiele plików** | Zezwala na więcej niż jeden plik |
| **Minimalna liczba plików** i **Maksymalna liczba plików** | Bez maksimum obowiązuje 20 plików, a więcej niż 50 nie jest możliwe |
| **Maksymalny rozmiar pliku (MB)** | Maksymalnie 50 MB na plik, także gdy chcesz wyższą wartość |
| **Dozwolone typy plików** | **Dowolny plik**, **Obrazy**, **PDF**, **Dokumenty biurowe** lub własne rozszerzenie, takie jak `.dwg`, albo typ MIME, taki jak `application/zip` |

Tillor sprawdza typ na podstawie zawartości pliku, nie tylko nazwy.

## JSON [#json]

Przeznaczony dla danych strukturalnych, które przekazuje integracja z innym systemem. Współpracownicy rzadko wypełniają to w formularzu. Za pomocą **Maksymalny rozmiar (KB)** ustawiasz granicę, domyślnie 64 KB i maksymalnie 256 KB.

## Ustawienia dla każdego typu [#instellingen-voor-elk-type]

| Ustawienie | Co robi |
|---|---|
| **Szyfruj tę wartość** | Przechowuje wartość zaszyfrowaną. Zaszyfrowanego pola nie można przeszukiwać, filtrować ani sortować i nie jest dostępne jako zmienna w automatyzacjach. Tylko dla pól najwyższego poziomu, więc nie dla podpól. Wszystkie pola niestandardowe i tak są przechowywane zaszyfrowane, niezależnie od tego, czy to włączysz |
| **Tylko API** | Ukrywa pole w formularzach i widokach szczegółów. Integracja wypełnia je przez API. Takie pole nie może być wymagane |
| **Tylko API, tylko do odczytu** | Pokazuje pole, ale wyłączone, dzięki czemu współpracownicy widzą wartość, ale jej nie zmieniają |
| **Reguły walidacji** | Porównaj datę, liczbę lub kwotę z innym polem (**Przed**, **W dniu lub przed**, **Po**, **W dniu lub po**, z przesunięciem w dniach, tygodniach lub miesiącach) albo sprawdź wartość wyrażeniem. Maksymalnie 10 reguł na pole |

Zmieniona granica nie działa wstecz. Wartość, której nie zmieniasz, nie blokuje zapisu rekordu, nawet jeśli nie spełnia już nowej reguły.


# Widoczność i dostęp (/pl-PL/eigen-velden/zichtbaarheid-en-toegang)

Pole niestandardowe znajduje się w formularzu rekordu, do którego należy. Domyślnie każdy z dostępem do tego rekordu może pole widzieć i wypełniać. Możesz to ograniczyć dla każdego pola.

## Gdzie widzisz wartości [#waar-je-de-waarden-ziet]

Pola niestandardowe wypełniasz w tym samym miejscu co pozostałe dane rekordu.

| Rekord | Gdzie |
|---|---|
| Klient | Blok **Dane klienta** w profilu klienta |
| Stanowisko, licznik, zajęcie, rezerwacja, produkt, dokument, metoda dostępu | Formularz tworzenia lub edycji rekordu |
| Zadanie | Okno zadania. Zmiany zapisujesz przyciskiem **Zapisz pola** |

Pole znajduje się w miejscu, które wybrano w **Pozycja w formularzu**. Bez wyboru znajduje się po polach standardowych.

<DocScreenshot src="/screenshots/eigen-velden/customer-custom-fields.png" alt="Profil klienta z polami niestandardowymi, takimi jak Psy, Data przyjazdu i Numer kaucji za butlę gazową, wśród pól standardowych" />

Jeśli pole jest wymagane, nie możesz zapisać rekordu, dopóki jest puste. Pole z **Widoczność** pojawia się dopiero wtedy, gdy warunek jest spełniony.

Pola niestandardowe znajdziesz też w eksporcie klientów i stanowisk i możesz używać ich w automatyzacjach.

## Kto może widzieć lub edytować pole [#wie-mag-een-veld-zien-of-bewerken]

Otwórz pole w <UIPath>Ustawienia > Pola niestandardowe</UIPath> i przejdź do **4. Dostęp**. Kliknij **Ogranicz**.

<Requires permission="Zarządzanie polami niestandardowymi" />

<DocScreenshot src="/screenshots/eigen-velden/field-edit-access.png" alt="Edycja pola z Kto widzi to pole i Kto może edytować to pole" />

Masz dwa bloki.

| Blok | Co robi |
|---|---|
| **Kto widzi to pole** | Jeśli zostawisz puste, każdy członek może je zobaczyć. Kto nie może go zobaczyć, nigdy nie zobaczy wartości, także w eksportach ani automatyzacjach, które edytuje |
| **Kto może edytować to pole** | Jeśli zostawisz puste, każdy, kto widzi pole, może je także edytować. Inni widzą je tylko do odczytu |

W każdym bloku wybierasz **współpracownika lub grupę** i/lub **uprawnienie**. Jeśli ktoś pasuje do jednego z wybranych współpracowników, grup lub uprawnień, ma dostęp. Edytować możesz tylko wtedy, gdy możesz też widzieć pole.

Na liście takie pole dostaje etykietę **Ograniczone**. Najedź na nią, aby zobaczyć wyjaśnienie: tylko wybrani współpracownicy, grupy lub uprawnienia mogą widzieć lub edytować to pole.

<Callout type="warn" title="Ukryte pole nie jest zabezpieczone">
Opcja **Widoczność** (warunek) ukrywa pole tylko w formularzu. Kto może widzieć pole, nadal może znaleźć wartość. Użyj **Kto widzi to pole**, jeśli nikt inny nie może jej czytać.
</Callout>

## Kto może zarządzać polami [#wie-mag-velden-beheren]

Tworzenie, zmienianie, zmiana kolejności i usuwanie pól oraz zarządzanie listami wyboru wymaga uprawnienia **Zarządzanie polami niestandardowymi**. Jak nadawać uprawnienia, opisano w [Zapraszanie użytkowników i nadawanie uprawnień](/gebruikers/gebruikers-en-rechten). Strona **Pola niestandardowe** jest widoczna dla tego, kto może wyświetlać lub edytować ustawienia, albo ma to uprawnienie. Bez uprawnienia widzisz tylko pola, które możesz czytać, a **Nowe pole**, edycja i usuwanie są wyłączone.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Współpracownik nie widzi pola">
Sprawdź w **Kto widzi to pole**, czy wybrano tego współpracownika, jego grupę lub jedno z jego uprawnień. Jeśli pole jest polem **Tylko API**, nie ma go w formularzach.
</Accordion>
<Accordion title="Współpracownik nie może zmienić pola">
Zajrzyj do **Kto może edytować to pole**. Jeśli wybrano tam współpracowników, grupy lub uprawnienia, inni mogą tylko czytać. Jeśli ktoś mimo to spróbuje zmienić wartość, Tillor to odrzuci.
</Accordion>
</Accordions>


# Tworzenie i edycja faktury (/pl-PL/facturen/aanmaken-en-bewerken)

Nowa faktura jest zawsze szkicem: tworzysz ją w profilu klienta i wypełniasz pozycje. Dopóki jest szkicem, możesz dodawać, zmieniać, przesuwać i usuwać pozycje. Potem [księgujesz ją](/facturen/boeken).

Zanim zaczniesz:

- Klient już istnieje w Tillor. Zobacz [Zarządzanie klientami](/klantenbeheer).
- Dla produktów z działką lub zajęciem miejsca klient ma zajęcie miejsca na tej działce. Bez zajęcia miejsca powstaje oferta, której nie można zaksięgować.

## Tworzenie faktury [#een-factuur-aanmaken]

Faktury tworzysz w profilu klienta, nie w <UIPath>Administracja > Faktury</UIPath>.

<Steps>
<Step>
### Otwórz klienta [#open-de-klant]
Przejdź do <UIPath>Klienci > Przegląd</UIPath> i otwórz profil klienta.
</Step>
<Step>
### Utwórz fakturę [#maak-de-factuur-aan]
W sekcji **Faktury** kliknij **Nowa faktura**. Tillor tworzy szkic faktury i od razu otwiera stronę faktury.

<DocScreenshot src="/screenshots/klanten/customer-new-invoice.png" alt="Nowa faktura z profilu klienta" />
</Step>
</Steps>

Faktura dostaje tymczasowy numer szkicu. Ostateczny numer faktury, data faktury i termin płatności pojawiają się dopiero przy [księgowaniu](/facturen/boeken).

## Dodawanie i zmienianie pozycji [#regels-toevoegen-en-aanpassen]

Na stronie faktury jest tabela z pozycjami faktury. Na dole jest pusty wiersz, w którym zaczynasz nową pozycję.

<Steps>
<Step>
### Wybierz produkt lub wpisz opis [#kies-een-product-of-typ-een-omschrijving]
Wybierz **Produkt** z listy, a Tillor wypełni **Opis** i cenę. Możesz też sam wpisać opis.
</Step>
<Step>
### Wpisz ilość i cenę [#vul-aantal-en-prijs-in]
Zmień **Ilość** i **Cena (z VAT)** za jednostkę, jeśli trzeba. **Całkowita kwota** pozycji jest liczona automatycznie. Jeśli w Twojej organizacji włączono ustawienie VAT dla każdej pozycji, wybierasz też stawkę VAT.
</Step>
<Step>
### Dodaj notatkę (opcjonalnie) [#voeg-een-notitie-toe-optioneel]
Pod tabelą możesz wypełnić **Uwaga (opcjonalnie)**. Ten tekst trafia na fakturę i jest widoczny dla klienta.
</Step>
</Steps>

Zmiany są zapisywane automatycznie niemal od razu. Możesz też kliknąć **Zapisz zmiany** albo **Anuluj**, aby cofnąć niezapisane zmiany.

### Zmiana kolejności lub usuwanie pozycji [#regels-herschikken-of-verwijderen]

- Przeciągnij pozycję za uchwyt po jej lewej stronie, aby zmienić kolejność.
- Kliknij krzyżyk po prawej stronie pozycji, aby ją usunąć.

Na osi czasu **Zdarzenia** obok faktury widzisz, co i kiedy zostało zmienione, z wartościami pól i pozycji przed zmianą i po niej.

## Pozycje z akcją [#regels-met-een-actie]

Jeśli wybrany produkt ma akcję na pozycji faktury, pod pozycją pojawiają się dodatkowe pola. Jakie akcje ma produkt, ustawiasz w samym produkcie. Zobacz [Akcje produktów](/producten/productacties).

| Akcja | Co wypełniasz na fakturze |
|-------|-----------------------------|
| **Doładuj tag NFC** | Tag, który ma zostać doładowany. Po zapłacie Tillor dopisuje kwotę do salda tagu. |
| **Okres** | Data początku i końca, a przy produkcie z działką także **Działka** (z listy lub **Wybierz na mapie**). |
| **Przedłuż okres zajęcia miejsca** | Działka, dla której przedłużasz zajęcie miejsca, oraz data początku i końca. |
| **Poproś o dane kontaktowe** | Adres e-mail i numer telefonu klienta. Jeśli są wymagane, nie zaksięgujesz faktury bez nich. |
| **Utwórz metodę dostępu** | Typ metody dostępu i ewentualnie numer rejestracyjny lub kod PIN. |
| **Pokaż alert** | Nic. Widzisz tylko alert z tekstem ustawionym przy produkcie. |
| **Zablokuj księgowanie** | Nic. Faktury nie można zaksięgować, dopóki ta pozycja na niej jest. |

### Wybór okresu i działki [#periode-en-terrein-kiezen]

Przy pozycji z **Okres** wybierasz datę początku i końca. Pod nią widzisz liczbę dni i **Ilość**, którą nalicza Tillor. Jeśli okres nie pasuje dokładnie do tygodnia lub miesiąca produktu, Tillor zaokrągla w górę i pojawia się **Zaokrąglone**. Polem **Proporcjonalnie** naliczasz niepełny tydzień lub miesiąc proporcjonalnie. To pole pojawia się tylko przy produktach z okresem tygodniowym lub miesięcznym.

Jeśli produkt wymaga działki, wybierasz najpierw okres, a potem **Działka**.

Przy księgowaniu Tillor tworzy rezerwację. Na pozycji pojawia się potem karta z numerem rezerwacji, statusem, działką i datami. Czy klient zostanie od razu zameldowany, zależy od produktu: przy **Zamelduj przy rezerwacji** następuje to przy księgowaniu, przy **Zamelduj przy płatności** dopiero gdy faktura jest zapłacona. Zaliczka tylko rezerwuje działkę.

### Przedłużanie zajęcia miejsca [#een-bezetting-verlengen]

Akcją **Przedłuż okres zajęcia miejsca** fakturujesz okres dla zajęcia miejsca klienta, na przykład opłatę za postój.

<Steps>
<Step>
### Wybierz działkę [#kies-het-terrein]
W **Wybierz aktywny zawód** wybierz działkę. Lista pokazuje aktywne zajęcia miejsca klienta.
</Step>
<Step>
### Wybierz okres [#kies-de-periode]
Wybierz **Data rozpoczęcia**. Potem Tillor od razu otwiera kalendarz dla **Data końcowa**. Pod datami widzisz, do kiedy zajęcie miejsca jest teraz zafakturowane, oraz ile dni i jaką ilość obejmuje pozycja.
</Step>
<Step>
### Ustaw zaokrąglanie [#stel-het-afronden-in]
Pole **Zaokrąglij do granicy następnego okresu** jest domyślnie włączone. Wtedy pozycja kończy się na najbliższej granicy okresu częstotliwości najmu, dzięki czemu klient z czasem podąża tym samym cyklem. Przy wyłączonym polu pozycja trwa dokładnie jeden okres od daty początku.
</Step>
</Steps>

Pozycja dostaje opis w postaci **Nazwa produktu | Nazwa działki | Okres**. Data końcowa liczy się jako ostatni dzień, a pół okresu jest naliczane również w połowie.

Jeśli zajęcie miejsca ma już datę **Opłacone do**, a zaokrąglanie jest włączone, nowa pozycja zaczyna się następnego dnia. Jeśli **Opłacone do** jest jeszcze puste, sam wybierasz datę początku, a Tillor oblicza datę końca do najbliższej granicy okresu. Co dzieje się z **Opłacone do** i **Zafakturowane do** po zaksięgowaniu i zapłacie, opisano w [Zajęcia miejsca](/bezettingen).

Dwa dodatkowe pola pomagają w wyjątkowych sytuacjach:

- **Pokaż wszystkie tereny (oferta)** pozwala wybrać dowolną działkę, aby przygotować ofertę. Jeśli klient nie ma zajęcia miejsca na tej działce, nie zaksięgujesz faktury. Użytkownicy z uprawnieniem **Korekty faktur** mogą jednak taką fakturę zaksięgować, zobacz [Księgowanie faktury](/facturen/boeken#problemen).
- **Oznacz jako kredyt (zwrot pieniędzy)** zamienia pozycję w zwrot. Ilość staje się ujemna, a okres biegnie od dziś do **Opłacone do**. Polem **Zaokrąglenie do granicy okresu** zaokrąglasz to do granicy okresu.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Zmiany są zapisywane automatycznie niemal od razu. Oś czasu **Zdarzenia** pokazuje, kto co zmienił.
- Nic nie trafia do klienta i nic nie zmienia się w zajęciach miejsca ani tagach. Dzieje się to dopiero przy [księgowaniu](/facturen/boeken) i przy płatności.
- Szkicu z pozycją **Zablokuj księgowanie** nie można zaksięgować.
- Szkic usuwasz przez **Usuń fakturę** w menu akcji.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę już zmieniać pozycji">
Edytować można tylko szkice faktur. Zaksięgowaną fakturę możesz pod pewnymi warunkami przywrócić do szkicu, zobacz [Korygowanie faktury](/facturen/corrigeren#terugzetten-naar-concept).
</Accordion>
<Accordion title="Pozycja z Doładuj tag NFC nie pokazuje tagów">
Klient nie ma dostępnego tagu. Najpierw powiąż tag NFC z klientem. Zobacz [NFC](/nfc).
</Accordion>
<Accordion title="Nie widzę przycisku Nowa faktura">
Przycisk jest w profilu klienta w sekcji **Faktury**, a nie na liście faktur w **Administracja**.
</Accordion>
<Accordion title="Klienta nie ma na liście Wybierz aktywny zawód">
Przy **Przedłuż okres zajęcia miejsca** lista pokazuje tylko aktywne zajęcia miejsca klienta. Najpierw utwórz zajęcie miejsca, zobacz [Zajęcia miejsca](/bezettingen), albo użyj **Pokaż wszystkie tereny (oferta)** dla oferty.
</Accordion>
</Accordions>

## Dalej [#verder]

<Cards>
  <Card title="Księgowanie faktury" href="/facturen/boeken" />
  <Card title="Produkty" href="/producten" description="Ustawianie akcji na pozycjach faktury" />
</Cards>


# Drukowanie, pobieranie i udostępnianie faktury (/pl-PL/facturen/afdrukken-en-downloaden)

Przyciskiem **Drukuj** drukujesz fakturę, zapisujesz ją jako PDF lub wysyłasz na drukarkę. Przycisk jest na każdej stronie faktury, także przy szkicu. Strzałka obok otwiera menu z pozostałymi opcjami. Link dla klienta utworzysz w sekcji [Udostępnianie osobistego linku](#een-persoonlijke-link-delen).

Zanim zaczniesz: opcje drukarek wymagają, aby dla Twojej organizacji działał Tillor Connector. Bez konektora te opcje są wyszarzone.

## Drukowanie lub zapisywanie [#afdrukken-of-opslaan]

| Opcja | Co robi |
|-------|--------------|
| **Drukuj** | Otwiera okno drukowania przeglądarki. Możesz też użyć skrótu Ctrl+P (Cmd+P na Macu). |
| **Otwórz w nowym oknie** | Pokazuje PDF w nowym oknie. |
| **Pobierz PDF** | Zapisuje fakturę jako plik PDF. |
| **Wyślij do drukarki A4** | Wysyła fakturę na podłączoną drukarkę A4. |
| **Wyślij do drukarki paragonowej** | Wysyła fakturę na podłączoną drukarkę paragonową. |

Obie opcje drukarek są wyszarzone, dopóki dla Twojej organizacji nie jest aktywny Tillor Connector. Jak skonfigurować drukarki, opisano w [Drukarka](/printer).

## Pokazywanie faktury na tablecie [#de-factuur-tonen-op-een-tablet]

Jeśli przy recepcji stoi tablet pokazujący dokumenty klienta, możesz tam wyświetlić fakturę. Otwórz trzy kropki w prawym górnym rogu strony faktury i wybierz **Podgląd na iPadzie**. Przy płatności gotówką ten sam przycisk jest także w oknie płatności.

## Udostępnianie osobistego linku [#een-persoonlijke-link-delen]

Przy zaksięgowanej fakturze możesz utworzyć link, który klient sam otworzy, aby obejrzeć fakturę i, jeśli coś jeszcze jest do zapłaty, zapłacić online.

<Steps>
<Step>
### Otwórz menu akcji [#open-het-actiemenu]
Kliknij trzy kropki w prawym górnym rogu strony faktury i wybierz **Osobisty URL**.
</Step>
<Step>
### Udostępnij link [#deel-de-link]
Tillor kopiuje link do schowka i pokazuje komunikat **URL wygenerowany**. Wklej go do wiadomości lub e-maila do klienta.
</Step>
</Steps>

<DocScreenshot src="/screenshots/facturen/invoice-actions-menu.png" alt="Menu akcji faktury - Osobisty URL, Kopiuj fakturę, Stornuj fakturę" />

Menu akcji zawiera jeszcze więcej opcji. Kopiowanie, odwracanie i przeliczanie faktury opisano w [Korygowanie faktury](/facturen/corrigeren).

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Drukowanie, pobieranie i wysyłanie na drukarkę nie zmieniają faktury.
- Przy **Podgląd na iPadzie** klient widzi fakturę na tablecie. Na osi czasu faktury widać, że PDF wysłano na tablet.
- Osobisty link nie ma terminu ważności. Klient widzi w nim kwotę do zapłaty i może zapłacić online. Zobacz [Płatność online klienta](/betalingsverwerking/online).
- Produkty mogą też drukować automatycznie przy płatności. Zobacz [Akcje produktów](/producten/productacties#thermisch-printen-en-a4-printen).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Wyślij do drukarki A4 jest wyszarzone">
Dla Twojej organizacji nie ma aktywnego Tillor Connector. Sprawdź połączenie i ustawienia drukarki, zobacz [Drukarka](/printer).
</Accordion>
<Accordion title="Brak opcji Osobisty URL">
Ta opcja jest tylko w menu akcji zaksięgowanej faktury.
</Accordion>
<Accordion title="Drukowanie się nie udaje">
Tillor pokazuje wtedy komunikat z powodem, na przykład brakiem papieru lub tonera. Usuń przyczynę i spróbuj ponownie.
</Accordion>
</Accordions>

## Dalej [#verder]

<Cards>
  <Card title="Drukarka" href="/printer" description="Konfiguracja drukarek i automatyczne drukowanie" />
  <Card title="Wysyłanie faktury" href="/facturen/versturen" />
</Cards>


# Rejestrowanie płatności (/pl-PL/facturen/betalingen-registreren)

Na zaksięgowanej fakturze z otwartą kwotą wykonujesz płatność lub ją zapisujesz, na przykład płatność kartą, gotówką lub poleceniem zapłaty. Kwota, stan płatności i lista **Płatności** obok faktury są potem aktualizowane. Wszystkie metody opisano też w [Przetwarzanie płatności](/betalingsverwerking).

Zanim zaczniesz:

- Faktura jest zaksięgowana i nadal jest otwarta jakaś kwota. W przeciwnym razie nie ma **Dokonaj płatności**.
- Dla **Terminal** podłączony jest Mollie. Dla **Mandat SEPA** klient ma aktywny mandat. W przeciwnym razie metody nie ma na liście lub jest wyszarzona.

## Wykonywanie płatności [#een-betaling-uitvoeren]

<Steps>
<Step>
### Otwórz zaksięgowaną fakturę [#open-de-geboekte-factuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> i otwórz zaksięgowaną fakturę. Przycisk **Dokonaj płatności** jest tam, dopóki jakaś kwota jest otwarta.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Zaksięgowana faktura - Dokonaj płatności" />
</Step>
<Step>
### Wybierz metodę płatności [#kies-de-betaalmethode]
Kliknij **Dokonaj płatności** i wybierz **Metoda płatności**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Okno płatności - metoda płatności i kwota" />

| Metoda | Do czego służy |
|---------|-----------------|
| **Terminal** | Płatność kartą. Wybierasz terminal płatniczy, a Tillor wysyła do niego płatność. Zobacz [Terminal](/betalingsverwerking/terminal). |
| **Przelew wewnętrzny** | Przeniesienie kwoty na inną zaksięgowaną fakturę tego samego klienta (**Faktura docelowa**). Zobacz [Przelew wewnętrzny](/betalingsverwerking/interne-overboeking). |
| **Gotówka** | Zapisanie płatności gotówką. Zobacz [Gotówka](/betalingsverwerking/contant). |
| **Przelew bankowy** | Zapisanie otrzymanego przelewu bankowego. |
| **Mandat SEPA** | Automatyczne polecenie zapłaty przez aktywny **Mandat** klienta. Zobacz [Mandat](/betalingsverwerking/mandaat). |
| **Inne** | Inna forma płatności, na przykład czek. Znajduje się pod **Więcej metod płatności** i jest widoczna tylko, jeśli ją włączysz. Opis jest wtedy wymagany. |

**Terminal** i **Mandat SEPA** są dostępne tylko wtedy, gdy są dostępne dla Twojej organizacji. **Mandat SEPA** jest wyszarzony, dopóki klient nie ma aktywnego mandatu, i nie istnieje dla faktur kredytowych.
</Step>
<Step>
### Wpisz kwotę [#vul-het-bedrag-in]
**Kwota** jest domyślnie ustawiona na pełną otwartą kwotę. Wpisz inną kwotę lub użyj przycisków **25%**, **50%**, **75%** i **100%**. Kwota nie może być wyższa niż to, co jest otwarte.
</Step>
<Step>
### Wypełnij dodatkowe pola [#vul-de-extra-velden-in]
Przy **Gotówka**, **Przelew bankowy** i **Inne** opcjonalnie wypełniasz **Data otrzymania** (nie w przyszłości) i **Komentarz**. Przy poleceniu zapłaty wybierasz **Mandat** i ewentualnie **Opóźnienie (dni)**, przy czym 0 oznacza wysłanie od razu.

Jeśli wybierzesz **Przelew bankowy** i klient ma adres e-mail, możesz zaznaczyć **Wyślij przypomnienie dotyczące komunikacji strukturalnej**. Klient dostaje wtedy e-mail ze wskazówką, aby przy kolejnych płatnościach używał komunikacji strukturalnej.
</Step>
<Step>
### Wykonaj płatność [#voer-de-betaling-uit]
Kliknij **Wykonaj płatność**.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Płatności na fakturze" />
</Step>
</Steps>

Przy **Gotówka** jest też przycisk **Podgląd na iPadzie**, aby pokazać fakturę klientowi na podłączonym tablecie.

## Kwoty maksymalne [#maximumbedragen]

Płatność gotówką nie może przekraczać **Maksimum gotówki** w <UIPath>Pomoc > Ustawienia > Płatności</UIPath> (domyślnie 2999 euro). Przy poleceniu zapłaty kwota nie może przekraczać maksimum mandatu.

## Powiązanie istniejącej płatności [#een-bestaande-betaling-koppelen]

Jeśli płatność lub transakcja bankowa, która należy do tej faktury, już wpłynęła, powiązujesz ją zamiast tworzyć nową.

<Requires permission="Przypisz płatność do faktury" />

<Steps>
<Step>
### Otwórz menu akcji [#open-het-actiemenu]
Kliknij trzy kropki w prawym górnym rogu strony faktury i wybierz **Przypisz płatność**.
</Step>
<Step>
### Wybierz płatność [#kies-de-betaling]
W oknie wybierz płatność lub grupę. Na kartach **Grupy płatności**, **Karta i płatności online** i **Transakcje bankowe** widać, co jest dostępne. Na górze są sugestie zgodne z otwartą kwotą.
</Step>
<Step>
### Powiąż [#koppel]
Kliknij **Przypisz płatność**, **Przypisz grupę** lub **Przypisz transakcję bankową**, zależnie od tego, co wybrano.
</Step>
</Steps>

Dla transakcji bankowych potrzebujesz też uprawnienia **Wyświetlanie transakcji bankowych**.

## Tworzenie linku do płatności częściowej [#een-link-voor-een-deelbetaling-maken]

Jeśli klient chce zapłacić tylko część otwartej kwoty, tworzysz link do płatności na kwotę, którą wybierzesz. Możliwe na każdej zaksięgowanej fakturze z otwartą kwotą.

<Steps>
<Step>
### Otwórz menu akcji [#open-het-actiemenu-1]
Kliknij trzy kropki obok **Wyślij powiadomienie** i wybierz **Link do płatności częściowej**.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-menu.png" alt="Menu akcji faktury z Link do płatności częściowej" />
</Step>
<Step>
### Wpisz kwotę [#vul-het-bedrag-in-1]
W **Kwota** wpisz, ile klient może zapłacić. Kwota musi być większa niż 0 i nie może być wyższa niż to, co jeszcze jest otwarte.
</Step>
<Step>
### Utwórz link [#maak-de-link]
Kliknij **Utwórz i skopiuj link**. Tillor kopiuje link do schowka i pokazuje go pod **Link do płatności**. Przyciskiem kopiowania obok kopiujesz go ponownie.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-dialog.png" alt="Okno Link do płatności częściowej z kwotą i linkiem do płatności" />
</Step>
</Steps>

Link wysyłasz klientowi sam, na przykład e-mailem lub przez czat. Klient otwiera zwykłą stronę płatności faktury, ale ta prosi teraz tylko o Twoją kwotę, z informacją, że jest to płatność częściowa kwoty, która jest jeszcze otwarta. Klient płaci wtedy w sposób, który wybierze na [stronie płatności](/betalingsverwerking/online).

Link pozostaje ważny, ale nigdy nie wymaga więcej niż to, co w danej chwili jest jeszcze otwarte. Jeśli w międzyczasie zapłacono już część, strona płatności odpowiednio się zmniejsza. Po płatności faktura ma stan <Status tone="warning">Częściowo</Status>, dopóki cała kwota nie wpłynie.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Otwarta kwota maleje, a stan płatności się zmienia: <Status tone="warning">Częściowo</Status>, dopóki coś jest otwarte, <Status tone="success">Płatny</Status>, gdy wszystko wpłynie.
- Przy poleceniu zapłaty lub płatności kartą faktura ma najpierw stan <Status tone="info">Aż do</Status>, dopóki pieniądze nie wpłyną ostatecznie.
- Jeśli pozycja ma akcję płatności, Tillor wykonuje ją, gdy faktura jest zapłacona. Chodzi na przykład o doładowanie tagu NFC, przedłużenie **Opłacone do** zajęcia miejsca lub wydrukowanie paragonu. Zobacz [Jak to się łączy?](/producten#hoe-hangt-dit-samen).
- Płatność trafia do raportu płatności z danego dnia. Zobacz [Raporty płatności](/boekhouden/betalingsrapporten).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Dokonaj płatności">
Faktura musi być zaksięgowana i musi być otwarta jakaś kwota. Na szkicu faktury nie można płacić.
</Accordion>
<Accordion title="Nie widzę Link do płatności częściowej">
Faktura musi być zaksięgowana i musi być jeszcze otwarta jakaś kwota.
</Accordion>
<Accordion title="Mandat SEPA jest wyszarzony">
Klient nie ma aktywnego mandatu. Ustaw go w danych klienta, zobacz [Mandat](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Nie mogę wybrać Inne">
Ta metoda płatności jest domyślnie wyłączona. Włącz **Pokaż metodę płatności „Inne”** w <UIPath>Pomoc > Ustawienia > Płatności</UIPath>.
</Accordion>
<Accordion title="Faktura ma stan Aż do">
Płatność została rozpoczęta, na przykład polecenie zapłaty, ale pieniądze jeszcze ostatecznie nie wpłynęły. Gdy płatność zostanie przetworzona, status zmieni się na **Płatny**. Zobacz [Statusy](/facturen/statussen).
</Accordion>
</Accordions>

## Dalej [#verder]

<Cards>
  <Card title="Przetwarzanie płatności" href="/betalingsverwerking" description="Wszystkie metody płatności szczegółowo" />
  <Card title="Statusy" href="/facturen/statussen" />
</Cards>


# Księgowanie faktury (/pl-PL/facturen/boeken)

Księgowanie zamienia szkic w ostateczną fakturę z własnym numerem faktury. Dopiero potem możesz fakturę [wysłać](/facturen/versturen) i [dać do opłacenia](/facturen/betalingen-registreren). Sprawdź więc pozycje przed zaksięgowaniem, bo zaksięgowanej faktury nie można już dowolnie zmieniać.

Zanim zaczniesz:

- Faktura ma co najmniej jedną pozycję lub sumę różną od zera.
- Pozycje z **Okres** lub **Przedłuż okres zajęcia miejsca** mają datę początku i końca.
- Jeśli pozycja ma akcję wymagającą danych, są one wypełnione. Chodzi na przykład o **Poproś o dane kontaktowe** lub **Utwórz metodę dostępu**.
- Dla belgijskiego klienta z numerem VAT wypełniono identyfikator Peppolu. Zobacz [Peppol](/boekhouden/peppol).

Jeśli coś jest nie tak, **Zaksięguj fakturę** jest wyszarzone. Najedź myszą na przycisk, aby przeczytać dlaczego. Zobacz też [Problemy?](#problemen).

## Księgowanie faktury [#een-factuur-boeken]

<Steps>
<Step>
### Otwórz szkic faktury [#open-de-conceptfactuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> i otwórz fakturę ze statusem <Status>Projekt</Status>, na przykład z listy **Warcaby**.
</Step>
<Step>
### Sprawdź fakturę [#controleer-de-factuur]
Przejrzyj pozycje i notatkę.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Szkic faktury - pozycje i Zaksięguj fakturę" />
</Step>
<Step>
### Kliknij Zaksięguj fakturę [#klik-op-boek-factuur]
Faktura dostaje kolejny numer faktury. Tillor informuje, że faktura została zaksięgowana.
</Step>
</Steps>

## Co się zmienia? [#wat-verandert-er]

Tak wygląda faktura przed zaksięgowaniem i po nim. To dwie różne przykładowe faktury, ale widać różnicę w numerze, statusie i przyciskach.

**Przed zaksięgowaniem**: tymczasowy numer szkicu i przycisk **Zaksięguj fakturę**.

<DocScreenshot src="/screenshots/facturen/invoice-before-title.png" alt="Tytuł szkicu faktury z numerem szkicu CON/2026/0001" />

<DocScreenshot src="/screenshots/facturen/invoice-before-toolbar.png" alt="Przyciski szkicu faktury: Zaksięguj fakturę i Drukuj" />

**Po zaksięgowaniu**: ostateczny numer faktury, stan płatności oraz przyciski **Dokonaj płatności** i **Wyślij powiadomienie**.

<DocScreenshot src="/screenshots/facturen/invoice-after-title.png" alt="Tytuł zaksięgowanej faktury z numerem INV/2026/0001 i stanem płatności Częściowo" />

<DocScreenshot src="/screenshots/facturen/invoice-after-toolbar.png" alt="Przyciski zaksięgowanej faktury: Dokonaj płatności, Drukuj i Wyślij powiadomienie" />

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- **Data faktury** to dzień księgowania. **Termin płatności** to ten dzień plus **Domyślny termin (dni)** Twojej organizacji, domyślnie 7 dni. Zmienisz to w <UIPath>Pomoc > Ustawienia > Fakturowanie</UIPath>.
- Jeśli suma nie jest wielokrotnością 5 centów, Tillor sam dodaje pozycję **Zaokrąglanie**.
- Jeśli faktura ma ujemną sumę, staje się **Faktura kredytowa**.
- Jeśli klient ma identyfikator Peppolu, Tillor automatycznie wysyła fakturę przez Peppol. Zobacz [Peppol](/boekhouden/peppol).
- Pozycje z **Przedłuż okres zajęcia miejsca** ustawiają **Zafakturowane do** zajęcia miejsca na koniec pozycji. **Opłacone do** następuje dopiero przy płatności. Zobacz [Jak to się łączy?](/producten#hoe-hangt-dit-samen).
- Pozycje z **Okres** i **Pytaj o działkę** tworzą rezerwację. Czy klient zostanie od razu zameldowany, zależy od produktu.
- Jeśli powiązany jest mandat polecenia zapłaty, Tillor od razu tworzy otwartą płatność. Bank jest obciążany dwa dni po zaksięgowaniu.
- Klient nie dostaje niczego automatycznie. Powiadomienie wysyłasz sam, zobacz [Wysyłanie faktury](/facturen/versturen).
- Chcesz jednak coś jeszcze zmienić? W ciągu 7 dni i dopóki nic nie wysłano, [przywróć fakturę do szkicu](/facturen/corrigeren#terugzetten-naar-concept).

## Wybór innego terminu płatności [#een-andere-betaaltermijn-kiezen]

Jeśli termin płatności różni się od domyślnego, nie musisz tego ustawiać wcześniej.

<Steps>
<Step>
### Otwórz menu wyboru [#open-het-keuzemenu]
Kliknij strzałkę obok **Zaksięguj fakturę** i wybierz **Niestandardowe warunki płatności…**.
</Step>
<Step>
### Wybierz termin [#kies-de-termijn]
W **Warunki płatności** wybierz opcję, od **Due on invoice date** do **Netto 60 dni**. Od razu widzisz **Szacowany termin płatności**.
</Step>
<Step>
### Zaksięguj [#boek]
Kliknij **Zaksięguj fakturę**.
</Step>
</Steps>

## Przekazywanie do księgowości [#doorsturen-naar-je-boekhouding]

Przekazywanie do oprogramowania księgowego normalnie odbywa się samo. Jeśli chcesz uruchomić je ponownie, na przykład po błędzie, możesz to zrobić dla każdej faktury.

<Requires permission="Wyślij do oprogramowania księgowego" />

Otwórz zaksięgowaną fakturę, kliknij trzy kropki w prawym górnym rogu i wybierz **Wyślij do oprogramowania księgowego**. Jakie systemy są dostępne, przeczytasz w [Księgowość](/boekhouden). [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) jest dostępny na zapytanie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Zaksięguj fakturę jest wyszarzone">
Najedź na przycisk. Tillor podaje powód. Najczęstsze są poniżej.
</Accordion>
<Accordion title="Ten szkic faktury zawiera pozycję Zablokuj księgowanie">
Produkt na tej pozycji nie pozwala na księgowanie. Usuń pozycję lub wybierz inny produkt.
</Accordion>
<Accordion title="Wypełnij datę początku i końca przy każdej pozycji z Okres lub przedłużonym okresem zajęcia miejsca">
Pozycji z **Okres** lub **Przedłuż okres zajęcia miejsca** brakuje daty. Wypełnij datę początku i końca.
</Accordion>
<Accordion title="Dodaj co najmniej jedną pozycję lub kwotę różną od zera">
Dodaj pozycję albo zadbaj, aby suma nie wynosiła zero.
</Accordion>
<Accordion title="Wypełnij wymagane dane kontaktowe lub wybierz typ metody dostępu">
Przy pozycjach z **Poproś o dane kontaktowe** wypełnij wymagane pola. Przy pozycjach z **Utwórz metodę dostępu** wybierz typ, a przy rozpoznawaniu tablic rejestracyjnych także numer rejestracyjny.
</Accordion>
<Accordion title="Ta faktura przedłuża działkę, której klient nie ma w zajęciu (oferta)">
Taka faktura jest ofertą i nie można jej zaksięgować. Najpierw niech klient zajmie działkę. Jeśli masz uprawnienie **Korekty faktur**, możesz przez strzałkę obok **Zaksięguj fakturę** wybrać **Wymuś księgowanie**. Zajęcie miejsca zostanie wtedy przedłużone dopiero, gdy klient zajmie działkę.
</Accordion>
<Accordion title="Kwota faktury przekracza maksimum powiązanego mandatu">
Kwota faktury nie może przekraczać maksymalnej kwoty powiązanego mandatu. Zmień mandat w **Mandat polecenia zapłaty** w **Informacje o fakturze** obok faktury albo obniż kwotę. Zobacz [Mandat SEPA](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Ta faktura sprowadza saldo klienta poniżej zera">
Produkt z chronioną księgą główną (na przykład kaucja) nie może sprowadzić salda klienta poniżej zera. Jeśli masz uprawnienie **Pomijanie salda konta**, możesz mimo to zaksięgować, podając uzasadnienie. Zobacz [Pilnowanie salda klienta](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
</Accordion>
<Accordion title="Faktury nie można zaksięgować, bo klient nie ma identyfikatora Peppolu">
Dla belgijskiego klienta z numerem VAT musi być znany identyfikator Peppolu. Otwórz <UIPath>Klienci > klient > Fakturowanie</UIPath>, przejdź do **Ustawienia faktury** i wpisz identyfikator. Zobacz [Peppol](/boekhouden/peppol).
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Wysyłanie faktury" href="/facturen/versturen" />
  <Card title="Rejestrowanie płatności" href="/facturen/betalingen-registreren" />
  <Card title="Korygowanie faktury" href="/facturen/corrigeren" description="Gdy po zaksięgowaniu jednak chcesz coś zmienić" />
</Cards>


# Korygowanie faktury (/pl-PL/facturen/corrigeren)

Zaksięgowanej faktury nie można tak po prostu zmienić. Którą drogę wybierzesz, zależy od tego, jak daleko faktura już zaszła.

Wszystkie korekty poza przywróceniem znajdują się w menu akcji (trzy kropki) obok **Wyślij powiadomienie**.

<DocScreenshot src="/screenshots/facturen/invoice-correct-menu.png" alt="Menu akcji zaksięgowanej faktury z Kopiuj fakturę i Stornuj fakturę" />

| Sytuacja | Co robisz |
|----------|-------------|
| Faktura została dopiero co zaksięgowana i nie została jeszcze wysłana | [Przywrócenie do szkicu](#terugzetten-naar-concept) |
| Faktura została już wysłana lub jest zbyt stara | [Odwrócenie](#een-factuur-omkeren) fakturą kredytową |
| Chcesz użyć tych samych pozycji ponownie | [Kopiowanie](#een-factuur-kopiëren) |
| Faktura jest na niewłaściwego klienta | [Przeniesienie](#een-factuur-verplaatsen-naar-een-andere-klant) |
| Kwoty się nie zgadzają | [Przeliczenie](#een-factuur-herberekenen) |

## Przywracanie do szkicu [#terugzetten-naar-concept]

Dopóki faktura nie wyszła jeszcze na zewnątrz, przywracasz ją do szkicu i po wprowadzeniu zmian księgujesz ją ponownie.

Jest to możliwe, gdy spełnione jest wszystko z poniższego:

- Faktura jest zaksięgowana.
- Tillor nie wysłał dla niej jeszcze powiadomienia, żadnym kanałem.
- Faktura nie została wysłana przez Peppol.
- Data faktury jest sprzed mniej niż 7 dni.

<Steps>
<Step>
### Otwórz zaksięgowaną fakturę [#open-de-geboekte-factuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> i otwórz fakturę.
</Step>
<Step>
### Przywróć ją [#zet-hem-terug]
Kliknij **Przywróć do szkicu** i potwierdź przyciskiem **Tak, przywróć do szkicu**. Jeśli nie ma przycisku, faktura nie spełnia warunków.
</Step>
<Step>
### Zmień fakturę i zaksięguj ponownie [#pas-de-factuur-aan-en-boek-opnieuw]
Zmień pozycje i kliknij **Zaksięguj fakturę**.
</Step>
</Steps>

W międzyczasie faktura ma numer szkicu z pierwotnym numerem w nawiasie. Pozycja **Zaokrąglanie** jest usuwana i wraca przy ponownym księgowaniu. Przy ponownym księgowaniu faktura odzyskuje swój pierwotny numer, pierwotną datę faktury i termin płatności. Szkicu powstałego z zaksięgowanej faktury nie można usunąć.

Po przywróceniu przy tym zdarzeniu na osi czasu **Zdarzenia** jest przycisk **Przywróć wersję**. Zastępujesz nim bieżące pozycje pozycjami z chwili przywrócenia. Jeśli faktura jest wtedy znów zaksięgowana, Tillor najpierw ponownie przywraca ją do szkicu.

<Callout type="warn" title="Uwaga">
Jeśli faktura została już wydrukowana, pokazana klientowi lub udostępniona w inny sposób, bądź ostrożny. Klient ma wtedy wersję, która wkrótce przestanie być aktualna.
</Callout>

### Gdy przywrócenie nie jest już możliwe [#als-terugzetten-niet-meer-kan]

<Requires permission="Korekty faktur" />

Jeśli faktura nie spełnia już warunków, na przykład dlatego że wysłano już powiadomienie lub faktura jest starsza niż 7 dni, możesz mimo to przywrócić ją z uprawnieniem **Korekty faktur**. Otwórz trzy kropki w prawym górnym rogu strony faktury i wybierz **Wymuś przywrócenie do szkicu**. Używaj tego tylko, gdy jest to dopuszczalne prawnie i księgowo. Faktura kredytowa przez [odwrócenie](#een-factuur-omkeren) jest zwykle czystszym rozwiązaniem.

## Odwracanie faktury [#een-factuur-omkeren]

Odwracając, tworzysz fakturę kredytową, która anuluje zaksięgowaną fakturę. Działa to zawsze, także gdy faktura została już wysłana lub opłacona.

<Steps>
<Step>
### Odwróć fakturę [#keer-de-factuur-om]
Otwórz trzy kropki w prawym górnym rogu zaksięgowanej faktury i wybierz **Stornuj fakturę**. Tillor tworzy nowy szkic z tymi samymi pozycjami w kwotach ujemnych i otwiera go.
</Step>
<Step>
### Sprawdź i zaksięguj [#controleer-en-boek]
Zmień szkic w razie potrzeby i kliknij **Zaksięguj fakturę**. Staje się on wtedy **Faktura kredytowa**.
</Step>
</Steps>

Obie faktury odwołują się do siebie. W **Informacje o fakturze** przy fakturze kredytowej jest **Storno**, a przy pierwotnej fakturze **Stornowano jako**. Na liście faktur w profilu klienta przy szkicu widzisz etykietę **Projekt odwrotny**, a przy pierwotnej fakturze **Faktura ta została odwrócona**.

Jeśli fakturę odwrócono już wcześniej, Tillor prosi o potwierdzenie przyciskiem **Tak, cofnij ponownie**, abyś nie utworzył przez pomyłkę dwóch faktur kredytowych.

Jeśli chcesz rozliczyć fakturę kredytową z pierwotną fakturą, wybierz przy płatności **Przelew wewnętrzny**. Zobacz [Przelew wewnętrzny](/betalingsverwerking/interne-overboeking).

## Kopiowanie faktury [#een-factuur-kopiëren]

Wybierz **Kopiuj fakturę** w menu akcji zaksięgowanej faktury. Tillor tworzy nowy szkic z tymi samymi pozycjami, tą samą notatką i tym samym mandatem polecenia zapłaty i otwiera go. Pozycja **Zaokrąglanie** nie jest kopiowana.

## Przenoszenie faktury do innego klienta [#een-factuur-verplaatsen-naar-een-andere-klant]

<Requires permission="Korekty faktur" />

Jeśli faktura jest na niewłaściwego klienta, przenosisz ją.

<Steps>
<Step>
### Otwórz menu akcji [#open-het-actiemenu]
Kliknij trzy kropki w prawym górnym rogu strony faktury i wybierz **Przenieś do klienta**.
</Step>
<Step>
### Wybierz klienta [#kies-de-klant]
Wybierz **Klient docelowy** i kliknij **Przenieś fakturę**.
</Step>
</Steps>

Razem z fakturą przenoszą się powiązane płatności, partie liczników i uwagi. Zaksięgowana faktura jest potem ponownie wysyłana do Twojej księgowości. Jeśli faktura została już wysłana przez Peppol, nie możesz jej przenieść.

## Przeliczanie faktury [#een-factuur-herberekenen]

Jeśli kwoty na zaksięgowanej fakturze nie zgadzają się z pozycjami, wybierz **Przelicz fakturę** w menu akcji. Tillor oblicza sumy od nowa.

## Usuwanie szkicu [#een-concept-verwijderen]

Szkic faktury możesz usunąć przez **Usuń fakturę** w menu akcji. Wracasz wtedy do profilu klienta. Zaksięgowanych faktur nie można usuwać, odwracasz je.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

| Droga | Skutek |
|-------|--------|
| Przywrócenie do szkicu | Numer faktury zostaje zachowany. Przy ponownym księgowaniu faktura odzyskuje pierwotny numer i daty. |
| Odwrócenie | Powstaje faktura kredytowa odwołująca się do pierwotnej faktury. Rozliczyć można [przelewem wewnętrznym](/betalingsverwerking/interne-overboeking). |
| Kopiowanie | Powstaje nowy szkic. Pierwotna faktura się nie zmienia. |
| Przenoszenie | Płatności, partie liczników i uwagi przenoszą się razem z fakturą. Zaksięgowana faktura trafia ponownie do księgowości. |
| Przeliczanie | Sumy są obliczane od nowa z pozycji. |

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Przywróć do szkicu">
Nie spełniono jednego z warunków. Czy wysłano już powiadomienie lub faktura ma 7 dni albo więcej? Wtedy możesz odwrócić fakturę lub, z uprawnieniem **Korekty faktur**, wymusić przywrócenie.
</Accordion>
<Accordion title="Brak Przenieś do klienta">
Potrzebujesz do tego uprawnienia **Korekty faktur**. Jeśli faktura została wysłana przez Peppol, przeniesienie nie jest możliwe.
</Accordion>
<Accordion title="Jakie uprawnienia ma mój użytkownik?">
Ustawia je administrator. Zobacz [Użytkownicy](/gebruikers).
</Accordion>
</Accordions>

## Dalej [#verder]

<Cards>
  <Card title="Księgowanie faktury" href="/facturen/boeken" />
  <Card title="Statusy" href="/facturen/statussen" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Wysyłanie faktur przez Peppol" />
</Cards>


# Przegląd (/pl-PL/facturen)

W <UIPath>Administracja > Faktury</UIPath> znajdziesz wszystkie faktury swojego parku, z otwartymi kwotami na górze. Faktura zaczyna jako szkic i staje się ostateczna dopiero po zaksięgowaniu. Potem możesz ją wysłać, dać do opłacenia i w razie potrzeby skorygować.

<Callout type="info" title="Warto wiedzieć">
- Nową fakturę tworzysz w profilu klienta, nie z tej listy.
- Zaksięgowana faktura dostaje termin płatności: dzień księgowania plus domyślny termin płatności Twojej organizacji, domyślnie 7 dni. Dla każdej faktury możesz wybrać inny termin.
- Jeśli suma nie jest wielokrotnością 5 centów, Tillor dodaje przy księgowaniu pozycję **Zaokrąglanie**.
- Tillor nie wysyła zaksięgowanej faktury klientowi automatycznie. Robisz to sam przyciskiem **Wyślij powiadomienie**.
- Przywrócenie do szkicu jest możliwe do 7 dni po dacie faktury, o ile nie wysłano powiadomienia, a faktura nie została wysłana przez Peppol. Później odwracasz fakturę fakturą kredytową.
- Płatność gotówką może domyślnie wynosić maksymalnie 2999 euro. Zmienisz to w **Maksimum gotówki** w <UIPath>Pomoc > Ustawienia > Płatności</UIPath>.
- Polecenie zapłaty z mandatem SEPA trafia do banku dwa dni po zaksięgowaniu. Do tego czasu możesz anulować płatność.
- Osobisty link do faktury nie ma terminu ważności. Klient widzi w nim, co jeszcze jest do zapłaty.
- Jeśli klient ma identyfikator Peppolu, Tillor po zaksięgowaniu automatycznie wysyła fakturę przez Peppol.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Faktura to początek łańcucha. Płatność jest powiązana z zaksięgowaną fakturą, płatności z jednego dnia trafiają do raportu płatności, a ten raport trafia do Twojej księgowości.

```mermaid
flowchart LR
  A[Conceptfactuur] -- Boeken --> B[Geboekte factuur]
  B -- Verstuur notificatie --> K[Klant ontvangt de factuur]
  K -- Klant betaalt online --> C[Betaling]
  B -- Jij registreert een betaling --> C
  C -- Saldo en betalingsstatus --> B
  C -- Per dag gebundeld --> D[Betalingsrapport]
  D -- Mollie en interne overboekingen --> E[Boekhouding]
```

- Otwarte saldo i stan płatności faktury zmieniają się automatycznie na podstawie płatności.
- Płatność bez faktury możesz później powiązać z zaksięgowaną fakturą.
- Które płatności trafiają do księgowości, przeczytasz w [Księgowość](/boekhouden).

## Lista faktur [#de-facturenlijst]

Na górze są cztery liczniki: **Suma faktur**, **Otwarte faktury** (niezapłacone lub częściowo zapłacone), **Zaległe faktury** (termin płatności minął) i **Całkowicie znakomite** (łączna kwota otwartych faktur).

Poniżej są cztery listy:

- **Oczekujące płatności**: zaksięgowane faktury, których płatność została rozpoczęta, ale jeszcze nie wpłynęła ostatecznie
- **Faktury z saldem otwartym**: zaksięgowane faktury z kwotą, która nadal wymaga zapłaty, posortowane według terminu płatności
- **Warcaby**: dziesięć ostatnio utworzonych szkiców faktur
- **Wszystkie faktury**: pełna lista, domyślnie przefiltrowana na zaksięgowane faktury

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Przegląd faktur - Wszystkie faktury" />

Nowych faktur nie tworzysz z tej listy. Robisz to w profilu klienta, zobacz [Tworzenie faktury](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken).

### Wyszukiwanie i filtrowanie [#zoeken-en-filteren]

Pasek wyszukiwania szuka po numerze faktury, imieniu lub nazwisku klienta, adresie e-mail i kwocie. Na liście **Wszystkie faktury** możesz dodatkowo filtrować według:

| Filtr | Do czego służy |
|--------|-------------------|
| **Okres** | Tylko faktury z danego okresu |
| **Status** | **Projekt** lub **Zarezerwowane** |
| **Stan płatności** | **Nie zapłacony**, **Częściowo**, **Aż do** lub **Płatny** |
| **Typ klienta** | **Standard**, **Przyczepa kempingowa do wynajęcia dla pracowników** lub **Pracownik holujący karawanę** |
| **Klient** | Wszystkie faktury jednego klienta |
| **Produkty** | Faktury z danym produktem w pozycji |
| **Kwota** | Faktury z minimalną lub maksymalną kwotą |

Na liście **Faktury z saldem otwartym** jest też filtr **Ze względu na przypomnienie**. Wybierasz liczbę dni (od 7 do 90) i widzisz zaległe faktury utworzone co najmniej tyle dni temu, dla których w ostatnich dniach nie wysłano wezwania do zapłaty e-mailem ani SMS-em. Przydatne, aby ustalić, kogo trzeba ponownie ponaglić.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Faktury z saldem otwartym" />

### Faktury według klienta [#facturen-per-klant]

W profilu klienta wszystkie faktury tego klienta znajdziesz w sekcji **Faktury** na karcie **Przegląd** lub na karcie **Fakturowanie**. Tam też utworzysz nową fakturę.

## Instrukcje [#handleidingen]

<Cards>
  <Card title="Tworzenie i edycja" href="/facturen/aanmaken-en-bewerken" description="Utwórz szkic faktury i dodaj pozycje" />
  <Card title="Księgowanie faktury" href="/facturen/boeken" description="Uczyń fakturę ostateczną" />
  <Card title="Wysyłanie faktury" href="/facturen/versturen" description="Powiadomienie lub wezwanie do zapłaty dla klienta" />
  <Card title="Rejestrowanie płatności" href="/facturen/betalingen-registreren" description="Zapisz płatność lub powiąż ją z fakturą" />
  <Card title="Drukowanie i pobieranie" href="/facturen/afdrukken-en-downloaden" description="PDF, drukarka i osobisty link" />
  <Card title="Korygowanie" href="/facturen/corrigeren" description="Przywracanie, odwracanie, kopiowanie i przenoszenie" />
  <Card title="Statusy" href="/facturen/statussen" description="Co oznaczają Projekt, Zarezerwowane i Płatny" />
</Cards>

## Powiązane [#gerelateerd]

<Cards>
  <Card title="Przetwarzanie płatności" href="/betalingsverwerking" description="Metody płatności szczegółowo" />
  <Card title="Produkty" href="/producten" description="Akcje na pozycjach faktury" />
  <Card title="Księgowość" href="/boekhouden" description="Raporty płatności i integracje księgowe" />
  <Card title="Przykłady z praktyki" href="/praktijk" description="Rozbudowane przykłady z praktyki" />
</Cards>

## Pojęcia [#begrippen]

- **Szkic**: faktura, którą możesz jeszcze zmieniać, z tymczasowym numerem szkicu.
- **Zaksięgowana**: ostateczna faktura z własnym numerem faktury. Zobacz [Księgowanie](/begrippen#boeken).
- **Faktura kredytowa**: zaksięgowana faktura z ujemną sumą, na przykład po odwróceniu faktury.
- **Stan płatności**: czy i ile z faktury zapłacono. Zobacz [Statusy](/facturen/statussen).
- **Klient**: klient, dla którego jest faktura. Zobacz [Klient](/begrippen#klant).
- **Zajęcie miejsca**: klient na działce przez pewien okres. Zobacz [Zajęcie miejsca](/begrippen#bezetting).


# Statusy faktur (/pl-PL/facturen/statussen)

Każda faktura ma **status** (czy jest już ostateczna) i, gdy zostanie zaksięgowana, **stan płatności** (ile zapłacono). Oba możesz filtrować na [liście faktur](/facturen).

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Lista faktur ze statusem i stanem płatności przy każdej fakturze" />

## Status faktury [#factuurstatus]

| Status | Znaczenie |
|--------|-----------|
| <Status>Projekt</Status> | Fakturę można jeszcze edytować i ma tymczasowy numer szkicu. Nie możesz jej jeszcze wysłać ani opłacić. |
| <Status tone="success">Zarezerwowane</Status> | Faktura jest ostateczna i ma własny numer faktury. Możesz ją wysłać, opłacić i skorygować. |

Szkic powstały z zaksięgowanej faktury ma numer szkicu z pierwotnym numerem faktury w nawiasie. Zobacz [Korygowanie faktury](/facturen/corrigeren).

## Stan płatności [#betalingsstatus]

Stan płatności znajduje się obok numeru zaksięgowanej faktury.

| Status | Znaczenie |
|--------|-----------|
| <Status tone="error">Nie zapłacony</Status> | Nic jeszcze nie zapłacono. |
| <Status tone="warning">Częściowo</Status> | Zapłacono część, a pozostała kwota nadal jest otwarta. |
| <Status tone="info">Aż do</Status> | Cała kwota została zainicjowana, na przykład polecenie zapłaty, ale pieniądze nie zostały jeszcze ostatecznie przetworzone. |
| <Status tone="success">Płatny</Status> | Faktura jest w całości uregulowana. |

Faktura jest **zaległa**, jeśli termin płatności minął, a jakaś kwota nadal jest otwarta. To nie jest osobny status. Widzisz to w liczniku **Zaległe faktury** na liście faktur.

## Typ faktury [#factuurtype]

| Typ | Znaczenie |
|------|-----------|
| **Faktura** | Zwykła faktura z dodatnią sumą. |
| **Faktura kredytowa** | Zaksięgowana faktura z ujemną sumą, na przykład po [odwróceniu faktury](/facturen/corrigeren#een-factuur-omkeren). |

## Etykiety na liście w profilu klienta [#labels-in-de-lijst-op-het-klantprofiel]

| Etykieta | Znaczenie |
|-------|-----------|
| **Wysłane za pośrednictwem Peppolu** | Faktura została wysłana przez Peppol. |
| **Projekt odwrotny** | Ten szkic utworzono, aby odwrócić inną fakturę. |
| **Faktura ta została odwrócona** | Istnieje faktura kredytowa lub szkic, który anuluje tę fakturę. |

## Dalej [#verder]

<Cards>
  <Card title="Przegląd" href="/facturen" description="Lista faktur i filtry" />
  <Card title="Rejestrowanie płatności" href="/facturen/betalingen-registreren" />
</Cards>


# Wysyłanie faktury (/pl-PL/facturen/versturen)

Przyciskiem **Wyślij powiadomienie** wysyłasz klientowi zaksięgowaną fakturę e-mailem, SMS-em, przez WhatsApp lub pocztą. Tillor nigdy nie robi tego sam. Jeśli faktura została już wysłana, ale nie jest zapłacona, wysyłasz wezwanie do zapłaty. Klient może potem zapłacić przez link w wiadomości, zobacz [Płatność online klienta](/betalingsverwerking/online).

Zanim zaczniesz:

- Faktura jest zaksięgowana. Przy szkicu nie ma tych przycisków.
- Klient ma co najmniej adres e-mail, numer telefonu lub pełny adres pocztowy (ulica, kod pocztowy i miejscowość). W przeciwnym razie przycisków nie ma.
- Dla wezwania do zapłaty musi być jeszcze otwarta jakaś kwota.

## Wysyłanie faktury [#een-factuur-versturen]

<Steps>
<Step>
### Otwórz zaksięgowaną fakturę [#open-de-geboekte-factuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> i otwórz fakturę ze statusem <Status tone="success">Zarezerwowane</Status>.
</Step>
<Step>
### Kliknij Wyślij powiadomienie [#klik-op-verstuur-notificatie]
Otworzy się okno **Wyślij powiadomienie**.
</Step>
<Step>
### Wybierz kanały [#kies-de-kanalen]
Możesz wybrać spośród:

- **E-mail**: klient dostaje e-mail z fakturą w załączniku. Domyślnie włączony, jeśli jest adres e-mail.
- **SMS**: klient dostaje wiadomość SMS. Dostępny tylko z numerem telefonu.
- **WhatsApp**: widoczny tylko wtedy, gdy zainstalowano WhatsApp Business. Wymaga numeru telefonu oraz metody płatności w Meta lub trwającej rozmowy z klientem.
- **Poczta**: faktura jest wysyłana jako PDF pocztą. Dostępna tylko z pełnym adresem pocztowym. Domyślnie wyłączona i pokazuje orientacyjną kwotę opłaty pocztowej za list.

Kanał, który nie jest możliwy dla tego klienta, jest wyłączony i podano przy nim powód, na przykład **Brak adresu e-mail w profilu**. Wybierz co najmniej jeden kanał.
</Step>
<Step>
### Wyślij [#verstuur]
Kliknij **Wyślij**.
</Step>
</Steps>

## Wysyłanie wezwania do zapłaty [#een-aanmaning-versturen]

Wezwanie do zapłaty możesz wysłać, gdy faktura jest zaksięgowana i nadal jest otwarta jakaś kwota.

<Steps>
<Step>
### Otwórz menu wyboru [#open-het-keuzemenu]
Kliknij strzałkę obok **Wyślij powiadomienie** i wybierz **Wyślij przypomnienie**.
</Step>
<Step>
### Wybierz kanały [#kies-de-kanalen-1]
Tutaj **E-mail** i **SMS** są domyślnie włączone, jeśli klient ma adres e-mail i numer telefonu. Przy **Poczta** klient dostaje list z wezwaniem do zapłaty i fakturą w załączniku, z kodem QR do obejrzenia lub opłacenia online.

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Okno potwierdzenia wysłania wezwania do zapłaty" />
</Step>
<Step>
### Wybierz ewentualnie list polecony [#kies-eventueel-aangetekend]
Jeśli zaznaczysz **Poczta**, możesz wybrać **List polecony z potwierdzeniem odbioru**. Jest to możliwe tylko przy wezwaniu do zapłaty, nie przy pierwszym powiadomieniu o fakturze, i tylko jeśli list polecony jest dostępny dla tego adresu. Tillor pokazuje wtedy orientacyjną dodatkową kwotę ponad zwykłą opłatę pocztową. Przycisk nazywa się wtedy **Wyślij z dodatkowym kosztem**.
</Step>
<Step>
### Wyślij [#verstuur-1]
Kliknij **Wyślij**.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Na stronie faktury w sekcji **Powiadomienia** widać, które wiadomości wysłano. Wszystkie wiadomości Twojej organizacji znajdziesz w <UIPath>Komunikacja > Powiadomienia</UIPath>.

Przesyłki pocztowe zaczynają od **Oczekująca**. Potem następują statusy listu: **PDF odebrany**, **Zwalidowana**, **Przetwarzanie**, **W centrum druku** i **Przekazany operatorowi pocztowemu**. Gdy przewoźnik to potwierdzi, status zmienia się na **Wysłane**. Poczta, której nie można doręczyć, dostaje **Błąd**. List anulowany u przewoźnika dostaje status **Pominięte**. Otwórz wiadomość, aby zobaczyć kwotę opłaty pocztowej, numer referencyjny przewoźnika i ostatni status śledzenia. Więcej na ten temat w [Powiadomienia](/notificaties).

- Tillor wysyła wiadomość od razu. Klient dostaje link, aby obejrzeć fakturę i zapłacić online.
- Wezwanie do zapłaty pozostaje osobną akcją dla każdej faktury. Filtr **Ze względu na przypomnienie** na [liście faktur](/facturen) pomaga wybrać, kogo ponaglić ponownie.
- Automatyzacje mogą też wysyłać wezwania do zapłaty automatycznie. Zobacz [Automatyzacje](/automatiseringen).

<Callout type="info">
Faktury, dla której wysłano już powiadomienie, nie można już łatwo przywrócić do szkicu. Zobacz [Korygowanie faktury](/facturen/corrigeren#terugzetten-naar-concept).
</Callout>

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Wyślij powiadomienie">
Faktura musi być zaksięgowana, a klient musi mieć adres e-mail, numer telefonu lub pełny adres pocztowy. Uzupełnij dane w profilu klienta.
</Accordion>
<Accordion title="Nie widzę Wyślij przypomnienie">
Wezwanie do zapłaty jest możliwe tylko przy zaksięgowanej fakturze z otwartą kwotą.
</Accordion>
<Accordion title="Wiadomość się nie powiodła">
Otwórz wiadomość w <UIPath>Komunikacja > Powiadomienia</UIPath>, aby zobaczyć komunikat o błędzie. Następnie sprawdź adres e-mail, numer telefonu lub adres pocztowy klienta i wyślij ponownie. Zobacz [Powiadomienia](/notificaties).
</Accordion>
</Accordions>

## Dalej [#verder]

<Cards>
  <Card title="Powiadomienia" href="/notificaties" description="Status i historia wysłanych wiadomości" />
  <Card title="Rejestrowanie płatności" href="/facturen/betalingen-registreren" />
</Cards>


# Zapraszanie użytkowników i nadawanie uprawnień (/pl-PL/gebruikers/gebruikers-en-rechten)

Współpracownik z kontem Tillor jest w Tillor użytkownikiem. Ty decydujesz, kto ma dostęp do Twojej organizacji oraz co ta osoba może zobaczyć i zrobić, za pomocą uprawnień. Dla współpracowników, do których często się odwołujesz razem, utwórz potem [grupę](/gebruikers/groepen).

Zanim zaczniesz:

- Potrzebujesz uprawnienia **Zarządzanie uprawnieniami użytkowników**. Bez niego przyciski **Zaproś użytkownika** i **Edytuj uprawnienia użytkownika** są wyszarzone.
- Możesz nadawać tylko uprawnienia, które sam masz. Uprawnienia, którego nie masz, nie włączysz innej osobie.
- Samo uprawnienie **Zarządzanie uprawnieniami użytkowników** może nadać innej osobie tylko użytkownik ze **Wszystkie uprawnienia**.

## Zaproszenie współpracownika [#een-collega-uitnodigen]

<Steps>
<Step>
### Otwórz użytkowników [#open-de-gebruikers]
Przejdź do <UIPath>Pomoc > Ustawienia > Użytkownicy</UIPath>. Zobaczysz **Członkowie** swojej organizacji oraz **Oczekujące zaproszenia**.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Ustawienia > Użytkownicy z listą członków" />
</Step>
<Step>
### Kliknij Zaproś użytkownika [#klik-op-gebruiker-uitnodigen]
Otworzy się okno **Zaproś użytkownika**.

<DocScreenshot src="/screenshots/gebruikers/settings-members-invite-dialog.png" alt="Okno Zaproś użytkownika" />
</Step>
<Step>
### Wpisz adres e-mail [#vul-het-e-mailadres-in]
Wpisz **Adres e-mail** współpracownika i kliknij **Zaproś**.
</Step>
</Steps>

Co dzieje się dalej, zależy od adresu e-mail:

<Tabs items={["Konto Tillor już istnieje", "Brak jeszcze konta Tillor"]}>
<Tab value="Er is al een Tillor-account">
Użytkownik od razu zostaje członkiem Twojej organizacji. Tillor wyświetla komunikat **Użytkownik dodany do organizacji**. Osoba od razu widzi Twoją organizację wśród swoich organizacji.
</Tab>
<Tab value="Nog geen Tillor-account">
Tillor wyświetla komunikat **Zaproszenie wysłane** i wysyła zaproszenie e-mailem. Do czasu pierwszego logowania osoba znajduje się w **Oczekujące zaproszenia** z odznaką **Oczekująca**. Przy pierwszym logowaniu zostaje członkiem Twojej organizacji. Przyciskiem **Cofnij zaproszenie** wycofujesz zaproszenie, a Tillor wyświetla komunikat **Zaproszenie cofnięte**.
</Tab>
</Tabs>

Nowy użytkownik na start dostaje te uprawnienia: **Wyświetlanie ustawień**, **Edycja ustawień**, **Wyświetlanie integracji**, **Zarządzanie integracjami**, **Powiadomienia o alarmach liczników**, **Powiadomienia o wiadomościach w skrzynce**, **Alerty tabletu i kiosku**, **Zarządzanie prośbami o podpis** i **Zarządzanie polami niestandardowymi**. Sprawdź, czy to pasuje, i w razie potrzeby zmień.

## Edycja uprawnień [#rechten-bewerken]

<Steps>
<Step>
### Kliknij przy użytkowniku Edytuj uprawnienia użytkownika [#klik-bij-de-gebruiker-op-rechten-bewerken]
Otworzy się okno **Edytuj uprawnienia użytkownika**. U góry widać grupy, do których należy użytkownik. Za pomocą **Szukaj uprawnień** szybko znajdziesz uprawnienie.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions-dialog.png" alt="Okno Edytuj uprawnienia użytkownika z uprawnieniami według obszarów" />
</Step>
<Step>
### Włącz lub wyłącz uprawnienia [#zet-rechten-aan-of-uit]
Uprawnienia są pogrupowane według obszarów, takich jak **Fakturowanie**, **Płatności** czy **Skrzynka odbiorcza**. Na dole widać, ile efektywnych uprawnień ma użytkownik.
</Step>
<Step>
### Zapisz uprawnienia [#sla-de-rechten-op]
Kliknij **Zapisz uprawnienia**. Tillor wyświetla komunikat **Uprawnienia użytkownika zapisane**.
</Step>
</Steps>

### Skąd pochodzi uprawnienie? [#waar-komt-een-recht-vandaan]

Przy każdym uprawnieniu widać jego źródło. Dzięki temu wiesz, dlaczego ktoś coś może lub nie może.

| Źródło | Znaczenie |
|---|---|
| **Bezpośrednio** | Nadałeś to uprawnienie bezpośrednio temu użytkownikowi. Możesz je tu wyłączyć |
| Nazwa grupy | Uprawnienie nadaje ta [grupa](/gebruikers/groepen#groepsrechten). Nie możesz go tu wyłączyć, tylko w grupie |
| **Zablokowane** z nazwą grupy | Ta grupa odmawia uprawnienia. Nawet jeśli użytkownik miał je sam, pozostaje zablokowane |
| **Nieprzyznane** | Nikt nie nadaje tego uprawnienia |

Przycisk **Edytuj uprawnienia użytkownika** jest wyszarzony przy Twoim własnym wierszu i przy użytkownikach z odznaką **Wszystkie uprawnienia**. Ci użytkownicy mają wszystko i nie możesz ich ograniczyć.

## Ustawianie powiadomień współpracownika [#meldingen-van-een-collega-instellen]

Ikoną dzwonka (**Ustawienia powiadomień**) przy użytkowniku otwierasz jego powiadomienia w tej organizacji. Dla każdego powiadomienia wybierasz e-mail, push lub połączenie telefoniczne. Przyciskiem **Wszystkie powiadomienia** wyłączasz kanał jednym kliknięciem. Zmiany działają od razu i obowiązują tylko w tej organizacji.

<DocScreenshot src="/screenshots/gebruikers/settings-members-notifications-dialog.png" alt="Okno z powiadomieniami współpracownika" />

Powiadomień, które są zawsze wysyłane, nie można wyłączyć. Czym jest powiadomienie i gdzie je zobaczysz, znajdziesz w [Powiadomienia](/notificaties#meldingen-in-de-app).

## Usuwanie użytkownika [#een-gebruiker-verwijderen]

Kliknij ikonę kosza (**Usuń z organizacji**) i potwierdź przyciskiem **Usuń użytkownika**. Tillor wyświetla komunikat **Użytkownik usunięty z organizacji**. Osoba od razu traci dostęp do tej organizacji. Jej konto Tillor nadal istnieje, podobnie jak ewentualne inne organizacje.

Nie możesz usunąć siebie. Użytkownika ze **Wszystkie uprawnienia** możesz usunąć tylko wtedy, gdy sam też masz **Wszystkie uprawnienia**.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Użytkownik widzi Twoją organizację wśród swoich organizacji i może korzystać z tego, do czego ma uprawnienia.
- Zmiana uprawnień obowiązuje od razu po zapisaniu.
- Usunięty użytkownik od razu traci dostęp. Jego konto Tillor nadal istnieje.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Przycisk Zaproś użytkownika jest wyszarzony">
Nie masz uprawnienia **Zarządzanie uprawnieniami użytkowników**. Poproś współpracownika ze **Wszystkie uprawnienia**, aby Ci je nadał.
</Accordion>
<Accordion title="Tillor wyświetla komunikat Nie udało się zaprosić użytkownika">
Ten adres e-mail jest już członkiem Twojej organizacji albo dla tego adresu czeka już otwarte zaproszenie. Sprawdź listy **Członkowie** i **Oczekujące zaproszenia**. Jeśli zaproszenie już tam jest, cofnij je i zaproś ponownie, gdy osoba nie dostała e-maila.
</Accordion>
<Accordion title="Zaproszona osoba nie może znaleźć e-maila">
Poproś ją o sprawdzenie spamu. Zostanie członkiem dopiero wtedy, gdy zaloguje się dokładnie tym adresem e-mail, na który wysłałeś zaproszenie. Jeśli zaloguje się innym adresem, cofnij zaproszenie i zaproś ten adres.
</Accordion>
<Accordion title="Uprawnienie jest wyszarzone i nie mogę go włączyć">
Możesz nadawać tylko uprawnienia, które sam masz. Jeśli przy uprawnieniu widać nazwę grupy, to ta grupa je nadaje lub blokuje, a zmieniasz je w grupie.
</Accordion>
<Accordion title="Edytuj uprawnienia użytkownika jest wyszarzone przy współpracowniku">
Współpracownik ma **Wszystkie uprawnienia** albo to Twój własny wiersz. Takich uprawnień nie możesz edytować.
</Accordion>
<Accordion title="Współpracownikowi brakuje przycisku, a nadałem uprawnienie">
Sprawdź w oknie **Edytuj uprawnienia użytkownika**, czy grupa nie pokazuje tego uprawnienia jako **Zablokowane**. Odmowa grupy zawsze wygrywa z uprawnieniem nadanym bezpośrednio.
</Accordion>
<Accordion title="Nie mogę usunąć użytkownika">
Nie możesz usunąć siebie. Użytkownika ze **Wszystkie uprawnienia** usuniesz tylko wtedy, gdy sam też masz **Wszystkie uprawnienia**.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Grupy" href="/gebruikers/groepen" description="Łączenie współpracowników i ustawianie uprawnień według grup" />
  <Card title="Powiadomienia" href="/notificaties" description="Jak docierają powiadomienia" />
  <Card title="Widoczność i dostęp do pól niestandardowych" href="/eigen-velden/zichtbaarheid-en-toegang" description="Uprawnienia dla każdego pola niestandardowego" />
  <Card title="Organizacja" href="/gebruikers/organisaties" description="Wszystkie części Ustawień" />
</Cards>


# Grupy (/pl-PL/gebruikers/groepen)

Grupa to stały zestaw współpracowników, na przykład **Recepcja** albo **Dział techniczny**. Grupy używasz w tych miejscach:

- **Przypisywanie zadań**: przy przypisywaniu zadania szukasz po nazwie grupy
- **Wspominanie i powiadamianie**: wzmianka lub powiadomienie dla grupy trafia do wszystkich członków
- **Udostępnianie widoków**: przy widoku zadań wybierz **Wybrane grupy**, zobacz [Widoki](/taken/weergaven#wie-ziet-een-weergave)
- **Automatyzacje**: kroki, które tworzą lub aktualizują zadanie, mogą przypisywać je do grup

## Tworzenie grupy [#een-groep-maken]

<Steps>
<Step>
### Otwórz Grupy [#open-groepen]
Przejdź do <UIPath>Pomoc > Ustawienia > Grupy</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-groups.png" alt="Ustawienia > Grupy z dwiema grupami" />
</Step>
<Step>
### Kliknij Nowa grupa [#klik-op-nieuwe-groep]
Wpisz **Nazwa**, na przykład Recepcja.
</Step>
<Step>
### Wybierz członków [#kies-de-leden]
W polu **Członkowie** wybierz osoby. Możesz dodać tylko użytkowników, którzy są już członkami organizacji.
</Step>
<Step>
### Kliknij Zapisz [#klik-op-opslaan]
Tillor wyświetla komunikat **Grupa zapisana**.
</Step>
</Steps>

Kliknij grupę, aby zmienić jej nazwę lub członków. Jeśli usuniesz grupę, zadania nadal pozostają przypisane osobom, które są na nich wpisane bezpośrednio. Znika tylko sama grupa.

## Uprawnienia grupy [#groepsrechten]

Grupa może też nadawać lub odbierać uprawnienia. Kliknij przy grupie ikonę klucza (**Uprawnienia grupy**). Dla każdego uprawnienia wybierasz:

| Wybór | Co robi |
|---|---|
| **Zezwól** | Każdy w grupie dostaje uprawnienie ("Przyznane wszystkim") |
| **Dziedzicz** | Grupa nic nie robi z tym uprawnieniem. Każdy członek zachowuje własny dostęp ("Dziedziczy własny dostęp"). To stan początkowy |
| **Odmów** | Uprawnienie jest zablokowane dla wszystkich w grupie ("Zablokowane dla wszystkich") |

<DocScreenshot src="/screenshots/gebruikers/settings-group-permissions-dialog.png" alt="Okno Uprawnienia grupy z opcjami Odmów, Dziedzicz i Zezwól" />

Za pomocą **Szukaj uprawnień** szybko znajdziesz uprawnienie. Na dole widać, ile uprawnień ustawiłeś. Kliknij **Zapisz**, a Tillor wyświetli komunikat **Zapisano uprawnienia grupy**.

<Requires permission="Zarządzanie uprawnieniami użytkowników" />

Bez tego uprawnienia przycisk **Uprawnienia grupy** jest wyszarzony. Nie możesz wtedy też usunąć grupy, która ma jeszcze uprawnienia grupy.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Uprawnienia grupy dochodzą do własnych uprawnień każdego członka. Odmowa zawsze wygrywa: jeśli uprawnienie w jednej grupie ma **Odmów**, a w innej **Zezwól**, pozostaje zablokowane.
- W oknie **Edytuj uprawnienia użytkownika** członka widzisz przy każdym uprawnieniu, która grupa je nadaje lub blokuje. Zobacz [Edycja uprawnień](/gebruikers/gebruikers-en-rechten#rechten-bewerken).
- Gdy dodasz członka, uprawnienia grupy obowiązują także jego. Gdy go usuniesz, już nie.
- Przypisanie zadania, wspomnienie kogoś lub wysłanie powiadomienia do grupy dociera do wszystkich, którzy są jej członkami w danej chwili.

## Grupy z Microsoft Entra [#groepen-uit-microsoft-entra]

Jeśli swoją kadrę zarządzasz już w Microsoft Entra ID, Entra może automatycznie aktualizować członków grupy. Pod listą grup pojawia się wtedy tabela **Grupy Entra**, w której łączysz każdą grupę Entra z grupą Tillor.

<Callout type="info">
W połączonej grupie źródłem jest Entra. Członek, którego dodasz lub usuniesz w Tillor ręcznie, zostanie przy następnej synchronizacji ponownie zrównany z Entra.
</Callout>

Zobacz [Grupy Microsoft Entra](/gebruikers/microsoft-entra), aby skonfigurować połączenie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor wyświetla komunikat Nie udało się zapisać grupy">
Spróbuj ponownie. Jeśli nadal się nie udaje, skontaktuj się z pomocą Tillor.
</Accordion>
<Accordion title="Przycisk Uprawnienia grupy jest wyszarzony">
Nie masz uprawnienia **Zarządzanie uprawnieniami użytkowników**.
</Accordion>
<Accordion title="Członek czegoś nie może, choć grupa na to zezwala">
Inna grupa tego członka odmawia tego uprawnienia. Odmowa zawsze wygrywa. Otwórz okno **Edytuj uprawnienia użytkownika** członka, aby zobaczyć, która grupa je blokuje.
</Accordion>
<Accordion title="Nie widzę członka na liście wyboru">
Na liście są tylko użytkownicy Twojej organizacji. Najpierw zaproś tę osobę. Zobacz [Zapraszanie użytkowników](/gebruikers/gebruikers-en-rechten).
</Accordion>
<Accordion title="Członek ciągle znika z grupy">
Jeśli grupa jest połączona z Microsoft Entra, źródłem jest Entra, a następna synchronizacja zrównuje członków. Zmień członka w Entra.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Grupy Microsoft Entra" href="/gebruikers/microsoft-entra" description="Automatyczne aktualizowanie grup z Entra" />
  <Card title="Widoki" href="/taken/weergaven" description="Udostępnianie widoku zadań grupie" />
  <Card title="Organizacja" href="/gebruikers/organisaties" description="Ustawienia i uprawnienia użytkowników" />
</Cards>


# Przegląd (/pl-PL/gebruikers)

Tutaj ustalasz, kto pracuje z Tillor i co może robić: zapraszasz użytkowników, nadajesz uprawnienia, umieszczasz współpracowników w grupach i dostosowujesz ustawienia swojej organizacji. Użytkownik to każda osoba z kontem, która ma dostęp do Twojej organizacji. Zarządzasz tym w <UIPath>Pomoc > Ustawienia</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Ustawienia > Użytkownicy z listą członków" />

<Callout type="info" title="Warto wiedzieć">
- Nowy użytkownik dostaje stały zestaw uprawnień startowych (ustawienia, integracje, kilka powiadomień, prośby o podpis i pola niestandardowe). Całą resztę nadajesz Ty
- Możesz nadawać tylko uprawnienia, które sam masz. Uprawnienie **Zarządzanie uprawnieniami użytkowników** może przekazać dalej tylko użytkownik ze **Wszystkie uprawnienia**
- Odmowa przez grupę zawsze wygrywa z uprawnieniem nadanym bezpośrednio
- Nie możesz usunąć siebie ani edytować własnych uprawnień
- Nie masz osobnego hasła do Tillor: logujesz się przez Google, Microsoft lub Apple
- Danych firmy, takich jak numer VAT czy IBAN, nie zmieniasz samodzielnie. Robi to pomoc Tillor
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Użytkownik ma uprawnienia na dwa sposoby: bezpośrednio lub przez grupę. Grupa może też odmówić uprawnienia.

```mermaid
flowchart TD
  U[Gebruiker] -->|direct gegeven| R[Rechten van de gebruiker]
  U -->|is lid van| G[Groep]
  G -->|Toestaan| R
  G -->|Overnemen| N[Doet niets, de gebruiker houdt zijn eigen rechten]
  G -->|Weigeren| B[Recht geblokkeerd, ook als de gebruiker het zelf had]
  R --> A[Wat de gebruiker in Tillor ziet en mag doen]
  B --> A
```

- **Bezpośrednio**: włączasz uprawnienie w oknie **Edytuj uprawnienia użytkownika**. Zobacz [Zapraszanie użytkowników i nadawanie uprawnień](/gebruikers/gebruikers-en-rechten).
- **Przez grupę**: w **Uprawnienia grupy** wybierasz dla każdego uprawnienia **Zezwól**, **Dziedzicz** lub **Odmów**. Dotyczy to wszystkich w grupie. Zobacz [Grupy](/gebruikers/groepen).
- **Odmowa**: jeśli uprawnienie w jednej grupie ma **Odmów**, jest zablokowane, bez względu na to, ile innych grup lub uprawnień bezpośrednich je nadaje.
- Tych samych grup używasz do przypisywania zadań, wspominania i udostępniania widoków.

## Twoje własne konto [#je-eigen-account]

Kliknij w pasku bocznym swoje imię (na dole) i wybierz **Konto**. Tam zarządzasz swoim profilem, numerem telefonu, aktywnymi sesjami, aplikacjami OAuth i połączonymi platformami logowania. W **Powiadomienia** wybierasz dla każdego powiadomienia, czy Tillor ma dotrzeć do Ciebie e-mailem czy push. Zobacz [Logowanie i dostęp](/inloggen).

## Klucze API [#api-sleutels]

Klucz API pozwala innemu programowi komunikować się z Tillor w Twoim imieniu. Należy do Twojego konta. Zarządzasz nimi na stronie konta.

<Steps>
<Step>
### Otwórz swoje konto [#open-je-account]
Kliknij w pasku bocznym swoje imię (na dole) i wybierz **Konto**.
</Step>
<Step>
### Utwórz klucz [#maak-de-sleutel]
Otwórz sekcję **Klucze API** i kliknij **Utwórz klucz API**.
</Step>
<Step>
### Skopiuj go od razu [#kopieer-hem-meteen]
Potem Tillor nie pokazuje już klucza w całości.
</Step>
</Steps>

Przez **Dla deweloperów** (to samo menu użytkownika) znajdziesz też skrót **Przejdź do kluczy API**.

<Callout type="warn">
Przechowuj klucze API bezpiecznie i nigdy nie udostępniaj ich niezabezpieczonymi kanałami. Jeśli klucz wyciekł, usuń go albo kliknij **Wygeneruj ponownie** i w razie potrzeby utwórz nowy.
</Callout>

## Części [#onderdelen]

<Cards>
  <Card title="Zapraszanie użytkowników i nadawanie uprawnień" href="/gebruikers/gebruikers-en-rechten" description="Dodawanie współpracowników i określanie, co mogą robić" />
  <Card title="Grupy" href="/gebruikers/groepen" description="Wspólne przypisywanie, wspominanie i nadawanie uprawnień współpracownikom" />
  <Card title="Grupy Microsoft Entra" href="/gebruikers/microsoft-entra" description="Automatyczne aktualizowanie członków grup z Entra" />
  <Card title="Organizacja" href="/gebruikers/organisaties" description="Wszystkie części Ustawień" />
  <Card title="Ustawienia fakturowania" href="/gebruikers/instellingen-facturatie" description="PDF, termin płatności i stawki VAT" />
  <Card title="Ustawienia płatności" href="/gebruikers/instellingen-betalingen" description="Pozostałe, przypomnienia i adres nadawcy" />
  <Card title="Ustawianie okresów najmu" href="/gebruikers/instellingen-huurperiodes" description="Częstotliwości najmu dla rezerwacji" />
  <Card title="Ustawienia kontroli dostępu" href="/gebruikers/instellingen-toegangscontrole" description="Wyjazd z wygasłą tablicą rejestracyjną" />
  <Card title="Dla deweloperów" href="/ontwikkelaars" description="Dokumentacja integracji i webhooki" />
</Cards>

## Pojęcia [#begrippen]

- **Użytkownik**: osoba z kontem, która ma dostęp do Twojej [organizacji](/begrippen#organisatie).
- **[Uprawnienie](/begrippen#recht)**: zgoda na zobaczenie lub zrobienie czegoś, na przykład **Edycja produktów**.
- **Wszystkie uprawnienia**: odznaka dla użytkowników, którzy mogą wszystko. Ich uprawnień nie edytujesz.
- **[Grupa](/begrippen#groep)**: stały zestaw współpracowników, ewentualnie z własnymi uprawnieniami.
- **Zaproszenie**: otwarta prośba do osoby bez konta, aby została członkiem.
- **Klucz API**: kod, za pomocą którego inny program pracuje z Tillor.

Więcej terminów znajdziesz w [słowniku pojęć](/begrippen).


# Ustawienia płatności (/pl-PL/gebruikers/instellingen-betalingen)

W <UIPath>Pomoc > Ustawienia > Płatności</UIPath> znajduje się kilka ustawień, które wpływają na rejestrowanie płatności i wysyłanie powiadomień. Ustawienia obowiązują w całej Twojej organizacji.

<Requires permission="Edycja ustawień" />

<DocScreenshot src="/screenshots/instellingen/settings-payments.png" alt="Ustawienia > Płatności" />

## Ustawienia [#instellingen]

| Ustawienie | Co robi |
|---|---|
| **Pokaż metodę płatności „Inne”** | Dodaje metodę **Inne** do ekranu płatności. Dzięki niej rejestrujesz płatności z własnym opisem, na przykład czek lub wymianę. Domyślnie wyłączone. |
| **Domyślnie: przypomnienie o ręcznym przelewie bankowym** | Domyślnie zaznacza pole przypomnienia o komunikacie strukturalnym, gdy rejestrujesz ręczny przelew bankowy. Dla każdej płatności możesz jeszcze to pole włączyć lub wyłączyć. Domyślnie wyłączone. |
| **Maksimum gotówki** | Kwota w pełnych euro. Domyślnie 2999. |
| **Adres nadawcy e-mail** | Adres, z którego Tillor wysyła powiadomienia e-mailem. |

## Maksimum gotówki [#maximumbedrag-contant]

Za pomocą **Maksimum gotówki** określasz, jak wysoka może być jedna płatność gotówką. Domyślnie jest to 2999 euro. Tillor sprawdza to przy każdej płatności gotówką, także gdy wpływa przez integrację. Jeśli kwota jest wyższa, zarejestruj ją w częściach lub wybierz inną metodę. Zobacz [Gotówka i przelew](/betalingsverwerking/contant).

## Adres nadawcy powiadomień [#afzenderadres-van-meldingen]

Jeśli zostawisz **Adres nadawcy e-mail** pusty, jako nadawca powiadomień widnieje nazwa Twojej organizacji z adresem Tillor. Jeśli wpiszesz prawidłowy adres e-mail, na przykład `meldingen@recreatiepark-het-meer.be`, Tillor użyje tego adresu, z nazwą Twojej organizacji jako nazwą nadawcy. Wpisz sam adres, bez nazwy. Nieprawidłowy adres nie zostanie zapisany.

## Zapisywanie zmian [#wijzigingen-opslaan]

Kliknij na dole **Zapisz ustawienia**. Przyciskiem **Anuluj** przywracasz formularz do zapisanych wartości.

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Gotówka i przelew" href="/betalingsverwerking/contant" description="Rejestrowanie płatności, które wpłynęły poza Tillor" />
  <Card title="Rejestrowanie płatności na fakturze" href="/facturen/betalingen-registreren" description="Metody płatności i pola na ekranie płatności" />
  <Card title="Ustawienia fakturowania" href="/gebruikers/instellingen-facturatie" description="Termin płatności, VAT i PDF" />
</Cards>


# Ustawienia fakturowania (/pl-PL/gebruikers/instellingen-facturatie)

W <UIPath>Pomoc > Ustawienia > Fakturowanie</UIPath> ustawiasz wartości domyślne dla faktur i dla PDF, który wysyłasz klientom. Ustawienia obowiązują w całej Twojej organizacji.

<Requires permission="Edycja ustawień" />

<DocScreenshot src="/screenshots/instellingen/settings-invoicing.png" alt="Ustawienia > Fakturowanie" />

## Co znajduje się w PDF faktury [#wat-staat-er-op-de-factuur-pdf]

| Ustawienie | Co robi |
|---|---|
| **Ogólne warunki na PDF faktury** | PDF dostaje przy każdej stronie odwrotną stronę z ogólnymi warunkami. W stopce znajduje się odwołanie do nich. Treść warunków jest stała i podaje nazwę prawną Twojej organizacji. Domyślnie wyłączone. |
| **Tabela podsumowania VAT na PDF faktury** | Obok sum pojawia się tabela z podstawą opodatkowania i kwotą VAT dla każdej stawki VAT. Domyślnie wyłączone. |
| **Pozycje na stronie PDF faktury** | Maksymalna liczba pozycji na stronie. Jeśli jest ich więcej, następuje nowa strona. Domyślnie 20, minimum 1. |

## Termin płatności [#betaaltermijn]

W **Domyślny termin (dni)** wpisujesz liczbę dni między datą faktury a terminem płatności. Dotyczy faktur, dla których sam nie wybrałeś terminu płatności. Domyślnie to 7 dni. Możesz wpisać 0, wtedy faktura jest wymagalna w dniu księgowania. Zobacz [Księgowanie faktury](/facturen/boeken).

## Wybór stawek VAT [#btw-tarieven-kiezen]

W **Dozwolone stawki VAT** znajdują się stawki, które możesz wybierać na liście VAT na szkicach faktur. Domyślnie to 0%, 6%, 9%, 12% i 21%.

1. Wpisz procent od 0 do 100 w polu pod listą. Dozwolony jest przecinek lub kropka.
2. Kliknij **Dodaj stawkę**.
3. Usuń stawkę krzyżykiem obok procentu.
4. Kliknij **Zapisz ustawienia**.

Lista jest zawsze ułożona od najniższej do najwyższej. Stawki, która już jest na liście, nie dodasz drugi raz. Jeśli na istniejącej pozycji faktury jest stawka, którą później usuniesz z listy, pozostaje ona na tej pozycji.

Tę listę wyboru widzisz tylko wtedy, gdy włączona jest **Lista rozwijana stawki VAT na liniach szkicu faktury**. Szkic faktury dostaje wtedy kolumnę VAT, w której dla każdej pozycji wybierasz stawkę. Jeśli wybierzesz produkt, wartością początkową pozostaje stawka tego produktu. Zobacz [VAT](/boekhouden/belasting) i [Tworzenie i edycja faktur](/facturen/aanmaken-en-bewerken).

## Automatyczne faktury za zużycie [#automatische-facturen-voor-verbruik]

W **Minimalna kwota automatycznych faktur za media** wpisujesz kwotę w euro. Dla klientów z automatycznym fakturowaniem mediów Tillor tworzy fakturę dopiero wtedy, gdy kwota do zapłaty osiągnie tę kwotę. Jeśli zostawisz pole puste (**Bez minimum**), fakturowana jest każda kwota do zapłaty.

Jeśli klient ma na profilu własne minimum, to minimum obowiązuje dla niego zamiast tego ustawienia. Zobacz [Zarządzanie licznikami](/meterbeheer).

## Zapisywanie zmian [#wijzigingen-opslaan]

Kliknij na dole **Zapisz ustawienia**. Przyciskiem **Anuluj** przywracasz formularz do zapisanych wartości. Jeśli masz tylko uprawnienie **Wyświetlanie ustawień**, pola są wyszarzone.

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Księgowanie faktury" href="/facturen/boeken" description="Data faktury i termin płatności" />
  <Card title="VAT" href="/boekhouden/belasting" description="Stawki VAT i VAT na fakturach" />
  <Card title="Ustawienia płatności" href="/gebruikers/instellingen-betalingen" description="Gotówka, Inne i adres nadawcy" />
</Cards>


# Ustawianie okresów najmu (/pl-PL/gebruikers/instellingen-huurperiodes)

Przy zajęciu miejsca wybierasz **Częstotliwość czynszu**. To, jakie opcje tam widzisz, ustalasz w <UIPath>Pomoc > Ustawienia > Okresy najmu</UIPath>. Każdy okres, który tu dodasz, staje się opcją na liście.

<Requires permission="Edycja ustawień" />

<DocScreenshot src="/screenshots/instellingen/settings-occupation.png" alt="Ustawienia > Okresy najmu z nowym okresem" />

## Dodawanie okresu [#een-periode-toevoegen]

<Steps>
<Step>
### Dodaj okres [#voeg-een-periode-toe]
Otwórz **Okresy najmu** i kliknij **Dodaj okres**. Pojawi się blok z wartościami początkowymi: styczeń, 12 miesięcy.
</Step>
<Step>
### Wypełnij okres [#vul-de-periode-in]
Wybierz **Miesiąc startu** i wpisz w **Czas trwania (miesiące)** liczbę od 1 do 12. Okres 12 miesięcy zaczynający się w styczniu to rok kalendarzowy. Okres 1 miesiąca to najem miesięczny. W polu **Etykieta** możesz wpisać własną nazwę, na przykład Rocznie.
</Step>
<Step>
### Wybierz sposób zaokrąglania [#kies-hoe-je-afrondt]
Pole **Zaokrąglaj daty startu do następnego okresu** jest domyślnie zaznaczone. Co robi, przeczytasz w [Zaokrąglanie do następnego okresu](#afronden-naar-de-volgende-periode).
</Step>
<Step>
### Zapisz [#sla-op]
Kliknij **Zapisz ustawienia**. Przyciskiem **Usuń okres** usuwasz okres. Przyciskiem **Anuluj** przywracasz formularz do zapisanej listy.
</Step>
</Steps>

Jeśli nie dodałeś jeszcze żadnych okresów, widać komunikat **Brak skonfigurowanych okresów najmu**. W formularzu zajęcia miejsca nie możesz wtedy wybrać częstotliwości czynszu.

## Gdzie widać okresy [#waar-zie-je-de-periodes-terug]

W formularzu zajęcia miejsca lista znajduje się w **Częstotliwość czynszu**, a na jej początku jest **Bez częstotliwości**. Okres 1 miesiąca nazywa się tam **Miesięcznie**. Okres 12 miesięcy wyświetla się jako **Rok (sty - gru)**, z pierwszym i ostatnim miesiącem Twojego okresu. Inne czasy trwania wyświetlają się jako **6 miesięcy (kwi - wrz)**. Jeśli przy okresie wpisałeś **Etykieta**, ta etykieta widnieje zamiast tego tekstu, na liście i w kolumnie **Częstotliwość czynszu** zajęć miejsc.

Jeśli usuniesz okres z ustawień, zajęcia miejsc, które już go używają, zachowują swoją częstotliwość czynszu.

## Zaokrąglanie do następnego okresu [#afronden-naar-de-volgende-periode]

To pole określa stan początkowy **Zaokrąglij do granicy następnego okresu** na pozycji faktury, którą przedłużasz zajęcie miejsca. Na pozycji faktury nadal możesz samodzielnie włączyć lub wyłączyć to pole.

- Gdy pole jest zaznaczone, pozycja kończy się na najbliższej granicy okresu. Jeśli zaczynasz w środku okresu, pierwszą część liczysz proporcjonalnie. Potem klient podąża tym samym cyklem co pozostali najemcy.
- Gdy pole jest odznaczone, pozycja trwa dokładnie jeden okres od daty startu.

Zobacz [Tworzenie i edycja faktur](/facturen/aanmaken-en-bewerken) i [Zajęcia miejsc](/bezettingen).

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Zajęcia miejsc" href="/bezettingen" description="Długoterminowe powiązanie klienta z miejscem" />
  <Card title="Tworzenie i edycja faktur" href="/facturen/aanmaken-en-bewerken" description="Zaokrąglanie do granicy następnego okresu na pozycji faktury" />
</Cards>


# Ustawienia kontroli dostępu (/pl-PL/gebruikers/instellingen-toegangscontrole)

W <UIPath>Pomoc > Ustawienia > Kontrola dostępu</UIPath> ustawiasz zachowanie szlabanów dla tablic rejestracyjnych, których okres dostępu wygasł.

<Requires permission="Edycja ustawień" />

<DocScreenshot src="/screenshots/instellingen/settings-access-control.png" alt="Ustawienia > Kontrola dostępu" />

## Zezwalanie na wyjazd wygasłym tablicom [#verlopen-kentekens-laten-uitrijden]

Gość z tablicą rejestracyjną, której okres dostępu wygasł, w przeciwnym razie nie przejedzie już przez szlaban wyjazdowy. Dzięki **Zezwól na wyjazd wygasłych tablic** szlaban wyjazdowy mimo to się otwiera, w okresie karencji po wygaśnięciu. Działa to tylko poza godzinami otwarcia. Jeśli recepcja jest otwarta, personel obsługuje pojazd przy okienku.

Pole jest domyślnie zaznaczone. Jeśli je odznaczysz, szlaban wyjazdowy pozostaje zamknięty dla wygasłej tablicy.

| Ustawienie | Co robi |
|---|---|
| **Zezwól na wyjazd wygasłych tablic** | Włącza lub wyłącza okres karencji. |
| **Okres karencji wyjazdu (dni)** | Liczba dni po wygaśnięciu, w których pojazd może jeszcze wyjechać poza godzinami otwarcia. Domyślnie 2, najwyżej 30. Przy 0 nie ma karencji. |

Karencja dotyczy tylko tablic rejestracyjnych przy wyjeździe. Tablica, która jest zablokowana lub nieaktywna, nigdy nie dostaje karencji. Dla innych metod dostępu, takich jak tagi NFC czy kody QR, karencja nie istnieje.

Godziny otwarcia pochodzą z <UIPath>Pomoc > Ustawienia > Godziny otwarcia</UIPath>. Zobacz [Godziny otwarcia](/gebruikers/organisaties#openingsuren).

## Zapisywanie zmian [#wijzigingen-opslaan]

Kliknij na dole **Zapisz ustawienia**. Przyciskiem **Anuluj** przywracasz formularz do zapisanych wartości.

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Kontrola dostępu" href="/toegangscontrole" description="Punkty dostępu, pojazdy i dziennik" />
  <Card title="Organizacja" href="/gebruikers/organisaties" description="Godziny otwarcia i inne ustawienia" />
</Cards>


# Grupy Microsoft Entra (/pl-PL/gebruikers/microsoft-entra)

Dzięki aprowizacji Microsoft Entra ID wysyła Twoich użytkowników i grupy do Tillor. Jeśli połączysz grupę Entra z [grupą](/gebruikers/groepen) Tillor, członkowie tej grupy podążają za Entra: kogo dodasz w Entra, dostaje zadania i widoki grupy, a kogo z niej usuniesz lub wyłączysz, traci je. Nikt nie musi się w tym celu logować ponownie.

Entra używa do tego protokołu SCIM. Tillor sam niczego nie odczytuje z Twojej dzierżawy Microsoft: to Entra decyduje, których użytkowników i grupy wysyła. Tylko podczas [Szybkiej konfiguracji](#snel-instellen) Twoja przeglądarka łączy się z Microsoft, aby utworzyć dla Ciebie aplikację.

## Co się dzieje, a co nie [#wat-er-wel-en-niet-gebeurt]

- **Tylko istniejący członkowie.** Entra nie tworzy kont Tillor. Osoba, która nie jest jeszcze członkiem Twojej organizacji, nie liczy się, dopóki jej nie [zaprosisz](/gebruikers/organisaties). Gdy tylko zostanie członkiem, od razu trafia do swoich połączonych grup
- **Brak danych osób niebędących członkami.** O osobach bez konta Tillor Tillor nie przechowuje imienia ani adresu e-mail, tylko nieczytelny kod, dzięki któremu rozpozna je, gdy później zostaną członkami
- **Nic bez połączenia.** Grupa Entra zmienia coś w Tillor dopiero wtedy, gdy połączysz ją z grupą Tillor w **Grupy Entra niepołączone**
- **Jeden do jednego.** Grupa Tillor należy do najwyżej jednej grupy Entra
- **Nazwa pozostaje w Tillor.** Jeśli zmienisz nazwę grupy w Entra, nową nazwę zobaczysz za **Entra ·**, ale grupa Tillor zachowuje własną nazwę
- **Grupy zagnieżdżone** nie są rozwijane. Grupa, która jest członkiem innej grupy, nie liczy się jako członek. Jeśli chcesz mieć także te osoby, przypisz grupę zagnieżdżoną osobno w Entra i połącz ją z tą samą lub inną grupą Tillor
- **Logowanie się nie zmienia.** Ludzie logują się jak zwykle przez Microsoft, zobacz [Logowanie](/inloggen)

## Zanim zaczniesz [#voordat-je-begint]

Potrzebujesz:

- W Tillor uprawnienia **Edycja ustawień**
- W Microsoft Entra roli **Cloud Application Administrator** lub **Application Administrator** (albo wyższej)
- Licencji Entra, która pozwala na automatyczną aprowizację do własnych aplikacji (Microsoft Entra ID P1 lub wyższa)

Zadbaj, aby Twoi współpracownicy mieli w Tillor to samo konto Microsoft lub ten sam adres e-mail co w Entra. Dzięki temu Tillor rozpoznaje, kto jest kim, zobacz [Jak Tillor rozpoznaje osoby](#hoe-tillor-mensen-herkent).

## Szybka konfiguracja [#snel-instellen]

Jeśli sam jesteś administratorem Entra, Tillor przygotuje połączenie za Ciebie za jednym razem.

1. Przejdź do **Pomoc > Ustawienia** i wybierz **Grupy**
2. Przy **Microsoft Entra** kliknij **Skonfiguruj z Microsoft**, a potem **Zaloguj się i skonfiguruj**
3. W oknie Microsoft zaloguj się kontem administratora i udziel zgody. Microsoft prosi o zgodę na zarządzanie aplikacjami i aprowizacją oraz na odczyt Twoich grup

Tillor tworzy wtedy aplikację w Entra, uzupełnia adres URL dzierżawy i token, sprawia, że użytkownicy są rozpoznawani po koncie Microsoft, i każe Entra wysyłać typ każdej grupy. Potem rozpoczyna się synchronizacja, a Tillor od razu wysyła Ciebie i wszystkie Twoje grupy, więc nie musisz czekać na pierwszą synchronizację. Na koniec Tillor odczytuje dla każdej grupy jej typ i to, czy należy do niej zespół w Teams. Widzisz, jak każdy krok jest odhaczany. Tillor robi to w tle: możesz zamknąć okno, a nawet stronę. Gdy później ponownie klikniesz **Skonfiguruj z Microsoft**, zobaczysz, jak daleko to zaszło, lub do godziny po zakończeniu, czy się udało, czy nie. Potem możesz zacząć od nowa przyciskiem **Skonfiguruj ponownie**.

Entra wysyła przy tym wszystkich Twoich użytkowników i wszystkie grupy. Nie musisz niczego wcześniej wybierać: grupy trafiają do **Grupy Entra niepołączone** i niczego nie zmieniają, dopóki ich nie połączysz. Przejdź w tym celu dalej do [Łączenie grup w Tillor](#groepen-koppelen-in-tillor). Członkowie grup dojdą z pierwszą synchronizacją. Trwa ona kilka minut, w dużych organizacjach kilka godzin.

<Callout type="info">
Tillor używa dostępu tylko do tej konfiguracji. Dostęp trafia zaszyfrowany do zadania w tle i potem nie jest nigdzie przechowywany; Microsoft sam go unieważnia po około godzinie. Jeśli ponownie przejdziesz **Skonfiguruj z Microsoft**, Tillor odnajdzie tę samą aplikację i nie utworzy drugiej.
</Callout>

<Callout type="warn">
Szybka konfiguracja tworzy nowy token. Token, który wcześniej wkleiłeś ręcznie w Entra, przestaje potem działać. Jeśli konfiguracja zatrzyma się w połowie, kliknij **Spróbuj ponownie**.
</Callout>

Jeśli logowanie się nie udaje, na przykład dlatego, że Twoja organizacja blokuje zgody dla aplikacji, albo chcesz, aby Entra wysyłała tylko wybrane grupy, skonfiguruj połączenie ręcznie, jak opisano poniżej.

## Konfiguracja ręczna [#handmatig-instellen]

<Steps>
<Step>

### Utwórz token w Tillor [#token-maken-in-tillor]

1. Przejdź do **Pomoc > Ustawienia** i wybierz **Grupy**
2. U góry jest **Microsoft Entra**. Jeśli połączenie jest już skonfigurowane, kliknij **Połączenie**
3. Skopiuj **Adres URL dzierżawy**. Wygląda tak: `https://…/api/orgs/<organisatie>/scim/v2`
4. Kliknij **Wygeneruj token** i skopiuj token, który się pojawi

<Callout type="warn">
Token jest pokazywany tylko raz. Wklej go od razu w Entra. Jeśli go zgubisz, kliknij **Zastąp token** i użyj nowego tokenu.
</Callout>

</Step>
<Step>

### Utwórz aplikację w Entra [#een-app-maken-in-entra]

1. Otwórz [Microsoft Entra admin center](https://entra.microsoft.com)
2. Przejdź do **Identity > Applications > Enterprise applications** i kliknij **New application**
3. Kliknij **Create your own application**
4. Nadaj aplikacji nazwę, na przykład **Tillor**, wybierz **Integrate any other application you don't find in the gallery (Non-gallery)** i kliknij **Create**

Jeśli masz już enterprise application dla Tillor, możesz użyć jej.

</Step>
<Step>

### Połącz aprowizację [#provisioning-koppelen]

1. W aplikacji otwórz **Provisioning** i kliknij **Get started** (lub **New configuration**)
2. Ustaw **Provisioning Mode** na **Automatic**
3. W **Admin Credentials** wpisz:
   - **Tenant URL**: adres URL dzierżawy z Tillor
   - **Secret Token**: token z Tillor
4. Kliknij **Test Connection**. Entra musi zgłosić, że połączenie się udało
5. Kliknij **Save**

</Step>
<Step>

### Sprawdź atrybuty [#attributen-controleren]

W **Mappings** otwórz regułę **Provision Microsoft Entra ID Users**:

- Ustaw **externalId** na **objectId** (domyślnie jest **mailNickname**). Wtedy Tillor rozpoznaje osobę po koncie Microsoft, nawet gdy adres e-mail się różni
- Zostaw **userName** (← **userPrincipalName**), **active** i **emails[type eq "work"].value** (← **mail**)

Zostaw **Provision Microsoft Entra ID Groups** włączone. Ustawienia domyślne (**displayName**, **externalId** ← **objectId**, **members**) są dobre.

Jeśli chcesz w Tillor widzieć, jakiego rodzaju jest grupa, dodaj do grup te atrybuty. W **Show advanced options** wybierz najpierw **Edit attribute list for customappsso** i dodaj atrybuty docelowe, potem dla każdej reguły **Add New Mapping**:

| Źródło w Entra | Atrybut docelowy | Typ |
|---|---|---|
| Wyrażenie `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 |

Jeśli brakuje źródła na liście Entra, pomiń tę regułę. Tego, czy do grupy należy zespół w Teams, Entra tą drogą nie przekaże; Tillor widzi to tylko przez **Skonfiguruj z Microsoft**.

Inne atrybuty możesz zostawić. Tillor ich nie zapisuje.

</Step>
<Step>

### Przypisz grupy [#groepen-toewijzen]

1. W aplikacji otwórz **Users and groups** i kliknij **Add user/group**
2. Wybierz grupy, które ma dostać Tillor, na przykład **Recepcja**, i kliknij **Assign**
3. Sprawdź w **Provisioning > Settings**, czy **Scope** jest ustawiony na **Sync only assigned users and groups**

Entra wysyła grupę razem z jej członkami. Nie musisz osobno przypisywać członków.

</Step>
<Step>

### Uruchom aprowizację [#provisioning-starten]

W **Provisioning** ustaw **Provisioning Status** na **On** i kliknij **Save**.

Pierwsza runda może chwilę potrwać, zależnie od liczby użytkowników. Potem Entra wysyła zmiany mniej więcej co 40 minut. Jeśli chcesz od razu zaktualizować jedną osobę, użyj **Provision on demand** w Entra.

</Step>
<Step>

### Łączenie grup w Tillor [#groepen-koppelen-in-tillor]

Odśwież **Ustawienia > Grupy**. U góry znajduje się wiersz **Microsoft Entra** z ostatnią synchronizacją i liczbą połączonych grup. Pod Twoimi grupami Tillor znajduje się **Grupy Entra niepołączone** z przesłanymi grupami, które jeszcze nic nie robią. Kliknij **Pokaż**, jeśli lista jest zwinięta, i użyj pola wyszukiwania, aby znaleźć grupę. Wybierz dla każdej grupy w **Połącz z…**, co ma się stać, a potem kliknij **Zapisz**. Przyciskiem **Cofnij zmiany** odrzucasz swoje wybory. Grupa Tillor może być połączona tylko z jedną grupą Entra; grup, które są już połączone, nie możesz wybrać ponownie.

| Wybór | Co się dzieje |
|---|---|
| **Utwórz nową** | Tillor tworzy grupę z nazwą z Entra i wypełnia ją rozpoznanymi członkami |
| Istniejąca grupa | Członkowie tej grupy są zastępowani rozpoznanymi członkami z Entra. Jeśli Entra nie wysłała jeszcze członków tej grupy, obecni członkowie pozostają do czasu, aż synchronizacja ich dostarczy |

Od teraz Entra aktualizuje członków przy każdej synchronizacji. Połączona grupa znika z listy, a w Twoich grupach Tillor pod grupą widnieje **Entra · [nazwa]** z informacją, jakiego rodzaju jest grupa.

Łączenie odbywa się tylko z poziomu **Grupy Entra niepołączone**. Grupy Tillor, którą zarządzasz ręcznie, na przykład IT, nie łączysz z poziomu samej grupy.

Za każdą nazwą grupy widać, jakiego rodzaju jest grupa w Entra. Przyciskami nad listą pokazujesz jeden rodzaj.

| Etykieta | Co to jest |
|---|---|
| **Zabezpieczenia** | Zwykła grupa zabezpieczeń, często grupa, którą chcesz połączyć |
| **Zabezpieczenia z obsługą poczty** | Grupa zabezpieczeń z własnym adresem e-mail |
| **Lista dystrybucyjna** | Tylko lista e-mailowa |
| **Microsoft 365** | Grupa ze wspólną skrzynką pocztową i witryną SharePoint, czasem z zespołem w Teams |
| **Windows Server AD** | Pochodzi z Twojego lokalnego Active Directory (hybrydowa) i jest tam zarządzana |
| **Dynamiczna** | Entra sama określa członków regułą |
| **Teams** | Należy do niej zespół w Teams |
| **Nieznany typ** | Tillor nie zna jeszcze typu. Przejdź ponownie **Skonfiguruj z Microsoft** |

Grupy witryny SharePoint, takie jak **Właściciele**, **Członkowie** i **Goście** witryny, nie są grupami Entra. Nigdy nie trafiają do Tillor. Widzisz natomiast grupę Microsoft 365 stojącą za witryną.

</Step>
</Steps>

## Jak Tillor rozpoznaje osoby [#hoe-tillor-mensen-herkent]

Dla każdego użytkownika, którego wysyła Entra, Tillor szuka istniejącego członka Twojej organizacji:

1. Najpierw po **koncie Microsoft**, którym ta osoba loguje się w Tillor (ID obiektu Entra, jeśli ustawisz **externalId** na **objectId**)
2. W przeciwnym razie po **adresie e-mail**: adres służbowy z Entra lub **userPrincipalName**, jeśli jest adresem e-mail

Jeśli Tillor nikogo nie znajdzie albo użytkownik jest w Entra wyłączony, nie liczy się w grupie. Gdy tylko osoba zostanie członkiem organizacji, od razu się liczy. Jeśli włączysz ją w Entra ponownie, liczy się od następnej synchronizacji.

## Co się dzieje przy zmianach w Entra [#wat-er-gebeurt-bij-wijzigingen-in-entra]

| W Entra | W Tillor |
|---|---|
| Członek dodany do połączonej grupy | Trafia do grupy Tillor (jeśli jest członkiem organizacji) |
| Członek usunięty z grupy | Znika z grupy Tillor |
| Użytkownik wyłączony (**Account enabled** wyłączone) | Znika ze wszystkich połączonych grup Tillor. Jego konto Tillor nadal istnieje |
| Użytkownik lub grupa nie jest już przypisana do aplikacji | Entra wysyła wyłączenie lub usunięcie, z takim samym skutkiem |
| Grupa usunięta | Pod grupą Tillor widnieje **Usunięto w Entra. Członkowie zostali zachowani.** Grupa Tillor pozostaje z ostatnimi członkami i nie jest już aktualizowana |

Całkowite usunięcie kogoś z organizacji robisz w Tillor, w [Organizacja](/gebruikers/organisaties). Entra zarządza tylko członkami grup.

## Co zobaczysz w dzienniku aktywności [#wat-je-terugziet-in-het-activiteitenlog]

W [dzienniku aktywności](/activiteitenlog) zobaczysz:

- Każdą zmianę członków grupy Tillor, którą wprowadza Entra, z informacją, kto dołączył lub odszedł. Jest ona zapisana na system, nie na użytkownika
- Każdą rundę synchronizacji z Entra, jeden wiersz na rundę. Rundy, w której Entra nic nie wysyła, nie widać
- Kto połączył lub odłączył grupę Entra z grupą Tillor i kto zastąpił token

## Zmiana lub zatrzymanie połączenia [#koppeling-wijzigen-of-stoppen]

- **Odłączanie**: kliknij przy grupie Tillor **Odłącz**. Grupa Tillor pozostaje taka, jaka jest, a Ty znów zarządzasz nią ręcznie. Grupa Entra wraca do **Grupy Entra niepołączone**
- **Inna grupa Tillor**: odłącz, a potem połącz grupę Entra w **Grupy Entra niepołączone** z inną grupą. Poprzednia grupa zachowuje swoich członków, ale nie jest już aktualizowana
- **Całkowite zatrzymanie**: ustaw w Entra **Provisioning Status** na **Off** albo usuń enterprise application

## Zastąpienie tokenu [#token-vervangen]

Kliknij w wierszu **Microsoft Entra** **Połączenie**, a potem **Zastąp token**, jeśli token wyciekł lub potrzebujesz go ponownie. Stary token od razu przestaje działać. Wklej nowy token w Entra w **Provisioning > Admin Credentials > Secret Token** i kliknij **Save**. Dopóki tego nie zrobisz, synchronizacja w Entra się nie udaje.

## Rozwiązywanie problemów [#problemen-oplossen]

**Skonfiguruj z Microsoft zatrzymuje się na jednym z kroków**

Przy kroku widać komunikat od Microsoft. Zwykle koncie brakuje roli administratora lub zgody. Sprawdź role w [Zanim zaczniesz](#voordat-je-begint) i kliknij **Spróbuj ponownie**. Tillor ponownie używa aplikacji i aprowizacji, które zostały już utworzone.

**Test Connection się nie udaje**

Sprawdź, czy adres URL dzierżawy został przepisany w całości, łącznie z `/scim/v2`, i czy token jest ostatnio wygenerowanym. Po **Zastąp token** stary token nie działa.

**Grupy nie ma na liście**

Poczekaj, aż pierwsza synchronizacja się zakończy, i odśwież stronę. Jeśli ustawiłeś połączenie ręcznie, Entra wysyła tylko grupy przypisane do aplikacji: sprawdź **Users and groups** w aplikacji i poczekaj na następną rundę albo użyj **Provision on demand**.

**Ktoś nie ma się w grupie Tillor**

- Czy ta osoba jest członkiem Twojej organizacji w Tillor? Entra nie tworzy kont
- Czy adres e-mail w Entra zgadza się z tym w Tillor? Jeśli nie, ustaw **externalId** na **objectId**, aby Tillor rozpoznał osobę po jej koncie Microsoft. Działa to tylko wtedy, gdy osoba już kiedyś zalogowała się w Tillor przez Microsoft
- Czy użytkownik jest w Entra włączony?
- Czy jest bezpośrednim członkiem grupy, a nie przez grupę zagnieżdżoną?

**Moja ręczna zmiana znika**

W połączonej grupie źródłem jest Entra. Zmień członków w Entra albo odłącz grupę.

**Więcej szczegółów o nieudanej rundzie**

Otwórz w Entra **Provisioning > Provisioning logs**. Zobaczysz tam dla każdego użytkownika i grupy, co Entra próbowała zrobić i jaką odpowiedź dał Tillor.

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Grupy" href="/gebruikers/groepen" description="Tworzenie i używanie grup" />
  <Card title="Widoki" href="/taken/weergaven" description="Udostępnianie widoku zadań grupie" />
  <Card title="Logowanie" href="/inloggen" description="Logowanie przez Microsoft" />
</Cards>


# Organizacja (/pl-PL/gebruikers/organisaties)

Na stronie **Ustawienia** (na dole menu głównego, <UIPath>Pomoc > Ustawienia</UIPath>) zarządzasz ustawieniami swojej organizacji. Po lewej przełączasz się między częściami. To, które części widzisz, zależy od Twoich uprawnień.

| Część | Do czego służy |
|---|---|
| **Ogólne** | Profil organizacji, strefa czasowa, kraj domyślny i kolory identyfikacji wizualnej. Zobacz [Ogólne](#algemeen) |
| **Godziny otwarcia** | Harmonogram tygodniowy, sezony, wyjątki i dni świąteczne. Zobacz [Godziny otwarcia](#openingsuren) |
| **Fakturowanie** | PDF, termin płatności i stawki VAT. Zobacz [Ustawienia fakturowania](/gebruikers/instellingen-facturatie) |
| **Drukowanie** | Drukarki i momenty drukowania. Zobacz [Drukowanie](#afdrukken) |
| **Płatności** | Metoda płatności Inne i adres nadawcy. Zobacz [Ustawienia płatności](/gebruikers/instellingen-betalingen) |
| **Okresy najmu** | Częstotliwości najmu dla zajęć miejsc. Zobacz [Ustawianie okresów najmu](/gebruikers/instellingen-huurperiodes) |
| **Taryfa parceli** | Formuła obliczanej taryfy. Zobacz [Formuła taryfy](/terreinen#tariefformule) |
| **Kontrola dostępu** | Wyjazd z wygasłą tablicą rejestracyjną. Zobacz [Ustawienia kontroli dostępu](/gebruikers/instellingen-toegangscontrole) |
| **Mapa** | Środek mapy i kierunek mapy. Zobacz [Ustawianie domyślnej mapy](/kaart#kaartstandaard-instellen) |
| **Typy terenów** | Typy dla terenów. Zobacz [Typy terenów](/terreinen#terreintypes) |
| **Etykiety zadań** | Etykiety dla zadań. Zobacz [Etykiety](/taken/labels) |
| **Grupy** | Łączenie współpracowników. Zobacz [Grupy](/gebruikers/groepen) |
| **Pola niestandardowe** | Dodatkowe pola dla klientów, terenów i innych. Zobacz [Pola niestandardowe](/eigen-velden) |
| **Apple Wallet** | Tło karty i punkt dostępu. Zobacz [Apple Wallet](#apple-wallet) |
| **Tablety i kioski** | Tablety i kioski. Zobacz [Tablety i kioski](/mobiele-app/tablets-en-kiosken) |
| **Integracje** | Połączenia z innymi usługami. Zobacz [Integracje](#integraties) |
| **Użytkownicy** | Członkowie, zaproszenia i uprawnienia. Zobacz [Zarządzanie uprawnieniami użytkowników](#gebruikersrechten-beheren) |

<Callout type="info" title="Warto wiedzieć">
- To, które części widzisz, zależy od Twoich uprawnień. Zmiany zapisujesz na dole przyciskiem **Zapisz ustawienia**
- Mniej więcej tydzień przed ustawowym dniem świątecznym Tillor wysyła e-mail na adres pomocy, jeśli godziny otwarcia tego dnia są jeszcze puste
- Po zapisaniu ustawień wallet Tillor ponownie aktualizuje wszystkie aktywne karty wallet. Odwiedzający zwykle widzą to po otwarciu karty
- Gdy Twoja organizacja ma już faktury lub płatności, waluty nie można już zmienić
</Callout>

<Callout type="info">
Dane firmy na fakturach (nazwa, adres, numer VAT, IBAN, logo) są ustawiane podczas onboardingu. Skontaktuj się z pomocą Tillor, jeśli chcesz je zmienić.
</Callout>

## Integracje [#integraties]

Wybierz **Integracje**, aby zobaczyć dostępne połączenia, takie jak telefonia Voys, konta bankowe, Mollie czy oprogramowanie księgowe (np. Admisol). W **Integracje** w menu po lewej są kategorie (komunikacja, płatności, księgowość, liczniki). Kliknij integrację na liście, aby otworzyć jej stronę szczegółów. Tam instalujesz połączenie lub zmieniasz ustawienia (bez osobnego okna dialogowego). Zobacz też [przegląd integracji](/integraties).

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Ustawienia - przegląd integracji" />

## Ogólne [#algemeen]

W **Ogólne** ustawiasz profil organizacji, strefę czasową, kraj domyślny i kolory identyfikacji wizualnej. Aby zapisać zmiany, potrzebujesz uprawnienia **Edycja ustawień**.

## Godziny otwarcia [#openingsuren]

W **Godziny otwarcia** edytujesz jeden harmonogram tygodniowy. Kolorowymi opcjami przełączasz się na **okresy sezonowe** (na przykład 1 lipca–31 sierpnia) lub **wyjątek** (jedna data albo okres, taki jak 24–26 grudnia). **Ustawowe dni świąteczne** z najbliższych 12 miesięcy są już dodane: wybierz dzień świąteczny i wpisz godziny (albo zostaw puste, jeśli tego dnia jesteś zamknięty). Zostaw dzień tygodnia pusty, jeśli tego dnia jesteś zamknięty. AI skrzynki odbiorczej używa tych godzin jako godzin otwarcia biura. Mniej więcej tydzień przed ustawowym dniem świątecznym Tillor wysyła e-mail z przypomnieniem na **adres pomocy** organizacji (lub na ogólny adres e-mail, jeśli nie ma adresu pomocy), gdy godziny na ten dzień nie są jeszcze wpisane. Jeśli używasz Partoo, godziny otwarcia synchronizują się automatycznie. Zobacz [Partoo](/integraties/partoo). Strona internetowa może pobrać wyliczone godziny (łącznie z etykietami sezonów, takimi jak Lato czy Zima) i nadchodzące dni świąteczne przez [API godzin otwarcia](/ontwikkelaars/voorbeelden/opening-hours).

## Drukowanie [#afdrukken]

W **Drukowanie** ustawiasz wydruki PDF, adresy IP drukarek i **harmonogram momentów drukowania**. Dodaj dla każdego dnia tygodnia jeden lub więcej czasów (albo zostaw dzień pusty). Płatności online, mandatowe i przelewem czekają na następny moment tego dnia, zanim faktura trafi do kolejki drukarki.

## Apple Wallet [#apple-wallet]

W **Apple Wallet** ustawiasz obok siebie dwie rzeczy: po lewej **tło karty**, po prawej **lokalizację punktu dostępu**.

**Tło karty** (po lewej): opcjonalne zdjęcie na całą powierzchnię dla układu Poster Generic na iPhonie z **iOS 27**. Prześlij JPEG, PNG lub WebP; duże pliki są automatycznie zmniejszane. Przeciągnij na podglądzie, aby wybrać, która część zdjęcia pozostaje widoczna za kodem QR. Podgląd od razu pokazuje Twój wybór; dopiero po **Zapisz** na dole **Ustawienia** zdjęcie (lub jego usunięcie) wchodzi w życie, a Tillor przesyła punkt ostrości do kart dostępu.

Na iPhonie z **iOS 26 lub starszym** karta używa klasycznego układu generic z tymi samymi danymi (status, imię i nazwisko odwiedzającego, ważność, kod QR). Bez własnego obrazu wszystkie karty dostają standardowe gradientowe tło Tillor. Z własnym zdjęciem u góry widać **logo organizacji** z danych firmy, w kolorze na zdjęciu. Przy standardowym gradiencie logo jest białe na ciemnym gradiencie.

Na kartach Poster Generic (iOS 27) kod QR jest **kwadratowy**; na starszych urządzeniach prostokątny, jak na klasycznej karcie generic.

**Lokalizacja punktu dostępu** (po prawej): kliknij mapę lub przeciągnij pinezkę, aby ustawić punkt GPS głównego punktu dostępu. **Apple Wallet** i **Google Wallet** używają tej lokalizacji na karcie dostępu. Na iPhonie iOS może zaproponować kartę na ekranie blokady, gdy odwiedzający jest w pobliżu. Wybierz **Użyj środka mapy parku**, aby usunąć pinezkę i użyć środka mapy parku.

Po zapisaniu **Ustawienia** Tillor ponownie aktualizuje wszystkie aktywne karty wallet w organizacji (Apple przez cichy push, Google przez synchronizację obiektów). Goście zwykle widzą aktualizację po otwarciu karty w Wallet; czasem potrzebne jest jeszcze ręczne odświeżenie w aplikacji Wallet. Podgląd w Tillor pokazuje to samo kadrowanie co na karcie: przeciągnij obraz tak, aby środek znalazł się w wybranym miejscu.

<DocScreenshot src="/screenshots/gebruikers/settings-wallet-barrier-map.png" alt="Ustawienia > Apple Wallet z tłem karty i punktem dostępu na mapie" />

Na odwrocie karty wallet znajdują się numer telefonu i adres e-mail organizacji (e-mail pomocy, jeśli jest ustawiony, w przeciwnym razie adres ogólny). Przy zablokowanych, wygasłych lub cofniętych kartach te dane pojawiają się także za tekstem recepcji na ekranie blokady (Apple) lub w Google Wallet.

<DocScreenshot src="/screenshots/gebruikers/settings-dialog.png" alt="Ustawienia > Ogólne" />

## Zarządzanie uprawnieniami użytkowników [#gebruikersrechten-beheren]

W **Użytkownicy** widzisz **Członkowie** swojej organizacji i **Oczekujące zaproszenia**. Jak zapraszasz i usuwasz współpracowników oraz ustawiasz ich powiadomienia, opisuje [Zapraszanie użytkowników i nadawanie uprawnień](/gebruikers/gebruikers-en-rechten).

### Edycja uprawnień [#rechten-bewerken]

Kliknij przy użytkowniku **Edytuj uprawnienia użytkownika**. Pełne wyjaśnienie, także o grupach i zablokowanych uprawnieniach, znajdziesz w [Edycja uprawnień](/gebruikers/gebruikers-en-rechten#rechten-bewerken). Poniżej znajdują się uprawnienia, które często budzą pytania.

### Konta bankowe [#bankrekeningen]

| Uprawnienie | Co może użytkownik? |
|---|---|
| **Wyświetlanie transakcji bankowych** | Strona **Administracja > Transakcje bankowe** i blok **Transakcje konta bankowego** w **Administracja > Raporty płatności** |
| **Synchronizacja transakcji bankowych** | Przycisk **Synchronizuj konto bankowe** (ręczny import) |

Uprawnienia znajdują się w oknie uprawnień w grupie **Transakcje bankowe**.

Zobacz też [Konta bankowe](/boekhouden/betalingsrapporten/betaalmethodes/ponto) dotyczące połączenia z open banking.

### Przypisywanie płatności [#betaling-koppelen]

| Uprawnienie | Co może użytkownik? |
|---|---|
| **Przypisz płatność** | **Przypisz płatność** na zaksięgowanej fakturze, **Przypisz** przy grupach płatności i **Przypisz do faktury** przy transakcjach bankowych (niewidoczne bez uprawnienia) |

Uprawnienie znajduje się w oknie uprawnień w grupie **Płatności**.

### Aplikacje OAuth [#oauth-apps]

| Uprawnienie | Co może użytkownik? |
|---|---|
| **Autoryzacja aplikacji OAuth** | Udzielać stronom trzecim (np. Cursor, Claude, ChatGPT) zgody przez OAuth i nadal używać istniejących tokenów OAuth |

Istniejący użytkownicy zachowują uprawnienie po migracji. Nowi użytkownicy nie dostają go automatycznie. Zaznacz je w oknie uprawnień użytkownika. Wyłącz je, aby ten użytkownik nie mógł łączyć nowych aplikacji OAuth; istniejące tokeny tego użytkownika też wtedy przestają działać. Użytkownicy z tym uprawnieniem w co najmniej jednej organizacji mogą autoryzować.

Zobacz też [MCP](/ontwikkelaars/mcp).

## Umowa powierzenia przetwarzania danych [#verwerkersovereenkomst]

Jeśli zamiast Tillor pojawia się ekran **Wymagana umowa powierzenia przetwarzania danych**, Twoja organizacja musi podpisać aktualną umowę powierzenia przetwarzania danych (DPA), zanim będziesz mógł dalej pracować. Najpierw możesz pobrać dokument przyciskiem **Pobierz dokument DPA**. Potem prosisz o kod weryfikacyjny. Trafia on SMS-em na numer telefonu osoby odpowiedzialnej. Wpisz kod i kliknij **Zaakceptuj DPA**.

## Dane na fakturach [#gegevens-op-facturen]

Dane firmy, takie jak nazwa, adres, numer VAT i IBAN, pojawiają się automatycznie na fakturach. Są ustawiane podczas onboardingu. Skontaktuj się z pomocą Tillor, aby je zmienić.

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Użytkownicy" href="/gebruikers" description="Zarządzanie dostępem do kont" />
  <Card title="Grupy" href="/gebruikers/groepen" description="Łączenie współpracowników, także z uprawnieniami grupy" />
  <Card title="Faktury" href="/facturen" description="Tworzenie i wysyłanie faktur" />
</Cards>


# Dowód i ważność (/pl-PL/handtekeningen/bewijs-en-geldigheid)

Przy każdym podpisie Tillor zapisuje, kto, kiedy i jak podpisał, a następnie zamyka plik PDF tak, aby późniejsza zmiana była widoczna. Efektem jest zwykły podpis elektroniczny, odpowiedni dla umów najmu, regulaminów, oświadczeń o zwolnieniu z odpowiedzialności i warunków. Przy dokumentach, dla których prawo wymaga mocniejszego podpisu, Tillor nie jest właściwym miejscem.

## Co znajduje się na stronach dowodowych? [#wat-staat-er-op-de-bewijspaginas]

Na końcu podpisanego pliku PDF dodawana jest jedna lub więcej stron **Dowód podpisu**. Znajdziesz na nich:

- tytuł dokumentu, prośbę, Twoją organizację, liczbę stron oraz kiedy prośba została utworzona, wysłana i zakończona
- dwa odciski pliku: pliku PDF takiego, jak go przesłałeś, oraz podpisanych stron przed dodaniem stron dowodowych. Jeśli w pliku zmieni się choćby jeden znak, odcisk przestanie się zgadzać
- dla każdego podpisującego: imię i nazwisko, rolę, rodzaj, adres e-mail, numer telefonu i język, kiedy wyszedł link i kiedy ta osoba po raz pierwszy otworzyła stronę, czas podpisania, adres IP i urządzenie
- jak potwierdzono tożsamość podpisującego: jednorazowym kodem, na jaki kanał kod został wysłany i kiedy, albo przez zalogowanie w Tillorze w przypadku pracowników
- zdanie, którym podpisujący wyraził zgodę, dokładnie tak, jak widział je na ekranie
- co podpisujący wypełnił: każde pole tekstowe, daty i pole wyboru wraz z wartością, także te, które pozostały puste
- podpis i parafę w takiej postaci, w jakiej zostały złożone, oraz na których stronach się znajdują. Podpis wpisany z klawiatury jest tam jako obraz wpisanego imienia i nazwiska, tak samo jak podpis narysowany
- jak podpisano: na stronie podpisu przez link, w Tillorze przez zalogowanego pracownika albo na tablecie przy recepcji (z kodem albo z tożsamością potwierdzoną przez pracownika)
- **ścieżkę audytu**: każdy krok z czasem, osobą oraz adresem IP i urządzeniem. Na przykład *Wysłano link do podpisu*, *Otwarto stronę podpisu*, *Wysłano kod weryfikacyjny*, *Wpisano błędny kod*, *Podpisano* i *Zakończono i opieczętowano*

Czasy podawane są w strefie czasowej Twojej organizacji, a obok czas UTC (światowy czas standardowy). Adresy IP i urządzenia Tillor przechowuje w postaci zaszyfrowanej. Widzisz je w Tillorze i na stronach dowodowych. Podpisy i wypełnione wartości znajdują się w dokumencie w miejscach, które wybrałeś. Twój oryginalny plik jest przechowywany osobno i nigdy się nie zmienia.

Te same kroki zobaczysz też na stronie prośby w sekcji **Historia** oraz przy kliencie w sekcji **Zdarzenia**.

<Callout type="info" title="Dla czytelnika technicznego">
Dwa odciski to sumy kontrolne SHA-256. Odcisk SHA-256 zmienia się całkowicie, gdy zmieni się choćby jeden bajt pliku, dlatego dowodzi, że plik nie został zmieniony. Na stronie dowodowej jest też odcisk certyfikatu pieczęci (zobacz poniżej).
</Callout>

## Pieczęć i znacznik czasu [#zegel-en-tijdstempel]

Podpisany plik PDF jest jako ostatni krok **opieczętowany** podpisem cyfrowym Twojej organizacji, utworzonym przez Tillor. Gdy otworzysz go w Adobe Reader lub innej przeglądarce PDF, zobaczysz panel podpisów. Jeśli po opieczętowaniu coś w pliku się zmieni, przeglądarka to zgłosi.

Przeglądarka może określać podpisującego jako **nieznany** lub **niezaufany**. To normalne: certyfikat pochodzi od Tillora, a nie od płatnego urzędu certyfikacji. Który to certyfikat, widać wraz z jego odciskiem na stronie dowodowej.

Pieczęć dostaje też **znacznik czasu** od niezależnej, bezpłatnej usługi znaczników czasu (FreeTSA, a gdy ta nie odpowiada, DigiCert). Dowodzi to niezależnie od Tillora, kiedy plik istniał dokładnie w tej postaci. Czas widać na stronie prośby w sekcji **Znacznik czasu**.

## Jaki to rodzaj podpisu [#welk-soort-handtekening]

To **zwykły podpis elektroniczny** według europejskich zasad eIDAS. Tillor sprawdza adres e-mail lub numer telefonu kodem, zapisuje rysunek podpisu i przechowuje dowód. Pasuje to do umów najmu, regulaminów, oświadczeń o zwolnieniu z odpowiedzialności i warunków.

**Kwalifikowany** podpis, na przykład przez itsme lub kartę eID, nie jest możliwy. Jeśli masz dokument, dla którego prawo tego wymaga, daj go podpisać poza Tillorem.

## Co dzieje się z dowodem? [#wat-gebeurt-er-met-het-bewijs]

- Oryginalny plik PDF i podpisany plik PDF pozostają w dokumentach klienta. Możesz je zarchiwizować, ale nie usunąć.
- Dowód jest częścią podpisanego pliku PDF. Kto dostał kopię, ma więc także strony dowodowe.
- Ścieżka audytu pozostaje na stronie prośby, także gdy prośba została odrzucona, anulowana lub wygasła.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Moja przeglądarka PDF mówi, że podpis jest niezaufany">
To prawda i jest to normalne. Pieczęć pochodzi od Tillora, a nie od płatnego urzędu certyfikacji. Ważne, aby przeglądarka nie zgłaszała zmiany po opieczętowaniu. Certyfikat widać wraz z jego odciskiem na stronie dowodowej.
</Accordion>
<Accordion title="Moja przeglądarka PDF zgłasza, że dokument został zmieniony po podpisaniu">
Plik został zmieniony po opieczętowaniu, na przykład przez ponowny zapis lub edycję. Pobierz podpisany plik PDF ponownie ze strony szczegółów prośby lub z dokumentów klienta. Ten plik jest niezmieniony.
</Accordion>
<Accordion title="Klient chce kwalifikowany podpis przez itsme lub eID">
To nie jest możliwe w Tillorze. Daj ten dokument podpisać poza Tillorem.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Tak podpisuje odbiorca" href="/handtekeningen/ondertekenen" />
  <Card title="Śledzenie prośby" href="/handtekeningen/opvolgen" />
  <Card title="Wszystkie pojęcia" href="/begrippen" />
</Cards>


# Prośba o podpisy (/pl-PL/handtekeningen/handtekening-vragen)

Za pomocą prośby o podpis sprawiasz, że jedna lub więcej osób podpisuje plik PDF online. Tworzysz ją w dwóch częściach: najpierw wybierasz klienta i plik PDF, a potem w edytorze ustawiasz podpisujących i pola. Jak potem śledzisz, kto już podpisał, opisujemy w części [Śledzenie prośby](/handtekeningen/opvolgen).

<Requires permission="Zarządzanie prośbami o podpis" />

Zanim zaczniesz:

- Potrzebujesz uprawnienia **Zarządzanie prośbami o podpis**. Jeśli go nie masz, przycisk **Poproś o podpisy** jest wyszarzony.
- Plik musi być plikiem PDF, do 250 MB. Inny typ pliku Tillor odrzuca komunikatem **To nie jest PDF. Wybierz plik PDF.**
- Każdy podpisujący potrzebuje adresu e-mail lub numeru telefonu, aby otrzymać link lub kod. W przypadku klienta lub osoby kontaktowej uzupełnij je najpierw w ich danych.
- Każdy podpisujący potrzebuje co najmniej jednego pola podpisu lub parafy.

## Tworzenie prośby o podpis [#een-ondertekenverzoek-maken]

<Steps>
<Step>
### Zacznij prośbę [#start-het-verzoek]
Wybierz, skąd zaczynasz.

<Tabs items={["Z Podpisów", "Z klienta"]}>
<Tab value="Z Podpisów">
Przejdź do <UIPath>Administracja > Podpisy</UIPath> i kliknij **Poproś o podpisy**. Wybierz **Klient**.
</Tab>
<Tab value="Z klienta">
Otwórz kartę **Dokumenty** klienta i kliknij **Poproś o podpisy**. Klient jest wtedy już wypełniony.
</Tab>
</Tabs>

W polu **Dokument** wybierz plik PDF, który już jest przy tym kliencie, albo zostaw **Prześlij nowy PDF** i przeciągnij plik PDF do pola (lub kliknij **Wybierz PDF**). Wpisz **Tytuł**, na przykład *Umowa najmu 2027*. Jeśli zostawisz go pusty, Tillor przejmie nazwę dokumentu. Następnie kliknij **Dalej**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-create-dialog.png" alt="Okno Poproś o podpisy z klientem, tytułem i dokumentem" />

Przesłany plik PDF trafia do dokumentów klienta. Tillor nigdy go nie zmienia: podpisy trafiają do osobnej kopii.
</Step>
<Step>
### Dodaj podpisujących [#voeg-ondertekenaars-toe]
W sekcji **Podpisujący** kliknij **Dodaj podpisującego** i wybierz:

- **Klient: [imię i nazwisko]**
- **Kontakt klienta**
- **Pracownik**
- **Strona zewnętrzna**: wpisz **Imię i nazwisko**, **Adres e-mail** i/lub **Numer komórkowy** oraz **Język**. Potrzebna jest co najmniej jedna z tych dwóch danych kontaktowych. Bez adresu e-mail osoba dostaje link SMS-em.

<DocScreenshot src="/screenshots/handtekeningen/signatures-add-signer-menu.png" alt="Menu Dodaj podpisującego" />

<DocScreenshot src="/screenshots/handtekeningen/signatures-external-dialog.png" alt="Okno Dodaj stronę zewnętrzną" />

Możesz dodać maksymalnie 10 podpisujących. Podpisują od góry do dołu, a następny dostaje link dopiero, gdy poprzedni podpisze. Za pomocą **Podpisuje wcześniej** i **Podpisuje później** (strzałki) zmieniasz kolejność, a ikoną kosza usuwasz osobę. W polu pod nazwiskiem możesz opcjonalnie wpisać **Rola**, na przykład *Najemca* lub *Poręczyciel*.

Każdy podpisujący dostaje własny kolor. Ten kolor zobaczysz przy jego polach w dokumencie.
</Step>
<Step>
### Umieść pola [#plaats-de-velden]
W sekcji **Pola dla** wybierz podpisującego, dla którego umieszczasz pola. Potem wybierz rodzaj pola i kliknij lub przeciągnij na stronę dokumentu. Przeciągnij pole, aby je przenieść, a przeciągnij róg, aby je powiększyć lub zmniejszyć.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor.png" alt="Edytor z podpisującymi, sekcją Pola dla i rodzajami pól" />

| Pole | Co robi podpisujący |
| --- | --- |
| **Podpis** | Umieszcza narysowany podpis, dotykając pola |
| **Parafa** | Umieszcza narysowaną parafę, dotykając pola |
| **Imię i nazwisko** | Nic: Tillor wpisuje imię i nazwisko podpisującego |
| **Data podpisu** | Nic: Tillor wpisuje dzień podpisania |
| **Tekst** | Wpisuje jedną linię, do 200 znaków, na przykład numer rejestracyjny |
| **Długi tekst** | Wpisuje kilka linii, do 2000 znaków, na przykład uwagę |
| **Pole wyboru** | Zaznacza warunek |
| **Data** | Wybiera datę, na przykład dzień przyjazdu |

Kliknij umieszczone pole, aby je zaznaczyć. Pod przyciskami zobaczysz wtedy:

- **Podpisujący**: przypisuje pole innemu podpisującemu, bez ponownego rysowania.
- Przy **Tekst**, **Długi tekst**, **Pole wyboru** i **Data** także **Pytanie lub etykieta** (widoczne dla podpisującego przy polu) oraz **Wymagane**. Pole, które nie jest wymagane, może pozostać puste.
- Krzyżyk na polu usuwa je.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor-fields.png" alt="Ostatnia strona z polami najemcy, współnajemcy i wynajmującego w ich własnych kolorach" />

Jeśli ktoś potrzebuje parafy na każdej stronie, użyj **Parafa na każdej stronie**. Tillor umieszcza wtedy pole parafy na wszystkich stronach dla tego podpisującego. Dopóki podpisujący nie ma pola podpisu ani parafy, przy tej osobie widzisz **Brak pola podpisu**.
</Step>
<Step>
### Ustaw wiadomość i termin [#stel-bericht-en-termijn-in]
W sekcji **Prośba** wpisz:

- **Tytuł**: tak, jak widzą go podpisujący.
- **Wiadomość do podpisujących**: opcjonalna, widoczna w e-mailu i na stronie podpisu.
- **Podpisać do**: ostateczna data. Domyślnie jest to 14 dni po utworzeniu. Podpisać można do końca tego dnia.
- **Przypomnienie po**: po ilu dniach (od 1 do 14) podpisujący, na którego jest kolej, dostaje przypomnienie. Domyślnie 3 dni.
</Step>
<Step>
### Wyślij prośbę [#verstuur-het-verzoek]
Kliknij **Wyślij** i potwierdź. Pierwszy podpisujący dostaje link.

<DocScreenshot src="/screenshots/handtekeningen/signatures-send-dialog.png" alt="Potwierdzenie Wysłać prośbę?" />

Jeśli chcesz kontynuować później, kliknij **Zapisz szkic**. Ikoną kosza obok (**Usuń szkic**) wyrzucasz prośbę, po potwierdzeniu. Plik PDF pozostaje w dokumentach klienta.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Prośba dostaje status <Status tone="info">W toku</Status>. Znajdziesz ją przy kliencie w sekcji **Dokumenty** oraz w <UIPath>Administracja > Podpisy</UIPath>. Tillor pokazuje **Wysłano do pierwszej osoby podpisującej**.
- Pierwszy podpisujący dostaje e-mail z osobistym linkiem lub SMS, jeśli jest tylko numer telefonu. Każdy kolejny podpisujący dostaje link, gdy poprzedni podpisze.
- Podpisujący, na którego jest kolej i który nie reaguje, dostaje automatycznie przypomnienie po liczbie dni ustawionej w **Przypomnienie po**, maksymalnie 2 razy. Przypomnienie możesz też zawsze wysłać sam, zobacz [Śledzenie prośby](/handtekeningen/opvolgen#een-herinnering-sturen).
- Gdy wszyscy podpiszą, prośba zmienia status na <Status tone="success">Zakończona</Status>, a podpisany plik PDF jest u klienta.
- Jeśli termin minie, zanim wszyscy podpiszą, prośba dostaje status <Status tone="warning">Wygasła</Status>.

Jeśli chcesz jeszcze coś zmienić, gdy nikt jeszcze nie podpisał, albo podpisałeś tylko Ty, kliknij **Wróć do edycji**. Prośba znów staje się szkicem: wysłane linki przestają działać, a wszyscy podpisują od nowa, gdy wyślesz ją ponownie. Jeśli ktoś inny już podpisał, anuluj prośbę i utwórz nową.

Chcesz, aby automatyzacja reagowała na zakończoną prośbę, na przykład zadaniem? Użyj wyzwalacza **Prośba o podpis zakończona**, zobacz [Wyzwalacze](/automatiseringen/triggers).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Przycisk Poproś o podpisy jest wyszarzony">
Brakuje Ci uprawnienia **Zarządzanie prośbami o podpis**. Poproś administratora o dodanie go w <UIPath>Ustawienia > Użytkownicy</UIPath>.
</Accordion>
<Accordion title="Tillor mówi: To nie jest PDF. Wybierz plik PDF.">
Wybrałeś inny typ pliku, na przykład Word. Zapisz najpierw dokument jako PDF i wybierz ten plik.
</Accordion>
<Accordion title="Tillor mówi: Wybierz klienta, lub: Prześlij plik PDF lub wybierz dokument klienta">
Na pierwszym ekranie pole **Klient** lub **Dokument** jest puste. Wypełnij oba i kliknij ponownie **Dalej**.
</Accordion>
<Accordion title="Nie mogę wysłać">
Tillor sprawdza prośbę przed wysłaniem i mówi, czego brakuje:

- **Przed wysłaniem dodaj co najmniej jednego podpisującego.**
- Podpisujący nie ma jeszcze pola podpisu ani parafy. Tillor zaznacza tę osobę. Przeciągnij wtedy na dokumencie, aby umieścić pole.
- Podpisujący nie ma adresu e-mail ani numeru telefonu i nie może otrzymać linku ani kodu. Dotyczy to też klienta lub osoby kontaktowej: uzupełnij najpierw adres e-mail lub numer telefonu w ich danych. Na liście przy takiej osobie widać **Brak adresu e-mail i numeru telefonu**.
- **Nadaj prośbie tytuł.**
</Accordion>
<Accordion title="Tillor mówi: Nie udało się wysłać prośby">
Prośba mogła nie zostać wysłana. Odśwież stronę. Jeśli prośba nadal ma status <Status>Szkic</Status>, kliknij ponownie **Wyślij**.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się zapisać szkicu">
Twoje zmiany nie zostały zapisane. Odśwież stronę i sprawdź, co jeszcze jest, zanim pójdziesz dalej.
</Accordion>
<Accordion title="Dokument nie ładuje się w edytorze">
Odśwież stronę. Jeśli nadal nie działa, sprawdź, czy plik jest prawidłowym plikiem PDF.
</Accordion>
<Accordion title="Umieściłem pole przy niewłaściwej osobie">
Kliknij pole i w polu **Podpisujący** wybierz właściwą osobę. Pole zostaje na swoim miejscu.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Śledzenie prośby" href="/handtekeningen/opvolgen" />
  <Card title="Tak podpisuje odbiorca" href="/handtekeningen/ondertekenen" />
  <Card title="Dowód i ważność" href="/handtekeningen/bewijs-en-geldigheid" />
</Cards>


# Przegląd (/pl-PL/handtekeningen)

Dzięki modułowi **Podpisy** zbierasz podpisy online pod plikiem PDF, takim jak umowa najmu, regulamin, oświadczenie o zwolnieniu z odpowiedzialności lub poręczenie. Podpisujący podpisują po kolei, a Ty decydujesz, w którym miejscu na stronach pojawi się każdy podpis, parafa lub pole do wypełnienia. Jak się do tego zabrać, opisujemy w części [Prośba o podpisy](/handtekeningen/handtekening-vragen).

Gdy wszyscy podpiszą, Tillor tworzy podpisany plik PDF ze stronami dowodowymi na końcu. Trafia on potem do **Dokumentów** klienta, a każdy podpisujący dostaje kopię. Twój oryginalny plik PDF zostaje przechowany bez zmian.

<Requires permission="Zarządzanie prośbami o podpis" />

Przygotowywanie, wysyłanie, przypominanie, cofanie i anulowanie próśb o podpis wymaga uprawnienia **Zarządzanie prośbami o podpis** w grupie **Podpisy** w <UIPath>Ustawienia > Użytkownicy</UIPath>. Jeśli go nie masz, te przyciski są wyszarzone. Wszyscy użytkownicy w Twojej organizacji mogą przeglądać prośby i sami się podpisać, gdy przyjdzie ich kolej.

<Callout type="info" title="Warto wiedzieć">
- Prośba może mieć maksymalnie 10 podpisujących i obsługuje tylko pliki PDF do 250 MB.
- Domyślnie podpisać można w ciągu 14 dni, do końca ostatniego dnia. Możesz wybrać inną datę.
- Podpisujący, na którego jest kolej, domyślnie dostaje przypomnienie po 3 dniach (możesz wybrać od 1 do 14 dni), maksymalnie 2 automatyczne przypomnienia. Wysyłane są przy codziennej kontroli Tillora.
- Przy podpisywaniu podpisujący potwierdza się 6-cyfrowym kodem. Kod jest ważny 10 minut, a nowy można poprosić po 2 minutach.
- Twój oryginalny plik PDF nigdy się nie zmienia. Oryginał i podpisany plik PDF możesz zarchiwizować, ale nie usunąć, bo stanowią dowód.
- Prośba dostaje status Wygasła podczas codziennej kontroli, a nie dokładnie w chwili upływu terminu.
</Callout>

## Gdzie to znajdziesz [#waar-vind-je-het]

- <UIPath>Administracja > Podpisy</UIPath> pokazuje wszystkie prośby o podpis wraz ze statusem i liczbą złożonych już podpisów.
- W profilu klienta, na karcie **Dokumenty**, znajdziesz przycisk **Poproś o podpisy**, a pod nim **Prośby o podpis** tego klienta.

<DocScreenshot src="/screenshots/handtekeningen/signatures-list.png" alt="Lista próśb o podpis w Administracja > Podpisy" />

## Jak to się łączy [#hoe-hangt-dit-samen]

Prośba o podpis zawsze należy do jednego klienta i jednego pliku PDF. Podpisujący nie muszą być samym klientem: podpisać może także osoba kontaktowa, współpracownik lub strona zewnętrzna.

```mermaid
flowchart LR
  A[PDF bij de klant] --> B[Ondertekenverzoek met ondertekenaars en velden]
  B --> C[Ondertekenaar 1 tekent]
  C --> D[Ondertekenaar 2 tekent]
  D --> E[Ondertekende PDF met bewijspagina's]
  E --> F[Documenten van de klant]
  E --> G[Kopie voor elke ondertekenaar]
```

## Jak przebiega prośba [#hoe-een-verzoek-verloopt]

```mermaid
flowchart LR
  A[Concept] -->|Versturen| B[Bezig]
  B -->|iedereen getekend| C[Afgerond]
  B -->|ondertekenaar weigert| D[Geweigerd]
  B -->|Aanvraag annuleren| E[Geannuleerd]
  B -->|termijn voorbij| F[Verlopen]
  B -->|Terug naar bewerken| A
```

## Statusy [#statussen]

| Status | Znaczenie |
|---|---|
| <Status>Szkic</Status> | Dopiero przygotowujesz prośbę. Nic jeszcze nie zostało wysłane. |
| <Status tone="info">W toku</Status> | Prośba została wysłana i trwa podpisywanie. |
| <Status tone="success">Zakończona</Status> | Wszyscy podpisali, a podpisany plik PDF jest u klienta. |
| <Status tone="error">Odrzucona</Status> | Któryś z podpisujących odmówił. Prośba została zatrzymana. |
| <Status>Anulowana</Status> | Ty lub współpracownik wycofaliście prośbę. |
| <Status tone="warning">Wygasła</Status> | Nie podpisano na czas. |

Przy każdym podpisującym zobaczysz **Oczekuje** (jeszcze nie jego kolej), **Link wysłany** (jego kolej), **Podpisano** lub **Odmowa**.

## Kto może podpisać [#wie-kan-ondertekenen]

| Rodzaj | Jak ta osoba podpisuje |
|---|---|
| **Klient** | Przez osobisty link w e-mailu lub w SMS-ie, jeśli jest tylko numer telefonu |
| **Kontakt** | Tak jak klient, dla osoby kontaktowej tego klienta |
| **Pracownik** | W samym Tillorze, bez kodu |
| **Strona zewnętrzna** | Tak jak klient, z imieniem i nazwiskiem oraz adresem e-mail lub numerem telefonu, które sam wpisujesz |

Klient, osoba kontaktowa lub strona zewnętrzna może też podpisać przy recepcji, na tablecie z aplikacją Tillor. Zobacz [Na tablecie przy recepcji](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Automatyzacja [#automatiseren]

Prośba o podpis może uruchomić [automatyzację](/automatiseringen/triggers). Za pomocą **Prośba o podpis zakończona** utworzysz na przykład zadanie, gdy umowa najmu zostanie podpisana, a za pomocą **Zmieniono prośbę o podpis** zareagujesz na każdą zmianę statusu. Te same zdarzenia możesz wysyłać jako [webhook](/ontwikkelaars/webhooks) do własnego systemu.

<Cards>
  <Card title="Poproś o podpisy" href="/handtekeningen/handtekening-vragen" />
  <Card title="Śledzenie prośby" href="/handtekeningen/opvolgen" />
  <Card title="Tak podpisuje odbiorca" href="/handtekeningen/ondertekenen" />
  <Card title="Dowód i ważność" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Pozyskanie klienta sezonowego" href="/praktijk/seizoensklant-binnenhalen" description="Z podpisaniem umowy najmu" />
</Cards>

## Pojęcia [#begrippen]

- **Prośba o podpis**: zlecenie zebrania podpisów pod jednym plikiem PDF, z podpisującymi, polami i terminem. Zobacz [prośba o podpis](/begrippen#ondertekenverzoek).
- **Podpisujący**: osoba, która ma podpisać. Klient, osoba kontaktowa, pracownik lub strona zewnętrzna.
- **Pole**: miejsce w pliku PDF, w którym podpisujący składa podpis, parafę lub coś wpisuje.
- **Szkic**: prośba, którą jeszcze przygotowujesz. Nic jeszcze nie zostało wysłane.
- **Strony dowodowe**: strony na końcu podpisanego pliku PDF, które pokazują, kto, kiedy i jak podpisał. Zobacz [strona dowodowa](/begrippen#bewijspagina).
- **Pieczęć**: podpis cyfrowy Twojej organizacji, którym zamykany jest podpisany plik PDF. Zobacz [pieczęć](/begrippen#zegel).


# Tak podpisuje odbiorca (/pl-PL/handtekeningen/ondertekenen)

Ta strona pokazuje, co przeżywają Twoi podpisujący, abyś mógł odpowiadać na pytania, oraz jak dać komuś podpisać przy recepcji na tablecie. Prośbę wysyłasz sam przez [Prośbę o podpisy](/handtekeningen/handtekening-vragen).

Zanim zaczniesz:

- Prośba musi mieć status <Status tone="info">W toku</Status>, a podpisujący musi mieć swoją kolej. Jeśli jeszcze nie jest czyjaś kolej, widać **To jeszcze nie Twoja kolej**.
- Do tabletu potrzebujesz uprawnienia **Zarządzanie prośbami o podpis**, a aplikacja Tillor musi być online na urządzeniu Twojej organizacji.
- Podpisujący potrzebuje numeru telefonu lub adresu e-mail, bo tam trafia kod. Tylko pracownik podpisuje bez kodu.

## Na tablecie przy recepcji [#op-de-tablet-aan-de-receptie]

Jeśli ktoś stoi przed Tobą, nie musi sam otwierać linku. Możliwe to dla klienta, osoby kontaktowej lub strony zewnętrznej, na którą jest kolej.

<Steps>
<Step>
### Otwórz prośbę [#open-het-verzoek]
Przejdź do <UIPath>Administracja > Podpisy</UIPath> i otwórz prośbę albo otwórz ją z karty **Dokumenty** klienta.
</Step>
<Step>
### Kliknij Podpisz na tablecie [#klik-op-op-tablet-tekenen]
Przy podpisującym, na którego jest kolej, kliknij **Podpisz na tablecie** i wybierz, jak potwierdzana jest tożsamość:

- **Z kodem**: podpisujący potwierdza na tablecie kodem, który przychodzi SMS-em lub e-mailem, tak jak przy linku.
- **Bez kodu**: sprawdziłeś tożsamość przy recepcji, na przykład na podstawie dowodu osobistego. Kod nie jest wymagany. Na stronie dowodowej widnieje, że tożsamość potwierdził pracownik, a w historii kto to był.

Tillor pokazuje **Otwarto na tablecie**.
</Step>
<Step>
### Pozwól osobie podpisać [#laat-de-persoon-tekenen]
Dokument otwiera się w aplikacji na tablecie, z imieniem i nazwiskiem podpisującego dużymi literami na górze. Sprawdź to imię i nazwisko razem z osobą przed Tobą. Kroki są takie same jak przy linku, zobacz poniżej. Tuż po wysłaniu tablet może jeszcze chwilę pokazywać **Przygotowywanie dokumentu…**.
</Step>
</Steps>

Po podpisaniu lub odmowie tablet po kilku sekundach wraca do ekranu startowego. Przy kilku podpisujących wysyłasz każdego osobno na tablet, gdy przyjdzie jego kolej. Na stronie dowodowej widnieje, że podpis złożono na tablecie.

## Co robi podpisujący? [#wat-doet-de-ondertekenaar]

<Tabs items={["Przez link", "Na tablecie"]}>
<Tab value="Przez link">
Podpisujący dostaje e-mail lub SMS, jeśli jest tylko numer telefonu. Zawiera on osobisty link do strony podpisu, Twoją wiadomość i nazwę Twojej organizacji. Strona działa na telefonie, tablecie i komputerze, w języku podpisującego.
</Tab>
<Tab value="Na tablecie">
Podpisujący widzi dokument od razu w aplikacji, po tym jak wybierzesz **Podpisz na tablecie**. Nie jest potrzebny link ani e-mail. Kto podpisuje na tablecie z kodem, dostaje kod na własnym telefonie lub w e-mailu.
</Tab>
</Tabs>

Potem kroki są takie same.

<Steps>
<Step>
### Zaczynamy [#beginnen]
Na pierwszej karcie widać, kto jeszcze podpisuje, miejsce w kolejce (na przykład *Podpisujący 2 z 3*) i kroki. Po prawej jest dokument, z podpisami wcześniejszych podpisujących już na swoich miejscach. Przyciskiem **Rozpocznij podpisywanie** podpisujący zaczyna. Każdy krok ma przycisk wstecz. Działa też przycisk wstecz telefonu.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-start.png" alt="Strona podpisu dla poręczyciela z kartą startową i dokumentem" />
</Step>
<Step>
### Narysuj podpis [#teken-je-handtekening]
Podpisujący rysuje **Podpis** palcem lub myszką albo wybiera **Wpisz** i wpisuje swoje pełne imię i nazwisko. Tillor zamienia wtedy wpisane imię i nazwisko na pismo odręczne. Jeśli są pola parafy, w ten sam sposób następuje **Parafa** (narysowana lub wpisane inicjały). Przyciskiem **Wyczyść** podpisujący zaczyna od nowa. Przełączenie między **Narysuj** i **Wpisz** czyści pole.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-type.png" alt="Krok Narysuj podpis z wybranym Wpisz" />
</Step>
<Step>
### Umieść podpis [#plaats-je-handtekening]
Podpisujący dotyka każdego zaznaczonego pola w dokumencie (**Kliknij, aby podpisać** lub **Kliknij, aby parafować**). **Następne pole** przeskakuje do następnego pustego pola. Za pomocą **Poprzednie pole** i **Następne pole** podpisujący przechodzi przez wszystkie pola. Drugie dotknięcie wypełnionego pola nic nie robi.
</Step>
<Step>
### Uzupełnij dane [#vul-je-gegevens-in]
Tylko jeśli umieściłeś pola do wypełnienia: tekst, datę lub zaznaczenie. Przy każdym polu widać **wymagane** lub **opcjonalne**. Puste wymagane pole zatrzymuje krok. To, co zostanie wpisane, od razu pojawia się w dokumencie. Imię i nazwisko oraz datę podpisu Tillor uzupełnia sam.
</Step>
<Step>
### Potwierdź i podpisz [#bevestig-en-onderteken]
Podpisujący zaznacza, że przeczytał dokument. Jeśli czegoś jeszcze brakuje, widać listę przycisków, które prowadzą do tego kroku.

Dopiero gdy wszystko jest gotowe, podpisujący prosi o wysłanie 6-cyfrowego kodu za pomocą **Wyślij kod weryfikacyjny**: SMS-em, jeśli jest numer telefonu, w przeciwnym razie e-mailem. Kod jest ważny 10 minut. Jeśli nie dotrze, po 2 minutach można użyć **Wyślij kod ponownie**. Potem podpisujący sam klika **Podpisz**. Nigdy nie podpisuje się samo.
</Step>
</Steps>

## Co widać potem? [#wat-zie-je-daarna]

- Jeśli jeszcze nie jest czyjaś kolej, widać **To jeszcze nie Twoja kolej**, a gdy nadejdzie, przyjdzie wiadomość.
- Kto już podpisał, widzi **Podpisałeś(-aś)**, dopóki pozostali nie skończą.
- Gdy wszyscy podpiszą, każdy podpisujący może przez ten sam link pobrać podpisany plik PDF (**Podpisane przez wszystkich**).
- Przy wycofanej prośbie podpisujący widzi **Prośba wycofana**, przy wygasłej **Termin podpisu minął**, a przy odrzuconej **Podpisywanie zatrzymane**.
- Pracownik podpisuje w Tillorze, przez przycisk **Podpisz teraz** na stronie szczegółów lub przez link w wiadomości. Kod nie jest potrzebny, bo ta osoba jest już zalogowana. Tu także podpis może być narysowany lub wpisany.

## Odmowa [#weigeren]

Za pomocą **Odmów podpisu** podpisujący może odrzucić prośbę i opcjonalnie podać powód (do 500 znaków). Prośba zostaje wtedy zatrzymana, nikt inny nie jest już proszony, a osoba, która utworzyła prośbę, dostaje wiadomość. Zobacz [Śledzenie prośby](/handtekeningen/opvolgen#wat-gebeurt-er-daarna).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie ma przycisku Podpisz na tablecie">
Przycisk pojawia się tylko wtedy, gdy aplikacja Tillor na urządzeniu Twojej organizacji miała w ostatnich minutach kontakt z Tillorem, i tylko przy kliencie, osobie kontaktowej lub stronie zewnętrznej, na którą jest kolej. Otwórz aplikację na tablecie, poczekaj chwilę i odśwież stronę. Sprawdź też, czy **Pokazuj paragony i dokumenty** jest włączone w [ustawieniach urządzenia](/mobiele-app/toestelinstellingen#kassabonnen-en-geluid). Zobacz też [Tablety i kioski](/mobiele-app/tablets-en-kiosken).
</Accordion>
<Accordion title="Tillor mówi: Nie udało się otworzyć na tablecie">
Tillor nie mógł dotrzeć do żadnego tabletu, który pokazuje dokumenty. Sprawdź, czy aplikacja jest otwarta i czy urządzenie ma połączenie, i spróbuj ponownie.
</Accordion>
<Accordion title="Podpisujący nie dostaje kodu">
Kod trafia na numer telefonu, a jeśli go nie ma, na adres e-mail. Poproś podpisującego o sprawdzenie folderu ze spamem i użycie po 2 minutach **Wyślij kod ponownie**. Jeśli numer lub adres się nie zgadza, popraw go przy kliencie lub osobie kontaktowej i wyślij przypomnienie. Przy stronie zewnętrznej anulujesz prośbę i tworzysz nową z poprawnymi danymi.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się zweryfikować kodu">
Wpisany kod się nie zgadza lub wygasł. Kod jest ważny 10 minut. Podpisujący prosi o nowy za pomocą **Wyślij kod ponownie** i go wpisuje. Każda błędna próba widnieje w historii jako **Wpisano błędny kod**.
</Accordion>
<Accordion title="Podpisujący nie może kliknąć Podpisz">
Czegoś jeszcze brakuje. W sekcji **Do zrobienia przed podpisaniem:** widać, co zostało: narysować podpis lub parafę, jeszcze dotknąć pola albo wypełnić wymagane pole. Zaznaczone musi być też pole, że dokument został przeczytany.
</Accordion>
<Accordion title="Link już nie działa">
Jeśli prośba została cofnięta do szkicu, anulowana lub wygasła, stary link już nie działa. Po ponownym wysłaniu podpisujący dostaje nowy link. Przy anulowanej lub wygasłej prośbie musisz utworzyć nową.
</Accordion>
<Accordion title="Podpisujący widzi: Ta prośba w międzyczasie się zmieniła">
Strona była już otwarta, gdy prośba się zmieniła, na przykład dlatego, że została już podpisana. Strona pokazuje teraz aktualny stan. Nic się nie stało.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Śledzenie prośby" href="/handtekeningen/opvolgen" />
  <Card title="Dowód i ważność" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Tablety i kioski" href="/mobiele-app/tablets-en-kiosken" />
</Cards>


# Śledzenie prośby (/pl-PL/handtekeningen/opvolgen)

Po wysłaniu śledzisz prośbę o podpis na stronie szczegółów: kto już podpisał, na kogo jest kolej i co jeszcze możesz zrobić. Tu też wysyłasz przypomnienie, anulujesz prośbę i pobierasz podpisany plik PDF.

Zanim zaczniesz:

- Przeglądać może każdy. Przypominanie, anulowanie, cofanie i wysyłanie na tablet wymaga uprawnienia **Zarządzanie prośbami o podpis**. Bez tego uprawnienia te przyciski są wyszarzone.
- Prośba musi być wysłana. <Status>Szkic</Status> edytujesz w edytorze, zobacz [Prośba o podpisy](/handtekeningen/handtekening-vragen).

## Otwieranie prośby [#het-verzoek-openen]

Otwórz <UIPath>Administracja > Podpisy</UIPath>. Lista pokazuje przy każdej prośbie **Tytuł**, **Klient**, **Status**, ile podpisów jest już **Podpisano**, kiedy została **Utworzono** i do kiedy można podpisać (**Podpisać do**). Szukaj po tytule lub nazwie klienta albo filtruj przez **Status**, na przykład tylko prośby, które są jeszcze w toku. Kliknij prośbę, aby ją otworzyć.

Te same prośby są też przy kliencie, na karcie **Dokumenty** w sekcji **Prośby o podpis**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-customer-documents.png" alt="Karta Dokumenty klienta z podpisanym plikiem PDF i prośbami o podpis" />

## Strona szczegółów [#de-detailpagina]

Po lewej widzisz dane prośby, podpisujących po kolei i **Historię**. Po prawej jest dokument z już złożonymi podpisami. Na górze widać, na kogo czeka prośba, na przykład *Czeka na podpis: Marc Janssens.*

Przy każdym podpisującym widać, czy musi jeszcze czekać (**Oczekuje**), dostał link (**Link wysłany**), **Podpisano** lub **Odmowa**, wraz z czasem. Strona odświeża się sama, gdy ktoś podpisze.

### Przed i po: od W toku do Zakończona [#voor-en-na-van-bezig-naar-afgerond]

Tak wygląda ten sam rodzaj prośby w trakcie podpisywania i po nim. Najpierw ma status <Status tone="info">W toku</Status>: najemca podpisał, a na poręczyciela jest kolej.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-in-progress.png" alt="Przed: prośba w toku, najemca podpisał i na poręczyciela jest kolej" />

Gdy ostatni podpisujący podpisze, prośba ma status <Status tone="success">Zakończona</Status>. Wszystkie podpisy są w dokumencie, historia jest uzupełniona, a na górze jest przycisk do pobrania podpisanego pliku PDF.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-completed.png" alt="Po: zakończona prośba z podpisami w dokumencie i historią" />

## Wysyłanie przypomnienia [#een-herinnering-sturen]

Przy podpisującym, na którego jest kolej, kliknij **Wyślij przypomnienie**. Ta osoba dostaje ten sam link ponownie, a Tillor pokazuje **Link został wysłany ponownie**. Link z pierwszej wiadomości też nadal działa. Przycisku nie ma przy pracownikach, którzy podpisują w Tillorze, ani przy podpisujących, którzy jeszcze muszą czekać.

Poza tym Tillor sam wysyła przypomnienia. Podpisujący, na którego jest kolej, dostaje przypomnienie po liczbie dni ustawionej w **Przypomnienie po** (domyślnie 3), licząc od pierwszej wiadomości lub poprzedniego przypomnienia. Dzieje się to maksymalnie 2 razy na podpisującego i podczas codziennej kontroli Tillora. Przypomnienie może więc dotrzeć nawet o dzień później niż liczba dni, którą ustawiłeś.

## Podpisywanie na tablecie [#laten-tekenen-op-de-tablet]

Jeśli podpisujący stoi przy recepcji, klikasz przy tej osobie **Podpisz na tablecie**. Jak to działa i dlaczego przycisku czasem brakuje, przeczytasz w części [Na tablecie przy recepcji](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Samodzielne podpisanie jako pracownik [#zelf-ondertekenen-als-medewerker]

Jeśli kolej jest na współpracownika lub na Ciebie, ta osoba dostaje wiadomość z linkiem do Tillora. Na stronie szczegółów jest wtedy przycisk **Podpisz teraz**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-staff-turn.png" alt="Prośba, w której kolej jest na pracownika, z przyciskiem Podpisz teraz" />

## Anulowanie prośby [#een-verzoek-annuleren]

Kliknij **Anuluj prośbę** i potwierdź. Linki do podpisu przestają wtedy działać, a już złożone podpisy nie są używane. Jeśli jednak chcesz kontynuować, kliknij **Zachowaj**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-cancel-dialog.png" alt="Potwierdzenie Anulować tę prośbę?" />

Anulować można tylko, dopóki prośba jest <Status tone="info">W toku</Status>. Zakończona, odrzucona lub wygasła prośba jest ostateczna.

## Wróć do edycji [#terug-naar-bewerken]

Jeśli nikt jeszcze nie podpisał albo podpisałeś tylko Ty, na stronie szczegółów jest **Wróć do edycji**. Prośba znów staje się szkicem, wysłane linki przestają działać, a wszyscy podpisują od nowa po wysłaniu. Jeśli podpisał już ktoś inny, przycisku nie ma. Anuluj wtedy prośbę i utwórz nową.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- **Ktoś podpisuje**: podpisujący dostaje status **Podpisano**, a następny dostaje link. Strona odświeża się sama.
- **Wszyscy podpisali**: na krótko widzisz *Wszyscy podpisali. Trwa przygotowanie podpisanego PDF.* Prośba zmienia status na <Status tone="success">Zakończona</Status>. Podpisany plik PDF jest jako **[tytuł] (podpisany)** w **Dokumentach** klienta, z tym samym typem dokumentu co oryginalny PDF. Jeśli ten nie miał typu, dostaje typ **Podpisana umowa**. Każdy podpisujący dostaje kopię.
- **Ktoś odmawia**: prośba zatrzymuje się ze statusem <Status tone="error">Odrzucona</Status>. Osoba, która utworzyła prośbę, dostaje powiadomienie, a pozostali podpisujący nie są już proszeni. Przy podpisującym widać powód, jeśli został podany.
- **Anulujesz**: prośba dostaje status <Status>Anulowana</Status>, a linki przestają działać.
- **Termin minął**: po dniu z **Podpisać do** nikt już nie może podpisać. Tillor ustawia prośbę podczas codziennej kontroli na <Status tone="warning">Wygasła</Status>. Do tej kontroli na stronie szczegółów widać, że termin minął. Jeśli chcesz, aby ktoś jeszcze podpisał, utwórz nową prośbę.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-declined.png" alt="Odrzucona prośba z powodem podanym przez klienta" />

## Podpisany plik PDF [#de-ondertekende-pdf]

Na stronie szczegółów pobierasz plik PDF przyciskiem **Pobierz podpisany PDF**, pod historią. Tam jest też **Znacznik czasu**, zobacz [Dowód i ważność](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

E-mailem plik PDF jest załącznikiem wiadomości do podpisującego. Jeśli to się nie uda, jest przycisk do pobrania. Kto ma tylko numer telefonu, dostaje SMS z linkiem.

Podpisany plik PDF i oryginalny plik PDF są dowodem podpisania. Dlatego nie możesz ich usunąć, ale możesz je zarchiwizować.

## Historia i zdarzenia [#verloop-en-gebeurtenissen]

W sekcji **Historia** widać każdy krok z czasem i osobą, która to zrobiła: utworzenie, wysłanie, wysłanie linku, otwarcie strony, wysłanie kodu, błędny kod, podpisanie, odmowa, cofnięcie, anulowanie, wygaśnięcie i zakończenie. Ta sama linia jest przy kliencie na karcie **Zdarzenia** oraz w [dzienniku aktywności](/activiteitenlog).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę przycisku Wyślij przypomnienie">
Przycisk jest tylko przy podpisującym ze statusem **Link wysłany**, czyli takim, na którego jest kolej. Przy pracowniku nigdy go nie ma, bo ten podpisuje w Tillorze. Jeśli jest, ale wyszarzony, brakuje Ci uprawnienia **Zarządzanie prośbami o podpis**.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się wysłać przypomnienia">
Spróbuj ponownie. Jeśli nadal się nie udaje, sprawdź adres e-mail i numer telefonu podpisującego. Przy kliencie lub osobie kontaktowej popraw je w ich danych. Przy stronie zewnętrznej anulujesz prośbę i tworzysz nową z poprawnymi danymi.
</Accordion>
<Accordion title="Brakuje przycisku Wróć do edycji">
Podpisał już ktoś inny niż Ty. Wtedy prośba nie może wrócić do szkicu. Anuluj prośbę przez **Anuluj prośbę** i utwórz nową.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się anulować prośby">
Anulować można tylko prośbę, która jest <Status tone="info">W toku</Status>. Odśwież stronę i sprawdź, jaki jest teraz status. Zakończonej, odrzuconej lub wygasłej prośby nie możesz już anulować.
</Accordion>
<Accordion title="Prośba nadal ma status W toku, ale termin minął">
Widzisz *Termin podpisu minął; prośba wygaśnie przy najbliższej codziennej kontroli.* Nikt nie może już podpisać. Gdy kontrola się odbędzie, prośba ma status <Status tone="warning">Wygasła</Status>.
</Accordion>
<Accordion title="Widzę Wszyscy podpisali, ale jeszcze nie ma podpisanego pliku PDF">
Tillor jeszcze przygotowuje plik PDF. Odśwież stronę po kilku minutach. Gdy będzie gotowy, jest w dokumentach klienta i pojawia się **Pobierz podpisany PDF**. Jeśli po kwadransie nadal nie jest gotowy, Tillor spróbuje ponownie przy następnej codziennej kontroli.
</Accordion>
<Accordion title="Nie mogę usunąć dokumentu ani podpisanego pliku PDF">
To zamierzone. Oryginalny plik PDF i podpisany plik PDF są dowodem. Możesz je zarchiwizować.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Tak podpisuje odbiorca" href="/handtekeningen/ondertekenen" />
  <Card title="Dowód i ważność" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Dokumenty" href="/documenten" />
</Cards>


# Skany dokumentów tożsamości (/pl-PL/identiteitsscans)

Za pomocą czytnika dokumentów tożsamości skanujesz paszporty, dowody osobiste, prawa jazdy, wizy i dokumenty pobytowe. Tillor rozpoznaje typ dokumentu, odczytuje dane i szybko tworzy z nich klienta, bez przepisywania wszystkiego. Czytnik wysyła skan przez [konektor Tillor](/connector) w Twojej sieci lokalnej do Twojej organizacji. Jak potem utworzyć klienta, opisujemy w części [Tworzenie klienta ze skanu](#klant-aanmaken-vanuit-een-scan).

<Callout type="info" title="Warto wiedzieć">
- Skan bez powiązanego klienta Tillor usuwa automatycznie po 7 dniach, razem z powiązanymi plikami.
- Powiązany skan jest przechowywany, dopóki go nie odłączysz lub nie usuniesz. Okres przechowywania określasz Ty.
- Utworzenie klienta na podstawie skanu wymaga co najmniej imienia w skanie.
- Jeśli istnieje już klient z tym samym numerem rejestru krajowego, powiąż skan z tym klientem zamiast tworzyć duplikat.
- Pliki skanów są przechowywane w postaci zaszyfrowanej. Na obrazach stron jest znak wodny **Not valid as ID**. Portret pozostaje bez znaku wodnego.
- Konektor domyślnie nasłuchuje na porcie 8765.
</Callout>

## Jak to się łączy [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  subgraph lokaal[Lokaal netwerk]
    R[Identiteitslezer]
    C[Tillor-connector]
  end
  T[Openstaande scan in Tillor]
  K[Klant of contactpersoon]
  R --> C
  C --> T
  T -->|Klant aanmaken of koppelen| K
  T -->|Niet gekoppeld na 7 dagen| X[Automatisch verwijderd]
```

Skan zaczyna jako oczekujący skan. Jeśli powiążesz go z klientem lub osobą kontaktową, pozostaje przechowywany przy tym kliencie.

## Tworzenie klienta ze skanu [#klant-aanmaken-vanuit-een-scan]

Zanim zaczniesz:

- Skan musi być w Tillorze jako oczekujący skan. Jeśli go nie ma, zobacz Problemy na dole.
- Skan potrzebuje imienia.

<Steps>
<Step>
### Otwórz listę klientów [#open-de-klantenlijst]
Przejdź do <UIPath>Klienci > Przegląd</UIPath> i kliknij **Utwórz nowego klienta**. Dopóki są oczekujące skany, przycisk pokazuje menu: wybierz **Ręczny** lub skan z listy.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Utwórz nowego klienta - menu z oczekującym skanem dokumentu tożsamości" />
</Step>
<Step>
### Sprawdź skan [#controleer-de-scan]
Po wybraniu skanu otwiera się potwierdzenie z podglądem dokumentu i danymi ze strefy odczytu maszynowego. Kliknij **Utwórz klienta**.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Potwierdzenie po wyborze oczekującego skanu z podglądem dokumentu" />
</Step>
</Steps>

Ta sama droga działa przez **Rozpocznij rezerwację** (**Nowy klient…**) oraz przez panel w prawym dolnym rogu z **Utwórz klienta na podstawie skanu**.

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Panel w prawym dolnym rogu - oczekujący skan dokumentu tożsamości z podglądem dokumentu" />

### Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tillor tworzy klienta, wiąże skan i w miarę możliwości uzupełnia imię, nazwisko, datę urodzenia, adres i inne pola.
- Przechodzisz do nowego profilu klienta.
- Skanu nie ma już w kolejce i pozostaje przechowywany przy kliencie.
- Powiązanie widać na karcie **Zdarzenia** klienta.

## Powiązanie z istniejącym klientem lub osobą kontaktową [#koppelen-aan-een-bestaande-klant-of-contactpersoon]

Oprócz nowego klienta możesz też powiązać skan z istniejącym klientem lub osobą kontaktową.

<Tabs items={["Z klientem", "Z osobą kontaktową"]}>
<Tab value="Z klientem">
W profilu klienta pojawia się karta z przerywaną ramką **Przypisz oczekujący skan tożsamości**, dopóki są odpowiednie oczekujące skany. Wybierz skan przez **Wybierz skan…** i kliknij **Przypisz do tego klienta**.
</Tab>
<Tab value="Z osobą kontaktową">
Na karcie osoby kontaktowej możesz powiązać skan, który nie ma jeszcze kontaktu i zawiera co najmniej imię, przez **Przypisz do kontaktu**. Możesz też utworzyć nowy kontakt przez **Utwórz kontakt ze skanu**.
</Tab>
</Tabs>

Po powiązaniu Tillor uzupełnia dane klienta lub kontaktu, o ile to możliwe. Jako imię Tillor przejmuje tylko pierwszy człon imienia, na przykład `Andy` z `Andy Adhemar R`. Na skanie wszystkie imiona pozostają widoczne.

## Odłączanie, eksportowanie lub usuwanie skanu [#een-scan-ontkoppelen-exporteren-of-verwijderen]

Przy powiązanym skanie są akcje **Pobierz**, **Eksportuj PDF**, **Odłącz skan** i **Usuń skan**. Usunięcie trwale usuwa skan i wszystkie zaszyfrowane pliki i nie można go cofnąć.

## Okres przechowywania i Twoja odpowiedzialność [#bewaartermijn-en-jouw-verantwoordelijkheid]

<Callout type="warn" title="7 dni dla oczekujących skanów">
Skany, które nie są jeszcze powiązane z klientem, Tillor usuwa automatycznie po 7 dniach (skan i powiązane pliki). Powiąż lub przetwórz oczekujące skany na czas przez **Utwórz nowego klienta**, panel w prawym dolnym rogu lub kartę z przerywaną ramką w profilu klienta.
</Callout>

Dla powiązanych skanów obowiązuje inna zasada: pozostają przechowywane, dopóki Twoja organizacja ich nie odłączy lub nie usunie. Ty decydujesz, czy, kiedy i na jakiej podstawie prawnej skanowane są dokumenty tożsamości i jak długo powiązane skany są potrzebne. Tillor przetwarza skany jako podmiot przetwarzający na Twoje polecenie. Przestrzeganie przepisów o ochronie prywatności, okresów przechowywania powiązanych skanów i terminowe usuwanie, gdy przechowywanie nie jest już potrzebne, to Twoja odpowiedzialność jako administratora danych.

## Problemy? [#problemen]

<Accordions>
<Accordion title="W Tillorze nie pojawia się żaden skan">
Sprawdź w czytniku adres IP konektora i port 8765 oraz czy konektor działa. Zobacz [Konektor](/connector).
</Accordion>
<Accordion title="Skanu nie ma w menu ani w panelu">
Za oczekujące uznawane są tylko skany bez powiązanego klienta. Jeśli skan jest już powiązany albo starszy niż 7 dni i został usunięty, już go tam nie ma.
</Accordion>
<Accordion title="Utwórz klienta na podstawie skanu jest wyszarzone">
Przy skanie widać powód. Jeśli skan nie ma imienia, widać *prosimy dodać je w czytniku lub powiązać skan ręcznie*. Jeśli dokument jest jeszcze ważny i istnieje już klient z tym numerem rejestru krajowego, otwórz proponowanego klienta u góry karty lub powiąż skan z tym klientem.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się utworzyć klienta z tego skanu">
Klient nie został utworzony, a skan pozostaje oczekujący. Spróbuj ponownie. Jeśli się nie uda, utwórz klienta ręcznie i powiąż skan przez **Przypisz do klienta**.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się powiązać skanu z klientem">
Spróbuj ponownie lub użyj panelu w prawym dolnym rogu.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Skan dokumentu tożsamości**: odczytane dane i obrazy jednego dokumentu tożsamości.
- **Oczekujący skan**: skan, który nie jest jeszcze powiązany z klientem i znika po 7 dniach.
- **Strefa odczytu maszynowego (MRZ)**: linie liter i cyfr na dole dokumentu, które odczytuje czytnik.
- **Konektor**: urządzenie w Twojej sieci lokalnej, które przekazuje skany do Tillora. Zobacz [konektor](/begrippen#connector).
- **Klient**: rekord w Tillorze. Zobacz [klient](/begrippen#klant).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Tworzenie klienta, także drogą ze skanem" />
  <Card title="Konektor" href="/connector" description="Urządzenie konektora w Twoim parku" />
  <Card title="Przykłady z praktyki" href="/praktijk" />
</Cards>


# Czytanie rozmów i odpowiadanie na nie (/pl-PL/inbox/gesprekken)

W skrzynce odbiorczej znajdziesz wszystkie rozmowy z połączonych kanałów w jednym miejscu. Tu je czytasz, odpowiadasz na nie i porządkujesz. Jak połączyć kanał, opisano w części [Skrzynka odbiorcza](/inbox).

Zanim zaczniesz:

- Do czytania rozmów potrzebujesz uprawnienia **Wyświetlanie skrzynki odbiorczej**, a do odpowiadania i archiwizowania uprawnienia **Zarządzanie skrzynką odbiorczą**. Bez uprawnienia **Wyświetlanie skrzynki odbiorczej** skrzynki nie ma na pasku bocznym.
- Musi być połączony co najmniej jeden kanał. W przeciwnym razie zobaczysz link do <UIPath>Ustawienia > Integracje</UIPath>.

<Requires permission="Wyświetlanie skrzynki odbiorczej" />

## Otwieranie skrzynki odbiorczej [#de-inbox-openen]

<Steps>
<Step>
### Przejdź do skrzynki odbiorczej [#ga-naar-de-inbox]
Na pasku bocznym w sekcji **Pomoc** wybierz pozycję **Skrzynka odbiorcza** (oznaczenie **1** na zrzucie ekranu). Jeśli nie ma jeszcze połączonego kanału, Tillor pokaże link do <UIPath>Ustawienia > Integracje</UIPath>.
</Step>
<Step>
### Wybierz rozmowę [#kies-een-gesprek]
Po lewej stronie znajduje się lista **Rozmowy** z wątkami ze wszystkich kanałów. Przyciskami **Otwarte** i **Zarchiwizowane** przełączasz się między aktywnymi i zakończonymi rozmowami. Kliknij rozmowę, aby otworzyć ją po prawej stronie.
</Step>
</Steps>

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-overview.png" alt="Skrzynka odbiorcza: lista rozmów z rozmowami demo i pustą kolumną szczegółów" />

Otwarta rozmowa pokazuje wiadomości po kolei, z nazwą nadawcy i godziną. Na dole znajduje się pole odpowiedzi (oznaczenie **2** w przykładzie).

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-whatsapp.png" alt="Skrzynka odbiorcza: rozmowa na WhatsAppie z polem odpowiedzi" />

Tło rozmowy zależy od kanału: beżowe dla WhatsAppa, niebieskie dymki dla Messengera, różowe dla Instagrama i jasnoszare dla czatu na stronie.

## Wysyłanie odpowiedzi [#een-antwoord-sturen]

<Requires permission="Zarządzanie skrzynką odbiorczą" />

<Steps>
<Step>
### Otwórz rozmowę [#open-het-gesprek]
Kliknij rozmowę na liście.
</Step>
<Step>
### Wpisz odpowiedź [#typ-je-antwoord]
Wpisz ją na dole w polu odpowiedzi.
</Step>
<Step>
### Wyślij [#verstuur]
Kliknij **Wyślij** lub naciśnij **Ctrl+Enter**.
</Step>
</Steps>

Przy własnych wiadomościach obok godziny widać jeden ptaszek dla wysłanej, dwa ptaszki dla dostarczonej i dwa niebieskie ptaszki dla przeczytanej. Odpowiedzi wysłane przez aplikację WhatsApp Business lub aplikację Messenger także pojawiają się w rozmowie, dopóki integracja jest aktywna.

Wysłanej wiadomości nie można edytować. Kanały nie dają takiej możliwości. W Messengerze i na Instagramie obok własnej wiadomości tekstowej jest przycisk usuwania. Ukrywa on wiadomość tylko w Tillorze, a klient nadal widzi ją w swojej aplikacji.

Przychodzące zdjęcia z Messengera są zapisywane i pokazywane w rozmowie, a na liście zamiast tekstu widać ikonę zdjęcia. Reakcje emoji na wiadomości z Messengera są pokazane jako liczniki pod wiadomością.

### WhatsApp i 24-godzinne okno odpowiedzi [#whatsapp-en-het-antwoordvenster-van-24-uur]

Klient, który napisze do Ciebie na WhatsAppie, otwiera bezpłatne 24-godzinne okno odpowiedzi. Tillor pokazuje **Otwarte okno bezpłatnej odpowiedzi** z odliczaniem. Gdy okno jest zamknięte, pojawia się **Okno całodobowe zamknięte**, a Twoja odpowiedź jest wysyłana jako płatny szablon WhatsAppa, dopóki klient nie napisze ponownie.

- Jeśli do Twojego konta WhatsApp Business nie dodano metody płatności w Meta WhatsApp Manager, Tillor blokuje płatne odpowiedzi. Bezpłatne odpowiedzi w ramach okna nadal możesz wysyłać.
- Jeśli Meta nie zatwierdziła jeszcze szablonu w języku Twojej organizacji, Twoja odpowiedź czeka. Zwykle trwa to kilka minut, ale może potrwać do 48 godzin.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Twoja odpowiedź pojawia się w rozmowie z ptaszkiem: wysłana, dostarczona lub przeczytana. Jeśli dostarczenie się nie powiedzie, widać **Nie dostarczono**.
- Zarchiwizowana rozmowa znika z listy **Otwarte**. Jeśli klient napisze ponownie, rozmowa pojawi się z powrotem.
- Rozmowa jest też widoczna przy kliencie, w <UIPath>Klienci > klient > Komunikacja</UIPath>.

## Wyszukiwanie i porządkowanie rozmów [#gesprekken-terugvinden-en-opruimen]

- **Szukanie**: filtruj wątki według nazwy lub numeru telefonu, w zakładce **Otwarte** lub **Zarchiwizowane**.
- **Nieprzeczytane**: w zakładce **Otwarte** nieprzeczytane rozmowy są wyróżnione pogrubieniem i czerwoną kropką. Kliknij **Oznacz wszystkie jako przeczytane** u góry listy, aby oznaczyć wszystko jako przeczytane za jednym razem.
- **Archiwizowanie**: kliknij **Archiwizuj** przy zakończonej rozmowie w zakładce **Otwarte**.
- **Przywracanie**: otwórz rozmowę w zakładce **Zarchiwizowane** i kliknij **Przywróć**, aby ją cofnąć i znów móc odpowiadać.
- **Menu kontekstowe**: kliknij rozmowę prawym przyciskiem myszy lub przytrzymaj ją, aby wybrać **Oznacz jako przeczytane**, **Oznacz jako nieprzeczytane**, **Przypnij rozmowę** lub **Odepnij rozmowę**, **Archiwizuj** i **Przywróć**.

Liczba przy pozycji **Skrzynka odbiorcza** na pasku bocznym zlicza otwarte rozmowy, w których ostatnia wiadomość pochodzi od klienta i czeka na odpowiedź. Nowe wiadomości pojawiają się na żywo, a liczba aktualizuje się sama.

## Tagi [#tags]

Tagami oznaczasz rozmowy dla całego zespołu.

1. Otwórz rozmowę i w panelu bocznym użyj bloku **Tagi**.
2. Utwórz tag przyciskiem **Nowy znacznik** lub wybierz istniejący. W menu tagów edytujesz lub usuwasz tagi.
3. Filtruj listę ikoną tagu obok filtra platformy.

Do tagów z opcją **AI może mieć zastosowanie** Tillie może sama dodawać po automatycznej odpowiedzi. Tagi, które Twój zespół już ustawił, pozostają.

## Powiadomienia [#meldingen]

Użytkownicy z uprawnieniem **Powiadomienia o wiadomościach w skrzynce** dostają powiadomienie push o każdej nowej wiadomości od klienta. Własne odpowiedzi nie wywołują powiadomienia.

Z uprawnieniem **Wyświetlanie skrzynki odbiorczej** przy nowej wiadomości widzisz też powiadomienie w prawym dolnym rogu, w tym samym doku co oczekujące skany tożsamości i aktywne rozmowy telefoniczne. Znajdziesz tam nadawcę, kanał i fragment tekstu. Kliknij je, aby otworzyć rozmowę. Powiadomienie znika po około dziesięciu sekundach, chyba że zatrzymasz nad nim wskaźnik myszy. Jeśli rozmowa jest już otwarta, powiadomienie się nie pojawia.

## Rozmowy i klienci [#gesprekken-en-klanten]

Tillor w miarę możliwości łączy rozmowę z klientem:

- WhatsApp według numeru telefonu.
- Messenger według zgodnej nazwy albo według numeru telefonu lub adresu e-mail, który klient sam poda w rozmowie.
- Instagram według zgodnej nazwy lub nazwy użytkownika z `@`.

Meta nie przekazuje przez Messengera ani Instagrama adresu e-mail ani numeru telefonu. Otwarte rozmowy klienta są też widoczne w <UIPath>Klienci > klient > Komunikacja</UIPath>.

Panel boczny po prawej pokazuje dla każdego kanału dane uczestnika, takie jak numer WhatsApp, nazwa użytkownika na Instagramie z linkiem do profilu albo strona w przypadku czatu na stronie. Ikoną panelu nad rozmową ukrywasz lub pokazujesz ten panel.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Skrzynki odbiorczej na pasku bocznym">
Potrzebujesz uprawnienia **Wyświetlanie skrzynki odbiorczej**. Poproś administratora o jego nadanie w <UIPath>Ustawienia > Użytkownicy</UIPath>, przez **Edytuj uprawnienia** przy Twoim nazwisku.
</Accordion>
<Accordion title="Nie mogę wysłać odpowiedzi">
Do odpowiadania potrzebujesz uprawnienia **Zarządzanie skrzynką odbiorczą**. W zarchiwizowanej rozmowie również nie możesz odpowiadać: najpierw kliknij **Przywróć**.
</Accordion>
<Accordion title="Tillor zgłasza Nie udało się wysłać wiadomości">
Sprawdź, czy rozmowa jest otwarta i czy masz uprawnienie **Zarządzanie skrzynką odbiorczą**. W przypadku WhatsAppa przyczyną może być też zamknięte okno odpowiedzi, patrz wyżej. Spróbuj potem ponownie.
</Accordion>
<Accordion title="Przy mojej wiadomości widnieje Nie dostarczono">
Kanał nie mógł dostarczyć wiadomości. W przypadku WhatsAppa zwykle wynika to z zamkniętego 24-godzinnego okna lub braku metody płatności w Meta.
</Accordion>
<Accordion title="Skrzynka odbiorcza jest pusta">
Nie ma jeszcze połączonego kanału albo nie przyszły jeszcze żadne wiadomości. Połącz kanał w <UIPath>Ustawienia > Integracje</UIPath>.
</Accordion>
<Accordion title="Klient edytował lub usunął wiadomość">
Tillor automatycznie dostosowuje rozmowę, gdy klient edytuje lub wycofuje wiadomość w Messengerze albo na Instagramie, albo edytuje ją na WhatsAppie (w ciągu 15 minut).
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Przegląd" href="/inbox" description="Kanały i uprawnienia" />
  <Card title="Rozmowy przez czat na stronie" href="/inbox/website-chat-gesprekken" description="Dodatki przy czacie na Twojej stronie" />
  <Card title="Asystent AI skrzynki odbiorczej" href="/inbox/inbox-ai-assistant" description="Tillie na wszystkich kanałach" />
</Cards>


# Asystent AI skrzynki odbiorczej (Tillie) (/pl-PL/inbox/inbox-ai-assistant)

**Tillie** to domyślne imię asystenta AI w [skrzynce odbiorczej Tillora](/inbox). Odpowiada na często zadawane pytania, zbiera dane do zapytań o rezerwację lub sprzedaż i przekazuje rozmowę Twojemu zespołowi, gdy potrzebna jest osoba z zespołu. Tillie działa na **wszystkich kanałach skrzynki odbiorczej**: [czat na stronie](/inbox/website-chat), [WhatsApp Business](/inbox/whatsapp-business-inbox), [Messenger](/inbox/messenger) i [Instagram Direct](/inbox/instagram).

<Callout type="info" title="Niezależnie od czatu na stronie">
Zainstaluj **Asystent AI skrzynki odbiorczej** osobno w **Ustawienia > Integracje**. Asystent należy do skrzynki odbiorczej, a nie tylko do widżetu na stronie.
</Callout>

## Instalacja integracji [#integratie-installeren]

1. Przejdź do **Ustawienia > Integracje** (pasek boczny w sekcji **Pomoc**)
2. Otwórz **Asystent AI skrzynki odbiorczej** na liście
3. Kliknij **Zainstalować**
4. W **Ustawienia** określ, co wolno Tillie (zobacz pola poniżej)

| Pole | Co robi? |
|------|----------------|
| **AI skrzynki odbiorczej włączona** | Główny przełącznik wszystkich funkcji AI skrzynki odbiorczej. Wyłącz, aby zatrzymać bez odinstalowywania |
| **Wysyłaj automatyczne odpowiedzi** | Gdy wyłączone, Tillie nie wysyła wiadomości do odwiedzających. Tłumaczenia, rozpoznawanie języka i szkice odpowiedzi dla zespołu mogą pozostać włączone osobno |
| **Automatycznie włączaj AI dla nowych rozmów** | Dotyczy tylko sytuacji, gdy automatyczne odpowiedzi są włączone. Gdy wyłączone, każda nowa rozmowa zaczyna się bez AI, a AI włączasz dla rozmowy na pasku bocznym. Gdy włączone, nowe rozmowy na wszystkich kanałach od razu dostają AI (z 30-minutową przerwą po wiadomości zespołu) |
| **Generuj szkice dla zespołu** | Pozwala współpracownikom wygenerować szkic AI w polu tworzenia wiadomości. Taki szkic nigdy nie jest wysyłany automatycznie |
| **Tłumacz wiadomości** | Tłumaczy przychodzące wiadomości na język organizacji, a odpowiedzi zespołu na język rozmówcy. Odpowiedzi zespołu dostają też poprawną interpunkcję, wielkie litery i rozwinięte skróty czatowe (także gdy tłumaczenie nie jest potrzebne) |
| **Wykrywaj język kontaktu** | Używa AI do rozpoznania języka odwiedzającego, jeśli nie jest jeszcze znany, i zapisuje go w rozmowie |
| **Imię asystenta AI** | Imię w odpowiedziach i promptach (domyślnie **Tillie**) |
| **Serwery MCP (JSON)** | Opcjonalne. Połączenia MCP tylko do odczytu (URL i nagłówki) |
| **Narzędzia MCP** | Po zapisaniu: **Załaduj narzędzia**, wyświetl narzędzia tylko do odczytu i włączaj lub wyłączaj każde z nich |

<Callout type="info" title="Tylko tłumaczenie, bez automatycznych odpowiedzi">
Włącz **AI skrzynki odbiorczej włączona**, **Tłumacz wiadomości** (i ewentualnie **Wykrywaj język kontaktu**) oraz wyłącz **Wysyłaj automatyczne odpowiedzi**. Tillie będzie wtedy tłumaczyć, ale niczego nie wyśle odwiedzającym.
</Callout>

### Narzędzia MCP (opcjonalnie) [#mcp-tools-optioneel]

Jeśli Twój park ma serwer MCP z połączeniami tylko do odczytu, Tillor może podczas rozmowy pobierać **dane parku na żywo**. Chodzi na przykład o aktywności, przyczepy na sprzedaż lub inne dane, które udostępnia Twój serwer.

Tillor **nie ma stałej listy nazw narzędzi**. To, jakie narzędzia istnieją, zobaczysz po **Załaduj narzędzia** w ustawieniach integracji. Możesz włączyć tylko narzędzia, które Twój serwer MCP oznacza jako tylko do odczytu.

1. Wypełnij **Serwery MCP (JSON)** (URL i nagłówki).
2. Zapisz i kliknij **Załaduj narzędzia**.
3. Włącz narzędzia pasujące do Twojego parku.

W zależności od konfiguracji AI w Twoim środowisku Tillie sama wybiera, które z włączonych narzędzi pasuje, na podstawie opisu narzędzia z Twojego serwera. Nigdy nie wywołuje narzędzi, których nie włączyłeś(-aś).

Wyniki z MCP trafiają do odpowiedzi Tillie. Nie zastępują bazy wiedzy: cen, dostępności i zasad nadal nie wymyśla, jeśli nie ma ich skąd wziąć.

<Callout type="info" title="Tillie nie odpowiada?">
Tillie korzysta z modelu AI, który Tillor ustawia dla Twojego środowiska. Jeśli asystent nie odpowiada, skontaktuj się z pomocą techniczną Tillora.
</Callout>

## Co Tillie robi po wiadomości odwiedzającego [#wat-tillie-doet-na-een-bezoekersbericht]

Po każdej nowej przychodzącej wiadomości w rozmowie, w której AI jest aktywne:

1. Tillor pokazuje na kanale **wskaźnik pisania**, gdy odpowiedź jest generowana
2. Tillor określa intencję: **rezerwacja**, **sprzedaż** lub **inne** (organizacje z obsługą wynajmowanych przyczep mają też **wynajmowaną przyczepę**)
3. Tillie odpowiada w języku odwiedzającego, a potem wskaźnik pisania znika

Tillie sama na podstawie swoich instrukcji decyduje, kiedy odpowiada, a kiedy milczy. Na powitanie ("cześć", "hej", "dzień dobry") odpowiada krótkim powitaniem i pytaniem, w czym może pomóc. Po zakończeniu rozmowy nie reaguje ponownie na krótkie "dziękuję", "ok" lub "nie" od odwiedzającego, żeby nie powstała pętla podziękowań.

| Intencja | Zachowanie |
|-----------|--------|
| **Rezerwacja** | Pyta o brakujące dane: przyjazd, wyjazd, rodzaj (namiot, domek mobilny, przyczepa turystyczna), psy tak/nie (i ile), liczba osób, dzieci i ich wiek, następnie imię i nazwisko, e-mail i numer telefonu, a opcjonalnie numer rejestracyjny do zameldowania (można pominąć). Dane, które Tillor już zna (np. z widżetu strony lub WhatsAppa), są uzupełniane, a pytania dotyczą tylko brakujących pól. Przy dniu tygodnia ("poniedziałek") Tillie najpierw zadaje pytanie potwierdzające ("Czy chodzi o …?"), zanim zajmie się dalej. Każda odpowiedź kończy się jednym pytaniem. Odpowiada na krótkie pytania o zasady z bazy wiedzy (np. późniejsza zmiana rezerwacji), a potem wraca do zbierania danych. Gdy wszystko jest kompletne, Tillie streszcza **zapytanie** i przekazuje rozmowę osobie z zespołu. To jeszcze nie jest ostateczna rezerwacja |
| **Wynajmowana przyczepa** | Zbiera imię i nazwisko, e-mail, adres, kraj i powód pobytu (na życzenie), a potem przekazuje rozmowę Twojemu zespołowi |
| **Sprzedaż** | Wyjaśnia, że odwiedzający musi przyjść do biura na oglądanie lub zakup, i przekazuje to Twojemu zespołowi |
| **Inne** | Odpowiada tylko wtedy, gdy odpowiedź jest w bazie wiedzy. W przeciwnym razie Tillie uczciwie mówi, że nie wie, proponuje przekazanie pytania osobie z zespołu i przekazuje rozmowę |

Tillie **nie wymyśla cen, dostępności ani zasad**. Jako fakt może podać tylko to, co jest w bazie wiedzy.

### Formularz rezerwacji na Twojej stronie [#boekingsformulier-op-je-website]

Czy podłączasz własny formularz do [czatu na stronie](/inbox/website-chat)? Wtedy możesz sprawić, że Tillie tylko potwierdzi i od razu przekaże rozmowę, bez pytań wstępnych. Pasuje to do formularza, po którym karta się zamyka. Zobacz [API czatu na stronie, metadane](/ontwikkelaars/website-chat#metadata-boekingsformulier).

## Dla każdej rozmowy: Automatyczny, Włączone lub Wyłączone [#per-gesprek-automatisch-aan-of-uit]

W szczegółach rozmowy na pasku bocznym wybierasz dla każdego wątku:

| Tryb | Zachowanie |
|-------|--------|
| **Automatyczny** | Tillie odpowiada, ale robi **30-minutową** przerwę po każdej wiadomości Twojego zespołu |
| **Wł.** | Tillie odpowiada zawsze, także zaraz po wiadomości zespołu |
| **Wył.** | Tillie nie odpowiada w tej rozmowie |

W czasie przerwy na pasku bocznym widzisz odliczanie.

## Tagi po odpowiedzi AI [#tags-na-een-ai-antwoord]

W panelu bocznym możesz tworzyć i przypisywać **tagi** dla całej organizacji (uprawnienie **Zarządzanie skrzynką odbiorczą**). Użyj **Nowy znacznik**, aby utworzyć tag. Otwórz menu tagów w rozmowie, aby przypisać tagi. Edycja i usuwanie każdego tagu są w tym samym menu. Zaznacz **AI może mieć zastosowanie**, jeśli Tillie może dodać ten tag po automatycznej odpowiedzi. Tillie wybiera wtedy sama zero lub więcej takich tagów na podstawie rozmowy. Tagi, które Twój zespół już ustawił, pozostają.

Typowe tagi to na przykład **Sprzedaż**, **Rezerwacja** i **Pilne**. Tillie rozpoznaje te nazwy i łączy je z tym, co już ustaliła w rozmowie:

| Intencja Tillie | Pasuje do nazw tagów takich jak |
|---|---|
| Sprzedaż | Sprzedaż, Sale |
| Rezerwacja | Rezerwacja, Booking |
| Wynajmowana przyczepa | Przyczepa, Wynajem |
| Pilne przekazanie | Pilne, Urgent, Nagłe |

Nazwa tagu nie musi dokładnie pasować: **Zapytanie o rezerwację** też liczy się jako tag rezerwacji. Brane są pod uwagę tylko tagi z opcją **AI może mieć zastosowanie**.

## Język, ton i dane kontaktowe [#taal-toon-en-contactgegevens]

Odpowiedzi podążają za językiem odwiedzającego, nie tylko za czterema językami widżetu (`en`, `nl`, `de`, `fr`), ale za każdym językiem, w którym Tillie potrafi odpowiadać (np. hiszpański, polski, turecki). Jeśli ktoś wyraźnie poprosi o inny język, Tillie przełącza się i zapisuje wybrany język w rozmowie.

**Podsumowania przekazań** (widoczne tylko dla Twojego zespołu) zawsze są w **języku organizacji** z Tillora, przy każdym przekazaniu (rezerwacja, wynajmowana przyczepa, sprzedaż, otwarte pytanie, wyraźna prośba o osobę z zespołu), niezależnie od języka rozmowy. Tillie dostaje ten język organizacji w każdym prompcie.

Wiadomości do odwiedzających (AI i zespołu) to zawsze **zwykły tekst**, bez markdownu, ponieważ WhatsApp, Instagram, Messenger i widżet go nie obsługują. Na WhatsAppie Tillie może pod krótką odpowiedzią dodać do trzech przycisków odpowiedzi, gdy dotknięcie to wybór, który wiadomość sama już wymienia. Wiadomość pozostaje czytelna, jeśli klient pisze zamiast dotykać. Poza 24-godzinnym oknem odpowiedź idzie jako szablon bez przycisków.

Tillie pozostaje spokojna i profesjonalna, nie rozmawia o konkurencji i nie lekceważy zasad bezpieczeństwa, gdy odwiedzający prosi o zignorowanie instrukcji. Dane kontaktowe do przekierowań pochodzą z Twojego **profilu organizacji w Tillorze** (nazwa, adres, telefon, e-mail, strona internetowa). **Godziny otwarcia biura** ustawiasz w **Ustawienia > Godziny otwarcia** (godziny tygodniowe, okresy sezonowe, święta i wyjątki). Tillie używa tych godzin, by powiedzieć, kiedy osoba z zespołu może odpowiedzieć. Dbaj o aktualność tych pól. Mniej więcej tydzień przed świętem ustawowym Tillor przypomina e-mailem na adres pomocy technicznej, jeśli godziny na ten dzień nie są jeszcze uzupełnione.

## Zdarzenia w rozmowie (tylko dla Twojego zespołu) [#gebeurtenissen-in-het-gesprek-alleen-voor-je-team]

Podczas zbierania danych do rezerwacji Tillie aktualizuje imię i nazwisko, e-mail i telefon, gdy tylko odwiedzający je poda. W skrzynce odbiorczej pojawia się wtedy zdarzenie **Tillie zaktualizował dane uczestnika** (z → na), widoczne tylko dla Twojego zespołu.

Przy przekazaniu pojawia się zdarzenie **Przekazanie AI**: wyróżniająca się karta z podsumowaniem (tabela z danymi rezerwacji lub wynajmowanej przyczepy oraz notatki dla otwartych pytań). Podsumowanie jest zawsze w **języku Twojej organizacji** (nl, en, de lub fr), także gdy odwiedzający pisze w innym języku. Odwiedzający nie widzi tej karty.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Skrzynka odbiorcza: czat na stronie z przekazaniem AI i szczegółami rozmowy" />

## Baza wiedzy: fakty, z których Tillie może korzystać [#kennisbank-feiten-die-tillie-mag-gebruiken]

Tillie odpowiada na pytania na podstawie **bazy wiedzy**: krótkich artykułów ze sprawdzonymi faktami o Twoim parku, na przykład godzinami otwarcia, zasadami dotyczącymi zwierząt, basenem, stacjami ładowania lub tym, jak później zmienić rezerwację.

Niektóre artykuły dotyczą wszystkich organizacji w Tillorze, inne są specyficzne dla Twojego parku. W rozmowie Tillie korzysta tylko z artykułów ogólnych oraz z tych, które dodano dla Twojej organizacji.

Chcesz, aby dodano, zmieniono lub usunięto jakieś tematy? Przekaż to pomocy technicznej Tillora. Uzupełniamy i utrzymujemy bazę wiedzy razem z Tobą, dopasowaną do tego, na co ma umieć odpowiadać Twoja recepcja.

## Przepływy rozmów: scenariusz dla każdej intencji [#gespreksflows-draaiboek-per-bedoeling]

Oprócz bazy wiedzy Tillie stosuje **przepływy rozmów**: ustalenia, o jakie dane pyta, w jakiej kolejności i kiedy przekazuje rozmowę Twojemu zespołowi. Każda intencja (rezerwacja, wynajmowana przyczepa, sprzedaż, inne, zobacz tabelę wyżej) ma taki przepływ.

Przepływy są domyślnie ustawione, ale Tillor dostraja je razem z Tobą do Twojego parku. Chcesz na przykład, aby przy zapytaniu o rezerwację pytała o inne dane albo szybciej przekazywała rozmowę? Przekaż to pomocy technicznej Tillora.

<Callout type="warn" title="Pierwsza wersja">
Sprawdzaj odpowiedzi AI w skrzynce odbiorczej, zanim zaufasz im wobec odwiedzających. Rezerwacja przez czat pozostaje **zapytaniem**, a nie ostateczną rezerwacją.
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Rozmowa przekazana przez Tillie znajduje się w skrzynce odbiorczej z blokiem **Tillie przekazał tę rozmowę Twojemu zespołowi** i zebranymi danymi.
- Twój zespół dostaje powiadomienie. Przy pilnym przekazaniu idzie ono jako powiadomienie **Pilne przekazanie AI**. Zobacz [Typy powiadomień](/communicatie/notificatietypes).
- Gdy odpowie osoba z zespołu, Tillie robi 30-minutową przerwę w trybie **Automatyczny**.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillie nie odpowiada">
Sprawdź, czy w <UIPath>Ustawienia > Integracje > Asystent AI skrzynki odbiorczej</UIPath> są włączone **AI skrzynki odbiorczej włączona** i **Wysyłaj automatyczne odpowiedzi**. Potem zajrzyj na pasek boczny rozmowy, czy tryb nie jest ustawiony na **Wył.** albo czy po wiadomości Twojego zespołu nie trwa odliczanie.
</Accordion>
<Accordion title="Nowe rozmowy zaczynają się bez Tillie">
Opcja **Automatycznie włączaj AI dla nowych rozmów** jest wyłączona. Włącz przełącznik albo wybierz dla rozmowy **Wł.**.
</Accordion>
<Accordion title="Tillie mówi, że czegoś nie wie">
Tillie korzysta tylko z tego, co jest w bazie wiedzy, i nie wymyśla cen, dostępności ani zasad. Uzupełnij bazę wiedzy.
</Accordion>
</Accordions>

## Powiązane [#gerelateerd]

<Cards>
  <Card title="Skrzynka odbiorcza" href="/inbox" description="Czytanie rozmów i odpowiadanie na nie" />
  <Card title="Czat na stronie" href="/inbox/website-chat" description="Czat na żywo na Twojej stronie" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="WhatsApp w skrzynce odbiorczej" />
  <Card title="Messenger" href="/inbox/messenger" description="Połącz Facebook Messenger" />
  <Card title="Instagram" href="/inbox/instagram" description="Połącz Instagram Direct" />
</Cards>


# Przegląd (/pl-PL/inbox)

W skrzynce odbiorczej czytasz wiadomości klientów i odwiedzających, które trafiają przez WhatsApp, Messengera, Instagram lub czat na Twojej stronie, i odpowiadasz na nie, wszystko w jednym miejscu. Znajdziesz ją na pasku bocznym w **Pomoc > Skrzynka odbiorcza**. Najpierw łączysz kanały, z których chcesz korzystać, a potem na co dzień pracujesz w [Czytanie rozmów i odpowiadanie na nie](/inbox/gesprekken).

<Callout type="info" title="Nie do automatycznych powiadomień">
Skrzynka odbiorcza służy do dwukierunkowej komunikacji z klientami. Automatyczne powiadomienia na WhatsAppie, na przykład przy niskim saldzie NFC, idą przez Twilio, a nie przez te integracje.
</Callout>

<Callout type="info" title="Warto wiedzieć">
- Nowa wiadomość pojawia się jako karta w prawym dolnym rogu i znika po około dziesięciu sekundach. Liczba przy pozycji **Skrzynka odbiorcza** zlicza otwarte rozmowy, które czekają na odpowiedź
- Asystent AI Tillie robi 30-minutową przerwę po tym, jak odpowie koleżanka lub kolega z zespołu
- Wiadomość z czatu na stronie może mieć maksymalnie 4096 znaków, bez obrazów i plików
- Klient może edytować wiadomość z WhatsAppa do 15 minut po wysłaniu, co widać w rozmowie
- Przypomnienie e-mailem dla odwiedzającego stronę jest wysyłane po około 5 minutach nieaktywności. Link działa 30 dni
- Własna wiadomość usunięta w Tillorze (Messenger i Instagram) znika tylko w Tillorze, a nie u klienta
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Każdy kanał instalujesz osobno. Potem wszystkie rozmowy trafiają na tę samą listę, a Tillor w miarę możliwości łączy je z klientem.

```mermaid
flowchart LR
  W[WhatsApp] --> I[Skrzynka odbiorcza]
  M[Messenger] --> I
  G[Instagram] --> I
  C[Czat na Twojej stronie] --> I
  I --> K[Połączony klient przez numer telefonu lub nazwę]
  I --> A[Tillie odpowiada lub przekazuje]
  A --> T[Twój zespół]
  I --> T
  T -->|odpowiedź| W
  T -->|odpowiedź| M
  T -->|odpowiedź| G
  T -->|odpowiedź| C
```

- Twój zespół odpowiada w Tillorze. Odpowiedź wraca do klienta tym samym kanałem.
- Tillie, asystent AI, może odpowiadać i przekazać rozmowę Twojemu zespołowi. Decydujesz o tym dla każdej rozmowy osobno.
- Odpowiedzi wysłane poza Tillorem, na przykład w aplikacji WhatsApp Business, także pojawiają się w rozmowie.

## Łączenie kanałów [#kanalen-koppelen]

Dla każdego kanału zainstaluj integrację w <UIPath>Ustawienia > Integracje</UIPath>.

<Cards>
  <Card title="Czat na stronie" href="/inbox/website-chat" description="Przycisk czatu na Twojej stronie, bez zewnętrznego konta" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="Połącz numer WhatsApp przez Meta" />
  <Card title="Messenger" href="/inbox/messenger" description="Połącz stronę na Facebooku przez Meta" />
  <Card title="Instagram" href="/inbox/instagram" description="Połącz Instagram Direct przez Meta" />
  <Card title="Asystent AI skrzynki odbiorczej" href="/inbox/inbox-ai-assistant" description="Tillie odpowiada i przekazuje rozmowy na wszystkich kanałach" />
</Cards>

W przypadku Messengera Tillor podczas łączenia pobiera istniejące rozmowy ze strony. Jeśli Messenger jest już połączony, możesz też ręcznie uruchomić tę synchronizację ze skrzynki odbiorczej.

## Praca na co dzień [#dagelijks-werken]

<Cards>
  <Card title="Czytanie rozmów i odpowiadanie na nie" href="/inbox/gesprekken" description="Odpowiedzi, archiwizowanie, tagi i powiadomienia" />
  <Card title="Rozmowy przez czat na stronie" href="/inbox/website-chat-gesprekken" description="Co widzisz przy odwiedzającym stronę" />
</Cards>

## Uprawnienia [#rechten]

| Uprawnienie | Co może użytkownik? |
|-----------|------------------------|
| **Wyświetlanie skrzynki odbiorczej** | Otwierać skrzynkę odbiorczą i czytać rozmowy |
| **Zarządzanie skrzynką odbiorczą** | Wysyłać odpowiedzi, archiwizować, przywracać i przypinać rozmowy, oznaczać je jako nieprzeczytane oraz usuwać własne wiadomości w Tillorze (Messenger i Instagram) |
| **Powiadomienia o wiadomościach w skrzynce** | Otrzymywać powiadomienia push o nowych wiadomościach od klientów |

Uprawnienia ustawiasz w <UIPath>Ustawienia > Użytkownicy</UIPath>.

## Pojęcia [#begrippen]

- **Rozmowa lub wątek**: wszystkie wiadomości z jednym klientem lub odwiedzającym na jednym kanale.
- **Otwarte i Zarchiwizowane**: dwie zakładki listy rozmów. Archiwizowanie usuwa rozmowę z zakładki **Otwarte**, a przywrócenie ją cofa.
- **Tillie**: domyślne imię asystenta AI w skrzynce odbiorczej. Możesz je zmienić.


Więcej terminów znajdziesz w [słowniku pojęć](/begrippen).


# Instagram (/pl-PL/inbox/instagram)

Dzięki **Instagramowi** odbierasz wiadomości z Instagram Direct w [skrzynce odbiorczej Tillora](/inbox). Integracja korzysta z połączonej **strony na Facebooku** z **kontem Instagram Professional** w Meta Business Suite.

Zanim zaczniesz:

- Potrzebujesz uprawnienia **Zarządzanie integracjami**.
- Twoje konto na Instagramie jest kontem Professional (Business lub Creator), połączonym ze stroną na Facebooku.

## Instalacja integracji [#integratie-installeren]

1. Przejdź do **Ustawienia** (pasek boczny w sekcji **Pomoc**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-nav.png" alt="Przejście do Ustawień" />

2. Wybierz **Integracje** i otwórz **Instagram** na liście (oznaczenie **2**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-instagram.png" alt="Ustawienia > Integracje: Instagram na liście" />

3. Kliknij **Zainstalować** (oznaczenie **1**) i dokończ proces Meta OAuth (uprawnienia do wiadomości na Instagramie)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/instagram-install.png" alt="Szczegóły Instagrama: Zainstalować" />

4. Wybierz **stronę na Facebooku** połączoną z Twoim kontem Instagram Professional
5. Sprawdź pole **Nazwa użytkownika na Instagramie** pod wyborem strony (Tillor pokazuje połączone konto, na przykład `@uwaccount`)
6. Zapisz ustawienia

Bez połączonego konta Instagram Professional na wybranej stronie Tillor nie może dokończyć integracji.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Po instalacji przychodzące wiadomości z Instagram Direct same trafiają do [skrzynki odbiorczej](/inbox).
- Odpowiedzi wysłane przez aplikację Instagram także pojawiają się w skrzynce odbiorczej. Wiadomości wysłane przez Tillor nie są pokazywane podwójnie.
- Jeśli mimo to nie przychodzą żadne wiadomości, skontaktuj się z pomocą techniczną Tillora. Połączenie Instagrama z Meta musi być skonfigurowane dla całej platformy.
- Messenger i Instagram to osobne integracje. Jeśli chcesz mieć oba kanały w skrzynce odbiorczej, zainstaluj obie.

## Problemy? [#problemen]

### Łączenie nie działa lub na stronie nie ma Instagrama [#koppelen-mislukt-of-geen-instagram-op-de-pagina]

Jeśli instalacja zatrzymuje się z komunikatem *Nie udało się połączyć aplikacji* lub *Brak konta Instagram Professional*, sprawdź w Meta:

1. **Instagram Professional**: Twoje konto na Instagramie musi być kontem Business lub Creator (nie osobistym).
2. **Połączenie ze stroną**: w [Meta Business Suite](https://business.facebook.com/) lub w Business Settings połącz konto na Instagramie ze **stroną na Facebooku**, którą wykorzystujesz do logowania.
3. **Dostęp do wiadomości**: w aplikacji Instagram: **Ustawienia** > **Wiadomości i odpowiedzi na relacje** > **Połączone narzędzia** > zezwól na dostęp do wiadomości (wymagane dla Direct w aplikacjach skrzynek odbiorczych).
4. **Właściwe logowanie do Meta**: użyj konta, które jest **administratorem** strony na Facebooku z uprawnieniami do wiadomości.


Podczas instalacji Tillor wyszukuje wszystkie strony na Facebooku na Twoim koncie i wybiera pierwszą stronę z połączonym kontem Instagram Professional. Jeśli masz kilka stron, po instalacji możesz wybrać inną w ustawieniach integracji.

<Callout type="info" title="Dla czytelnika technicznego">
Podczas instalacji Tillor zawsze prosi o uprawnienia `instagram_basic`, `instagram_manage_messages` i `pages_read_engagement`. Ustaw je najpierw na **Ready for testing** w **Use cases** (Messenger/Instagram) w Meta Developer Console. **Invalid Scopes** oznacza, że nie ma ich jeszcze w aplikacji Meta. Uprawnienia `instagram_business_*` należą do innej metody logowania i nie są przeznaczone dla Tillora.
</Callout>

## Powiązane [#gerelateerd]

<Cards>
  <Card title="Skrzynka odbiorcza" href="/inbox" description="Czytanie rozmów i odpowiadanie na nie" />
  <Card
    title="Messenger"
    href="/inbox/messenger"
    description="Połącz Facebook Messenger ze skrzynką odbiorczą"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Połącz numer WhatsApp ze skrzynką odbiorczą"
  />
</Cards>


# Messenger (/pl-PL/inbox/messenger)

Dzięki **Messengerowi** odbierasz wiadomości od klientów przez połączoną stronę na Facebooku w [skrzynce odbiorczej Tillora](/inbox).

Zanim zaczniesz:

- Potrzebujesz uprawnienia **Zarządzanie integracjami**.
- Logujesz się do Meta kontem, które jest administratorem strony na Facebooku.

## Instalacja integracji [#integratie-installeren]

1. Przejdź do **Ustawienia** (pasek boczny w sekcji **Pomoc**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-nav.png" alt="Przejście do Ustawień" />

2. Wybierz **Integracje** i otwórz **Messenger** na liście (oznaczenie **2**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-messenger.png" alt="Ustawienia > Integracje: Messenger na liście" />

3. Kliknij **Zainstalować** (oznaczenie **1**) i dokończ proces Meta OAuth

<DocScreenshot src="/screenshots/communicatie/providers/messenger/messenger-install.png" alt="Szczegóły Messengera: Zainstalować" />

4. Na stronie szczegółów wybierz, która **strona na Facebooku** odbiera wiadomości z Messengera
5. Zapisz ustawienia

Tillor pokazuje połączoną stronę w **Ustawienia** na stronie szczegółów. Po instalacji Tillor automatycznie odbiera przychodzące wiadomości z Messengera. Odpowiedzi wysłane także przez aplikację Messenger pojawiają się w skrzynce odbiorczej. Wiadomości wysłane przez Tillor nie są pokazywane podwójnie.

Dla **Instagram Direct** zainstaluj osobną integrację [Instagram](/inbox/instagram).

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tillor pobiera istniejące rozmowy ze strony. Tę synchronizację możesz później uruchomić też samodzielnie ze skrzynki odbiorczej.
- Nowe wiadomości same trafiają do [skrzynki odbiorczej](/inbox). Tillor łączy je z klientem o tej samej nazwie albo według numeru telefonu lub adresu e-mail, który klient poda w rozmowie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie przychodzą żadne wiadomości">
Sprawdź w <UIPath>Ustawienia > Integracje > Messenger</UIPath>, czy wybrano właściwą **stronę na Facebooku** i czy ustawienia zostały zapisane.
</Accordion>
<Accordion title="Rozmowa nie jest połączona z klientem">
Meta nie przekazuje przez Messengera adresu e-mail ani numeru telefonu. Tillor łączy tylko według zgodnej nazwy albo danych, które klient sam poda.
</Accordion>
</Accordions>

## Powiązane [#gerelateerd]

<Cards>
  <Card title="Skrzynka odbiorcza" href="/inbox" description="Czytanie rozmów i odpowiadanie na nie" />
  <Card
    title="Instagram"
    href="/inbox/instagram"
    description="Połącz Instagram Direct ze skrzynką odbiorczą"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Połącz numer WhatsApp ze skrzynką odbiorczą"
  />
</Cards>


# Rozmowy przez czat na stronie (/pl-PL/inbox/website-chat-gesprekken)

Rozmowa pojawia się w skrzynce odbiorczej, gdy tylko odwiedzający wyśle pierwszą wiadomość, z kanałem **Czat internetowy**. Jak odpowiadać, opisano w [Czytanie rozmów i odpowiadanie na nie](/inbox/gesprekken). Ta strona wyjaśnia, co dodatkowo widać przy czacie na stronie.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Skrzynka odbiorcza: czat na stronie ze szczegółami rozmowy" />

W panelu bocznym po prawej jest przycisk **Otwórz na stronie internetowej** ze stroną, na której odwiedzający był ostatnio aktywny, oraz dane odwiedzającego i sesji. Dodatkowe pola z formularza odwiedzającego też tam są.

## Kim jest odwiedzający? [#wie-is-de-bezoeker]

- Tillor rozpoznaje odwiedzającego po jego przeglądarce. Ta sama przeglądarka na tym samym urządzeniu otwiera więc tę samą rozmowę.
- Imię i nazwisko, e-mail i telefon z formularza odwiedzającego są po pierwszej wiadomości zapamiętywane w tej przeglądarce. Gdy odwiedzający wróci później, nie musi niczego wypełniać ponownie.
- Jeśli to miejsce jest puste, na przykład w innej przeglądarce lub po wyczyszczeniu danych, widżet uzupełnia dane z istniejącej rozmowy.
- Wiadomości to tekst do 4096 znaków. Obrazy i pliki nie są obsługiwane.

## Pisanie i obecność [#typen-en-aanwezigheid]

| Co | Kto to widzi | Gdzie |
|-----|--------------|------|
| **Pisanie na maszynie…**, gdy odwiedzający pisze | Twój zespół | Pod rozmową w skrzynce odbiorczej, także przed pierwszą wiadomością |
| **Pisanie na maszynie…**, gdy pisze osoba z zespołu | Odwiedzający | W widżecie |
| **Online** (zielona kropka) lub **Ostatnio widziany** z godziną | Twój zespół | Nad rozmową |

Odwiedzający liczy się jako online, dopóki karta jest widoczna. Widżet co około 20 sekund wysyła sygnał życia. Pobieranie wiadomości, pisanie i czytanie też liczą się jako aktywność.

## Ptaszki [#vinkjes]

Odwiedzający widzą ptaszki przy własnych wiadomościach:

| Ptaszki | Znaczenie |
|---------|-----------|
| Jeden | Wysłano |
| Dwa szare | Twój zespół otworzył rozmowę i załadował wiadomości |
| Dwa niebieskie | Twój zespół oznaczył rozmowę jako przeczytaną |

W skrzynce odbiorczej widzisz ptaszki przy własnych odpowiedziach:

| Ptaszki | Znaczenie |
|---------|-----------|
| Jeden | Wysłano |
| Dwa szare | Odwiedzający jest na stronie i pobrał wiadomości, także przy zamkniętym czacie |
| Dwa niebieskie | Odwiedzający ma otwarte okno czatu |

Odpowiedzi ze skrzynki odbiorczej pojawiają się w widżecie automatycznie, także gdy odwiedzający otworzy okno później.

## Aktywność odwiedzającego w rozmowie [#bezoekersactiviteit-in-het-gesprek]

Po pierwszej wiadomości Twój zespół widzi w rozmowie szare teksty informacyjne. Odwiedzający ich nie widzi. Te wiersze nie zwiększają licznika nieprzeczytanych i nie wywołują powiadomienia push.

| Zdarzenie | Tekst w skrzynce odbiorczej |
|-------------|-------------------|
| Czat zamknięty | Użytkownik zamknął czat |
| Inna karta lub okno zminimalizowane | Użytkownik zmienił kartę lub zminimalizował przeglądarkę |
| Otwarto inną stronę | Użytkownik przeszedł do adresu URL strony |

Nawigacja jest też widoczna na stronach, które zmieniają podstrony wewnętrznie bez przeładowania. Widżet co około 20 sekund przekazuje bieżącą stronę, dzięki czemu panel boczny pokazuje ostatnią aktywną stronę.

## Tillie na czacie strony [#tillie-op-website-chat]

Tillie, asystent AI, działa też w widżecie. Zainstaluj w tym celu osobno **Asystent AI skrzynki odbiorczej**. Instalacja, baza wiedzy i zachowanie są opisane w [Asystent AI skrzynki odbiorczej (Tillie)](/inbox/inbox-ai-assistant). Wiadomości od Tillie dostają w widżecie ikonę robota zamiast logo organizacji.

<Callout type="info" title="Pierwsza wiadomość">
Gdy tylko odwiedzający zacznie pisać, Twój zespół może zobaczyć **Pisanie na maszynie…**. Pierwsza wiadomość wychodzi dopiero po **Wyślij**, razem z uzupełnionymi danymi kontaktowymi.
</Callout>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Czytanie rozmów i odpowiadanie na nie" href="/inbox/gesprekken" description="Odpowiedzi, archiwizowanie, tagi" />
  <Card title="Ustawienia czatu na stronie" href="/inbox/website-chat-instellingen" description="Widżet i formularz odwiedzającego" />
  <Card title="API czatu na stronie" href="/ontwikkelaars/website-chat" description="Zbuduj własny interfejs czatu" />
</Cards>


# Ustawienia czatu na stronie (/pl-PL/inbox/website-chat-instellingen)

Ustawienia znajdziesz w <UIPath>Ustawienia > Integracje > Czat na stronie</UIPath>. Instalację i umieszczanie fragmentu kodu opisano w [Umieszczanie czatu na Twojej stronie](/inbox/website-chat).

## Widżet [#widget]

| Pole | Co robi? |
|-------|---------------|
| **Widżet włączony** | Ukrywa czat wszędzie bez usuwania integracji. Domyślnie włączone |
| **Pokaż na publicznych stronach Tillera** | Pokazuje przycisk czatu na publicznych stronach Tillora, takich jak karta wstępu, otwarta faktura i publiczna mapa. Twoja własna strona używa fragmentu kodu. Domyślnie włączone |
| **Wiadomość powitalna** | Tekst w nagłówku czatu i przed pierwszą wiadomością odwiedzającego. Maksymalnie 500 znaków. Puste pole daje domyślny tekst w języku widżetu |
| **Etykietka programu uruchamiającego** | Etykieta pływającego przycisku, przeznaczona dla czytników ekranu. Maksymalnie 80 znaków |
| **Odpowiedz wkrótce na wiadomość** | Wiersz pod nazwą organizacji w nagłówku czatu, na przykład "Zwykle odpowiadamy szybko" |
| **Ikona programu uruchamiającego** | Ikona na przycisku czatu: **Dymka**, **Zaokrąglony czat**, **Znak zapytania**, **Szukaj** lub **Osoba** |
| **Kolor akcentujący** | Kolor przycisku czatu i wiadomości odwiedzającego. Wybierz kolor lub wpisz wartość hex, na przykład `#2563eb` |
| **Dozwolone domeny** | Nazwy hostów oddzielone przecinkami, które mogą ładować czat. Puste oznacza: każda domena |
| **Wyślij odwiedzającym e-mail z informacją o nieprzeczytanych odpowiedziach** | Zobacz [poniżej](#herinnering-per-e-mail). Domyślnie włączone |

Nagłówek czatu automatycznie pokazuje logo Twojej organizacji. Wiadomości od asystenta AI dostają ikonę robota zamiast tego logo. Żadnego z nich nie można ustawić w czacie na stronie.

<Callout type="info" title="Jaki język dostaje odwiedzający?">
Jeśli nie ustawisz **Wiadomość powitalna**, **Etykietka programu uruchamiającego** ani **Odpowiedz wkrótce na wiadomość**, widżet używa domyślnego tekstu w swoim własnym języku. Ten język ustawiasz we fragmencie kodu przez `data-locale` (zobacz [Opcje we fragmencie kodu](#opties-op-het-snippet)).
</Callout>

## Formularz odwiedzającego [#bezoekersformulier]

Tu decydujesz, co odwiedzający wypełnia przed pierwszą wiadomością. Jeśli są pola wymagane, są razem z polem wiadomości na jednym ekranie. Odwiedzający wypełnia wszystko i klika **Wyślij**, bez osobnego kroku pośredniego.

### Pola standardowe [#standaardvelden]

| Pole | Co robi? |
|-------|---------------|
| **Wymagane imię i nazwisko** | Odwiedzający wpisują swoje imię i nazwisko. Jest ono zapisywane przy rozmowie |
| **Wymagany e-mail** | Odwiedzający wpisują swój adres e-mail. Adres jest zapisywany przy rozmowie |
| **Wymagany telefon** | Odwiedzający wpisują numer telefonu. Tillor zamienia go na stały format i używa go do połączenia rozmowy z połączeniami i klientami |

Każde pole włączasz lub wyłączasz osobno. Jeśli włączony jest tylko telefon, odwiedzający widzi tylko pole telefonu.

### Dodatkowe pola [#extra-velden]

Kliknij **Dodaj pole** dla własnych pytań. Możesz dodać maksymalnie 8 dodatkowych pól. Pole usuniesz przyciskiem **Usuń pole**.

| Opcja | Wyjaśnienie |
|-------|-------|
| **Etykieta pola** | To, co odwiedzający widzi w widżecie. Maksymalnie 80 znaków |
| **Klucz pola** | Wewnętrzna nazwa pola. Zacznij od małej litery i używaj tylko małych liter, cyfr i `_` (maksymalnie 32 znaki) |
| **Typ pola** | **Tekst** lub **E-mail** |
| **Wymagane** | Odwiedzający musi wypełnić pole, zanim będzie mógł rozmawiać. Nowe pole jest domyślnie wymagane |
| **Symbol zastępczy** | Podpowiedź w polu wprowadzania. Maksymalnie 120 znaków |

Odpowiedzi w dodatkowych polach są w skrzynce odbiorczej przy rozmowie, obok kanału i identyfikatora odwiedzającego.

## Przypomnienie e-mailem [#herinnering-per-e-mail]

Odwiedzający często zamykają stronę, zanim odpowie Twój zespół lub Tillie. Dzięki **Wyślij odwiedzającym e-mail z informacją o nieprzeczytanych odpowiedziach** odwiedzający dostaje e-mail z przyciskiem **Kontynuuj rozmowę**, gdy tylko czeka na niego odpowiedź, której nie przeczytał.

- Odwiedzający musi podać adres e-mail, w formularzu odwiedzającego lub wypełniony wcześniej. Bez adresu nic się nie dzieje.
- E-mail jest wysyłany dopiero, gdy odwiedzający nie był aktywny przez około 5 minut. Na każdą serię nieprzeczytanych odpowiedzi dostaje jeden e-mail.
- Przycisk otwiera czat i kontynuuje rozmowę, także na innym urządzeniu lub w innej przeglądarce. Link działa 30 dni.
- Odwiedzający może też odpowiedzieć bezpośrednio na e-mail. Ta odpowiedź pojawia się w tej samej rozmowie w skrzynce odbiorczej, z małą ikoną koperty przy wiadomości.
- Odpowiedzi od Tillie też się liczą, tak samo jak odpowiedzi Twojego zespołu.

## Opcje we fragmencie kodu [#opties-op-het-snippet]

Oprócz `data-org-id` i `data-widget-key` możesz ustawić opcjonalne atrybuty w skrypcie. Jest to przeznaczone dla osoby, która umieszcza fragment kodu na stronie.

| Atrybut | Co robi? |
|-----------|---------------|
| `data-locale` | Język widżetu: `en`, `nl`, `de`, `fr`, `pt` lub `ro`, ewentualnie z regionem, np. `nl-BE`. Domyślnie `en`, a inny język wraca do angielskiego. Region określa format daty i godziny |
| `data-accent-color` | Kolor akcentujący dla tej strony jako 6-cyfrowy hex. Ma pierwszeństwo przed kolorem z **Ustawienia** |
| `data-messages` | Obiekt JSON do dostosowania pojedynczych tekstów, na przykład `{"send":"Wyślij","messagePlaceholder":"Wpisz swoją wiadomość…"}` |
| `data-sounds` | `false` wyłącza dźwięki przy nowych odpowiedziach zespołu i przy wysyłaniu. Domyślnie włączone |
| `data-launcher` | `false` ukrywa pływający przycisk czatu. Czat otwierasz wtedy własnym przyciskiem przez [SDK widżetu](/ontwikkelaars/website-chat#widget-sdk) |
| `data-visitor` | Obiekt JSON do wstępnego wypełnienia imienia i nazwiska, e-maila i telefonu, na przykład `{"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"}` |
| `data-visitor-name`, `data-visitor-email`, `data-visitor-phone` | Wstępnie wypełnia jedno z tych pól |
| `data-debug` | `true` pokazuje wiersze logu w konsoli przeglądarki |

Atrybuty uzupełniają tylko puste pola. Jeśli odwiedzający wypełnił już dane w tej przeglądarce, pozostają one bez zmian.

Przykład z holenderskimi tekstami:

```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>
```

Debugowanie można też włączyć bez zmiany fragmentu kodu: uruchom w konsoli przeglądarki `localStorage.setItem('tillor-inbox-debug', '1')` i odśwież stronę.

## Ochrona przed spamem [#spambeveiliging]

Widżet nie używa captchy. Tillor zabezpiecza wysyłanie kluczem widżetu i opcją **Dozwolone domeny**. Jeśli Twój formularz kontaktowy ma własną captchę, może zostać jako dodatkowa warstwa.

## Warunki dla odwiedzających [#voorwaarden-voor-bezoekers]

Pod polem wiadomości jest krótka informacja, że wysyłając wiadomość, odwiedzający akceptuje [warunki czatu na stronie](https://tillor.eu/chat-terms). Link otwiera się w nowej karcie i podąża za językiem `data-locale`.

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Umieszczanie czatu na Twojej stronie" href="/inbox/website-chat" description="Instalacja i umieszczanie fragmentu kodu" />
  <Card title="Rozmowy przez czat na stronie" href="/inbox/website-chat-gesprekken" description="Co widzisz Ty i odwiedzający" />
  <Card title="API czatu na stronie" href="/ontwikkelaars/website-chat" description="SDK widżetu i własny interfejs czatu" />
</Cards>


# Umieszczanie czatu na Twojej stronie (/pl-PL/inbox/website-chat)

Dzięki integracji czatu na stronie Twoja strona dostaje przycisk czatu. Wiadomości od odwiedzających trafiają do [skrzynki odbiorczej](/inbox), obok WhatsAppa, Messengera i Instagrama.

<Requires permission="Zarządzanie integracjami" />

<Steps>
<Step>
### Zainstaluj integrację [#installeer-de-integratie]
Przejdź do <UIPath>Ustawienia > Integracje</UIPath> i otwórz **Czat na stronie**. Kliknij **Zainstalować**. Połączenie z zewnętrznym kontem nie jest potrzebne, a klucz widżetu tworzy sam Tillor.
</Step>
<Step>
### Skonfiguruj widżet [#stel-de-widget-in]
W **Ustawienia** na tej samej stronie wypełnij co najmniej **Wiadomość powitalna** i **Kolor akcentujący**. Wypełnij też **Dozwolone domeny**, aby czat mogła ładować tylko Twoja strona. Wszystkie opcje znajdziesz w [Ustawienia czatu na stronie](/inbox/website-chat-instellingen).
</Step>
<Step>
### Skopiuj fragment kodu [#kopieer-het-snippet]
Pod **Umieść na swojej stronie internetowej** kliknij **Skopiuj fragment**. Jeśli bloku nie ma, zapisz ustawienia i odśwież stronę.
</Step>
<Step>
### Wklej fragment kodu na swojej stronie [#plak-het-snippet-op-je-site]
Wklej fragment przed zamykającym znacznikiem `</body>` na każdej stronie, na której ma być przycisk czatu. Jeśli strona ma wspólny szablon lub stopkę, umieść go raz w tym szablonie.
</Step>
</Steps>

## Co zobaczysz potem? [#wat-zie-je-daarna]

Otwórz swoją stronę. W prawym dolnym rogu jest przycisk czatu. Wyślij sam wiadomość testową: rozmowa pojawi się w skrzynce odbiorczej z kanałem **Czat internetowy**. Wyjaśnienie, co widzisz Ty, a co odwiedzający, znajdziesz w [Rozmowy przez czat na stronie](/inbox/website-chat-gesprekken).

<Callout type="info" title="Klucz widżetu jest publiczny">
Klucz jest czytelny we fragmencie kodu, tak jak w innych produktach czatowych. Ogranicz nadużycia opcją **Dozwolone domeny** (nazwy hostów oddzielone przecinkami, na przykład `recreatiepark-het-meer.be, www.recreatiepark-het-meer.be`). Jeśli zostawisz to pole puste, czat działa na każdej domenie, na której znajduje się fragment kodu.
</Callout>

## Czat na publicznych stronach Tillora [#chat-op-publieke-tillor-paginas]

Jeśli **Czat na stronie** jest zainstalowany, **Widżet włączony** jest włączony i **Pokaż na publicznych stronach Tillera** jest włączone, przycisk czatu pojawia się też na publicznych stronach Twojej organizacji. Nie musisz tam umieszczać fragmentu kodu. Chodzi między innymi o strony karty wstępu, otwartej faktury, tagu NFC, danych organizacji i publicznej mapy.

- Na tych stronach Tillor używa **Kolor akcentujący** z ustawień.
- **Dozwolone domeny** dotyczy tylko Twojej własnej strony, a nie stron Tillora.
- Jeśli wyłączysz **Widżet włączony**, przycisk znika wszędzie. Jeśli wyłączysz tylko **Pokaż na publicznych stronach Tillera**, czat na Twojej stronie nadal działa.

## Tymczasowe wyłączenie czatu [#de-chat-tijdelijk-uitzetten]

Wyłącz **Widżet włączony** w <UIPath>Ustawienia > Integracje > Czat na stronie</UIPath>. Integracja pozostaje zainstalowana, a klucz widżetu się nie zmienia. Włącz przełącznik ponownie, aby przywrócić czat.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Przycisk czatu nie pojawia się na mojej stronie">
Sprawdź najpierw, czy **Widżet włączony** jest włączony. Jeśli przy **Dozwolone domeny** jest lista, sprawdź, czy jest na niej nazwa hosta strony, razem z `www.`, jeśli Twoja strona działa z tym prefiksem. Sprawdź też, czy fragment kodu naprawdę jest na tej stronie, a nie tylko w szablonie, którego ta strona nie używa.
</Accordion>
<Accordion title="Fragment kodu do osadzenia nie ładuje się w ustawieniach">
Tillor pokazuje wtedy komunikat, że nie udało się załadować fragmentu. Zapisz ustawienia i odśwież stronę.
</Accordion>
<Accordion title="Czat jest na stronach Tillora, ale nie na mojej stronie">
Na stronach Tillora fragment kodu nie jest potrzebny. Twoja własna strona pokazuje czat tylko z fragmentem kodu z kroku 3.
</Accordion>
<Accordion title="Chcę podłączyć własny formularz kontaktowy lub zastąpić przycisk">
Zajmuje się tym programista za pomocą SDK widżetu. Zobacz [API czatu na stronie](/ontwikkelaars/website-chat).
</Accordion>
<Accordion title="Odwiedzający widzi You sent a lot of messages in a short time">
Tillor ogranicza, ile odwiedzający wysyła przez czat, aby skrypt nie mógł zalać twojej skrzynki i odpowiedzi Tillie: 10 wiadomości na minutę i 200 dziennie na odwiedzającego oraz 30 na minutę i 600 dziennie dla wszystkich w tej samej sieci razem (np. wifi twojego kempingu). Załączniki: 10 na godzinę na odwiedzającego i 50 na godzinę na sieć. Po minucie odwiedzający może kontynuować; żadna wysłana już wiadomość nie ginie. Widżet pokazuje ten komunikat po angielsku.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Ustawienia czatu na stronie" href="/inbox/website-chat-instellingen" description="Wszystkie pola i opcje osadzania" />
  <Card title="Rozmowy przez czat na stronie" href="/inbox/website-chat-gesprekken" description="Co widzisz Ty i odwiedzający" />
  <Card title="API czatu na stronie" href="/ontwikkelaars/website-chat" description="Podłącz własny formularz lub interfejs czatu" />
  <Card title="Asystent AI skrzynki odbiorczej" href="/inbox/inbox-ai-assistant" description="Pozwól Tillie odpowiadać" />
</Cards>


# WhatsApp Business (/pl-PL/inbox/whatsapp-business-inbox)

Dzięki **WhatsApp Business** odbierasz wiadomości klientów przez WhatsApp w [skrzynce odbiorczej Tillora](/inbox) i na nie odpowiadasz. To **nie** to samo co powiadomienia WhatsApp przez Twilio.

<Callout type="info">
Informacje o automatycznych wiadomościach WhatsApp (powiadomieniach) znajdziesz w [Twilio](/communicatie/providers/twilio). Aplikacja **WhatsApp Business** w marketplace służy tylko do rozmów w skrzynce odbiorczej.
</Callout>

Zanim zaczniesz:

- Potrzebujesz uprawnienia **Zarządzanie integracjami**.
- Masz konto WhatsApp Business w Meta i logujesz się kontem, które nim zarządza.

## Instalacja integracji [#integratie-installeren]

1. Przejdź do **Ustawienia > Integracje**
2. Otwórz **WhatsApp Business** na liście (oznaczenie **2**)

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/marketplace-whatsapp.png" alt="Ustawienia > Integracje: WhatsApp Business na liście" />

3. Kliknij **Zainstalować** (oznaczenie **1**) i dokończ proces Meta OAuth

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/whatsapp-install.png" alt="Szczegóły WhatsApp Business: Zainstalować" />

4. Wybierz, który **Numer WhatsAppa** odbiera wiadomości skrzynki odbiorczej
5. Zapisz ustawienia

Po instalacji Tillor automatycznie odbiera przychodzące wiadomości. Odpowiedzi wysłane także przez aplikację WhatsApp Business lub połączone urządzenie pojawiają się w skrzynce odbiorczej. Wiadomości wysłane przez Tillor nie są pokazywane podwójnie.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Przychodzące wiadomości same pojawiają się w [skrzynce odbiorczej](/inbox), połączone z klientem o tym samym numerze telefonu.
- Odpowiedzi wysyłasz w Tillorze. Poza 24-godzinnym oknem idą jako płatny szablon, zobacz [Czytanie rozmów i odpowiadanie na nie](/inbox/gesprekken#whatsapp-en-het-antwoordvenster-van-24-uur).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie przychodzą żadne wiadomości">
Sprawdź w <UIPath>Ustawienia > Integracje > WhatsApp Business</UIPath>, czy wybrano właściwy **Numer WhatsAppa** i czy ustawienia zostały zapisane.
</Accordion>
<Accordion title="Moje odpowiedzi nie wychodzą poza oknem odpowiedzi">
Dodaj w Meta WhatsApp Manager metodę płatności dla swojego konta WhatsApp Business. Bez metody płatności Tillor blokuje płatne odpowiedzi.
</Accordion>
</Accordions>

## Powiązane [#gerelateerd]

<Cards>
  <Card title="Skrzynka odbiorcza" href="/inbox" description="Czytanie rozmów i odpowiadanie na nie" />
  <Card title="Messenger" href="/inbox/messenger" description="Facebook Messenger dla skrzynki odbiorczej" />
</Cards>


# Przegląd (/pl-PL/integraties)

Integracja łączy Tillor z inną usługą, na przykład do płatności, księgowości, telefonii, kamer lub Twojego wpisu w Google. Wszystkimi zarządzasz w <UIPath>Ustawienia > Integracje</UIPath>. Jak zainstalować integrację, opisano w [Instalacja integracji](/integraties/integratie-installeren).

<Requires permission="Wyświetlanie integracji" />

## Jak to się łączy? [#hoe-hangt-dit-samen]

Integracja należy do całej Twojej organizacji, a nie do jednego użytkownika. Po zainstalowaniu połączenie działa tam, gdzie jest potrzebne: połączenie z kamerami przy punktach dostępu, połączenie z pocztą w profilu klienta, połączenie płatności przy fakturach. Niektóre połączenia idą przez connector, mały program na komputerze w Twojej sieci. Musi on wtedy być online.

```mermaid
flowchart LR
  A[Ustawienia > Integracje] --> B[Instalacja integracji]
  B --> C[Płatności i faktury]
  B --> D[Profil klienta i skrzynka odbiorcza]
  B --> E[Punkty dostępu i kamery]
  E -. przez .-> F[Connector w Twojej sieci]
```

<Callout type="info" title="Warto wiedzieć">
- Przeglądać możesz z uprawnieniem **Wyświetlanie integracji**. Instalowanie, zmiana i odinstalowanie wymagają **Zarządzanie integracjami**.
- Odinstalowania nie można cofnąć. Integrację instalujesz potem od nowa i ponownie wypełniasz dane.
- Partoo dostaje Twoje godziny otwarcia na najbliższe 90 dni i aktualizację każdej nocy. Zobacz [Partoo](/integraties/partoo).
- Płatności opłacone ponad 24 godziny temu nie dostają już nakładki na kamerze. Zobacz [UniFi Protect](/integraties/unifi-protect).
- To, które integracje widzisz, zależy od Twojej organizacji. Brakuje którejś? Zapytaj administratora Tillora lub pomoc techniczną.
</Callout>

## Dostępne integracje [#beschikbare-integraties]

| Integracja | Do czego | Opis |
|---|---|---|
| Mollie | Płatności online i terminalowe, polecenie zapłaty SEPA | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) |
| Rachunki bankowe | Import transakcji bankowych i łączenie ich z fakturami | [Ponto i rachunki bankowe](/boekhouden/betalingsrapporten/betaalmethodes/ponto) |
| Admisol | Wysyłanie raportów płatności do księgowości | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) |
| Odoo | Eksport klientów i faktur do Odoo | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) |
| ICY | Odczyt liczników | [Zarządzanie licznikami](/meterbeheer) |
| Voys | Łączenie rozmów telefonicznych z klientami | [Voys](/communicatie/providers/voys) |
| WhatsApp Business | Wiadomości WhatsApp w skrzynce odbiorczej | [WhatsApp Business](/inbox/whatsapp-business-inbox) |
| Messenger | Rozmowy z Facebook Messengera w skrzynce odbiorczej | [Messenger](/inbox/messenger) |
| Instagram | Rozmowy z Instagram Direct w skrzynce odbiorczej | [Instagram](/inbox/instagram) |
| Czat na stronie | Czat na żywo na Twojej stronie | [Czat na stronie](/inbox/website-chat) |
| Asystent AI skrzynki odbiorczej | Automatyczne odpowiadanie na często zadawane pytania | [Asystent AI skrzynki odbiorczej](/inbox/inbox-ai-assistant) |
| UniFi Protect | Łączenie kamer z punktami dostępu i płatnościami | [UniFi Protect](/integraties/unifi-protect) |
| Partoo | Utrzymywanie jednolitych godzin otwarcia w Google i innych wpisach | [Partoo](/integraties/partoo) |
| Outlook | Podgląd poczty klienta w profilu klienta | [Outlook](/integraties/outlook) |

## Pojęcia [#begrippen]

- **Integracja**: połączenie między Tillorem a zewnętrzną usługą.
- **Connector**: program w Twojej sieci, który łączy z Tillorem urządzenia takie jak kamery i drukarki. Zobacz [Connector](/connector).
- **Instalowanie i odinstalowywanie**: włączanie lub usuwanie połączenia. Usunięcia nie można cofnąć.
- **Klucz API**: tajny kod, dzięki któremu Tillor może pracować w innej usłudze.
- **Nakładka**: tekst wyświetlany nad obrazem z kamery, na przykład płatność.

Więcej wyjaśnień znajdziesz w [słowniku pojęć](/begrippen).

<Cards>
  <Card title="Instalacja integracji" href="/integraties/integratie-installeren" description="Wyszukiwanie, wypełnianie i łączenie" />
  <Card title="UniFi Protect" href="/integraties/unifi-protect" description="Obraz z kamer przy wejściach i płatnościach" />
  <Card title="Partoo" href="/integraties/partoo" description="Automatyczne przekazywanie godzin otwarcia" />
  <Card title="Outlook" href="/integraties/outlook" description="Poczta klienta w profilu klienta" />
</Cards>


# Instalowanie integracji (/pl-PL/integraties/integratie-installeren)

Integrację instalujesz w <UIPath>Ustawienia > Integracje</UIPath>. Wyszukujesz ją, wpisujesz dane zewnętrznej usługi i klikasz **Zainstalować**. Potem dostosowujesz ją w bloku **Ustawienia** albo usuwasz przyciskiem **Odinstaluj**. Co jest dostępne, zobaczysz w [przeglądzie](/integraties).

<Requires permission="Zarządzanie integracjami" />

Zanim zaczniesz:

- Z samym uprawnieniem **Wyświetlanie integracji** widzisz listę i ustawienia, ale nie możesz niczego zmienić.
- Przygotuj dane logowania lub klucze zewnętrznej usługi. W przypadku Outlooka zostaniesz przekierowany, aby zalogować się na miejscu.
- Przy połączeniu działającym przez konektor, na przykład UniFi Protect, konektor musi być online.

## Instalowanie integracji [#een-integratie-installeren]

<Steps>
<Step>
### Znajdź integrację [#zoek-de-integratie]
Użyj paska wyszukiwania albo wybierz po lewej w **Integracje** kategorię: **Komunikacja**, **Monitoring**, **Płatności**, **Księgowość** lub **Liczniki**. **Wszystkie integracje** pokazuje wszystko. Integracja, która jest już połączona, ma etykietę **Połączono**.

<DocScreenshot src="/screenshots/integraties/integrations-overview.png" alt="Ustawienia > Integracje z listą integracji" />
</Step>
<Step>
### Otwórz integrację [#open-de-integratie]
Kliknij ją. Niektóre strony mają u góry link **Zobacz dokumentację**.
</Step>
<Step>
### Uzupełnij dane i kliknij Zainstalować [#vul-de-gegevens-in-en-klik-op-installeren]
To, co wpisujesz, zależy od usługi. W przypadku Outlooka zostaniesz przekierowany do samej usługi, aby się zalogować.
</Step>
</Steps>

## Zmiana lub usunięcie [#aanpassen-of-verwijderen]

Po instalacji na tej samej stronie pojawia się blok **Ustawienia**. Zmień tam połączenie i zapisz. Przyciskiem **Odinstaluj** usuwasz połączenie. Tego nie da się cofnąć.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Połączenie działa od razu dla całej Twojej organizacji.
- To, co robi połączenie, zobaczysz tam, gdzie jest potrzebne, na przykład w profilu klienta lub przy punkcie dostępu.
- Po **Odinstaluj** połączenie przestaje działać. To, co już znajduje się w drugiej usłudze, tam zostaje.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Widzę komunikat Nie znaleziono integracji">
Żadna integracja nie pasuje do Twojej frazy ani kategorii. Spróbuj innej frazy albo wybierz **Wszystkie integracje**. Jeśli brakuje integracji, której oczekujesz, nie jest włączona dla Twojej organizacji. Zapytaj wsparcie.
</Accordion>
<Accordion title="Przycisk Zainstalować jest szary lub go nie ma">
Nie masz uprawnienia **Zarządzanie integracjami**. Zapytaj administratora.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się połączyć">
Nie udało się połączyć integracji. Sprawdź wpisane dane i spróbuj ponownie.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się odłączyć">
Spróbuj ponownie. Jeśli to nie pomoże, napisz na support@tillor.eu.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się zaktualizować ustawień aplikacji">
Twoja zmiana nie została zapisana. Spróbuj zapisać ponownie.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Przegląd integracji" href="/integraties" description="Wszystkie dostępne połączenia" />
  <Card title="Konektor" href="/connector" description="Program w Twojej sieci" />
</Cards>


# Połączenie z Outlookiem (/pl-PL/integraties/outlook)

Dzięki połączeniu z Outlookiem w profilu klienta widzisz wiadomości, które Twoja organizacja wymieniła z tym klientem. Tillor pobiera je na żywo z Outlooka i sam ich nie przechowuje.

<Requires permission="Zarządzanie integracjami" />

Zanim zaczniesz:

- Potrzebujesz konta Microsoft, z którego Tillor może czytać pocztę.
- Aby zobaczyć pocztę w profilu klienta, potrzebujesz uprawnienia **Wyświetlanie skrzynki odbiorczej**. Bez niego brakuje zakładki **Outlook**.

## Instalowanie [#installeren]

<Steps>
<Step>
### Otwórz integrację [#open-de-integratie]
Przejdź do <UIPath>Ustawienia > Integracje > Outlook</UIPath>.
</Step>
<Step>
### Kliknij Zainstalować [#klik-op-installeren]
Zostaniesz przekierowany do Microsoftu.
</Step>
<Step>
### Zaloguj się i udziel zgody [#log-in-en-geef-toestemming]
Zaloguj się kontem, z którego Tillor może czytać pocztę.

<DocScreenshot src="/screenshots/integraties/integrations-outlook.png" alt="Instalowanie Outlooka" />
</Step>
</Steps>

Po połączeniu w **Ustawienia** zobaczysz nazwę, adres e-mail i nazwę użytkownika połączonego konta oraz datę, do której połączenie jest aktywne.

## Wybór skrzynek [#mailboxen-kiezen]

Domyślnie Tillor szuka tylko w skrzynce połączonego konta. W **Skrzynki pocztowe** wybierasz dodatkowe skrzynki, na przykład współdzieloną skrzynkę recepcji.

- **Osobista** to skrzynka połączonego konta.
- **Współdzielona** to skrzynki współdzielone, które to konto może otworzyć. Tillor sam je wyszukuje.
- **Dodana ręcznie** to adresy, które wpisujesz sam. Wpisz adres i wybierz **Dodaj [adres]**.

## Poczta w profilu klienta [#mail-op-het-klantprofiel]

W profilu klienta pojawia się zakładka **Outlook**, między **Komunikacja** a **Wydarzenia**. Zakładka jest tylko wtedy, gdy Outlook jest połączony i masz uprawnienie **Wyświetlanie skrzynki odbiorczej**.

- U góry widać liczbę wiadomości i skrzynki, w których szukano. Przyciskiem **Odśwież** pobierasz najnowszą pocztę.
- Tillor szuka po adresie e-mail klienta i jego kontaktów. Jeśli nikt nie ma adresu e-mail, zobaczysz informację, że nie ma czego szukać.
- Każda wiadomość pokazuje temat, czy jest **Odebrane** czy **Wysłane**, od kogo do kogo oraz spinacz przy załącznikach. Kliknij wiadomość, aby otworzyć treść i załączniki. Przyciskiem **Otwórz w Outlooku** przejdziesz do wiadomości w samym Outlooku.
- Ta sama wiadomość w kilku skrzynkach pojawia się na liście tylko raz.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tillor tylko czyta pocztę i niczego nie przechowuje. Jeśli usuniesz połączenie, zakładka **Outlook** znika z profilu klienta.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Dane konta niedostępne">
Tillor nie mógł pobrać połączonego konta Microsoft. Odśwież stronę albo połącz Outlooka ponownie przez **Zainstalować**.
</Accordion>
<Accordion title="Połącz ponownie, aby wykryć skrzynki współdzielone">
Outlook został połączony, zanim Tillor mógł wyszukiwać skrzynki współdzielone. Kliknij **Połącz Outlook ponownie** albo wpisz sam adres skrzynki współdzielonej.
</Accordion>
<Accordion title="Nie udało się wczytać skrzynek współdzielonych">
Nadal możesz ręcznie wpisać adres skrzynki w **Dodana ręcznie**.
</Accordion>
<Accordion title="Poczta Outlook niedostępna">
Tillor nie mógł wczytać poczty z Outlooka. Spróbuj ponownie przyciskiem **Odśwież** lub sprawdź połączenie.
</Accordion>
<Accordion title="Nie udało się przeszukać niektórych skrzynek">
Połączone konto nie ma dostępu do tej skrzynki. Sprawdź uprawnienia do skrzynki w Outlooku.
</Accordion>
<Accordion title="Nie widzę zakładki Outlook w profilu klienta">
Outlook nie jest połączony albo brakuje Ci uprawnienia **Wyświetlanie skrzynki odbiorczej**.
</Accordion>
<Accordion title="Nie udało się wczytać tej wiadomości">
Spróbuj otworzyć wiadomość jeszcze raz. Jeśli to nie pomoże, przejdź do samej wiadomości przyciskiem **Otwórz w Outlooku**.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Profil klienta i jego zakładki" />
  <Card title="Integracje" href="/integraties" description="Wszystkie dostępne połączenia" />
</Cards>


# Połączenie z Partoo (/pl-PL/integraties/partoo)

Partoo zarządza Twoimi wizytówkami w Google i na innych stronach. Dzięki temu połączeniu Tillor wysyła Twoje godziny otwarcia do lokalizacji w Partoo, więc nie musisz ich prowadzić w dwóch miejscach. Same godziny zarządzasz w Tillor, zobacz [Ustawienia organizacji](/gebruikers/organisaties#openingsuren).

<Requires permission="Zarządzanie integracjami" />

Zanim zaczniesz:

- Utwórz w Partoo osobnego użytkownika dla Tillor, bez logowania dwuetapowego. Przy logowaniu dwuetapowym Tillor nie może się zalogować.
- Uzupełnij godziny otwarcia w Tillor, zobacz nagłówek Godziny otwarcia w ustawieniach organizacji.

## Instalowanie [#installeren]

<Steps>
<Step>
### Otwórz integrację [#open-de-integratie]
Przejdź do <UIPath>Ustawienia > Integracje > Partoo</UIPath>.
</Step>
<Step>
### Wpisz dane użytkownika Partoo [#vul-de-gegevens-van-de-partoo-gebruiker-in]
Wpisz **E-mail** i **Hasło** tego użytkownika.
</Step>
<Step>
### Wybierz lokalizację [#kies-je-vestiging]
Lista lokalizacji pojawia się dopiero po wpisaniu e-maila i hasła. W **Lokalizacja** wybierz swoją lokalizację. Wpisz tekst w **Szukaj lokalizacji…**, aby wyszukać.
</Step>
<Step>
### Kliknij Zainstalować [#klik-op-installeren]

<DocScreenshot src="/screenshots/integraties/integrations-partoo.png" alt="Instalowanie Partoo" />
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Tillor wysyła godziny tygodniowe, sezony i wyjątkowe dni z [godzin otwarcia Twojej organizacji](/gebruikers/organisaties#openingsuren):

- Godziny tygodniowe to godziny bieżącego tygodnia. Partoo nie zna sezonów, więc Tillor wysyła godziny sezonu, który obowiązuje teraz.
- Dni w ciągu najbliższych 90 dni, w których godziny się różnią, na przykład inny sezon, święto lub wyjątek, trafiają jako osobne daty. Okres zamknięcia staje się jednym okresem.
- Tillor wysyła to co noc i od razu po każdej zmianie godzin otwarcia, strefy czasowej, kraju domyślnego lub samego połączenia. Zmieniane jest tylko to, co różni się od Partoo.

## Zmiana lub usunięcie [#aanpassen-of-verwijderen]

Zmień e-mail, hasło lub lokalizację w bloku **Ustawienia**. Zostaw hasło puste, aby zachować obecne. Przyciskiem **Odinstaluj** zatrzymujesz przesyłanie. To, co już jest w Partoo, tam zostaje.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Partoo odrzuciło ten e-mail lub hasło">
Sprawdź dane użytkownika Partoo. Jeśli ten użytkownik ma włączone logowanie dwuetapowe, wyłącz je albo utwórz osobnego użytkownika.
</Accordion>
<Accordion title="Ten użytkownik Partoo nie widzi żadnej lokalizacji">
Nadaj użytkownikowi Partoo w Partoo dostęp do swojej lokalizacji i sprawdź ponownie.
</Accordion>
<Accordion title="Nie udało się wczytać lokalizacji z Partoo">
Spróbuj ponownie za chwilę. Jeśli problem się utrzymuje, napisz na support@tillor.eu.
</Accordion>
<Accordion title="Godziny w Google się nie zgadzają">
Najpierw sprawdź godziny otwarcia w Tillor, strefę czasową i kraj domyślny. Po zmianie Tillor od razu je wysyła, a potem jeszcze raz każdej nocy.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Ustawienia organizacji" href="/gebruikers/organisaties" description="Godziny otwarcia, sezony i wyjątki" />
  <Card title="Integracje" href="/integraties" description="Wszystkie dostępne połączenia" />
</Cards>


# Połączenie z UniFi Protect (/pl-PL/integraties/unifi-protect)

Dzięki połączeniu z UniFi Protect z próby wejścia lub zdarzenia punktu dostępu jednym kliknięciem przechodzisz do nagrania z odpowiedniej kamery. Płatności gotówkowe i kartą mogą ponadto pojawiać się jako tekst na obrazie kamery, dzięki czemu przy różnicy kasowej możesz cofnąć się w nagraniu. Instalacja wygląda tak samo jak przy każdej integracji, zobacz [Instalowanie integracji](/integraties/integratie-installeren).

<Requires permission="Zarządzanie integracjami" />

Zanim zaczniesz:

- Kamery są odczytywane przez [konektor](/connector) na Twoim parku. Musi być online. Jeśli nie jest, Tillor pokaże **Konektor Tillor jest offline lub niedostępny.**
- Potrzebujesz danych swojej konsoli UniFi OS. To urządzenie lub serwer, na którym działa UniFi Protect.
- Aby połączyć z punktami dostępu, te punkty dostępu muszą istnieć, zobacz [Kontrola dostępu](/toegangscontrole).

## Instalowanie [#installeren]

<Steps>
<Step>
### Otwórz integrację [#open-de-integratie]
Przejdź do <UIPath>Ustawienia > Integracje > UniFi Protect</UIPath>.
</Step>
<Step>
### Uzupełnij dane konsoli [#vul-de-console-in]
- **Host konsoli**: lokalny adres IP lub nazwa hosta Twojej konsoli UniFi OS.
- **Klucz API**: tajny kod, który tworzysz w konsoli i dzięki któremu Tillor może odczytywać kamery.
- **Identyfikator konsoli w chmurze**: długi identyfikator po `/consoles/` w adresie URL unifi.ui.com Twojej konsoli.
</Step>
<Step>
### Wybierz kamery płatności [#kies-de-betaalcameras]
W **Kamera płatności gotówkowych** i **Kamera płatności POS** wybierz kamerę albo zostaw **Nie rejestruj**. POS to terminal płatniczy.
</Step>
<Step>
### Kliknij Zainstalować [#klik-op-installeren]
Gdy host i klucz API są uzupełnione, Tillor wczytuje kamery z konsoli.

<DocScreenshot src="/screenshots/integraties/integrations-unifi-protect.png" alt="Instalowanie UniFi Protect" />
</Step>
</Steps>

## Łączenie kamer z punktami dostępu [#cameras-koppelen-aan-toegangspunten]

Po instalacji w bloku **Ustawienia** znajduje się tabela **Kamery punktów dostępu**. Połącz każdy **Punkt dostępu** z **Kamera**. Jeśli lista jest pusta, najpierw dodaj punkty dostępu.

Potem w szczegółach próby wejścia i zdarzenia punktu dostępu pojawia się link **Otwórz w UniFi Protect**. Otwiera on nagranie z tego momentu w UniFi Protect, w nowej karcie.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Jeśli wybrano kamerę w **Kamera płatności gotówkowych** lub **Kamera płatności POS**, Tillor wysyła do niej każdą płatność, która przechodzi na **Zapłacono**. Płatności gotówkowe trafiają do kamery gotówkowej, płatności kartą na terminalu do kamery POS.
- Płatności opłacone ponad 24 godziny temu nie dostają już tekstu na obrazie.
- Płatności przez Mollie liczą się tylko wtedy, gdy należą do głównego profilu Mollie.
- Jeśli zmienisz dane, zapisz. Jeśli zostawisz **Klucz API** puste, obowiązuje dotychczasowy klucz. Przyciskiem **Odinstaluj** usuwasz połączenie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie znaleziono kamer na tej konsoli UniFi Protect">
Konsola nie ma kamer albo klucz API nie ma do nich dostępu. Sprawdź klucz i czy kamery są widoczne w UniFi Protect.
</Accordion>
<Accordion title="Nie udało się pobrać kamer z UniFi Protect">
Sprawdź host, klucz API i czy konektor jest online. Tillor pokazuje: **Sprawdź host, klucz API i konektor.**
</Accordion>
<Accordion title="Konektor Tillor jest offline lub niedostępny">
Kamery są ładowane przez konektor w Twojej sieci lokalnej. Uruchom konektor lub przywróć połączenie, zobacz [Konektor](/connector).
</Accordion>
<Accordion title="Nie widzę Otwórz w UniFi Protect przy próbie wejścia">
Do tego punktu dostępu nie przypisano kamery. Połącz ją w tabeli **Kamery punktów dostępu**.
</Accordion>
<Accordion title="Płatności nie ma na obrazie">
Sprawdź, czy kamera w **Kamera płatności gotówkowych** lub **Kamera płatności POS** nie jest ustawiona na **Nie rejestruj**. Płatność opłacona ponad 24 godziny temu nie dostaje już nakładki. Płatność przez Mollie liczy się tylko przy głównym profilu.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Kontrola dostępu" href="/toegangscontrole" description="Dziennik dostępu i punkty dostępu" />
  <Card title="Konektor" href="/connector" description="Połączenie z Twoją siecią lokalną" />
  <Card title="Integracje" href="/integraties" description="Wszystkie dostępne połączenia" />
</Cards>


# Mapa (/pl-PL/kaart)

Na mapie jednym spojrzeniem widzisz, które działki są wolne, zarezerwowane lub zajęte, dla każdego wybranego dnia. Tutaj też wyznaczasz granice działek, aby Tillor znał ich powierzchnię, i mierzysz odległości. Same działki zarządzasz w [Działki](/terreinen).

<Callout type="info" title="Warto wiedzieć">
- Mapa zawsze otwiera się na dzisiaj. Twój styl, etykiety i warstwy są zapamiętywane.
- Rezerwacje wymeldowane i anulowane nie liczą się do koloru, etykiety wyjazdu ani podwójnej rezerwacji.
- Etykiety z nocami i wyjazdem znikają poniżej poziomu powiększenia 17,5. Nazwa działki zostaje.
- Działki bez wyznaczonej granicy nie ma na mapie. Rysować można tylko przy włączonym **Tryb edycji**.
- Mapa otwiera się na środku mapy, który ustawiasz w **Ustawienia > Mapa**. Ten sam punkt określa też pogodę.
</Callout>

## Otwieranie mapy [#de-kaart-openen]

Przejdź do <UIPath>Park > Mapa</UIPath>. Od razu widzisz wszystkie działki wraz ze statusem zajętości.


<DocScreenshot src="/screenshots/park/map-overview.png" alt="Mapa z wyznaczoną działką 12" />

- **Zielony obszar** - działka do rezerwacji jest wolna
- **Szary obszar** - działka jest **Niedostępne do rezerwacji** i nie ma w wybranym dniu aktywnego pobytu (brak rezerwacji i zajęcia); brak etykiet z nocami i wyjazdem
- **Cyjanowy obszar** - rezerwacja **zarezerwowana**, jeszcze bez zameldowania (także w późniejsze dni okresu pobytu, dopóki nie dokonano zameldowania)
- **Niebieski obszar** - rezerwacja **zameldowana** (aktywny pobyt w wybranym dniu)
- **Żółty obszar** - działka ma aktywne zajęcie (najem długoterminowy; obowiązuje w każdym wybranym dniu, dopóki zajęcie trwa)
- **Czerwony obszar** (jasna nakładka, czerwona ramka) - podwójna rezerwacja: nakładające się okresy rezerwacji na tej samej działce

Kliknij działkę na mapie, aby otworzyć okno z nazwą, rezerwacjami, ewentualnym aktywnym zajęciem (gość) i skrótami.

## Wybór daty [#datum-kiezen]

Po prawej obok **Ustawienia mapy** wybierasz **datę** (domyślnie dzisiaj). Mapa pokazuje wtedy, jak działki wyglądają tego dnia. Po odświeżeniu strony data wraca na **dzisiaj**; zapamiętywane są tylko pozostałe ustawienia mapy (styl, etykiety, warstwy). Rezerwacje **wymeldowane** i **anulowane** nie liczą się do koloru, etykiety wyjazdu ani podwójnej rezerwacji (nie pojawiają się też w oknie na mapie). Przy wolnych miejscach pod nazwą działki jest etykieta z ikoną księżyca i liczbą nocy do następnego zameldowania. Przy rezerwacji lub zajęciu z datą wyjazdu jest etykieta z ikoną wyjazdu i liczbą nocy do wymeldowania (0 = dzisiaj). Najedź kursorem na etykietę, aby zobaczyć pełny tekst. Przy **podwójnej rezerwacji** (dwie lub więcej rezerwacji z nakładającymi się okresami pobytu na tej samej działce) działka dostaje czerwoną ramkę i jasną czerwoną nakładkę; przed numerem działki widać czerwoną ikonę trójkąta. W oknie zobaczysz ostrzeżenie z danymi rezerwacji, których to dotyczy. Poniżej poziomu powiększenia **17,5** mapa automatycznie ukrywa etykiety z nocami i wyjazdem; nazwa działki pozostaje widoczna. Powiększ co najmniej do **17,5** (albo wyłącz **Noce i wymeldowanie** w ustawieniach mapy), aby zobaczyć te etykiety. Po oddaleniu nazwy działek są wyświetlane mniejsze, żeby mniej się nakładały.

## Warstwy i kolory [#lagen-en-kleuren]

W lewym dolnym rogu są trzy przyciski: **Warstwy**, **Eksportuj do PDF** i **Ustawienia mapy**, a na prawo od nich wybór daty. Przyciskiem **Warstwy** decydujesz, co widzisz i jak są pokolorowane działki.

<DocScreenshot src="/screenshots/instellingen/map-layers.png" alt="Mapa z panelem Warstwy" />

- W **Kolory** wybierasz **Zajęcie** lub **Typ działki**. Przy **Zajęcie** działki są kolorowane tak, jak opisano wyżej. Przy **Typ działki** każda działka dostaje **Kolor mapy** swojego typu, zobacz [Typy terenów](/terreinen#terreintypes).
- Przy **Zajęcie** pod **Warstwy działek** jest pole wyboru dla każdego rodzaju: **Wolne**, **Zarezerwowane**, **Zameldowane**, **Zajęte**, **Niedostępne do rezerwacji** i **Podwójna rezerwacja**. Odznacz pole, aby ukryć te działki.
- W **Typy terenów** wybierasz, które typy pojawiają się na mapie. **Bez typu** dotyczy działek bez typu.

Przyciskiem **Eksportuj do PDF** pobierasz plik pdf z działkami, które są teraz na mapie: nazwa, powierzchnia, gaz i obliczona taryfa, na wybrany dzień.

## Ustawienia mapy [#kaartinstellingen]

Przyciskiem **Ustawienia mapy** dostosowujesz wygląd.

<DocScreenshot src="/screenshots/instellingen/map-settings.png" alt="Mapa z panelem Ustawienia mapy" />

| Ustawienie | Opis |
|------------|--------------|
| **Styl** | **Satelita**, **Hybryda** lub **Ulice** |
| **Tryb edycji** | Pokaż narzędzia do rysowania i edycji granic działek |
| **Nazwy działek** | Pokaż nazwy działek na mapie. Działa tylko wtedy, gdy włączona jest co najmniej jedna warstwa |
| **Noce i wymeldowanie** | Pokaż przy nazwach działek, ile nocy jest wolnych i kiedy pobyt się kończy. Działa tylko wtedy, gdy włączone są **Nazwy działek** |

Twoje ustawienia są zapisywane automatycznie.

## Ustawianie domyślnej mapy [#kaartstandaard-instellen]

<Requires permission="Edycja ustawień" />

W <UIPath>Pomoc > Ustawienia > Mapa</UIPath> określasz, gdzie mapa się otwiera i jak jest obrócona.

<DocScreenshot src="/screenshots/instellingen/settings-map.png" alt="Ustawienia > Mapa" />

| Ustawienie | Opis |
|---|---|
| **Środek mapy** | Kliknij mapę albo przeciągnij pinezkę na środek parku. Pod spodem widać współrzędne. |
| **Kierunek mapy** | Kierunek kompasu w stopniach (0-360), w którym otwiera się mapa. |

Środek mapy liczy się także poza mapą. To miejsce, dla którego pobierana jest pogoda w <UIPath>Park > Pogoda</UIPath>, a podpowiedzi adresów przy wpisywaniu adresu dają pierwszeństwo miejscom w pobliżu. Jeśli w **Apple Wallet** nie ustawiono **Lokalizacja punkt dostępuu**, Apple Wallet i Google Wallet używają środka mapy dla karty dostępu. Zobacz [Organizacja](/gebruikers/organisaties#apple-wallet). Jeśli środek jest w złym miejscu, nie będzie się zgadzać także pogoda.

## Wyznaczanie granic działek [#terreingrenzen-intekenen]

W trybie edycji zapisujesz na mapie dokładną granicę działki. Z niej Tillor oblicza powierzchnię w m², której używa formuła taryfy.

1. Przejdź do **Park > Mapa**
2. Kliknij **Ustawienia mapy** w lewym dolnym rogu
3. Włącz **Tryb edycji**
4. Klikaj wybrane punkty na mapie, aby narysować wielokąt
5. Zamknij wielokąt, klikając punkt początkowy
6. W oknie dialogowym wybierz działkę, którą chcesz połączyć

<DocScreenshot src="/screenshots/park/map-terrain-select-dialog.png" alt="Okno łączenia działki po narysowaniu wielokąta" />

7. Kliknij **"Zaktualizuj"**

Działka pojawia się teraz na mapie jako kolorowy obszar.

<Callout type="info">
Działki bez wyznaczonej lokalizacji są na początku listy wyboru, abyś łatwo mógł je znaleźć i połączyć.
</Callout>

## Mierzenie odległości [#afstanden-meten]

Funkcją pomiaru szybko zmierzysz odległości i powierzchnie na mapie - przydatne przy planowaniu terenu lub szacowaniu odległości między lokalizacjami.

1. Kliknij w lewym górnym rogu mapy **Zmierz odległość** lub **Zmierz powierzchnię**
2. Umieść punkty na mapie (powierzchnię zamykasz, klikając punkt początkowy)
3. Pomiar jest pokazany na mapie; użyj **Wyczyść pomiary**, aby zacząć od nowa

## Otwieranie działki z mapy [#een-terrein-openen-vanaf-de-kaart]

Z mapy możesz szybko przejść do działki:

1. Kliknij działkę na mapie
2. Okno pokazuje nazwę, status zajętości, aktywne rezerwacje, a przy zajęciu gościa
3. Kliknij **"Zobacz szczegóły"**, aby przejść do strony ze szczegółami
4. Dopóki nie ma aktywnego zajęcia, możesz rozpocząć **"Utwórz rezerwację"**

## Co dzieje się po wyznaczeniu granicy? [#wat-gebeurt-er-na-het-intekenen]

- Działka dostaje kolor na mapie, a Tillor uzupełnia **Powierzchnię** na stronie działki.
- **Obliczona taryfa** jest przeliczana na nowo, bo powierzchnia się liczy. Zobacz [Działki](/terreinen#hoe-het-tarief-tot-stand-komt).
- **Łączna powierzchnia** na górze listy działek od teraz uwzględnia tę działkę.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Mojej działki nie ma na mapie">
Działka nie ma jeszcze wyznaczonej granicy. Włącz **Tryb edycji**, narysuj działkę i wybierz ją w oknie dialogowym. Działki bez lokalizacji są na początku listy wyboru. Jeśli działka jest, sprawdź w **Warstwy**, czy włączona jest warstwa jej statusu.
</Accordion>
<Accordion title="Brakuje etykiet z nocami i wyjazdem">
Powiększ co najmniej do poziomu 17,5 i sprawdź w **Ustawienia mapy**, czy włączone są zarówno **Nazwy działek**, jak i **Noce i wymeldowanie**. Szare działki niedostępne do rezerwacji, bez pobytu, nigdy nie mają takiej etykiety.
</Accordion>
<Accordion title="Mapa otwiera się w złym miejscu lub pokazuje złą pogodę">
Środek mapy jest ustawiony błędnie. Przesuń pinezkę w <UIPath>Pomoc > Ustawienia > Mapa</UIPath>.
</Accordion>
<Accordion title="Nie widzę Utwórz rezerwację w oknie">
Ta opcja jest tylko wtedy, gdy działka nie ma aktywnego zajęcia.
</Accordion>
<Accordion title="Mapa pokazuje dzisiejszą datę, także po moim wyborze">
Wybrana data nie jest zapamiętywana. Po odświeżeniu mapa wraca na dzisiaj.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Działki" href="/terreinen" description="Tworzenie działek, taryfa i liczniki" />
  <Card title="Rezerwacje" href="/reserveringen" description="Planuj pobyty i zarządzaj nimi" />
  <Card title="Park" href="/park" description="Przegląd zarządzania parkiem" />
</Cards>


# Zarządzanie klientami (/pl-PL/klantenbeheer)

Klient to miejsce w Tillor, w którym zbiera się wszystko o osobie lub firmie: dane, osoby kontaktowe, faktury, zajęcia, rezerwacje, dokumenty i dostęp. Tworzysz klienta, odnajdujesz go na liście i aktualizujesz jego dane w profilu klienta. Zacznij od [Dodawania nowego klienta](#een-nieuwe-klant-toevoegen).

<Callout type="info" title="Warto wiedzieć">
- Przy tworzeniu wymagane jest tylko **Imię**. Wszystkie pozostałe dane uzupełnisz później w profilu klienta.
- Tillor ostrzega o **Możliwy duplikat klienta**, jeśli imię i nazwisko razem, adres e-mail lub numer telefonu są już u innego klienta. Adres e-mail lub numer telefonu liczą się od 4 znaków.
- Podpowiedzi adresów pojawiają się od 3 wpisanych znaków w polu **Ulica**.
- Skany dokumentów tożsamości bez powiązanego klienta Tillor usuwa po 7 dniach.
- Usunięcie klienta usuwa też wszystkie powiązane dane i nie można tego cofnąć.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Wszystko, co rejestrujesz w Tillor, jest powiązane z klientem. Zajęcie łączy klienta z działką, a przez to także z licznikami na tej działce. Zużycie z tych liczników trafia na fakturę klienta.

```mermaid
flowchart LR
  K[Klient] --> C[Osoby kontaktowe]
  K --> R[Rezerwacje]
  K --> B[Zajęcia]
  B --> T[Działka]
  T --> M[Liczniki]
  M --> V[Zużycie]
  V --> F[Faktury]
  K --> F
  F --> P[Płatności]
  K --> D[Dokumenty i prośby o podpis]
  K --> O[Uwagi i zadania]
```

## Dodawanie nowego klienta [#een-nieuwe-klant-toevoegen]

Zanim zaczniesz:

- Skan dokumentu tożsamości, jeśli chcesz utworzyć klienta na jego podstawie. Jeśli w kolejce nie ma skanu, po prostu wybierz wpisanie ręczne.
- Nie masz pewności, czy klient już istnieje? Najpierw wyszukaj go na liście, zobacz [Wyszukiwanie i filtrowanie klientów](#klanten-zoeken-en-filteren).

<Steps>
<Step>
### Otwórz listę klientów [#open-de-klantenlijst]
Przejdź do <UIPath>Klienci > Przegląd</UIPath> i kliknij w prawym górnym rogu **Utwórz nowego klienta**. Dopóki są oczekujące skany dokumentów tożsamości, przycisk pokazuje menu z **Ręczny** i skanami z kolejki.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Utwórz nowego klienta z menu oczekującego skanu dokumentu tożsamości" />
</Step>
<Step>
### Wybierz, jak utworzyć klienta [#kies-hoe-je-de-klant-aanmaakt]
<Tabs items={["Ręcznie", "Ze skanu dokumentu tożsamości"]}>
<Tab value="Ręcznie">
Wybierz **Ręczny**. Otworzy się formularz z **Imię**, **Nazwisko**, **Adres e-mail** i **Numer telefonu**. Wpisz to, co wiesz, i kliknij **Utwórz klienta**. Jeśli może już istnieć klient z podobnymi danymi, na dole pojawia się żółty komunikat z linkiem do tego klienta.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Okno Utwórz nowego klienta (Ręczny)" />
</Tab>
<Tab value="Ze skanu dokumentu tożsamości">
Wybierz skan z menu, na przykład **Lotte Peeters**. W potwierdzeniu zobaczysz podgląd dokumentu (przód, tył, portret) i dane ze strefy maszynowej. Kliknij **Utwórz klienta**. Tillor tworzy klienta, łączy skan i uzupełnia dane z dokumentu.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Potwierdzenie po wybraniu oczekującego skanu dokumentu tożsamości" />

Oczekujące skany są też w panelu w prawym dolnym rogu, z **Utwórz klienta na podstawie skanu**. Więcej o skanach znajdziesz w [Skany tożsamości](/identiteitsscans).

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Panel w prawym dolnym rogu z oczekującym skanem dokumentu tożsamości" />
</Tab>
</Tabs>
</Step>
<Step>
### Sprawdź, czy klient się nie dubluje [#controleer-op-een-dubbele-klant]
Jeśli może już istnieć klient z tym samym imieniem i nazwiskiem, adresem e-mail lub numerem telefonu, Tillor pokazuje **Możliwy duplikat klienta** z nazwą i numerem klienta. Kliknij **Skorzystaj z tego klienta**, aby otworzyć tego klienta, albo **Utwórz mimo wszystko**, jeśli to naprawdę inna osoba.
</Step>
</Steps>

<Callout type="warn" title="Okres przechowywania i odpowiedzialność">
Skany bez powiązanego klienta Tillor usuwa **automatycznie po 7 dniach**. Przetwórz je na czas.

Dla **powiązanych** skanów okres przechowywania i podstawę prawną określa **Twoja organizacja**. Tillor przechowuje je, dopóki ich nie odłączysz lub nie usuniesz. Przestrzeganie przepisów o ochronie prywatności i odpowiednich okresów przechowywania to **Twoja odpowiedzialność** jako administratora danych.
</Callout>

### Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Trafiasz do nowego profilu klienta, gdzie uzupełniasz resztę: adres, numer VAT, osoby kontaktowe i pola niestandardowe.
- Jeśli klient został utworzony ze skanu, skan należy do klienta i nie ma go już w kolejce.
- Utworzenie jest pierwszym wierszem w zakładce **Wydarzenia** klienta.
- Chcesz, aby przy nowym kliencie od razu coś się wydarzyło, na przykład mail powitalny? Użyj [automatyzacji](/automatiseringen).

## Sprawdzanie numeru VAT [#een-btw-nummer-controleren]

W zakładce **Przegląd**, w bloku **Dane klienta**, wpisujesz **Numer VAT**. Tillor sprawdza numer w europejskim rejestrze VIES, gdy uzupełniono też **Kraj** i numer jest wystarczająco długi.

- Jeśli numer jest prawidłowy, widzisz zielony znacznik i okno z oficjalną nazwą firmy i adresem z VIES. Kliknij **Zastosuj adres firmy**, aby przenieść ten adres do formularza.
- Jeśli numer jest nieprawidłowy, widzisz czerwoną ikonę i komunikat o błędzie.

## Profil klienta [#het-klantprofiel]

Gdy klikniesz klienta, zobaczysz profil klienta. U góry są podsumowane dane klienta, a pod nimi przypięte uwagi. Zakładki prowadzą do reszty.

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Profil klienta - blok Dane klienta" />

| Zakładka | Co tam znajdziesz |
|---|---|
| **Przegląd** | Dane klienta (formularz do edycji), ostatnia komunikacja, faktury, odczyty liczników, uwagi, zajęcia i powiadomienia |
| **Fakturowanie** | Wszystkie faktury tego klienta oraz [saldo na koncie księgowym](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken) |
| **Kontrola dostępu** | Prawa dostępu i tablice rejestracyjne |
| **Łączność** | Dodatkowe osoby kontaktowe |
| **Tagi NFC** | Połączone tagi NFC |
| **Rezerwacje** | Wszystkie rezerwacje |
| **Komunikacja** | Wiadomości i historia komunikacji |
| **Outlook** | Poczta od klienta i do klienta z Twoich skrzynek Outlook. Ta zakładka pojawia się tylko wtedy, gdy [Outlook](/integraties/outlook) jest połączony i możesz **Wyświetlanie skrzynki odbiorczej** |
| **Wydarzenia** | Oś czasu ze zmianami, w tym utworzenie klienta lub kontaktu, przypisanie lub odłączenie dokumentu tożsamości oraz przed/po przy aktualizacjach klienta, kontaktu, ustawień fakturowania i metody dostępu |
| **Dokumenty** | Zapisane pliki i załączniki oraz [prośby o podpis](/handtekeningen) |
| **Zadania** | Zadania powiązane z tym klientem |

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Profil klienta - zakładka Kontrola dostępu z metodami dostępu" />

### W skrócie [#in-één-oogopslag]

W zakładce **Przegląd** w lewym górnym rogu jest karta **W skrócie**. Pokazuje tylko to, co w danej chwili wymaga uwagi, i zwija się, gdy nie ma nic do pokazania:

- **Aktywne rezerwacje** i **Nadchodzące rezerwacje**, z przyciskiem **Zobacz rezerwację**
- **Liczniki aktywne z alarmami**
- **Otwarte zadania** tego klienta
- **Skany tożsamości** tego klienta

<DocScreenshot src="/screenshots/klanten/customer-key-info.png" alt="Profil klienta - karta W skrócie" />

Te same dane widzisz na karcie połączenia przychodzącego. Uwaga, którą przypniesz, jest od razu pod danymi klienta u góry profilu. Zobacz [Uwagi](/notities#opmerking-vastzetten).

### Urodziny [#verjaardagen]

Jeśli klient lub jego partner ma dziś urodziny, u góry profilu klienta jest zielony blok **Urodziny dzisiaj** z imieniem i wiekiem, a po stronie spadają konfetti. W przypadku klienta data pochodzi z pola **Data urodzenia**. Partner to kontakt z relacją **Partner**. Data urodzenia 29 lutego w latach bez dnia przestępnego liczy się jako 28 lutego.

## Edycja danych klienta [#klantgegevens-bewerken]

W zakładce **Przegląd**, w bloku **Dane klienta**, zmieniasz pola. Na dole formularza są **Anuluj** i **Zapisz**. Każda zmiana trafia do zakładki **Wydarzenia**, z podsumowaniem **Przed / po** dla każdego pola, dzięki czemu dokładnie widzisz, co zostało zmienione.

Jeśli Twoja organizacja utworzyła [pola niestandardowe](/eigen-velden) dla klientów, są one dodatkowymi polami w tym samym bloku.

### Wpisywanie adresu [#adres-invullen]

Adres składa się z **Ulica**, **Nr** i **Lokal**, a następnie **Kod pocztowy**, **Miejscowość** i **Kraj**.

<DocScreenshot src="/screenshots/klanten/customer-address-input.png" alt="Pole adresu z ulicą, numerem i lokalem" />

- Jeśli wpiszesz co najmniej trzy znaki ulicy, Tillor podpowiada adresy. Wybierz jeden: zostaną uzupełnione ulica, numer, kod pocztowy, miejscowość i kraj. Podpowiedzi pochodzą z OpenStreetMap, bezpłatnej bazy map.
- Jeśli w polu **Ulica** wpiszesz **Kerkstraat 5**, cyfra przeskakuje do **Nr**. Spacja po numerze przenosi Cię do **Lokal**. Jeśli wkleisz pełny adres, także zostanie podzielony. W krajach, gdzie numer stoi przed ulicą, numer nie jest automatycznie przenoszony.
- Jeśli kod pocztowy lub miejscowość są już wpisane, Tillor sprawdza adres. Zielony znacznik z **Znaleziono adres** oznacza, że adres istnieje. Żółta ikona z **Sugerowana pisownia** pokazuje zwyczajową pisownię. Kliknij **Zaktualizuj adres**, aby ją przejąć.
- Adres jest zapisywany jako jeden wiersz, na przykład na fakturach i w eksportach.

Podpowiedzi to pomoc, nie obowiązek. Zawsze możesz wpisać coś sam.

## Wyszukiwanie i filtrowanie klientów [#klanten-zoeken-en-filteren]

Przejdź do <UIPath>Klienci > Przegląd</UIPath>. U góry jest pasek wyszukiwania.

<DocScreenshot src="/screenshots/klanten/customers-list.png" alt="Lista klientów z paskiem wyszukiwania" />

- Wpisz nazwę, adres e-mail, numer telefonu lub numer klienta.
- Wyniki aktualizują się w trakcie pisania, z krótkim opóźnieniem.
- Możesz też filtrować według **Utworzono** (zakres dat), **Status** i **Typ**.

## Usuwanie klienta [#een-klant-verwijderen]

Użyj **Usuń Klienta** w menu u góry profilu klienta. Tillor pyta: **Czy na pewno chcesz usunąć tego klienta?** Jeśli potwierdzisz, znikają też wszystkie powiązane dane. Nie można tego cofnąć.

## Typowe scenariusze [#veelvoorkomende-scenarios]

### Nowy klient rezerwuje po raz pierwszy [#een-nieuwe-klant-boekt-voor-het-eerst]

1. Klient dzwoni lub rezerwuje online.
2. Dodajesz klienta przez **Utwórz nowego klienta**.
3. Uzupełniasz adres i pozostałe dane w profilu klienta (zakładka **Przegląd** > **Dane klienta**).
4. Tworzysz zajęcie na wybranej działce, zobacz [Zajęcia](/bezettingen#een-bezetting-aanmaken).
5. Zużycie podłączonych liczników Tillor śledzi automatycznie. Zobaczysz je w **Odczyty** w **Przegląd**.

### Zmiana danych klienta [#klantgegevens-wijzigen]

Otwórz profil klienta, zmień adres w formularzu i kliknij **Zapisz**.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pokazuje: Klient nie został utworzony">
Komunikat brzmi **Nie można utworzyć klienta.** Sprawdź, czy uzupełniono **Imię** i czy adres e-mail jest prawidłowy, z małpą i domeną. Potem spróbuj ponownie.
</Accordion>
<Accordion title="Tillor pokazuje: Możliwy duplikat klienta">
Istnieje już klient z tym samym imieniem i nazwiskiem, adresem e-mail lub numerem telefonu. Kliknij **Skorzystaj z tego klienta**, jeśli to ta sama osoba, albo **Utwórz mimo wszystko**, jeśli to inna osoba.
</Accordion>
<Accordion title="Tillor pokazuje: Coś poszło nie tak. Nie można zaktualizować klienta">
Twoje zmiany nie zostały zapisane. Sprawdź w formularzu, czy nie ma nieprawidłowego adresu e-mail lub pustego wymaganego pola, i kliknij ponownie **Zapisz**.
</Accordion>
<Accordion title="Skanu nie ma w menu Utwórz nowego klienta">
Za oczekujące uznawane są tylko skany bez powiązanego klienta. Jeśli skan jest już powiązany z klientem albo starszy niż 7 dni, nie ma go tam. Zobacz [Skany tożsamości](/identiteitsscans).
</Accordion>
<Accordion title="Utwórz klienta na podstawie skanu jest szare">
Przy skanie jest podany powód. Zwykle skan nie ma imienia: *uzupełnij je w czytniku lub powiąż ten skan ręcznie*. Albo istnieje już klient z tym samym numerem rejestru narodowego. Otwórz wtedy tego klienta i powiąż z nim skan.
</Accordion>
<Accordion title="Tillor pokazuje: Nieprawidłowy numer VAT">
Numer jest nieprawidłowy lub niezarejestrowany w VIES. Sprawdź, czy **Kraj** się zgadza i czy numer jest kompletny. Tillor zgłasza też **Numer VAT musi mieć co najmniej ... znaków**, gdy numer jest za krótki dla wybranego kraju, i prosi o numer oraz kraj, jeśli brakuje jednego z nich.
</Accordion>
<Accordion title="Nie widzę zakładki Outlook">
Zakładka pojawia się tylko wtedy, gdy [Outlook](/integraties/outlook) jest połączony i masz uprawnienie **Wyświetlanie skrzynki odbiorczej**.
</Accordion>
<Accordion title="Nie pojawiają się podpowiedzi adresów">
Wpisz co najmniej trzy znaki w polu **Ulica**. Jeśli podpowiedzi nadal się nie pojawiają, po prostu wpisz adres sam.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Klient**: rekord w Tillor osoby lub firmy. Zobacz [klient](/begrippen#klant).
- **Osoba kontaktowa**: dodatkowa osoba przy kliencie, na przykład partner lub kontakt awaryjny.
- **Zajęcie**: klient na działce przez pewien okres. Zobacz [zajęcie](/begrippen#bezetting).
- **Rezerwacja**: zamówienie pobytu. Zobacz [rezerwacja](/begrippen#reservering).
- **Wydarzenia**: oś czasu ze wszystkimi zmianami przy kliencie. Zobacz [wydarzenie](/begrippen#gebeurtenis).
- **VIES**: europejski rejestr, w którym Tillor sprawdza numer VAT.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Skany tożsamości" href="/identiteitsscans" description="Tworzenie klienta ze skanu, okres przechowywania i konektor" />
  <Card title="Zajęcia" href="/bezettingen" />
  <Card title="Rezerwacje" href="/reserveringen" />
  <Card title="Faktury" href="/facturen" />
  <Card title="Działki" href="/terreinen" />
  <Card title="Pozyskanie klienta sezonowego" href="/praktijk/seizoensklant-binnenhalen" />
</Cards>


# Alarmy i status licznika (/pl-PL/meterbeheer/alarmen-en-status)

Licznik zgłasza alarm, gdy przekazuje odchylenie, takie jak problem z połączeniem lub awaria techniczna. Tutaj przeczytasz, gdzie to zobaczysz, co oznacza wskaźnik statusu i jak wyczyścić alarm.

## Obsługa alarmu [#een-alarm-opvolgen]

<Steps>
<Step>
### Znajdź licznik z alarmem [#zoek-de-meter-met-een-alarm]
Przejdź do <UIPath>Park > Liczniki</UIPath>. Licznik z aktywnym alarmem ma trójkącik.
</Step>
<Step>
### Otwórz licznik i przeczytaj alarm [#open-de-meter-en-lees-het-alarm]
Na liście alarmów widzisz dla każdego alarmu komunikat, **Rozpoczęto** oraz to, czy jest Aktywny czy Rozwiązany. Komunikat zależy od typu licznika i dostawcy.
</Step>
<Step>
### Rozwiąż problem [#los-het-probleem-op]
Sprawdź baterię i sygnał w szczegółach licznika, a w razie potrzeby podjedź do licznika.
</Step>
<Step>
### Wyczyść alarm [#wis-het-alarm]
W menu działań licznika wybierz **Wyczyść alarmy**.
</Step>
</Steps>

## Co oznacza status [#wat-de-status-betekent]

- **Wskaźnik statusu**: inteligentne liczniki (ICY i Tillor Hydrodigit) pokazują, czy ostatnio się komunikowały i czy są alarmy. Wskaźnik zmienia kolor przy aktywnym alarmie lub gdy licznik od ponad doby niczego nie przesłał.
- **Poziom baterii** i **jakość sygnału**: jako procent w szczegółach licznika, dla liczników, które to przekazują.

## Kontrolery ICY [#icy-controllers]

Moduły ICY na działkach komunikują się przez kontroler w szafie licznikowej. Jeśli kontroler wypadnie, żaden licznik za tym kontrolerem niczego już nie przesyła.

Jeśli Twój park ma liczniki ICY, w <UIPath>Park > Liczniki</UIPath> nad listą jest karta **Kontrolery ICY**. Mówi ona, ile jest kontrolerów, ile z nich ICY nie widziało w ostatniej godzinie i ile alarmów jest otwartych na kontrolerach. Kliknij **Pokaż**, aby zobaczyć tabelę:

- **Kontroler**: nazwa szafy licznikowej, w której wisi najwięcej liczników kontrolera, z zielonym lub czerwonym kółkiem. Jeśli nazwa w ICY się różni, stoi obok na szaro. Jeśli liczniki nie wiszą w żadnej szafie licznikowej, widzisz tylko nazwę z ICY.
- **Liczniki**: ile Twoich liczników komunikuje się przez ten kontroler. Przy samym liczniku ta nazwa jest w polu **Kontroler** na karcie **Informacje**.
- **Alarmy**: alarmy, które ICY zgłasza na samym kontrolerze, wraz z informacją, od kiedy. Alarm znika z listy, gdy ICY przestaje go zgłaszać; nie musisz go czyścić. Alarm, którego Tillor jeszcze nie zna z nazwy, pojawia się jako **Nieznany alarm** z kodem z ICY. Kto dostaje powiadomienia push o alarmach liczników, dostaje też powiadomienie o nowym i o rozwiązanym alarmie na kontrolerze.
- **Ostatnio widziane**: kiedy ICY ostatnio widziało kontroler. Jeśli było to ponad godzinę temu, czas jest na czerwono.

Kontroler z alarmem lub kontroler, który milczy dłużej niż godzinę, jest na górze, a karta wtedy sama się otwiera.
Tillor aktualizuje listę za każdym razem, gdy odczytywane są liczniki ICY.

## Gdy wszystkie liczniki milkną naraz [#als-al-je-meters-tegelijk-stilvallen]

Liczniki Tillor Hydrodigit i Tillor EM300 przesyłają swój stan do Tillor przez odbiornik, bramę LoRa. Zwykle wysyłają pomiar około dwa razy dziennie. Jeśli każdy ostatnio aktywny licznik LoRa Twojej organizacji od ponad 24 godzin niczego nie wysłał, przyczyną jest prawdopodobnie brama lub połączenie z Tillor, a nie liczniki. Pojedynczy milczący licznik nie wywołuje tego komunikatu: potrzebne są co najmniej dwa aktywne liczniki.

Wtedy administratorzy Tillor dostają powiadomienie z ostatnim otrzymanym pomiarem i zaangażowanymi licznikami. Te liczniki nie są wtedy jeszcze osobno pokazywane jako licznik wymagający uwagi. Nie musisz nic ustawiać. Jeśli na swoich licznikach widzisz wspólny, stary **Ostatni odczyt**, skontaktuj się ze wsparciem.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Wyczyszczony alarm nie jest już na liście jako aktywny. Trójkącik przy liczniku w <UIPath>Park > Liczniki</UIPath> dotyczy tylko aktywnych alarmów.
- Jeśli licznik zgłosi problem ponownie, dostaniesz nowy alarm.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Alarm ciągle wraca">
Przyczyna nadal istnieje. Sprawdź baterię, sygnał i miejsce licznika, a w razie potrzeby zadzwoń do wsparcia.
</Accordion>
<Accordion title="Kilka liczników nie ma świeżego pomiaru">
Sprawdź, czy wszystkie mają stary **Ostatni odczyt**. Wtedy przyczyną jest brama lub połączenie. Skontaktuj się ze wsparciem.
</Accordion>
<Accordion title="Grupa liczników ICY nagle przestała cokolwiek przesyłać">
Sprawdź na karcie **Kontrolery ICY**, czy kontroler ma alarm lub jest na czerwono. Wtedy winny jest ten kontroler lub jego połączenie, a nie liczniki. Sprawdź zasilanie i sieć szafy licznikowej i w razie potrzeby skontaktuj się z ICY.
</Accordion>
<Accordion title="Jeden licznik nic nie przesyła, ale nie ma komunikatu">
Komunikat o bramie wymaga co najmniej dwóch aktywnych liczników. Sprawdź sam status, baterię i sygnał tego licznika.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Przeglądanie odczytów i trendów" href="/meterbeheer/meterstanden-en-trends" />
  <Card title="Fakturowanie zużycia" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Okresy zużycia (/pl-PL/meterbeheer/consumptie-batches)

Ta strona wyjaśnia, jak Tillor dzieli zużycie klienta na okresy, abyś wiedział, dlaczego kwota wygląda tak, a nie inaczej. **Okres zużycia** (consumptiebatch) to okres zużycia licznika dla jednego klienta i jednego licznika. Tillor automatycznie śledzi, kiedy okres się zaczyna, kiedy się kończy i czy został już zafakturowany. Chcesz tylko zafakturować? Przejdź do [Fakturowanie zużycia](/meterbeheer/verbruik-factureren).

## Cykl życia okresu [#levenscyclus-van-een-batch]

```mermaid
flowchart TD
  A[Utworzony<br/>tylko stan początkowy] -- odczyty --> B[Otwarty<br/>stan początkowy i końcowy]
  B -- zamknięcie --> C[Zamknięty<br/>zablokowany]
  C -- fakturowanie --> D[Zafakturowany<br/>zakończony]
```

### Statusy [#statussen]

| Status | Opis |
|--------|------|
| **Otwarta** | Nowe odczyty są automatycznie dodawane do okresu |
| **Zamknięta** | Okres jest zamknięty i czeka na zafakturowanie |
| **Zafakturowana** | Zużycie zostało ujęte na fakturze |

## Kiedy powstaje okres? [#wanneer-wordt-een-batch-aangemaakt]

- **Przy zajęciu miejsca**: gdy przypisujesz klienta do działki z licznikami i podajesz stan początkowy
- **Przy ręcznym odczycie**: gdy wprowadzasz odczyt licznika na działce z aktywnym zajęciem miejsca i nie istnieje jeszcze otwarty okres dla tej pary klient-licznik

## Kiedy okres jest zamykany? [#wanneer-wordt-een-batch-gesloten]

- **Przy zakończeniu zajęcia miejsca**: gdy klient opuszcza działkę (zajęcie miejsca zostaje usunięte)
- **Przy korekcie lub resecie licznika**: gdy stan licznika spada (np. licznik został wymieniony lub poprawiony) - system zamyka poprzedni okres, tworzy zamknięty okres "skoku" z ujemnym zużyciem (np. -90 przy 100→10), a kolejny odczyt rozpoczyna nowy otwarty okres
- **Przy nowym zajęciu miejsca**: gdy przypisany zostaje inny klient (lub ten sam klient ponownie) z jawnie podanymi stanami początkowymi

<Callout type="info" title="Stan licznika spada">
Jeśli stan licznika spada (korekta, reset lub wymiana), Tillor automatycznie zamyka trwający okres, tworzy zamknięty okres "skoku" z ujemnym zużyciem i od razu otwiera nowy okres od nowego stanu. Okres skoku łatwo rozpoznać i oznaczyć jako opłacony. Kolejny odczyt jest dodawany do nowego okresu.
</Callout>

## Przykłady [#voorbeelden]

<Accordions type="multiple">
  <Accordion title="Zwykłe zajęcie miejsca (typowy przebieg)">
    Klient zajmuje działkę, zużywa media i wyjeżdża. Najczęstszy scenariusz.

    ```
    1. Bezetting aangemaakt met startstand 100 m³ (15 jan)
       → Batch: start 100 m³, open

    2. Uitlezingen: 150 m³ (20 jan), 200 m³ (25 jan)
       → Batch: start 100 m³, eind 200 m³, verbruik 100 m³

    3. Bezetting beëindigd met eindstand 250 m³
       → Batch gesloten: verbruik 150 m³, wacht op facturering

    4. Factureer verbruik
       → Batch gefactureerd, klaar
    ```
  </Accordion>

  <Accordion title="Fakturowanie w trakcie pobytu (typowy przebieg)">
    Zajęcie miejsca trwa dalej, a ty fakturujesz okres po okresie bez zamykania okresu.

    ```
    1. Batch: 0 → 50 m³ (open)
    2. Markeer als gefactureerd
       → Batch 1 gesloten, Batch 2 automatisch aangemaakt: 50 → (open)
    3. Nieuwe uitlezingen: 75, 100 m³
       → Batch 2: 50 → 100 m³, verbruik 50 m³
    4. Markeer weer als gefactureerd
       → Batch 2 gesloten, Batch 3: 100 → (open)
    ```
  </Accordion>

  <Accordion title="Stan licznika spada - prosty przypadek (100 → 10)">
    Tylko stan początkowy, potem korekta. Okres skoku ze zużyciem -90 m³, potem nowy otwarty okres.

    ```
    1. Batch: start 100 m³ (15 jan), nog geen eindstand
    2. Uitlezing op 16 jan: 10 m³ (meter gecorrigeerd)
       → Batch 1 gesloten (verbruik 0)
       → Sprong-batch: start 100 m³, eind 10 m³ (verbruik -90 m³) - gesloten
       → Nieuwe open batch: start 10 m³
    3. Volgende uitlezing: 20 m³ → batch: 10 → 20 m³, verbruik 10 m³
    ```
  </Accordion>

  <Accordion title="Stan licznika spada - ze zużyciem (100 → 150 → 10)">
    Najpierw normalne zużycie, potem wymiana licznika. Okres skoku ze zużyciem -140 m³, potem nowy otwarty okres.

    ```
    1. Batch: start 100 m³ (15 jan), eind 150 m³ (20 jan) → verbruik 50 m³
    2. Uitlezing op 25 jan: 10 m³ (meter vervangen)
       → Batch 1 gesloten met eind 150 m³ (verbruik 50 m³)
       → Sprong-batch: start 150 m³, eind 10 m³ (verbruik -140 m³) - gesloten
       → Nieuwe open batch: start 10 m³
    3. Volgende uitlezing: 20 m³ → batch: 10 → 20 m³, verbruik 10 m³
    ```
  </Accordion>

  <Accordion title="Okres bez zużycia">
    Odczyt z takim samym stanem jak stan początkowy. Tillor dostosowuje datę początkową.

    ```
    1. Batch: start 982 m³ (1 dec), open
    2. Uitlezing 5 jan: 982 m³ (zelfde stand)
       → Start automatisch aangepast naar 5 jan
       → Periode toont "5 jan → ..." in plaats van "1 dec → ..."
    3. Uitlezing 5 jan (later): 990 m³
       → Verbruik 8 m³, periode "5 jan → 5 jan"
    ```
  </Accordion>

  <Accordion title="Klient wraca">
    Klient opuszcza działkę i wraca później. Nowy okres, niepowiązany z poprzednim.

    ```
    1. Klant A: batch 0 → 50 m³, bezetting beëindigd
    2. Klant B: batch 55 → 100 m³, bezetting beëindigd
    3. Klant A keert terug met startstand 110 m³
       → Nieuwe batch: start 110 m³ (niet 50 m³)
       → Geen koppeling met vorige periode
    ```
  </Accordion>

  <Accordion title="Usunięto fakturę roboczą - kontynuacja znów staje się jednym okresem">
    Zafakturowałeś zużycie, gdy zajęcie miejsca jeszcze trwało, a potem usuwasz fakturę roboczą.

    ```
    1. Open batch: 100 m³ (1 feb) → 200 m³ (7 mrt), bezetting loopt door
    2. Factureer verbruik (conceptfactuur)
       → Batch A: 100 → 200 m³, gekoppeld aan factuur, afgesloten voor die factuur
       → Batch B automatisch: start 200 m³ (zelfde uitlezing als eind van A), open
    3. Nieuwe uitlezing: 250 m³ (15 mrt)
       → Batch B: 200 → 250 m³
    4. Conceptfactuur verwijderen
       → Batch A: niet meer gekoppeld aan factuur, niet gefactureerd
       → Batch B (start nog steeds op 200 m³) wordt samengevoegd in A
       → Resultaat: één open batch 100 m³ → 250 m³, klaar om opnieuw te factureren
    ```
  </Accordion>

  <Accordion title="Usunięto fakturę roboczą - brak scalenia (inny początek)">
    Dwa osobne okresy na tym samym liczniku: drugi okres **nie** zaczyna się od stanu końcowego pierwszego. Tillor ich **nie** scala.

    ```
    1. Batch A: 12,49 m³ → 13,21 m³ (eindstand = uitlezing X)
    2. Later een andere periode / sprong op de meter
    3. Batch B: 0,10 m³ → 0,77 m³ (start = uitlezing Y, Y ≠ X)
    4. Zelfde of andere factuur - maakt niet uit voor dit voorbeeld
    5. Als je een factuur verwijdert die alleen bij A hoorde:
       → A wordt weer vrijgegeven voor facturering
       → Batch B blijft bestaan; wordt niet in A getrokken (start Y is niet hetzelfde als eind X)
    ```
  </Accordion>

  <Accordion title="Usunięto fakturę roboczą - kontynuacja została już ponownie zafakturowana">
    Pierwsza faktura obejmuje okres do stanu X; potem pojawiają się nowe odczyty i **druga** faktura na kontynuację. Usunięcie pierwszej faktury nie zmienia drugiej.

    ```
    1. Factuur 1: batch A 0 → 50 m³ → na facturering batch B: start 50 m³, open
    2. Uitlezingen: 60, 75 m³ op batch B
    3. Factuur 2: batch B gefactureerd → batch C: start 75 m³
    4. Factuur 1 verwijderen
       → A weer vrijgegeven
       → B hoort nog bij factuur 2 → wordt niet als "open voortzetting van A" gezien
       → Geen samenvoeging van A met B; C blijft de actieve voortzetting na factuur 2
    ```
  </Accordion>
</Accordions>

## Fakturowanie [#facturering]

### Sposób 1: przyciskiem faktury (nowa faktura) [#manier-1-via-factuurknop-nieuwe-factuur]

1. Przejdź do **Klienci** > klient > karta **Przegląd** (kafel **Odczyty**)
2. Kliknij **Zafakturuj zużycie**
3. System tworzy fakturę z zużyciem jako pozycją albo dodaje je do istniejącej faktury roboczej
4. Okresy są oznaczane jako zafakturowane i powiązane z fakturą

### Sposób 2: ręczne oznaczenie jako zafakturowane [#manier-2-handmatig-als-gefactureerd-markeren]

Jeśli zużycie zostało zafakturowane poza Tillor:

1. Otwórz okres w kafelku **Odczyty** (profil klienta) lub **Zużycie** (**Park** > **Liczniki** > licznik)
2. Kliknij ikonę ostrzeżenia obok okresu
3. Potwierdź przyciskiem **Tak, oznacz jako zafakturowane**
4. Okres zostaje zamknięty bez powiązania z fakturą

<Callout type="warn" title="Uwaga">
Tylko ręcznie oznaczone okresy można "cofnąć". Okresów powiązanych z prawdziwą fakturą nie można cofnąć - najpierw trzeba usunąć fakturę.
</Callout>

### Automatyczny nowy okres [#automatische-nieuwe-batch]

Gdy oznaczasz okres jako zafakturowany (a zajęcie miejsca nadal trwa), Tillor automatycznie tworzy **nowy otwarty okres**, który zaczyna się od stanu końcowego poprzedniego. Dzięki temu zużycie biegnie dalej bez luk.

```
Batch 1: 0 → 50 m³ (gefactureerd)
         ↓
Batch 2: 50 → (open, klaar voor nieuwe uitlezingen)
```

## Usuwanie faktury [#factuur-verwijderen]

Gdy usuwasz **fakturę roboczą**, do której było przypisane zużycie, Tillor automatycznie dostosowuje okresy zużycia.

### Co dzieje się zawsze? [#wat-gebeurt-er-altijd]

- Powiązanie z tą fakturą znika.
- Okres znów jest **niezafakturowany** i może trafić na kolejną fakturę.

### Kiedy dwa okresy znów stają się jednym? [#wanneer-worden-twee-batches-weer-één]

Czasem po zafakturowaniu Tillor automatycznie zaczął **nowy otwarty okres** od **stanu końcowego** zafakturowanego okresu. Gdy usuwasz tę fakturę, system szuka takiej kontynuacji:

| Warunek | Skutek |
|---------|--------|
| Istnieje inny okres z **takim samym stanem początkowym** jak **stan końcowy** zafakturowanego okresu (ten sam odczyt jako punkt połączenia) | Ta kontynuacja zostaje **scalona** z pierwotnym okresem. Znów masz **jeden** ciągły okres. |
| Kontynuacja jest **jeszcze niezafakturowana** (nie ma na niej faktury) | Scalenie jest **dozwolone**. |
| Kontynuacja **zaczyna się od innego odczytu** niż stan końcowy zafakturowanego okresu | **Brak** scalenia: to dwa osobne okresy. |
| Kontynuacja jest **już ponownie zafakturowana** (inna faktura) | **Brak** scalenia: ten okres pozostaje na drugiej fakturze. |

### Stan końcowy po scaleniu [#eindstand-na-samenvoegen]

Po scaleniu okres powinien znów być **otwarty** (jeśli kontynuacja była otwarta), a **stan końcowy** jest aktualnym stanem końcowym tej kontynuacji - czyli łącznie z odczytami, które wpłynęły **po** fakturze. Jeśli kontynuacja technicznie nie miała stanu końcowego, ale na liczniku są nowsze odczyty, Tillor uzupełnia stan końcowy **najnowszym odczytem po punkcie połączenia** (ta sama logika co przy tworzeniu okresu).

<Callout type="info" title="Ręcznie oznaczone jako zafakturowane">
Tylko okresy **bez** powiązania z fakturą możesz ręcznie przywrócić jako "niezafakturowane" ikoną cofania (w **Park** > **Liczniki** > licznik, przy rozliczonych okresach). Okresy powiązane z prawdziwą fakturą podlegają powyższym zasadom dopiero **po** usunięciu tej faktury.
</Callout>

## Szczególne sytuacje [#specifieke-situaties]

### Okres bez zużycia [#periode-zonder-verbruik]

Gdy pojawia się odczyt z takim samym stanem jak stan początkowy (zużycie = 0), Tillor automatycznie dostosowuje datę początkową. Wyświetlany okres pokazuje tylko czas, w którym faktycznie wystąpiło zużycie.

### Klient wraca [#klant-keert-terug]

Gdy klient ponownie zajmuje działkę po wcześniejszym wyjeździe:

- Tworzony jest **zupełnie nowy okres**
- Okres nie zaczyna się tam, gdzie zakończył się poprzedni
- Ponownie wybierasz stan początkowy (albo stan licznika w tym momencie)

### Licznik powiązany z kilkoma klientami [#meter-gekoppeld-aan-meerdere-klanten]

Każda para klient-licznik ma własne okresy. Ta sama działka może mieć kilka zajęć miejsca (np. w różnych okresach), każde z własnymi okresami zużycia.

## Przegląd w aplikacji [#overzicht-in-de-applicatie]

Gdzie zobaczysz okresy:

- **Klienci** > klient > karta **Przegląd** > kafel **Odczyty**: dla każdego licznika tylko **otwarte** okresy (pomarańczowy akcent) z przyciskiem **Zafakturuj zużycie** na górze.
- **Park** > **Liczniki** > licznik > kafel **Zużycie**: dla każdego klienta najpierw otwarte okresy (pomarańczowe), pod nimi rozliczone okresy (zielone przy powiązaniu z fakturą, szare przy ręcznym oznaczeniu).
- **Klienci** > **Niezafakturowane zużycie**: tabela klientów, którym trzeba jeszcze zafakturować zużycie.


<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Klienci > Niezafakturowane zużycie" />

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie licznikami" href="/meterbeheer" description="Powrót do przeglądu" />
  <Card title="Fakturowanie zużycia" href="/meterbeheer/verbruik-factureren" description="Fakturowanie krok po kroku" />
  <Card title="Faktury" href="/facturen" description="Faktury robocze i fakturowanie" />
  <Card title="Zarządzanie klientami" href="/klantenbeheer" />
</Cards>


# Przegląd (/pl-PL/meterbeheer)

Dzięki zarządzaniu licznikami odczytujesz liczniki swojego parku zdalnie i widzisz, kto ile zużywa, bez obchodzenia szafek licznikowych. Widzisz stany liczników, zużycie w okresach i alarmy, a zużycie rozliczasz z klientem, który w danej chwili stoi na działce. Swoje liczniki znajdziesz w <UIPath>Park > Liczniki</UIPath>.

<DocScreenshot src="/screenshots/park/meters-list.png" alt="Park > Liczniki ze wszystkimi licznikami parku" />

## Jak to się łączy? [#hoe-hangt-dit-samen]

Licznik nigdy nie należy bezpośrednio do klienta. Licznik jest przypisany do **działki**, a klient jest przypisany do tej działki przez **zajęcie miejsca**. Kto ma teraz zajęcie miejsca na działce, otrzymuje zużycie z liczników na tej działce.

```mermaid
flowchart LR
  M[Licznik] -->|przypisujesz do| T[Działka]
  K[Klient] -->|dostaje zajęcie miejsca na| T
  T --> V[Zużycie klienta]
  V --> F[Faktura]
```

Z tego wynikają trzy rzeczy, które często zaskakują:

- Nie ma przycisku do przypisania licznika do klienta. Robisz to w dwóch krokach: licznik do działki, klient do działki. Zobacz [Przypisanie licznika do klienta](/meterbeheer/meter-koppelen).
- Gdy klient się przeprowadza, nie przenosisz licznika. Zajęcie miejsca się kończy, a kolejny klient otrzymuje zużycie od własnego stanu początkowego.
- Jeśli na działce nie ma zajęcia miejsca, zużycie nie należy do nikogo i nie możesz go zafakturować.

<Callout type="info" title="Warto wiedzieć">
- Działka może mieć jednocześnie najwyżej jedno aktywne zajęcie miejsca. Działka z zajęciem miejsca nie pojawia się na liście wyboru w **Utwórz zajęcie miejsca**.
- Liczniki we wspólnej sieci LoRa wysyłają pomiar mniej więcej dwa razy dziennie. Zobacz ramkę poniżej.
- Tillor zgłasza możliwą awarię odbiornika (bramki), gdy wszystkie ostatnio aktywne liczniki LoRa nie wysłały niczego przez ponad 24 godziny, i to tylko przy co najmniej dwóch aktywnych licznikach.
- Jeśli chcesz zafakturować zużycie klienta, a kwota do zapłaty jest niższa niż kwota minimalna, Tillor czeka do następnego dnia fakturowania.
- Przy automatycznym fakturowaniu Tillor wstrzymuje fakturę, jeśli zużycie prądu lub wody jest co najmniej dwukrotnie wyższe niż zwykle u danego klienta.
- Usuniętego licznika nie można przywrócić, razem ze wszystkimi odczytami i okresami zużycia.
</Callout>

<Callout type="info" title="Dla czytelnika technicznego">
LoRa to połączenie bezprzewodowe o dużym zasięgu i niskim poborze energii. Licznik wysyła swój stan do odbiornika na parku lub w jego pobliżu, czyli bramki, a ta przekazuje go do Tillor. Dev EUI to unikalny numer licznika LoRa, 16 znaków (cyfry 0-9 i litery a-f). Numer ten wpisujesz przy tworzeniu licznika. Liczniki ICY rozpoznasz po numerze seryjnym.
</Callout>

## Co chcesz zrobić? [#wat-wil-je-doen]

<Cards>
  <Card title="Przypisanie licznika do klienta" href="/meterbeheer/meter-koppelen" description="Licznik do działki, klient do działki" />
  <Card title="Podgląd odczytów i trendów" href="/meterbeheer/meterstanden-en-trends" description="Stan, zużycie dziennie lub godzinowo, porównanie z poprzednim tygodniem" />
  <Card title="Fakturowanie zużycia" href="/meterbeheer/verbruik-factureren" description="Ręcznie lub automatycznie, z kwotą minimalną" />
  <Card title="Alarmy i status licznika" href="/meterbeheer/alarmen-en-status" description="Brak odczytu, bateria, sygnał i awarie" />
  <Card title="Usuwanie licznika" href="/meterbeheer/meter-verwijderen" description="W trzech krokach, nie można cofnąć" />
  <Card title="Okresy zużycia" href="/meterbeheer/consumptie-batches" description="Jak okresy zużycia biegną, zamykają się i łączą" />
</Cards>

## Jak trafiają odczyty? [#hoe-komen-de-meterstanden-binnen]

Inteligentne liczniki same przesyłają swój stan, zwykle codziennie lub co tydzień. Nie musisz nic robić: nowe stany pojawiają się same przy liczniku i u klienta, który stoi na działce. Jeśli licznik nie ma inteligentnego połączenia, stan wprowadzasz samodzielnie.

## Pojęcia [#begrippen]

- **Licznik**: licznik wody, gazu lub prądu. Zobacz [Pojęcia](/begrippen#meter).
- **Działka**: miejsce, w którym wisi licznik i w którym stoi klient. Zobacz [Pojęcia](/begrippen#terrein).
- **Zajęcie miejsca**: klient na działce przez jakiś okres. Zobacz [Pojęcia](/begrippen#bezetting).
- **Okres zużycia** (consumptiebatch): zużycie jednego klienta na jednym liczniku, od stanu początkowego do stanu końcowego.
- **Niezafakturowane zużycie**: zużycie, które nie zostało jeszcze zafakturowane.
- **Stan początkowy**: stan licznika, od którego klient zaczyna zajęcie miejsca.


# Przypisanie licznika do klienta (/pl-PL/meterbeheer/meter-koppelen)

Licznika nie przypisujesz do samego klienta. Przypisujesz licznik do działki i dajesz klientowi zajęcie miejsca na tej działce. Potem zużycie samo trafia do klienta. Schemat znajdziesz w [Jak to się łączy?](/meterbeheer#hoe-hangt-dit-samen)

<Requires permission="Edycja: liczniki" />

Zanim zaczniesz:

- Licznik jest już w <UIPath>Park > Liczniki</UIPath>. Licznika, który już jest przypisany do działki, nie zobaczysz na liście wyboru.
- Działka istnieje i nie ma jeszcze aktywnego zajęcia miejsca. Jeśli działka jest zajęta, nie ma jej na liście wyboru w **Utwórz zajęcie miejsca**; jeśli widzisz **Nie znaleziono dostępnych działek.**, wszystkie są zajęte.
- Klient istnieje.

## Krok 1: przypisz licznik do działki [#stap-1-de-meter-aan-het-terrein-hangen]

<Steps>
<Step>
### Otwórz działkę [#open-het-terrein]
Przejdź do <UIPath>Park > Działki</UIPath> i kliknij działkę.
</Step>
<Step>
### Kliknij Dodaj licznik [#klik-op-meter-toevoegen]
Na dole kafelka **Liczniki** znajdziesz **Dodaj licznik**. Wybierz licznik z listy.
</Step>
<Step>
### Potwierdź przyciskiem Przypisz licznik [#bevestig-met-meter-toekennen]
Licznik jest teraz w kafelku **Liczniki** działki.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Szczegóły działki z kafelkiem Liczniki" />

## Krok 2: umieść klienta na działce [#stap-2-de-klant-op-het-terrein-zetten]

<Steps>
<Step>
### Otwórz klienta [#open-de-klant]
Przejdź do <UIPath>Klienci > Przegląd</UIPath> i otwórz klienta. Na karcie **Przegląd** znajdziesz kafelek **Zajęcia**.
</Step>
<Step>
### Kliknij Utwórz zajęcie miejsca [#klik-op-bezetting-aanmaken]
Wybierz działkę. Jeśli na działce są liczniki, możesz dla każdego licznika wpisać **stan początkowy**. Wybierasz istniejący odczyt albo wpisujesz wartość. Jeśli nie ma liczników, zobaczysz **Brak powiązanych liczników**.
</Step>
<Step>
### Potwierdź [#bevestig]
Kliknij ponownie **Utwórz zajęcie miejsca**.
</Step>
</Steps>

## Odłączanie licznika [#een-meter-loskoppelen]

Otwórz działkę, przejdź do kafelka **Liczniki** i w menu (...) przy liczniku wybierz **Odłącz od działki**. Licznik nadal istnieje i możesz go przypisać do innej działki. Ta opcja jest tylko na stronie działki, nie w menu samego licznika.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tillor rozpoczyna dla każdego licznika na działce okres zużycia dla tego klienta, od stanu początkowego. Zobacz [Okresy zużycia](/meterbeheer/consumptie-batches).
- Nowe odczyty trafiają do tego okresu. Widzisz je u klienta w kafelku **Odczyty**, a przy liczniku w kafelku **Zużycie**.
- Gdy zajęcie miejsca się kończy, Tillor zamyka okres. Potem możesz zafakturować zużycie, zobacz [Fakturowanie zużycia](/meterbeheer/verbruik-factureren).
- Jeśli później przypiszesz dodatkowy licznik do działki z trwającym zajęciem miejsca, okres zużycia dla tego licznika zacznie się, gdy wprowadzisz jego odczyt.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę licznika na liście w Dodaj licznik">
Lista pokazuje tylko liczniki bez działki. Jeśli licznik jest już przypisany do innej działki, przejdź do tej działki i wybierz **Odłącz od działki**.
</Accordion>
<Accordion title="Nie znaleziono dostępnych działek">
Wszystkie działki mają już aktywne zajęcie miejsca. Najpierw zakończ zajęcie miejsca na działce, której chcesz użyć, albo utwórz nową działkę.
</Accordion>
<Accordion title="Odłącz od działki nie ma w menu licznika">
Ta opcja jest tylko w menu (...) na stronie działki, w kafelku **Liczniki**. Tillor pokazuje **Nie udało się odłączyć licznika**, jeśli się nie udało; spróbuj wtedy jeszcze raz.
</Accordion>
<Accordion title="Klient nie widzi zużycia licznika">
Sprawdź trzy rzeczy: czy licznik jest przypisany do działki, czy klient ma na tej działce aktywne zajęcie miejsca i czy po starcie wpłynął jakiś odczyt. Bez zajęcia miejsca zużycie nie należy do nikogo.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Fakturowanie zużycia" href="/meterbeheer/verbruik-factureren" />
  <Card title="Działki" href="/terreinen" />
  <Card title="Zajęcia miejsc" href="/bezettingen" />
</Cards>


# Usuwanie licznika (/pl-PL/meterbeheer/meter-verwijderen)

Licznik, który już nie istnieje, usuwasz w trzech krokach. Nie można tego cofnąć. Jeśli chcesz tylko zdjąć licznik z działki, odłącz go, zobacz [Przypisanie licznika do klienta](/meterbeheer/meter-koppelen#een-meter-loskoppelen).

<Requires permission="Edycja: liczniki" />

<Steps>
<Step>
### Otwórz menu akcji [#open-het-actiemenu]
Kliknij trzy kropki przy liczniku, na liście lub na stronie licznika, i wybierz **Usuń licznik**.

<DocScreenshot src="/screenshots/meterbeheer/meter-actions-menu.png" alt="Menu akcji licznika z opcją Usuń licznik" />
</Step>
<Step>
### Krok 1 z 3: Kontynuuj [#stap-1-van-3-doorgaan]
Czytasz, że licznik zniknie dla wszystkich w Twojej organizacji. Kliknij **Kontynuuj** albo **Anuluj**, aby przerwać.

<DocScreenshot src="/screenshots/meterbeheer/meter-delete-dialog.png" alt="Krok 1 usuwania licznika" />
</Step>
<Step>
### Krok 2 z 3: sprawdź, co zniknie [#stap-2-van-3-bekijk-wat-verdwijnt]
Widzisz wszystkie odczyty ze zdjęciami, uwagi, alarmy i odchylenia oraz liczbę okresów zużycia. Okresy zużycia, które nie zostały jeszcze zafakturowane, są na czerwono. Jeśli licznik jest nadal przypisany do działki, też to zobaczysz. Kliknij **Kontynuuj**.
</Step>
<Step>
### Krok 3 z 3: wpisz nazwę [#stap-3-van-3-typ-de-naam]
Wpisz nazwę licznika. Dopiero wtedy przycisk **Usuń na stałe** stanie się aktywny.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Licznik, jego odczyty, zdjęcia, uwagi i alarmy znikają, także dla Twoich współpracowników.
- Okresów zużycia, które nie były jeszcze zafakturowane, nie możesz już zafakturować. Zafakturuj je lub oznacz najpierw, zobacz [Fakturowanie zużycia](/meterbeheer/verbruik-factureren).
- Jeśli usuwasz licznik na jego własnej stronie, wracasz potem do listy liczników.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Przycisk Usuń na stałe jest szary">
Musisz dokładnie przepisać nazwę licznika. Sprawdź wielkie litery i spacje.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się usunąć licznika">
Licznik nie został usunięty. Spróbuj ponownie; jeśli nadal się nie udaje, skontaktuj się z pomocą techniczną.
</Accordion>
<Accordion title="Nie widzę Usuń licznik w menu">
Potrzebujesz uprawnienia **Edycja: liczniki**. Poproś o nie administratora.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Przypisanie licznika do klienta" href="/meterbeheer/meter-koppelen" />
  <Card title="Fakturowanie zużycia" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Podgląd odczytów i trendów (/pl-PL/meterbeheer/meterstanden-en-trends)

Na stronie licznika widzisz ostatni stan, kto aktualnie z niego korzysta i jak rozwija się zużycie. Dzięki temu szybko sprawdzisz, czy licznik robi to, co powinien, i czy dzieje się coś dziwnego. Chcesz rozliczyć zużycie? Przejdź do [Fakturowanie zużycia](/meterbeheer/verbruik-factureren).

## Otwórz licznik [#een-meter-openen]

<Steps>
<Step>
### Przejdź do Park > Liczniki [#ga-naar-park--meters]
Widzisz wszystkie liczniki z kolumnami **Nazwa**, **Typ** (woda, prąd lub gaz), **Dostawca**, **Moduł** (Campère lub PRM, tylko przy licznikach ICY), **Działka** i **Ostatni odczyt** z datą. Liczniki z aktywnym alarmem mają trójkącik.
</Step>
<Step>
### Kliknij licznik [#klik-op-de-meter]
Na górze widzisz dane licznika, a poniżej m.in. kafelki **Informacje**, **Zużycie**, **Zużycie i trendy**, alarmy i aktywność.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Szczegóły licznika z kafelkiem Zużycie" />

Co gdzie jest:

- **Informacje**: numer seryjny, typ, działka, ostatni pomiar i, jeśli licznik to przekazuje, poziom baterii. Przy liczniku ICY widzisz też, jaki **Moduł** jest na tym miejscu (Campère lub PRM), przez jaki **Kontroler** ten moduł się komunikuje (z nazwą szafki licznikowej tego kontrolera), **Czas wyłączenia** ustawiony w ICY i, jeśli ICY go zna, **Numer seryjny modułu**.
- **Klient** w nagłówku: klient z aktywnym zajęciem miejsca na działce licznika. Jeśli widzisz **Brak klienta**, działka nie jest zajęta albo licznik nie jest nigdzie przypisany.
- **Zużycie**: dla każdego klienta zużycie niezafakturowane i rozliczone.
- **Aktywność**: pod kafelkiem **Zużycie** oś czasu z utworzeniem licznika, zmianami oraz ręcznie wprowadzonymi, zmienionymi lub usuniętymi odczytami. Znajdziesz tam też zmiany, które Tillor wykrywa w ICY, takie jak inny numer seryjny czy inny czas wyłączenia modułu.

## Czytanie zużycia i trendów [#verbruik-en-trends-lezen]

Na górze kafelka **Zużycie i trendy** widzisz zużycie za **Ten tydzień** i **Poprzedni tydzień**, różnicę **vs poprzedni tydzień** oraz średnią tygodniową (**Śr. / tydzień**). Jeśli licznik ma jeszcze za mało historii, zobaczysz **Za mało historii**.

<DocScreenshot src="/screenshots/meterbeheer/meter-consumption-trends.png" alt="Zużycie i trendy licznika" />

Pod wykresem są **Wnioski**: prognoza na najbliższe 30 dni, suma w wybranym okresie, dzień szczytowy, dni bez zużycia i przebieg. Jeśli zużycie z ostatnich 7 dni jest znacznie powyżej normy, zobaczysz **Podwyższone zużycie** wraz z pogodą z tych dni. Zobacz [Pogoda](/weer).

<Tabs items={["Dziennie lub godzinowo", "Wybór okresu"]}>
<Tab value="Dziennie lub godzinowo">
Przyciskami w prawym górnym rogu kafelka przełączasz **Podział** między **Dziennie** a **Godzinowo** oraz **Typ wykresu** między obszarowym a słupkowym. Widok godzinowy pokazuje zużycie godzinowe jako słupki; godzina, która jeszcze trwa, ma oznaczenie **w trakcie**.

- Jeśli wybierzesz okres dwóch dni lub krótszy, jak **Dzisiaj** lub **Wczoraj**, wykres automatycznie pokazuje słupki godzinowe.
- Przy dłuższym okresie **Godzinowo** pokazuje ostatnie 31 dni.
</Tab>
<Tab value="Wybór okresu">
Kliknij przycisk kalendarza w prawym górnym rogu. Po lewej wybierasz szybki okres: **Dzisiaj**, **Wczoraj**, **Ostatnie 7 dni**, **Ostatni miesiąc**, **Ostatnie 3 miesiące** lub **Wszystko**. Po prawej wybierasz w kalendarzu **Data rozpoczęcia** i **Data końcowa** i potwierdzasz przyciskiem **Zastosuj**. Kliknięcie jednego dnia pokazuje tylko ten dzień. Możesz też zmienić godzinę początku i końca.

<DocScreenshot src="/screenshots/meterbeheer/meter-period-picker.png" alt="Wybór okresu z szybkimi okresami i kalendarzem" />
</Tab>
</Tabs>

## Liczniki z możliwością przełączania [#schakelbare-meters]

Dla liczników, które możesz włączać i wyłączać zdalnie, jak ICY, wykres historii pokazuje też stan włączony/wyłączony. Zielona linia oznacza, że licznik był włączony. Czerwona linia z przerywanymi znacznikami oznacza wyłączony. Jeśli odczyt nie ma danych o włączeniu lub wyłączeniu, liczy się jako włączony.

Przy liczniku ICY w menu akcji w sekcji **Natężenie** wybierasz, ile amperów dostaje miejsce. Widzisz tylko wartości do maksimum ustawionego w ICY dla modułu na tym miejscu: jeśli to 16 A, wartości 20 A i 25 A nie ma na liście.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Nic się nie zmienia w Twoich danych: to tylko widoki. Trendy i pogoda są aktualizowane, gdy tylko wpłyną nowe odczyty.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Widzę Za mało historii">
Licznik nie ma jeszcze wystarczająco dużo dni z pomiarami, aby porównać z poprzednim tygodniem. Wróć później.
</Accordion>
<Accordion title="Wykres jest pusty i widzę Brak dostępnego zużycia">
Dla wybranego okresu nie ma zużycia. Wybierz dłuższy okres, na przykład **Wszystko**.
</Accordion>
<Accordion title="Ostatni stan jest stary">
Sprawdź w [Alarmy i status licznika](/meterbeheer/alarmen-en-status), czy jest alarm albo awaria odbiornika.
</Accordion>
<Accordion title="W sekcji Natężenie nie ma wartości, której potrzebuję">
Tillor nie oferuje wartości powyżej maksimum ustawionego w ICY dla modułu na tym miejscu. Jeśli to maksimum jest nieprawidłowe, skontaktuj się z ICY.
</Accordion>
<Accordion title="Przy Klient widzę Brak klienta">
Na działce licznika nie ma aktywnego zajęcia miejsca albo licznik nie jest przypisany do żadnej działki (**Brak działki**). Zobacz [Przypisanie licznika do klienta](/meterbeheer/meter-koppelen).
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Alarmy i status licznika" href="/meterbeheer/alarmen-en-status" />
  <Card title="Pogoda" href="/weer" />
  <Card title="Fakturowanie zużycia" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Fakturowanie zużycia (/pl-PL/meterbeheer/verbruik-factureren)

Zużycie klienta jest gotowe do zafakturowania, gdy tylko pojawi się okres zużycia ze zużyciem. Jednym przyciskiem umieszczasz je na fakturze albo pozwalasz Tillor fakturować automatycznie w ustalonym dniu. Jak okres powstaje i się zamyka, przeczytasz w [Okresy zużycia](/meterbeheer/consumptie-batches).

Zanim zaczniesz:

- Klient ma lub miał zajęcie miejsca na działce z licznikami. Bez zajęcia miejsca nie ma zużycia do zafakturowania, zobacz [Przypisanie licznika do klienta](/meterbeheer/meter-koppelen).
- Jest niezafakturowane zużycie. Jeśli widzisz **Nie znaleziono liczników z zaległym zużyciem.**, nie ma czego fakturować.

## Fakturowanie zużycia [#verbruik-factureren]

<Tabs items={["Od klienta", "Wszyscy klienci", "Zafakturowane poza Tillor"]}>
<Tab value="Od klienta">
<Steps>
<Step>
### Otwórz klienta [#open-de-klant]
Przejdź do <UIPath>Klienci > Przegląd</UIPath>, otwórz klienta i spójrz na kafelek **Odczyty**. Znajdziesz tam dla każdego licznika otwarte okresy.
</Step>
<Step>
### Kliknij Zafakturuj zużycie [#klik-op-factureer-verbruik]
Tillor umieszcza na fakturze dla każdego okresu pozycję główną z kwotą, a pod nią pozycję informacyjną z datami i stanami licznika. Jeśli jest już odpowiednia faktura robocza, Tillor dodaje pozycje do niej.
</Step>
<Step>
### Wybierz sam liczniki i fakturę [#kies-zelf-welke-meters-en-welke-factuur]
Otwórz strzałkę obok przycisku i wybierz **Dodaj z wyborem...**. W **Zaawansowane fakturowanie** wybierasz istniejącą fakturę roboczą w polu **Faktura (opcjonalnie)** albo zostawiasz je puste, aby utworzyć nową fakturę. W **Wybierz liczniki** zaznaczasz, które liczniki mają być uwzględnione.
</Step>
</Steps>
</Tab>
<Tab value="Wszyscy klienci">
Przejdź do <UIPath>Klienci > Niezafakturowane zużycie</UIPath>. Widzisz klientów z zużyciem, które trzeba jeszcze zafakturować, z łączną kwotą przy każdym. Domyślnie są tu tylko klienci bez automatycznego fakturowania. Fakturuj bezpośrednio z wiersza.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Klienci > Niezafakturowane zużycie" />
</Tab>
<Tab value="Zafakturowane poza Tillor">
Jeśli zużycie zafakturowałeś gdzie indziej, oznaczasz je bez faktury:

1. Otwórz okres w kafelku **Odczyty** (profil klienta) lub **Zużycie** (<UIPath>Park > Liczniki</UIPath> > licznik).
2. Kliknij ikonę ostrzeżenia obok okresu.
3. Potwierdź przyciskiem **Tak, oznacz jako zafakturowane**.

<Callout type="warn" title="Uwaga">
Tillor nie tworzy tu faktury. Tylko okresy oznaczone w ten sposób cofniesz ikoną cofania przy rozliczonych okresach. Okres powiązany z prawdziwą fakturą zostaje zwolniony dopiero po usunięciu tej faktury.
</Callout>
</Tab>
</Tabs>

## Automatyczne fakturowanie [#automatisch-factureren]

Jeśli u klienta włączone jest automatyczne fakturowanie mediów, Tillor w wybranym dniu sam tworzy fakturę i ją wysyła. Ustawiasz to w profilu klienta.

Dwie zasady decydują, czy faktura rzeczywiście powstanie:

- **Kwota minimalna.** Jeśli kwota do zapłaty jest niższa, Tillor czeka do kolejnego dnia fakturowania. Minimum dla wszystkich klientów znajdziesz w **Ustawienia > Fakturowanie** jako **Minimalna kwota automatycznych faktur za media**. W profilu klienta możesz w ustawieniach faktur wpisać własną **Kwota minimalna**, która ma pierwszeństwo dla tego klienta. Jeśli zostawisz oba pola puste, fakturowana jest każda kwota.
- **Zużycie znacznie powyżej zwykłego.** Jeśli niezafakturowane zużycie prądu lub wody jest co najmniej dwukrotnie wyższe niż zwykle u klienta, Tillor nie tworzy faktury. Dostajesz e-mail na adres wsparcia Twojej organizacji, a faktura nie powstaje, dopóki ktoś jej nie sprawdzi.

Tillor porównuje każdy typ sam ze sobą: prąd z wcześniejszym prądem, wodę z wcześniejszą wodą. Zwykłe zużycie to wartość środkowa z ostatnich faktur danego typu. Nie ma stałej granicy w m³ ani kWh. Jeśli klient nie ma jeszcze wcześniejszej faktury dla danego typu, faktura wychodzi automatycznie.

Jeśli po sprawdzeniu stan licznika się zgadza, fakturujesz zużycie samodzielnie z profilu klienta albo przez **Klienci > Niezafakturowane zużycie**. Ustaw tam filtr **Automatyczne fakturowanie** na **Z datą**, aby zobaczyć wstrzymanych klientów.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Okresy przechodzą z niezafakturowanych do rozliczonych. Jeśli zajęcie miejsca jest nadal aktywne, Tillor od razu otwiera nowy okres od stanu końcowego, aby nie było luki.
- Pozycje znajdują się na fakturze roboczej. Zaksięguj i wyślij ją jak każdą inną fakturę, zobacz [Faktury](/facturen).
- Jeśli ponownie usuniesz fakturę roboczą, zużycie znów jest dostępne. Zobacz [Usuwanie faktury](/meterbeheer/consumptie-batches#factuur-verwijderen).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pokazuje Błąd fakturowania">
Nie udało się umieścić zużycia na fakturze. Spróbuj ponownie. Jeśli nie działa z wybraną fakturą roboczą, wybierz **Utwórz nową fakturę**.
</Accordion>
<Accordion title="Automatyczna faktura nie powstała i dostałem e-mail">
Zużycie było co najmniej dwa razy wyższe niż zwykle. Sprawdź stan licznika i zafakturuj samodzielnie, jeśli wszystko się zgadza.
</Accordion>
<Accordion title="Klienta nie ma w Niezafakturowane zużycie">
Lista domyślnie pokazuje tylko klientów bez automatycznego fakturowania. Ustaw filtr **Automatyczne fakturowanie** na **Z datą**, aby zobaczyć pozostałych klientów. Jeśli klienta nadal nie ma, nie ma niezafakturowanego zużycia.
</Accordion>
<Accordion title="Nie ma nic do zafakturowania, mimo że klient zużył wodę">
Sprawdź, czy klient ma aktywne zajęcie miejsca na działce, na której jest licznik, i czy po stanie początkowym wpłynął jakiś odczyt. Okres bez zużycia nie daje kwoty.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Okresy zużycia" href="/meterbeheer/consumptie-batches" />
  <Card title="Faktury" href="/facturen" />
  <Card title="Zarządzanie klientami" href="/klantenbeheer" />
</Cards>


# Przegląd (/pl-PL/nfc)

Tag NFC to karta, opaska, brelok lub naklejka, którą klient przykłada do czytnika, jak przy płatności zbliżeniowej. Dzięki niej bierze prysznic, otwiera drzwi lub ładuje samochód. Na tej stronie zobaczysz, jak tag, klient i saldo do siebie pasują. Kroki do przypisania lub doładowania tagu znajdziesz w [Zarządzanie tagami](/nfc/nfc-tags).

Wszystkie tagi swojej organizacji znajdziesz na stronie **Kontrolery**, w kafelku **Tagi NFC**.

<DocScreenshot src="/screenshots/nfc/nfc-tags-list.png" alt="Kafelek Tagi NFC na stronie Kontrolery" />

<Callout type="info" title="Warto wiedzieć">
- Tag pojawia się w Tillor sam, gdy po raz pierwszy zostanie przyłożony do czytnika. Nie tworzysz go samodzielnie.
- Tag należy najwyżej do jednego klienta i ma status **Aktywny**, **Nieaktywny** lub **Zablokowany**.
- Saldo na tagu jest w euro. Zmiana salda jest zawsze zapisywana jako transakcja i nie można jej edytować ani usunąć.
- Płatność, która ma jeszcze zostać zapisana na tagu, pozostaje otwarta przez 2 minuty. Potem wygasa.
- Zablokowany tag przestaje działać przy czytnikach.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Sam tag o niczym nie wie. Tillor zapamiętuje, kto go ma, jakie jest saldo i dokąd tag ma dostęp. Czytnik pyta o to Tillor w chwili, gdy klient przykłada tag.

```mermaid
flowchart TD
  K[Klient] --> T[Tag NFC]
  T --> G[Grupy dostępu<br/>dokąd tag ma dostęp?]
  T --> S[Saldo<br/>ile środków jest na nim?]
  L[Czytnik przy prysznicu, drzwiach lub stacji ładowania] -->|klient przykłada tag| T
  L --> TR[Transakcja<br/>kwota, powód i czytnik]
  S --> TR
```

- Bez klienta czytnik odrzuca tag. Na ekranie widać wtedy **Tag nie jest przypisany**.
- Bez odpowiedniej grupy dostępu czytnik odrzuca tag komunikatem **Brak dostępu**.
- Bez wystarczającego salda widać **Niewystarczające saldo**. Wszystkie komunikaty ekranowe znajdziesz w [Komunikaty ekranowe](/controllers/troubleshooting/scherm).
- Każde obciążenie lub doładowanie trafia jako wiersz do [transakcji](/nfc/nfc-transacties).
- Tag jest też metodą dostępu. Dodajesz go klientowi w [Kontrola dostępu](/toegangscontrole#een-toegangsmethode-toevoegen).

## Elementy [#onderdelen]

<Cards>
  <Card title="Zarządzanie tagami" href="/nfc/nfc-tags" description="Przypisywanie tagów klientom i edycja salda" />
  <Card title="Transakcje" href="/nfc/nfc-transacties" description="Całe użycie i zmiany salda" />
  <Card title="Kontrolery" href="/controllers" description="Czytniki, do których klienci przykładają tag" />
</Cards>

## Pojęcia [#begrippen]

- **Tag**: karta, opaska, naklejka lub brelok.
- **UID**: unikalny numer tagu.
- **Saldo**: środki na tagu.
- **Grupa dostępu**: określa, dla których czytników tag obowiązuje.
- **Transakcja**: obciążenie lub doładowanie salda.

Więcej wyjaśnień znajdziesz w [słowniku pojęć](/begrippen).


# Zarządzanie tagami (/pl-PL/nfc/nfc-tags)

Tag NFC jest użyteczny dopiero wtedy, gdy jest przypisany do klienta. Wtedy klient może nim brać prysznic, otwierać drzwi lub ładować, a Ty możesz pilnować salda. Wszystkie poniższe kroki wykonujesz w profilu klienta. Co dzieje się przy każdym przyłożeniu, przeczytasz w [Transakcje](/nfc/nfc-transacties).

Zanim zaczniesz:

- Tag musi już być w Tillor. Dzieje się to samo, gdy po raz pierwszy zostanie przyłożony do czytnika.
- Tag nie może być jeszcze przypisany do innego klienta. W przeciwnym razie nie ma go na liście.
- Jeśli nie ma wolnego tagu, lista pokazuje **Nie znaleziono dostępnych tagów**.

## Przypisanie tagu do klienta [#een-tag-koppelen-aan-een-klant]

<Steps>
<Step>
### Otwórz kartę Tagi NFC [#open-het-tabblad-nfc-tags]
Przejdź do <UIPath>Klienci > klient > Tagi NFC</UIPath>. Widzisz wszystkie tagi tego klienta. Nad tabelą filtrujesz według **UID** i **Typ** (**Karta**, **Opaska**, **Naklejka** lub **Brelok**).
</Step>
<Step>
### Wybierz tag [#kies-de-tag]
Kliknij **Wybierz kartę** i wybierz tag. Na liście możesz wyszukiwać.
</Step>
<Step>
### Kliknij Przypisz [#klik-op-toewijzen]
Tillor pokazuje **Karta przypisana do klienta** i tag jest w tabeli.
</Step>
</Steps>

W tabeli widzisz dla każdego tagu **UID** (ikona wskazuje typ), **Status**, **Saldo**, kiedy był **Ostatnio używany** i **Grupy dostępu**.

## Co możesz zrobić z tagiem? [#wat-kun-je-met-een-tag-doen]

Otwórz menu akcji (trzy kropki) przy tagu.

<DocScreenshot src="/screenshots/nfc/nfc-tag-actions-menu.png" alt="Menu akcji tagu NFC" />

| Akcja | Co robi |
|---|---|
| **Edytuj saldo** | Dodaje kwotę lub ustawia saldo, zobacz poniżej. |
| **Zablokuj** / **Odblokuj** | Ustawia status **Zablokowany** lub przywraca go. |
| **Grupy dostępu** | Określa, dla których grup dostępu tag obowiązuje. |
| **Wyślij powiadomienie o niskim saldzie** | Wysyła klientowi powiadomienie, że saldo jest niskie. |
| **Kopiuj osobisty URL** | Kopiuje link do własnej strony tagu. |
| **Usuń z klienta** | Odłącza tag od klienta. |
| **Zobacz szczegóły** | Otwiera stronę szczegółów z transakcjami i aktywnością. |

### Zmiana salda [#het-saldo-aanpassen]

<Steps>
<Step>
### Wybierz Edytuj saldo [#kies-saldo-bewerken]
Otwórz menu akcji i wybierz **Edytuj saldo**.
</Step>
<Step>
### Wybierz, jak zmieniasz saldo [#kies-hoe-je-het-saldo-wijzigt]
<DocScreenshot src="/screenshots/nfc/nfc-tag-topup-dialog.png" alt="Okno Edytuj saldo" />

W polu **Opcja** wybierz **Dodaj saldo** (kwota do obecnego salda) lub **Ustaw saldo** (dokładna kwota). Na dole widzisz wynik, na przykład **Bieżące: ... → Nowe: ...**.
</Step>
<Step>
### Potwierdź [#bevestig]
Wpisz kwotę i kliknij **Dodaj** lub **Ustaw**. Kwota musi być dodatnia. Tillor pokazuje **Saldo zaktualizowane** lub **Saldo ustawione**.
</Step>
</Steps>

### Blokowanie tagu [#een-tag-blokkeren]

Zgubiony lub skradziony tag blokujesz przez **Zablokuj**. Status zmienia się na **Zablokowany** i tag przestaje działać przy czytnikach. Przez **Odblokuj** w tym samym menu zdejmujesz blokadę. Klient może też sam zablokować swój tag na stronie osobistej.

### Wybór grup dostępu [#toegangsgroepen-kiezen]

Wybierz **Grupy dostępu** i zaznacz lub odznacz grupy. Zmiana obowiązuje od razu. Jeśli widzisz **Brak dostępnych grup dostępu**, Twoja organizacja nie ma jeszcze skonfigurowanych grup.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Przypisany tag pojawia się w tabeli i u klienta. Gdy klient przyłoży go do czytnika, czytnik pyta Tillor, czy to dozwolone.
- Każda zmiana salda staje się [transakcją](/nfc/nfc-transacties), także gdy zmieniasz saldo ręcznie. Powód to wtedy **Korekta ręczna**.
- W sekcji **Aktywność** na stronie szczegółów widzisz stan przed i po każdej zmianie (saldo, blokada, powiązanie z klientem).
- Przy **Usuń z klienta** tag nadal istnieje. Można go znów przypisać innemu klientowi. Transakcje są zachowane.
- Przez **Kopiuj osobisty URL** klient dostaje własną stronę. Może na niej zablokować swoją kartę i, jeśli masz skonfigurowane płatności online, sam ją doładować. Powstaje wtedy faktura dla klienta.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Lista tagów jest pusta">
Tillor pokazuje **Nie znaleziono dostępnych tagów**. Na liście są tylko tagi, które nie należą jeszcze do nikogo. Odłącz tag od innego klienta przez **Usuń z klienta** albo przyłóż nowy tag do czytnika, aby pojawił się w Tillor.
</Accordion>
<Accordion title="Tillor pokazuje: Aktualizacja nie powiodła się">
Nie udało się zapisać salda lub grup dostępu. Spróbuj ponownie. Jeśli nadal się nie udaje, odśwież stronę i sprawdź, czy tag nadal jest przypisany do klienta.
</Accordion>
<Accordion title="Klient jest odrzucany przy czytniku">
Przeczytaj powód na ekranie kontrolera, zobacz [Komunikaty ekranowe](/controllers/troubleshooting/scherm). Zwykle tag jest **Zablokowany**, nie jest przypisany do klienta, nie ma właściwej grupy dostępu albo saldo jest za niskie.
</Accordion>
<Accordion title="Tillor pokazuje: Kwota musi być dodatnia">
Kwota musi być wpisana i większa od zera. W przeciwnym razie Tillor pokazuje **Kwota jest wymagana**, **Nieprawidłowa kwota** lub **Kwota musi być dodatnia**.
</Accordion>
<Accordion title="Klient nie może sam doładować">
Doładowanie przez stronę osobistą działa tylko wtedy, gdy Twoja organizacja ma skonfigurowane płatności online i tag jest przypisany do klienta. Zobacz [Przetwarzanie płatności](/betalingsverwerking).
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Transakcje" href="/nfc/nfc-transacties" description="Podgląd historii transakcji" />
  <Card title="Kontrola dostępu" href="/toegangscontrole" description="Szlabany i metody dostępu" />
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Zarządzanie profilami klientów" />
</Cards>


# Transakcje (/pl-PL/nfc/nfc-transacties)

Każda zmiana salda tagu NFC jest zapisywana jako transakcja, także ręczna korekta. Dzięki temu dokładnie widzisz, kiedy i dlaczego saldo się zmieniło. Transakcji nie można edytować ani usuwać.

## Podgląd transakcji [#transacties-bekijken]

<Steps>
<Step>
### Otwórz tag [#open-de-tag]
Przejdź do <UIPath>Klienci > klient > Tagi NFC</UIPath>, otwórz menu akcji (trzy kropki) przy tagu i wybierz **Zobacz szczegóły**.
</Step>
<Step>
### Zajrzyj do Transakcje [#kijk-bij-transacties]
Kafelek **Transakcje** jest na stronie szczegółów. Najnowsza jest na górze. Przy więcej niż pięciu transakcjach strony przełączasz na dole.

<DocScreenshot src="/screenshots/nfc/nfc-tag-detail.png" alt="Strona szczegółów tagu NFC z transakcjami" />
</Step>
</Steps>

Nad tabelą są filtry **Data**, **Status**, **Źródło** i **Powód anulowania**. Domyślnie włączone są **Oczekująca** i **Zatwierdzona**. Jeśli chcesz zobaczyć też anulowane i wygasłe transakcje, kliknij **Wyczyść filtry**.

## Kolumny [#kolommen]

| Kolumna | Znaczenie |
|---|---|
| **Kwota** | Zmiana salda. Dodatnia przy doładowaniu, ujemna przy użyciu. |
| **Powód** | Przyczyna, na przykład **Korzystanie z prysznica przy** kontrolerze, **Obciążenie POS**, **Doładowanie POS**, **Korekta ręczna** lub **Dodano, ponieważ faktura ... została opłacona**. |
| **Kontroler** | Kontroler, który wywołał transakcję. Jeśli widzisz **System**, nie było kontrolera: to ręczna zmiana, aplikacja recepcji lub opłacona faktura. |
| **Data** | Data i godzina. |
| **Status** | Zobacz poniżej. |
| **Źródło** | **Online** lub **Offline**. |
| **Opis**, **Powód anulowania** | Dodatkowe wyjaśnienie, a przy anulowanej transakcji powód. |

## Statusy [#statussen]

| Status | Znaczenie |
|---|---|
| <Status tone="info">Oczekująca</Status> | Obciążenie jest zarezerwowane i musi jeszcze zostać zapisane na tagu. |
| <Status tone="success">Zatwierdzona</Status> | Transakcja jest zakończona, a saldo zostało zmienione. |
| <Status tone="error">Anulowana</Status> | Transakcja nie doszła do skutku. Powód jest w **Powód anulowania**. |
| <Status>Wygasła</Status> | Tag nie został przyłożony do czytnika na czas. Rezerwacja pozostaje otwarta przez 2 minuty. |

Możliwe powody anulowania to **Niewystarczające saldo**, **Brak autoryzacji**, **Zapis na karcie nie powiódł się** i **Wygasła**.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Transakcja oczekująca staje się <Status tone="success">Zatwierdzona</Status>, gdy tag otrzyma nowe saldo. Jeśli to się nie uda w ciągu 2 minut, staje się <Status>Wygasła</Status> i saldo się nie zmienia.
- W polu **Źródło** widać **Offline**, jeśli transakcja nie przebiegła na żywo przez Tillor.
- Recepcjonista może w aplikacji Tillor wykonać to samo obciążenie lub doładowanie. Saldo jest wtedy aktualizowane tylko w Tillor. Widać to jako **Obciążenie POS** lub **Doładowanie POS**, bez kontrolera.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Saldo nie zgadza się z tym, czego spodziewa się klient">
Otwórz transakcje i sprawdź powód oraz datę ostatnich wierszy. Wiersz z **Korekta ręczna** został wprowadzony przez współpracownika. Jeśli widzisz transakcje ze statusem **Wygasła** lub **Anulowana**, nic z nich nie zostało pobrane.
</Accordion>
<Accordion title="Transakcja ma status Oczekująca i nie znika">
Poczekaj, aż minie 2 minuty. Transakcja stanie się wtedy <Status>Wygasła</Status>. Poproś klienta, aby ponownie przyłożył tag do czytnika.
</Accordion>
<Accordion title="Kafelek Transakcje jest pusty">
Tag nie był jeszcze używany, a saldo nie było zmieniane. Nie ma więc nic do pokazania.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie tagami" href="/nfc/nfc-tags" description="Przypisywanie kart i edycja salda" />
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Podgląd profili klientów" />
</Cards>


# Powiadomienia (/pl-PL/notificaties)

Przegląd powiadomień pokazuje każdą wiadomość, którą Tillor wysłał do klientów i współpracowników: e-mailem, SMS-em, pocztą, przez WhatsApp lub push. Jednym spojrzeniem widzisz, które wiadomości dotarły, które są jeszcze w drodze, a które się nie powiodły. Samodzielne wysłanie wiadomości o fakturze opisujemy w [Wysyłanie faktury lub wezwania do zapłaty](/communicatie/e-mails).

Przegląd otwierasz przez <UIPath>Komunikacja > Powiadomienia</UIPath>.

<Callout type="info" title="Warto wiedzieć">
- Jeśli wiadomość utknie na dłużej niż 5 minut bez przekazania dalej, Tillor automatycznie próbuje ją wysłać ponownie
- Jeśli po 2 dniach nadal nie doszło do wysyłki, Tillor ustawia wiadomość jako **Niepowodzenie**. Dotyczy to także SMS-a, który tak długo pozostaje w stanie **Oczekujące**
- Lista **Ostatnia komunikacja** domyślnie pokazuje 50 wiadomości na stronę
- Kliknięcie linku w e-mailu lub SMS-ie liczy się dopiero wtedy, gdy nastąpi co najmniej około półtorej sekundy po wysłaniu. Dzięki temu programy pocztowe, które pobierają linki z wyprzedzeniem, nie są liczone jako kliknięcie
- Wiadomości o fakturze nie wychodzą automatycznie po zaksięgowaniu faktury. To Ty uruchamiasz wysyłkę
- Karta z nowym powiadomieniem w Tillor znika po kilku sekundach. Powiadomienie pozostaje w dzwonku, dopóki go nie przeczytasz
- Powiadomień, które są wysyłane zawsze, nie można wyłączyć
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Wiadomość zaczyna się od jakiegoś powodu. Następnie Tillor wybiera kanał i zapisuje wynik w przeglądzie.

```mermaid
flowchart LR
  A[Klikasz Wyślij powiadomienie] --> D[Wiadomość]
  B[Coś się dzieje, np. alarm licznika] --> D
  C[Automatyzacja wysyła wiadomość] --> D
  D --> E{Dla kogo?}
  E -- Klient --> F[E-mail, SMS, poczta lub WhatsApp]
  E -- Współpracownik --> G[Push, e-mail lub telefon, zgodnie z jego preferencjami]
  F --> H[Powiadomienia: status dla każdego kanału]
  G --> H
  G --> I[Dzwonek w Tillor]
  H --> J[Widoczne także u klienta i na fakturze]
```

- **Do klienta** kanał zwykle wybierasz sam, na przykład w oknie **Wyślij powiadomienie** na fakturze. [Automatyzacja](/begrippen#automatisering) także może wysłać wiadomość do klienta.
- **Do współpracownika**: to on sam decyduje, jak Tillor ma się z nim kontaktować, osobno dla każdego typu powiadomienia. Zobacz [Powiadomienia w aplikacji](#meldingen-in-de-app).
- **Wynik** widzisz tutaj, a także u klienta i na fakturze, do których wiadomość należy. Kolumna **Źródło** prowadzi Cię tam bezpośrednio.

## Przeglądanie powiadomień [#notificaties-bekijken]

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Przegląd powiadomień ze statystykami i listami" />

Na górze znajdują się cztery statystyki:

- **Łączna liczba powiadomień**: wszystkie próby wysyłki
- **Wysłane powiadomienia**: wiadomości, które zostały dostarczone
- **Nieudane powiadomienia**: wiadomości, których nie udało się dostarczyć
- **Odrzucone powiadomienia**: wiadomości, które wróciły, głównie e-maile

Poniżej są cztery listy: **Odrzucone powiadomienia**, **Oczekujące powiadomienia** (jeszcze w kolejce lub w drodze), **Ostatnia komunikacja** (wszystkie statusy) i **Nieudane powiadomienia**. Filtry **Typ** i **Kanał** nad każdą listą zawężają to, co widzisz. Jakie są typy, opisujemy w [Typy powiadomień](/communicatie/notificatietypes).

Każdy wiersz pokazuje:

| Kolumna | Co widzisz |
|---|---|
| **Typ** | Rodzaj wiadomości, np. Nowa faktura lub Alarm licznika lub kontrolera |
| **Źródło** | Faktura, klient lub płatność, do których należy wiadomość |
| **Kanał** | E-mail, SMS, Poczta, WhatsApp lub Push |
| **Status** | Status doręczenia |
| **Odbiorca** | Adres e-mail, numer telefonu, adres pocztowy lub użytkownik |
| **Data** | Kiedy utworzono próbę wysyłki |

### Przeglądanie szczegółów dostarczenia [#leveringsdetails-bekijken]

Kliknij kanał w wierszu, aby zobaczyć, co dokładnie zostało wysłane i co się wydarzyło.

<DocScreenshot src="/screenshots/notificaties/notifications-delivery-detail.png" alt="Szczegóły dostarczenia e-maila Nowa faktura" />

Okno pokazuje status doręczenia, ewentualny komunikat o błędzie, odbiorcę (**Do**), adres nadawcy (**Od**) oraz **Temat** w przypadku e-maila. Widzisz też, kiedy wiadomość była gotowa (**Utworzono**) i kiedy faktycznie wyszła (**Wysłano**). **Wysłane przez** pokazuje użytkownika, który uruchomił wysyłkę, lub **System**, jeśli stało się to automatycznie. Na dole znajdują się **Treść** i ewentualne **Załączniki**.

W przypadku e-maila i WhatsApp widzisz także **Odczytano**, a na liście ikonę oka przy przeczytanych wiadomościach. W przypadku e-maila i SMS-a pojawia się **Kliknięto**, jeśli klient kliknął link.

W przypadku poczty są dodatkowe pola: **Referencja przewoźnika**, **Status śledzenia** i **Ostatnia aktualizacja śledzenia** (ostatnie zdarzenie od operatora pocztowego), **Koszt przesyłki** w chwili wysyłki oraz, przy przesyłce poleconej, etykieta **List polecony** z dodatkowymi kosztami i objaśnieniem rozliczenia.

<DocScreenshot src="/screenshots/notificaties/notifications-post-registered-detail.png" alt="Szczegóły dostarczenia poleconego wezwania do zapłaty pocztą" />

### Statusy [#statussen]

| Status | Znaczenie |
|---|---|
| <Status tone="info">Oczekujące</Status> | Wiadomość jest przetwarzana lub czeka w kolejce |
| <Status tone="success">Wysłane</Status> | Wiadomość została dostarczona |
| <Status tone="error">Niepowodzenie</Status> | Doręczenie się nie powiodło |
| <Status>Pominięte</Status> | Wiadomość nie została (już) wysłana, np. dlatego, że push był niedostępny lub list został anulowany u operatora pocztowego |
| <Status tone="info">Opóźnione</Status> | Wiadomość jest zaplanowana i wyjdzie później |
| <Status tone="warning">Odrzucone</Status> | Wiadomość nie dotarła pod adres e-mail lub numer |
| <Status tone="error">Zgłoszone jako spam</Status> | Odbiorca oznaczył wiadomość jako spam |

List wysyłany pocztą zaczyna ze statusem **Oczekujące**. Gdy operator pocztowy potwierdzi, że list jest w drodze lub został doręczony, zmienia się on na **Wysłane**. Nieodebrana lub niedoręczalna poczta otrzymuje status **Niepowodzenie**. Anulowany list otrzymuje status **Pominięte**. Ten wiersz znajdziesz głównie na liście **Ostatnia komunikacja**.

## Powiadomienia w aplikacji [#meldingen-in-de-app]

Wszystko, co Tillor wysyła do Ciebie jako współpracownika, np. przypisane zadanie, wzmianka w komentarzu czy alarm licznika, znajdziesz także w samym Tillor. Każde powiadomienie pojawia się tam jeden raz, nawet jeśli zostało wysłane e-mailem i przez push. Nie musisz niczego w tym celu ustawiać.

- **Dzwonek**: w prawym górnym rogu paska i w lewym dolnym rogu menu (**Powiadomienia**) znajduje się dzwonek z liczbą nieprzeczytanych powiadomień. Kliknij go, aby zobaczyć najnowsze powiadomienia. Przyciskiem **Oznacz wszystkie jako przeczytane** aktualizujesz listę jednym kliknięciem
- **Zobacz e-mail**: kliknij powiadomienie, aby otworzyć e-mail wysłany do Ciebie w tej sprawie, z przyciskiem na górze prowadzącym do odpowiedniej strony (np. **Otwórz zadanie**). Powiadomienie bez e-maila od razu przenosi Cię na tę stronę. Powiadomienie jest wtedy przeczytane
- **Karta w prawym dolnym rogu**: jeśli powiadomienie przyjdzie, gdy masz otwarty Tillor, pojawi się jako karta w prawym dolnym rogu, w tym samym miejscu co przychodząca rozmowa. Kliknij kartę lub zamknij ją krzyżykiem. Zamknięta karta pozostaje w dzwonku jako nieprzeczytana. Jeśli jesteś już na stronie, której dotyczy powiadomienie, karta się nie pojawia
- **Pozostaje**: powiadomienia, w związku z którymi także do Ciebie dzwonimy, np. connector, który przestał być osiągalny, pozostają, dopóki ich nie zamkniesz
- **Skrzynka odbiorcza**: nowe wiadomości w skrzynce odbiorczej mają własną kartę i licznik przy **Skrzynka odbiorcza**. W dzwonku od razu są oznaczone jako przeczytane. Dotyczy to także dziennego zestawienia liczników wymagających uwagi
- **Dziennie**: na liście Twoje powiadomienia są pogrupowane według dnia, wraz z kategorią. Przyciskami na górze pokazujesz jedną kategorię

Powiadomienia są osobiste: widzisz tylko własne, osobno dla każdej organizacji.

W [automatyzacji](/begrippen#automatisering) w kroku **Powiadom współpracowników** opcją **Pokaż w Tillor** wybierasz, czy powiadomienie dostanie kartę i licznik nieprzeczytanych. Jeśli opcja jest wyłączona, powiadomienie znajduje się na liście jako przeczytane.

### Wyłączanie powiadomień [#meldingen-uitzetten]

<Steps>
<Step>
### Otwórz swoje konto [#open-je-account]
Kliknij w menu swoją nazwę i wybierz **Konto**.
</Step>
<Step>
### Przejdź do Powiadomień [#ga-naar-meldingen]
Dla każdego typu powiadomienia włącz lub wyłącz kanały. W wierszu **Wszystkie powiadomienia** wyłączasz kanał jednocześnie dla wszystkiego.
</Step>
</Steps>

Kanał wyłączony przy **Wszystkie powiadomienia** pozostaje wyłączony dla każdego powiadomienia poniżej, z wyjątkiem powiadomień, które są wysyłane zawsze. Typ, dla którego wyłączysz wszystkie kanały, przestaje się też pojawiać w aplikacji. Dla współpracownika ustawiasz to w <UIPath>Ustawienia > Użytkownicy</UIPath>, zobacz [Ustawianie powiadomień współpracownika](/gebruikers/gebruikers-en-rechten#meldingen-van-een-collega-instellen).

## Powiadomienia zewnętrzne [#externe-notificaties]

Podłączony system zewnętrzny, np. oprogramowanie do newsletterów lub rezerwacji, może zarejestrować w Tillor e-maile, które sam wysłał do klienta. Znajdziesz je u klienta, na fakturze i na liście **Ostatnia komunikacja**, wśród wiadomości Tillor. Rozpoznasz je po etykiecie **Zewnętrzne** z nazwą systemu.

- Tillor nie wysłał tej wiadomości i nie może sprawdzić jej statusu. Status pochodzi z systemu zewnętrznego
- Powiadomienia zewnętrzne nie są wliczane do statystyk na górze i nie ma ich na listach **Odrzucone powiadomienia**, **Oczekujące powiadomienia** i **Nieudane powiadomienia**
- W oknie szczegółów obrazy są domyślnie zablokowane. Dzięki temu nadawca nie zauważy, że otwierasz wiadomość. Kliknij **Wczytaj obrazy**, aby mimo to je wyświetlić
- System zewnętrzny może później zaktualizować lub usunąć własne powiadomienia. Zobaczysz to w [dzienniku aktywności](/activiteitenlog) klienta lub faktury

To, kto może rejestrować powiadomienia zewnętrzne, regulujesz uprawnieniami **Rejestrowanie powiadomień zewnętrznych** i **Zarządzanie powiadomieniami zewnętrznymi innych**. Opis techniczny dla integratorów znajduje się w [Dla programistów > Powiadomienia zewnętrzne](/ontwikkelaars/externe-notificaties).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Wiadomość ma status Odrzucone">
Adres e-mail lub numer klienta nie istnieje albo nie może odbierać wiadomości. Otwórz wiadomość z listy **Odrzucone powiadomienia** i przeczytaj komunikat o błędzie. Przejdź przez kolumnę **Źródło** do profilu klienta, popraw adres e-mail i wyślij wiadomość ponownie przyciskiem **Wyślij powiadomienie** na fakturze.
</Accordion>
<Accordion title="SMS lub wiadomość WhatsApp się nie powiodła">
Otwórz wiadomość z listy **Nieudane powiadomienia** i przeczytaj komunikat o błędzie. Zwykle numer telefonu jest nieprawidłowy lub brakuje numeru kierunkowego kraju. Popraw numer w profilu klienta i wyślij ponownie.
</Accordion>
<Accordion title="SMS pozostaje w stanie Oczekujące">
Operator telefoniczny czasem przekazuje informację o doręczeniu z opóźnieniem. Po 2 dniach Tillor automatycznie ustawia SMS-a jako **Niepowodzenie**. Otwórz okno szczegółów, aby zobaczyć komunikat o błędzie, i sprawdź numer.
</Accordion>
<Accordion title="List wysłany pocztą nie powiódł się lub jest niedoręczalny">
Otwórz wiadomość z listy **Oczekujące powiadomienia** lub **Nieudane powiadomienia**. Sprawdź adres pocztowy w profilu klienta (ulica, kod pocztowy i miejscowość) i wyślij list ponownie przyciskiem **Wyślij powiadomienie** lub **Wyślij przypomnienie** na fakturze.
</Accordion>
<Accordion title="List ma status Pominięte">
List został anulowany u operatora pocztowego. Znajdź przesyłkę na liście **Ostatnia komunikacja** i sprawdź w polu **Status śledzenia**, co się wydarzyło. Wysyłaj ponownie tylko wtedy, gdy klient nadal powinien otrzymać list.
</Accordion>
<Accordion title="Nie widzę przycisku Wyślij powiadomienie na fakturze">
Przycisk jest tylko na zaksięgowanej fakturze i tylko wtedy, gdy klient ma adres e-mail, numer telefonu lub pełny adres pocztowy. Uzupełnij jedną z tych danych w profilu klienta.
</Accordion>
<Accordion title="Nie dostaję już powiadomienia w Tillor">
Sprawdź w **Konto** w sekcji **Powiadomienia**, czy wszystkie kanały dla tego typu nie zostały wyłączone. Typ bez kanałów nie pojawia się też w dzwonku.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **[Powiadomienie](/begrippen#notificatie)**: wiadomość, którą Tillor wysyła do klienta lub współpracownika e-mailem, SMS-em, pocztą, przez WhatsApp lub push.
- **Kanał**: droga, którą wychodzi wiadomość. Jedno powiadomienie może iść kilkoma kanałami.
- **Dostawa**: jedna próba wysyłki jednym kanałem, z własnym statusem.
- **Odrzucone**: wiadomość wróciła, ponieważ adres lub numer nie istnieje.
- **Powiadomienie** (w aplikacji): powiadomienie dla [użytkownika](/begrippen#gebruiker) Tillor, widoczne w dzwonku.
- **Zewnętrzne**: wiadomość, którą wysłał podłączony system i która została jedynie zarejestrowana w Tillor.

Więcej terminów znajdziesz w [słowniku pojęć](/begrippen).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Wysyłanie faktury lub wezwania do zapłaty" href="/communicatie/e-mails" description="Samodzielne wysyłanie wiadomości z faktury" />
  <Card title="Typy powiadomień" href="/communicatie/notificatietypes" description="Wszystkie rodzaje wiadomości i kiedy wychodzą" />
  <Card title="Wysyłanie faktury" href="/facturen/versturen" description="Faktury i wezwania do zapłaty pocztą" />
  <Card title="Automatyzacje" href="/automatiseringen" description="Wysyłanie wiadomości przez automatyzację" />
</Cards>


# Komentarze (/pl-PL/notities)

Dzięki komentarzom współpracownicy razem pracują nad klientami, fakturami, rezerwacjami i innymi rekordami, a klient niczego nie widzi. Piszesz komentarz na stronie szczegółów rekordu, wspominasz współpracownika znakiem @ i przypinasz ważne komentarze. Zacznij od [Dodawanie komentarza](#een-opmerking-toevoegen).

<Callout type="info" title="Warto wiedzieć">
- Komentarze są zawsze wewnętrzne. Nigdy nie są widoczne dla klientów, także na fakturach i w e-mailach.
- Współpracownik, którego wspomnisz znakiem @, dostaje powiadomienie.
- Rozwiązanego komentarza nie można już edytować ani przypiąć.
- Rozwiązanie komentarza automatycznie odpina przypięty komentarz.
- Usunięcia komentarza nie można cofnąć.
- Przypięty komentarz pozostaje widoczny na górze rekordu, bez przewijania do karty **Komentarze**.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  R[Rekord: klient, faktura, rezerwacja...] --> O[Komentarz]
  O -->|wzmianka @| M[Powiadomienie dla współpracownika]
  O -->|Przypnij| P[Na górze rekordu]
  O -->|Przypomnienie| T[Zadanie do dalszych kroków]
  O -->|Rozwiąż| X[Rozwiązany i zwinięty]
```

Wszystkie komentarze Twojej organizacji znajdziesz też razem w <UIPath>Komunikacja > Komentarze</UIPath>, z odnośnikiem do rekordu, do którego należą.

## Gdzie znaleźć komentarze? [#waar-vind-je-opmerkingen]

Na stronach szczegółów znajduje się karta **Komentarze**. W zależności od rekordu:

- <UIPath>Klienci > Przegląd</UIPath> lub <UIPath>Klienci > Komunikacja</UIPath>: w profilu klienta
- <UIPath>Administracja > Faktury</UIPath>: na stronie szczegółów faktury
- <UIPath>Klienci > Rezerwacje</UIPath>: na stronie szczegółów rezerwacji
- <UIPath>Park > Działki</UIPath>: na stronie szczegółów działki
- <UIPath>Park > Liczniki</UIPath>: na stronie szczegółów licznika
- <UIPath>Administracja > Raporty płatności</UIPath>: w raporcie płatności

## Dodawanie komentarza [#een-opmerking-toevoegen]

<Steps>
<Step>
### Otwórz rekord [#open-het-record]
Otwórz na przykład profil klienta lub fakturę i przejdź do karty **Komentarze**.

<DocScreenshot src="/screenshots/notities/invoice-comments.png" alt="Karta komentarzy na stronie szczegółów faktury" />
</Step>
<Step>
### Kliknij Dodaj komentarz [#klik-op-reactie-toevoegen]
Wpisz komentarz w polu **Napisz komentarz...**.

- Wpisz **@** i wybierz współpracownika z listy, aby go wspomnieć. Dostanie powiadomienie.
- Wpisz **/**, aby powiązać klienta, fakturę, licznik, działkę lub inny rekord.
- Dodaj załącznik przez **Dołącz plik**, wklejając go lub przeciągając pliki.
</Step>
<Step>
### Kliknij Wyślij [#klik-op-verzenden]
Komentarz pojawia się teraz na karcie. Przyciskiem **Odpowiedz** przy istniejącym komentarzu rozpoczynasz wątek dyskusji.
</Step>
</Steps>

### Co się dzieje potem? [#wat-gebeurt-er-daarna]

- Komentarz znajduje się w rekordzie i w centralnym przeglądzie.
- Wspomniany współpracownik dostaje powiadomienie.
- Jeśli chcesz mieć pewność, że ktoś zareaguje, kliknij zegarek przy komentarzu (**Ustaw przypomnienie o dalszych krokach**). Tillor tworzy wtedy zadanie, aby można było później sprawdzić, czy sprawa została podjęta.

## Zarządzanie komentarzami [#opmerkingen-beheren]

Przy każdym komentarzu w prawym górnym rogu znajdują się przyciski akcji, o ile masz odpowiednie uprawnienia.

### Edycja lub usunięcie komentarza [#opmerking-bewerken-of-verwijderen]

- **Edytuj**: zmień treść. Możesz to zrobić przy własnych komentarzach, ale nie przy rozwiązanych.
- **Usuń**: usuń komentarz po potwierdzeniu. Tego nie można cofnąć.

### Przypinanie komentarza [#opmerking-vastzetten]

Chcesz, aby ważny komentarz był stale widoczny na górze?

1. Kliknij ikonę pinezki (**Przypnij**).
2. Komentarz otrzymuje etykietę **Przypięty** i trafia na początek listy.
3. Kliknij ikonę pinezki ponownie, aby go odpiąć (**Odepnij**).

Rozwiązanych komentarzy nie można przypiąć.

#### Gdzie znajduje się przypięty komentarz [#waar-staat-een-vastgezette-opmerking]

- W profilu klienta znajduje się bezpośrednio pod danymi klienta na górze, nad zakładkami.
- Na fakturze, rezerwacji, działce lub liczniku znajduje się na karcie **W skrócie** na górze, razem z otwartymi zadaniami. Ta karta zwija się, gdy nic w niej nie ma.

### Oznaczanie komentarza jako rozwiązanego [#opmerking-als-opgelost-markeren]

W przypadku zakończonych dyskusji:

1. Kliknij haczyk (**Rozwiąż**).
2. Komentarz zostaje oznaczony jako **Rozwiązany** i znika z listy otwartych.
3. Na stronie szczegółów rozwiązane komentarze znajdują się na dole w rozwijanej sekcji.
4. Kliknij haczyk ponownie, aby to cofnąć (**Cofnij rozwiązanie**).

### Pobieranie komentarzy jako PDF [#opmerkingen-als-pdf-downloaden]

Ikoną drukarki pobierasz wszystkie komentarze rekordu jako PDF (**Pobierz wszystkie komentarze jako PDF**) lub jeden wątek (**Pobierz ten wątek komentarzy jako PDF**).

## Przegląd wszystkich komentarzy [#overzicht-van-alle-opmerkingen]

Przejdź do <UIPath>Komunikacja > Komentarze</UIPath>, aby zobaczyć centralny przegląd. Na górze widzisz statystyki (łącznie, otwarte, rozwiązane i przypięte). Poniżej:

<DocScreenshot src="/screenshots/notities/comments-overview.png" alt="Centralny przegląd komentarzy - Otwarte komentarze" />

- **Otwarte komentarze**: komentarze, które są nadal otwarte.
- **Rozwiązane komentarze**: zamknięte komentarze, dla odniesienia.

Każdy komentarz pokazuje **Źródło** (np. klient lub faktura), dzięki czemu od razu możesz przejść do rekordu.

### Filtrowanie [#filteren]

- **Ostatni tydzień**, **Ostatni miesiąc** lub **Wszystkie**: filtr według daty utworzenia.
- **Pokaż tylko wzmianki**: tylko komentarze, w których wspomniano Ciebie.
- Szukaj przez **Szukaj komentarzy...** lub filtruj według autora, wspomnianej osoby, rozwiązania, przypięcia oraz komentarza głównego lub odpowiedzi.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor mówi: Komentarz nie został utworzony">
Komentarz nie został zapisany. Sprawdź, czy pole tekstowe nie jest puste, i spróbuj ponownie kliknąć **Wyślij**.
</Accordion>
<Accordion title="Nie widzę współpracownika po wpisaniu @">
Jeśli pojawia się **Nie znaleziono użytkowników**, spróbuj innego imienia lub adresu e-mail. Na liście są tylko użytkownicy Twojej organizacji.
</Accordion>
<Accordion title="Nie mogę edytować ani przypiąć komentarza">
Rozwiązany komentarz jest zablokowany. Kliknij najpierw haczyk, aby ponownie go otworzyć (**Cofnij rozwiązanie**). Edytować można tylko własne komentarze.
</Accordion>
<Accordion title="Przypięty komentarz zniknął">
Rozwiązanie komentarza go odpina. Otwórz go ponownie haczykiem, a następnie przypnij od nowa.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się przypiąć/odpiąć komentarza lub Nie udało się rozwiązać/cofnąć rozwiązania komentarza">
Zmiana nie została wprowadzona. Odśwież stronę i spróbuj ponownie.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się utworzyć PDF">
Spróbuj ponownie. Jeśli PDF się nie pojawia, przeglądarka blokuje wyskakujące okno. Zezwól na wyskakujące okna dla tej witryny.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Komentarz**: wewnętrzny tekst w rekordzie, ewentualnie z załącznikami. Zobacz [komentarz](/begrippen#opmerking).
- **Wzmianka**: współpracownik, którego wskazujesz znakiem @. Dostaje powiadomienie.
- **Przypięcie**: utrzymanie komentarza na górze rekordu.
- **Rozwiązany**: zakończony komentarz, który znika z listy otwartych.
- **Źródło**: rekord, do którego należy komentarz.
- **Zadanie**: to-do, które może wyniknąć z przypomnienia przy komentarzu. Zobacz [zadanie](/begrippen#taak).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie klientami" href="/klantenbeheer" description="Zarządzanie profilami klientów" />
  <Card title="Faktury" href="/facturen" description="Zarządzanie fakturami" />
</Cards>


# Park (/pl-PL/park)

W sekcji **Park** znajduje się wszystko, co dotyczy fizycznego miejsca: mapa z dzisiejszym obłożeniem, lista działek, liczniki i szafy licznikowe oraz pogoda. Zacznij od [Działki](/terreinen), ponieważ zajęcie miejsca, licznik i taryfa są z nimi powiązane.

## Co gdzie znajdziesz? [#wat-vind-je-waar]

| Menu | Do czego | Opis |
|---|---|---|
| <UIPath>Park > Mapa</UIPath> | Mapa Twojego parku, kolorowana według obłożenia dla każdego dnia | [Mapa](/kaart) |
| <UIPath>Park > Działki</UIPath> | Wszystkie działki, ich taryfa i liczniki na nich | [Działki](/terreinen) |
| <UIPath>Park > Liczniki</UIPath> | Wszystkie liczniki wody, gazu i energii elektrycznej | [Zarządzanie licznikami](/meterbeheer) |
| <UIPath>Park > Szafy licznikowe</UIPath> | Szafy, w których wiszą liczniki, i to, które liczniki w nich są | Zarządzaj szafami licznikowymi i przypisanymi do nich licznikami |
| <UIPath>Park > Pogoda</UIPath> | Pogoda dla każdego dnia w lokalizacji Twojego parku | [Pogoda](/weer) |

<DocScreenshot src="/screenshots/park/map-overview.png" alt="Mapa parku z pokolorowanymi działkami" />

## Szafy licznikowe [#meterkasten]

W <UIPath>Park > Szafy licznikowe</UIPath> zarządzasz szafami licznikowymi i przypisanymi do nich licznikami. Przyciskiem **Nowa szafa licznikowa** dodajesz szafę, z nazwą i opisem.

## Jak to się łączy? [#hoe-hangt-dit-samen]

**Działka** jest punktem zaczepienia. Do działki przypisujesz liczniki. Klient trafia na działkę przez **zajęcie miejsca**, a gość na krótki pobyt przez **rezerwację**. Zużycie liczników na działce trafia do klienta z aktywnym zajęciem miejsca.

```mermaid
flowchart LR
  M[Liczniki] --> T[Działka]
  T --> K[Mapa]
  B[Zajęcie miejsca<br/>klient na dłuższy czas] --> T
  R[Rezerwacja<br/>pobyt z datą zameldowania i wymeldowania] --> T
  T --> V[Taryfa i zużycie na fakturze]
```

Działka dostaje kolor na mapie dopiero wtedy, gdy wrysujesz jej granicę. Zobacz [Wrysowywanie granic działek](/kaart#terreingrenzen-intekenen).

<Callout type="info" title="Warto wiedzieć">
- Działka może mieć naraz maksymalnie jedno aktywne zajęcie miejsca.
- Nowa działka domyślnie nie jest dostępna do rezerwacji. Zaznacz **Rezerwowalny**, jeśli klienci mogą rezerwować ją online.
- Powierzchni nie można wpisać. Tillor oblicza ją, gdy wrysujesz działkę na mapie, i używa jej do taryfy.
- Mapa zawsze otwiera się na dzisiaj. Pozostałe ustawienia mapy (styl, etykiety, warstwy) są zapamiętywane.
- Etykiety z liczbą nocy i wyjazdem pojawiają się dopiero od poziomu powiększenia 17,5.
- Pogoda jest pobierana co noc dla środka mapy Twojej organizacji.
</Callout>

## Pojęcia [#begrippen]

- **Działka**: miejsce w Twoim parku z nazwą, taryfą i ewentualnie licznikami. Zobacz [Pojęcia](/begrippen#terrein).
- **Mapa**: interaktywna mapa w sekcji Park.
- **Szafa licznikowa**: szafa z licznikami. Zobacz [Pojęcia](/begrippen#meterkast).
- **Zajęcie miejsca**: klient na działce przez pewien okres. Zobacz [Pojęcia](/begrippen#bezetting).
- **Rezerwowalny**: działka, którą klienci mogą rezerwować online.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Działki" href="/terreinen" description="Tworzenie działek, taryfa i liczniki" />
  <Card title="Mapa" href="/kaart" description="Mapa, warstwy i granice działek" />
  <Card title="Zarządzanie licznikami" href="/meterbeheer" />
  <Card title="Pogoda" href="/weer" />
</Cards>


# Ustawienia druku (/pl-PL/printer/afdrukinstellingen)

To lista wszystkich ustawień w <UIPath>Ustawienia > Druk</UIPath>. Ustawienia obowiązują dla całej Twojej organizacji. Konfigurację krok po kroku opisujemy w [Konfigurowanie drukarek](/printer/printers-instellen).

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Ustawienia > Druk" />

| Ustawienie | Znaczenie |
| ---------- | --------- |
| **Druk PDF** | Włącza drukowanie faktur i dokumentów na fizycznych drukarkach. Bez tego Tillor niczego nie drukuje. |
| **Automatyczny druk faktury po płatności** | Opłacone faktury trafiają automatycznie do kolejki druku. Dla każdego typu płatności wybierasz, czy dzieje się to od razu, o następnym terminie odcięcia, czy wcale. |
| **Automatyczny druk dokumentu tożsamości przy powiązaniu** | Jeśli powiążesz skan dokumentu tożsamości z klientem lub kontaktem (także przy tworzeniu klienta ze skanu), podsumowanie jako PDF trafia do drukarki A4. Wymaga: włączonego **Druk PDF** i wypełnionego **Adres IP drukarki PDF**. |
| **Adres IP drukarki PDF** | Adres sieciowy drukarki A4 do faktur i dokumentów, na przykład `192.168.1.100`. |
| **Adres IP drukarki termicznej** | Adres sieciowy drukarki paragonów, na przykład `192.168.1.101`. |
| **Szerokość papieru drukarki termicznej** | Szerokość rolki paragonowej: **80 mm** (domyślnie) lub **58 mm**. Tillor dostosowuje do niej długość wiersza i logo na paragonie. |
| **Adres IP drukarki etykiet** | Adres sieciowy drukarki etykiet, na przykład `192.168.1.102`. |
| **Harmonogram odcięcia druku** | Dla każdego dnia tygodnia jedna lub kilka godzin z dokładnością do minuty, na przykład 09:00 i 13:30. Puste oznacza, że tego dnia nie ma terminów odcięcia. |
| **Czas automatycznego druku według typu płatności** | Dla każdego kanału (terminal/recepcja, ręcznie, online, mandat, przelew): **Drukuj natychmiast**, **Następny termin odcięcia** lub **Nie drukuj automatycznie**. Domyślnie terminal i płatność ręczna drukują od razu. Online, mandat i przelew czekają na termin odcięcia. |
| **Wstrzymaj druk do** | Wstrzymuje kolejkę druku do wybranej chwili. **Wyczyść pauzę** usuwa pauzę. Możesz też wstrzymać z poziomu [kolejki druku](/printer/printwachtrij). |

Kliknij na dole **Zapisz ustawienia**, aby zastosować zmiany. Obowiązują od razu.

<Callout type="info">
Drukarki muszą być w tej samej sieci co connector i mieć stały adres IP. Nadaj drukarce stały adres w routerze, w przeciwnym razie adres może się zmienić.
</Callout>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Konfigurowanie drukarek" href="/printer/printers-instellen" description="Kroki na początek" />
  <Card title="Drukowanie dokumentów" href="/printer/documenten-afdrukken" description="Drukowanie faktury lub paragonu" />
  <Card title="Connector" href="/connector" description="Program, który steruje drukarką" />
</Cards>


# Drukowanie faktury lub paragonu (/pl-PL/printer/documenten-afdrukken)

Fakturę drukujesz ze strony faktury, na drukarce A4 lub drukarce paragonów. Przy płatnościach Tillor może też sam drukować paragony. Fakturę możesz też pokazać na tablecie bez drukowania.

<Requires permission="Edycja ustawień" />

Zanim zaczniesz:

- Drukarki są skonfigurowane, zobacz [Konfigurowanie drukarek](/printer/printers-instellen).
- Dla Twojej organizacji działa connector. Bez niego opcji **Wyślij do drukarki A4** i **Wyślij do drukarki paragonowej** nie ma w menu.

## Drukowanie faktury [#een-factuur-afdrukken]

<Steps>
<Step>
### Otwórz fakturę [#open-de-factuur]
Przejdź do <UIPath>Administracja > Faktury</UIPath> i otwórz fakturę.
</Step>
<Step>
### Wybierz sposób drukowania [#kies-hoe-je-afdrukt]
<Tabs items={["Na papierze przez przeglądarkę", "Na drukarce w sieci"]}>
<Tab value="Na papierze przez przeglądarkę">
Kliknij **Drukuj**. Przeglądarka otwiera własne okno drukowania.
</Tab>
<Tab value="Na drukarce w sieci">
Kliknij strzałkę obok **Drukuj** i wybierz **Wyślij do drukarki A4** lub **Wyślij do drukarki paragonowej**. Tillor umieszcza zadanie w kolejce druku.
</Tab>
</Tabs>

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Szczegóły faktury - akcje druku i płatności" />
</Step>
</Steps>

## Paragony po płatności [#bonnen-na-een-betaling]

Włącz w <UIPath>Ustawienia > Druk</UIPath> opcję **Automatyczny druk faktury po płatności**. Opłacone faktury trafiają wtedy do drukarki A4 i ewentualnie do drukarki paragonów, od razu lub o następnym terminie odcięcia, zależnie od kanału płatności.

Dla każdego produktu możesz dodatkowo włączyć **Druk termiczny** i **Druk A4** oraz ustawić liczbę kopii na stronie produktu. Te kopie wychodzą dodatkowo, gdy ten produkt znajdzie się na opłaconej fakturze.

## Pokazywanie faktury na tablecie [#een-factuur-op-de-tablet-tonen]

Chcesz pokazać fakturę bez drukowania? Wybierz w menu z trzema kropkami przy fakturze **Podgląd na iPadzie** lub kliknij w oknie płatności gotówkowej **Podgląd na iPadzie**. PDF pojawia się na połączonym tablecie, a Tillor wyświetla **PDF wysłany na iPada**. Zobacz [Tablety i kioski](/mobiele-app/tablets-en-kiosken).

## Co się dzieje potem? [#wat-gebeurt-er-daarna]

- Zadanie dla drukarki znajduje się w [kolejce druku](/printer/printwachtrij) ze statusem. W terminie druku trafia do drukarki.
- Jeśli drukowanie się nie powiedzie, Tillor w większości przypadków automatycznie próbuje ponownie. Potem zadanie ma status **Niepowodzenie**, dopóki Ty nie spróbujesz ponownie lub go nie anulujesz.
- Sama faktura się nie zmienia: drukowanie niczego nie księguje ani nie wysyła.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Wyślij do drukarki A4">
Dla Twojej organizacji nie ma aktywnego connectora albo **Druk PDF** jest wyłączony. Zobacz [Konfigurowanie drukarek](/printer/printers-instellen).
</Accordion>
<Accordion title="Tillor mówi Drukowanie nie powiodło się">
Komunikat brzmi **Nie udało się wysłać dokumentu do drukarki.** Otwórz [kolejkę druku](/printer/printwachtrij), aby zobaczyć przyczynę w polu **Ostatni błąd**, na przykład drukarka offline lub bez papieru.
</Accordion>
<Accordion title="Tillor mówi Pobieranie nie powiodło się">
Nie udało się pobrać PDF. Spróbuj ponownie.
</Accordion>
<Accordion title="Tillor mówi PDF nie został wysłany">
Nie udało się wysłać PDF na tablet. Oznacza to, że żaden tablet nie jest osiągalny. Otwórz aplikację Tillor na tablecie i sprawdź, czy w <UIPath>Ustawienia > Tablety i kioski</UIPath> jest **Połączone**.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie kolejką druku" href="/printer/printwachtrij" description="Śledzenie zadań i ponawianie prób" />
  <Card title="Faktury" href="/facturen" description="Zarządzanie fakturami i ich wysyłanie" />
  <Card title="Produkty" href="/producten" description="Ustawianie kopii dla każdego produktu" />
</Cards>


# Przegląd (/pl-PL/printer)

Dzięki integracji z drukarką drukujesz faktury, paragony i etykiety bezpośrednio z Tillor na drukarce w Twoim parku, bez wcześniejszego pobierania dokumentu. Drukarki ustawiasz raz w [Konfigurowanie drukarek](/printer/printers-instellen), a potem drukujesz jednym kliknięciem lub pozwalasz Tillor robić to przy płatności.

## Jak to się łączy? [#hoe-hangt-dit-samen]

Tillor nie wysyła zadania druku bezpośrednio do drukarki. Zadanie trafia najpierw do kolejki druku. W terminie druku Tillor przekazuje je do connectora, małego programu na komputerze w Twojej sieci, a ten uruchamia drukowanie na drukarce.

```mermaid
flowchart LR
  A[Drukujesz fakturę lub<br/>wpływa płatność] --> B[Kolejka druku w Tillor]
  B -- od razu lub w terminie druku --> C[Connector w Twojej sieci]
  C --> D[Drukarka]
  B -- niepowodzenie --> E[Tillor ponawia próbę]
```

Dlatego connector musi być online, a drukarka osiągalna w tej samej sieci. Bez aktywnego connectora nie widzisz opcji wysyłania na drukarkę. Zobacz [Connector](/connector).

<Callout type="info" title="Warto wiedzieć">
- Są trzy rodzaje drukarek: drukarka A4 do faktur i dokumentów, drukarka termiczna do paragonów kasowych i drukarka etykiet.
- Szerokość rolki paragonowej to 80 mm (domyślnie) lub 58 mm.
- Nieudane zadanie Tillor automatycznie ponawia po 10 sekundach, 5 minutach i 15 minutach. Potem ma status **Niepowodzenie**. Jeśli skończył się papier lub drukarka jest offline, zadanie od razu ma status **Niepowodzenie**.
- W każdy poniedziałek rano Tillor jeszcze raz próbuje wykonać wszystkie zadania ze statusem **Niepowodzenie**.
- Drukowanie można wstrzymać na 15 minut, 1 godzinę, 4 godziny, 6 godzin, 1 dzień lub do chwili, gdy sam je wznowisz.
- Domyślnie płatności terminalowe i ręczne drukują od razu. Płatności online, mandaty i przelewy czekają na następny termin druku.
</Callout>

## Co chcesz zrobić? [#wat-wil-je-doen]

<Cards>
  <Card title="Konfigurowanie drukarek" href="/printer/printers-instellen" description="Wpisywanie adresów sieciowych i wybór terminów druku" />
  <Card title="Drukowanie dokumentów" href="/printer/documenten-afdrukken" description="Drukowanie faktury lub paragonów po płatności" />
  <Card title="Zarządzanie kolejką druku" href="/printer/printwachtrij" description="Wstrzymywanie, ponawianie lub anulowanie zadań" />
  <Card title="Ustawienia druku" href="/printer/afdrukinstellingen" description="Wszystkie ustawienia w jednym miejscu" />
</Cards>

## Pojęcia [#begrippen]

- **Kolejka druku**: lista zadań druku, które Tillor musi jeszcze wysłać.
- **Termin druku**: stała godzina w dniu tygodnia, o której Tillor wysyła zgromadzone zadania, inaczej termin odcięcia.
- **Drukarka termiczna**: drukarka do paragonów kasowych.
- **Connector**: program w Twojej sieci, który steruje drukarką. Zobacz [Connector](/connector).
- **Adres IP**: adres sieciowy drukarki, na przykład `192.168.1.100`.

Więcej objaśnień znajdziesz w [słowniku pojęć](/begrippen).


# Konfigurowanie drukarek (/pl-PL/printer/printers-instellen)

Aby Tillor mógł drukować, musi wiedzieć, jakie masz drukarki i gdzie są w Twojej sieci. Ustawiasz to jednorazowo dla całej organizacji. Potem możesz [drukować dokumenty](/printer/documenten-afdrukken). Każde ustawienie z objaśnieniem znajdziesz w [Ustawienia druku](/printer/afdrukinstellingen).

<Requires permission="Edycja ustawień" />

Zanim zaczniesz:

- Connector działa na komputerze w tej samej sieci co drukarki. Zobacz [Connector](/connector). Jeśli nie jest aktywny, później nie zobaczysz opcji wysyłania na drukarkę.
- Znasz adres IP każdej drukarki, czyli jej adres sieciowy, na przykład `192.168.1.100`. Nadaj drukarce stały adres w routerze, w przeciwnym razie adres może się zmienić i drukowanie przestanie działać.

## Dodawanie drukarki [#een-printer-toevoegen]

<Steps>
<Step>
### Otwórz Druk [#open-afdrukken]
Przejdź do <UIPath>Ustawienia > Druk</UIPath>.

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Ustawienia > Druk" />
</Step>
<Step>
### Włącz Druk PDF [#zet-pdf-afdrukken-aan]
Bez tego przełącznika Tillor niczego nie drukuje.
</Step>
<Step>
### Wpisz adresy drukarek [#vul-de-printeradressen-in]
W sekcji **Adresy IP drukarek** wpisz adres **Adres IP drukarki PDF** (A4), **Adres IP drukarki termicznej** (paragony) i **Adres IP drukarki etykiet**. Pozostaw puste to, czego nie masz. W **Szerokość papieru drukarki termicznej** wybierz 80 mm lub 58 mm, zgodnie z Twoją rolką paragonową.
</Step>
<Step>
### Wybierz, kiedy ma się drukować [#kies-wanneer-er-afgedrukt-wordt]
W **Harmonogram odcięcia druku** ustaw dla każdego dnia tygodnia jedną lub kilka godzin (na przykład 09:00 i 13:30). W **Czas automatycznego druku według typu płatności** wybierz dla każdego kanału płatności: **Drukuj natychmiast**, **Następny termin odcięcia** lub **Nie drukuj automatycznie**.
</Step>
<Step>
### Kliknij Zapisz ustawienia [#klik-op-instellingen-opslaan]
Ustawienia obowiązują od razu dla całej Twojej organizacji.
</Step>
</Steps>

## Automatyczny druk przy płatności [#automatisch-afdrukken-bij-betaling]

Chcesz, aby opłacona faktura trafiała na papier bez Twojej interwencji? Włącz **Automatyczny druk faktury po płatności**. Dla każdego kanału płatności decydujesz powyższym terminem druku, czy dzieje się to od razu, czy o następnym terminie odcięcia.

## Co się dzieje potem? [#wat-gebeurt-er-daarna]

- Przy każdym wydruku Tillor umieszcza zadanie w [kolejce druku](/printer/printwachtrij), które connector przekazuje drukarce.
- Opłacone faktury trafiają automatycznie do drukarki A4 i ewentualnie do drukarki paragonów, jeśli to włączysz.
- Jeśli dla kanału wybierzesz termin odcięcia, Tillor gromadzi zadania do tej chwili. Jeśli tego dnia nie ma terminu druku, nie ma też terminu odcięcia.
- Wypróbuj to na fakturze, zobacz [Drukowanie dokumentów](/printer/documenten-afdrukken).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę Wyślij do drukarki A4 przy fakturze">
Opcje pojawiają się tylko wtedy, gdy **Druk PDF** jest włączony i dla Twojej organizacji działa connector. Sprawdź jedno i drugie.
</Accordion>
<Accordion title="Tillor mówi Drukarka jest offline lub nie odpowiada">
Drukarka jest wyłączona, nie ma połączenia z siecią albo adres IP przestał być prawidłowy. Sprawdź adres w <UIPath>Ustawienia > Druk</UIPath> i czy connector jest online.
</Accordion>
<Accordion title="Tillor mówi Brak papieru, tonera lub tuszu">
Uzupełnij drukarkę i spróbuj ponownie wykonać zadanie z kolejki druku.
</Accordion>
<Accordion title="Tillor mówi Drukarka nie odpowiedziała na czas">
Connector nie dostał odpowiedzi od drukarki. Sprawdź, czy connector działa i czy drukarka jest osiągalna. Zobacz w kolejce druku, czy zadanie zostało ponowione.
</Accordion>
<Accordion title="Paragony nie wychodzą od razu">
Sprawdź w **Czas automatycznego druku według typu płatności**, czy ten kanał nie ma ustawienia **Następny termin odcięcia**. Wtedy paragon czeka do godziny wybranej w **Harmonogram odcięcia druku**. Jeśli wstrzymano drukowanie, zajrzyj do [kolejki druku](/printer/printwachtrij).
</Accordion>
<Accordion title="Paragon nie mieści się na papierze">
Sprawdź **Szerokość papieru drukarki termicznej**: 80 mm lub 58 mm.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Ustawienia druku" href="/printer/afdrukinstellingen" description="Wszystkie ustawienia w jednym miejscu" />
  <Card title="Connector" href="/connector" description="Program, który steruje drukarką" />
  <Card title="Zarządzanie kolejką druku" href="/printer/printwachtrij" description="Wstrzymywanie lub ponawianie zadań" />
</Cards>


# Zarządzanie kolejką druku (/pl-PL/printer/printwachtrij)

W kolejce druku widzisz, które zadania druku czekają, są w toku lub się nie powiodły. Tutaj wstrzymujesz drukowanie, przetwarzasz zadania dalej i rozwiązujesz problemy z zadaniami, które się nie udały. Lista odświeża się sama, gdy zadanie zmieni status.

<Requires permission="Edycja ustawień" />

Zanim zaczniesz: drukarki są skonfigurowane, zobacz [Konfigurowanie drukarek](/printer/printers-instellen).

## Przeglądanie kolejki [#de-wachtrij-bekijken]

Przejdź do <UIPath>Administracja > Kolejka druku</UIPath>. Listy to:

- **W kolejce, zaplanowane i przetwarzane**: zadania, które są jeszcze przetwarzane. Zadanie ze statusem **Zaplanowane na później** czeka na swój termin w polu **Zaplanowano** i wtedy drukuje się samo, chyba że drukowanie jest wstrzymane.
- **Niepowodzenie**: zadania, które definitywnie się nie powiodły, z przyczyną w polu **Ostatni błąd**.
- **Wszystkie zadania drukowania**.

## Wstrzymywanie drukowania [#het-afdrukken-pauzeren]

<Steps>
<Step>
### Wybierz Wstrzymaj drukowanie [#kies-afdrukken-pauzeren]
Kliknij **Wstrzymaj drukowanie** i wybierz czas: 15 minut, 1 godzina, 4 godziny, 6 godzin, 1 dzień lub **Do ponownego włączenia**.

<DocScreenshot src="/screenshots/printer/print-pause-menu.png" alt="Menu z czasem trwania pauzy" />
</Step>
<Step>
### Wznów, gdy będziesz gotowy [#hervat-wanneer-je-klaar-bent]
Kliknij **Wznów drukowanie**. W przeciwnym razie drukowanie wznowi się samo po wybranym czasie.
</Step>
</Steps>

W czasie pauzy czekają zarówno zadania bezpośrednie, jak i zaplanowane. Nowe zadania pozostają w kolejce. Przy ikonie pauzy widać, do kiedy trwa. Pauzę możesz też ustawić w **Wstrzymaj druk do** w <UIPath>Ustawienia > Druk</UIPath>.

## Przetwarzanie lub naprawa zadań [#opdrachten-doorzetten-of-herstellen]

<Tabs items={["Zadania utknęły", "Zadanie się nie powiodło"]}>
<Tab value="Zadania utknęły">
Kliknij na pasku narzędzi listy **Przetwórz kolejkę**. Zaplanowane zadania są wtedy przetwarzane od razu. Przycisk jest szary, dopóki drukowanie jest wstrzymane, z podpowiedzią **Wznów drukowanie, aby przetworzyć kolejkę**.
</Tab>
<Tab value="Zadanie się nie powiodło">
Otwórz menu z trzema kropkami w wierszu i wybierz **Ponów**, aby wysłać je jeszcze raz, lub **Anuluj**. Anulowane zadanie otrzymuje status **Anulowane** i nie jest już drukowane.
</Tab>
</Tabs>

## Co się dzieje potem? [#wat-gebeurt-er-daarna]

- Nieudane zadanie Tillor ponawia sam po 10 sekundach, potem po 5 minutach i potem po 15 minutach. Jeśli nadal się nie uda, ma status **Niepowodzenie**.
- Błędów, których nowa próba nie naprawi, Tillor nie ponawia: brak papieru, tonera lub tuszu, drukarka offline lub wstrzymana albo wyłączona kolejka drukarki. Te zadania od razu mają status **Niepowodzenie**.
- W każdy poniedziałek rano Tillor jeszcze raz przygotowuje do wykonania wszystkie zadania ze statusem **Niepowodzenie**.
- Zadanie, które pozostaje w stanie **Niepowodzenie**, nic nie robi, dopóki go nie ponowisz lub nie anulujesz.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Zadanie ma status Niepowodzenie z komunikatem Drukarka jest offline lub nie odpowiada">
Włącz drukarkę, sprawdź połączenie sieciowe i czy connector jest online. Następnie wybierz **Ponów**.
</Accordion>
<Accordion title="Zadanie pokazuje Brak papieru, tonera lub tuszu">
Uzupełnij drukarkę i wybierz **Ponów**.
</Accordion>
<Accordion title="Zadanie pokazuje Drukowanie wstrzymane. Prosimy sprawdzić papier, toner lub tusz.">
Sama drukarka jest wstrzymana, na przykład z powodu zacięcia papieru. Usuń problem przy drukarce i spróbuj ponownie.
</Accordion>
<Accordion title="Zadanie pokazuje Zadanie druku zostało utracone lub nie zostało ukończone na drukarce">
Zadanie zostało wysłane do drukarki, ale nie zostało ukończone. Sprawdź, czy coś już wyszło, zanim spróbujesz ponownie, w przeciwnym razie dostaniesz dwa wydruki.
</Accordion>
<Accordion title="Zadanie pokazuje Kolejka drukarki jest wyłączona">
Kolejka na samej drukarce jest wyłączona. Włącz ją przy drukarce i spróbuj ponownie.
</Accordion>
<Accordion title="Przetwórz kolejkę jest szare">
Drukowanie jest wstrzymane. Wybierz **Wznów drukowanie**.
</Accordion>
<Accordion title="Tillor mówi Nie udało się uruchomić przetwarzania kolejki druku">
Nie udało się przetworzyć kolejki. Spróbuj jeszcze raz. Jeśli nadal się nie uda, sprawdź, czy connector jest online.
</Accordion>
<Accordion title="Tillor mówi Nie udało się ponowić zadania drukowania">
Spróbuj ponownie lub anuluj zadanie i wydrukuj dokument od nowa z faktury.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Konfigurowanie drukarek" href="/printer/printers-instellen" description="Adresy sieciowe i terminy druku" />
  <Card title="Drukowanie faktury lub paragonu" href="/printer/documenten-afdrukken" description="Tworzenie zadań" />
</Cards>


# Przypisywanie akcji do produktu (/pl-PL/producten/acties-instellen)

Akcjami automatyzujesz to, co dzieje się po zaksięgowaniu lub opłaceniu faktury: doładowanie tagu NFC, przedłużenie zajęcia miejsca, wydruk paragonu lub utworzenie metody dostępu. Produkt może mieć kilka akcji jednocześnie.

<Requires permission="Edycja produktów" />

Zanim zaczniesz: produkt już istnieje. Zobacz [Tworzenie produktu](/producten/product-aanmaken). Schemat tego, co Tillor robi i kiedy, znajdziesz w [Jak to się łączy?](/producten#hoe-hangt-dit-samen).

<Steps>
<Step>
### Otwórz produkt [#open-het-product]

Przejdź do <UIPath>Administracja > Produkty</UIPath> i otwórz produkt.
</Step>
<Step>
### Zaznacz akcje [#vink-de-acties-aan]

Znajdź po prawej kartę **Akcje linii faktury**. Zaznacz akcje, których chcesz. Przy niektórych akcjach pojawiają się potem dodatkowe pola. Co robi każda akcja i jakie pola do niej należą, przeczytasz w [Akcje produktu](/producten/productacties).

Pozostaw wszystkie pola niezaznaczone dla zwykłej taryfy bez dalszych działań.
</Step>
<Step>
### Zapisz [#sla-op]

Kliknij **Zapisz** na dole karty **Dodatkowe linie faktury**. Akcje są teraz na produkcie i będą przenoszone do nowych linii faktury.
</Step>
</Steps>

## Co się dzieje potem? [#wat-gebeurt-er-daarna]

Gdy wybierzesz produkt na linii faktury, Tillor przenosi na tę linię akcje z ustawionymi wartościami. To, co dana akcja robi i kiedy, zależy od jej typu. Niektóre akcje działają przy księgowaniu faktury, większość przy płatności.

| Moment | Akcje |
|--------|-------|
| Przy księgowaniu | **Przedłuż okres zajęcia miejsca** (zmienia **Zafakturowane do**), **Poproś o dane kontaktowe** (księgowanie jest możliwe dopiero po uzupełnieniu wymaganych pól), utworzenie rezerwacji przy **Okres** z **Pytaj o działkę** |
| Przy płatności | **Doładuj tag NFC**, **Okres**, **Przedłuż okres zajęcia miejsca** (zmienia **Opłacone do**), **Przedłuż metodę dostępu**, **Utwórz metodę dostępu**, **Druk termiczny** i **Druk A4** |
| Bez skutku ubocznego | **Zużycie licznika** (określa taryfę), **Pokaż alert** (wyświetla tekst) |
| Blokuje księgowanie | **Zablokuj księgowanie** |

Na liście produktów w kolumnie **Akcja** widzisz, jakie akcje ma produkt.

<Callout type="info">
Zmiana akcji produktu obowiązuje dla linii faktury, które dodasz później.
</Callout>

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę pola, którego szukam">
Dodatkowe pola pojawiają się dopiero po zaznaczeniu odpowiedniej akcji. **Zamelduj przy rezerwacji** i **Zamelduj przy płatności** widzisz tylko wtedy, gdy **Pytaj o działkę** jest włączone.
</Accordion>
<Accordion title="Akcja nie wykonuje się przy płatności">
Sprawdź, czy akcja jest uzupełniona na samej linii faktury. Przy **Utwórz metodę dostępu** musi być na przykład wybrany typ. Bez typu Tillor niczego nie tworzy, a przy linii, która nie jest opcjonalna, nie można zaksięgować faktury.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Akcje produktu" href="/producten/productacties" description="Wszystkie akcje i ich ustawienia" />
  <Card title="Ustawianie dodatkowych linii faktury" href="/producten/bundel-instellen" />
</Cards>


# Ustawianie dodatkowych linii faktury (/pl-PL/producten/bundel-instellen)

Niektóre produkty to więcej niż jedna linia na fakturze: opłata za miejsce z dopłatami, objaśnienie, wynajem licznika lub tagi NFC. Dlatego na produkcie głównym ustawiasz pakiet dodatkowych linii. Gdy ktoś wybierze ten produkt jako linię główną na fakturze roboczej, Tillor dodaje linie podrzędne pod tą linią główną, w kolejności, którą ustawisz.

```mermaid
flowchart TD
  hoofd[Linia główna: produkt z pakietem] --> stap1[Krok 1 w pakiecie]
  stap1 --> kind1[Linia podrzędna na fakturze]
  hoofd --> stap2[Krok 2 w pakiecie]
  stap2 --> kind2[Linia podrzędna na fakturze]
```

<Requires permission="Edycja produktów" />

## Tworzenie lub edycja pakietu [#een-bundel-aanmaken-of-bewerken]

<Steps>
<Step>
### Otwórz produkt główny [#open-het-hoofdproduct]

Przejdź do <UIPath>Administracja > Produkty</UIPath> i otwórz produkt, na przykład opłatę za miejsce.
</Step>
<Step>
### Rozpocznij pakiet [#start-de-bundel]

Znajdź kartę **Dodatkowe linie faktury** pod **Ogólne**. Jeśli produkt nie ma jeszcze pakietu, kliknij **Skonfiguruj pakiet**.
</Step>
<Step>
### Dodaj kroki [#voeg-stappen-toe]

Kliknij **Krok produktu** dla linii z produktem i kwotą lub **Krok informacyjny** dla linii z samym tekstem. Wypełnij pola w każdym kroku. Co robi każde pole, opisujemy w [Kroki pakietu](/producten/bundel-velden).
</Step>
<Step>
### Ustaw kroki w odpowiedniej kolejności [#zet-de-stappen-in-de-juiste-volgorde]

Strzałkami **Przenieś krok w górę** i **Przenieś krok w dół** ustalasz kolejność na fakturze. **Usuń krok** usuwa krok.
</Step>
<Step>
### Zapisz [#sla-op]

Kliknij **Zapisz** na dole karty.
</Step>
</Steps>

<Callout type="info">
**Zapisz** pod **Dodatkowe linie faktury** zapisuje całą stronę produktu, także zmiany w **Ogólne** i **Akcje linii faktury**. Każdy krok produktu musi mieć produkt, a każdy krok informacyjny tekst. W przeciwnym razie Tillor nie zapisze pakietu.
</Callout>

Przyciskiem **Usuń cały pakiet** wyłączasz pakiet. Pakiet może mieć maksymalnie 40 kroków.

## Przykład: pakiet opłaty za miejsce [#voorbeeld-een-staangeld-bundel]

Typowy pakiet dla opłaty za miejsce składa się z pięciu kroków. W krokach z formułą wklejasz formułę z [Kroki pakietu](/producten/bundel-velden#voorbeelden) w polu **Formuła**.

<Steps>
<Step>
### Objaśnienie [#toelichting]

**Krok informacyjny** z tekstem „Zawiera podatki turystyczne, gminne i prowincjonalne".
</Step>
<Step>
### Pierwszy NFC w cenie [#eerste-nfc-inbegrepen]

**Krok produktu** z produktem dopłaty za NFC i formułą, która zwraca pierwszy aktywny tag NFC klienta z ilością 0 i ceną 0. Włącz **Pomnóż przez ilość wiersza kotwicy** i **Raz na fakturę**, wybierz **Styl linii** **INFO** i wpisz w **Dodatkowe dni po końcu wiersza głównego (metody dostępu)** na przykład `20`.
</Step>
<Step>
### Dodatkowe tagi NFC [#extra-nfc-tags]

Ten sam krok produktu z formułą, która zwraca drugi, trzeci itd. aktywny tag NFC według taryfy produktu, z takimi samymi opcjami skali i przedłużenia. Tutaj też włącz **Raz na fakturę**.
</Step>
<Step>
### Wynajem licznika [#meterhuur]

**Krok produktu** z produktem wynajmu licznika i formułą, która z `{meters}` wybiera liczniki, które się liczą, na przykład tylko liczniki energii ICY z włączonym zasilaniem, i dla każdego licznika zwraca linię z nazwą licznika w opisie.
</Step>
<Step>
### Psy [#honden]

**Krok produktu** z produktem dla psów i formułą, która odczytuje liczbę psów z własnego pola klienta i zwraca jedną linię z tą liczbą, albo żadnej linii, jeśli nie ma psów.
</Step>
</Steps>

## Przedłużanie NFC przez pakiet [#nfc-verlengen-via-de-bundel]

Dla opłaty za miejsce z tagami NFC trzy rzeczy muszą ze sobą współgrać:

1. Na produkcie głównym jest akcja **Przedłuż okres zajęcia miejsca**, a na linii faktury wybrana jest działka.
2. W pakiecie jest co najmniej jeden krok z wypełnionym **Dodatkowe dni po końcu wiersza głównego (metody dostępu)**, na przykład kroki NFC z powyższego przykładu.
3. Na produkcie głównym jest akcja **Przedłuż metodę dostępu** z odpowiednimi typami, statusami i ewentualnie dniem tygodnia oraz godziną końca.

Przy płatności linii takiego kroku Tillor ustawia ważność metod dostępu klienta na datę końcową linii głównej opłaty za miejsce plus dodatkowe dni. Domyślnie trwa ona do 23:59 w strefie czasowej organizacji lub do dnia tygodnia i godziny, które ustawisz w **Przedłuż metodę dostępu**. Jeśli linia główna nie ma daty końcowej, Tillor niczego nie przedłuża.

<Callout type="warn" title="Uwaga">
**Dodatkowe dni po końcu wiersza głównego (metody dostępu)** działa tylko wtedy, gdy produkt ma jako akcję **Przedłuż okres zajęcia miejsca**. Jeśli pod polem pojawia się komunikat, że jest to wymagane, zaznacz po prawej w **Akcje linii faktury** opcję **Przedłuż okres zajęcia miejsca**.
</Callout>

## Co się dzieje na fakturze roboczej? [#wat-gebeurt-er-op-een-conceptfactuur]

- Linie podrzędne pojawiają się pod linią główną dopiero po wybraniu działki w **Przedłuż okres zajęcia miejsca**.
- Tillor buduje linie podrzędne od nowa, gdy na linii głównej zmienisz produkt, ilość lub działkę. W innych przypadkach ręcznie zmienione linie podrzędne pozostają. Jeśli na przykład usuniesz linię licznika, nie wróci sama.
- W edytorze faktury widzisz podgląd linii podrzędnych, wraz ze skutkiem **Raz na fakturę**, aby zgadzało się z tym, co będzie po zapisaniu.
- Linię główną strzałkami przesuwasz tylko jako cały blok. Linie podrzędne przesuwasz tylko w obrębie ich pakietu. Jeśli usuniesz linię główną, znikają razem z nią linie podrzędne.
- Na PDF zwykłe linie podrzędne często mają **↳** przed opisem. Linie informacyjne są szarymi liniami bez kwot.
- Kroki bez wybranego produktu Tillor pomija. Produkt, który został usunięty lub go brakuje, nie da więc żadnej linii.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Linie podrzędne nie pojawiają się pod linią główną">
Przy produkcie głównym z **Przedłuż okres zajęcia miejsca** musisz najpierw wybrać działkę na linii głównej. Do przedłużenia NFC przy płatności linia główna potrzebuje ponadto daty końcowej.
</Accordion>
<Accordion title="Ta sama dopłata jest na fakturze dwa razy">
Jeśli na fakturze są dwie lub więcej linii głównych z pakietem, każda linia główna dostaje linie pakietu. Włącz **Raz na fakturę** przy krokach, które mogą wystąpić tylko raz. Krok należy wtedy tylko do pierwszej linii głównej w kolejności na fakturze.
</Accordion>
<Accordion title="Pakiet nie jest zapisywany">
Sprawdź, czy każdy krok produktu ma **Produkt**, a każdy krok informacyjny **Tekst linii informacyjnej**.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Kroki pakietu" href="/producten/bundel-velden" description="Pola, klucze dynamiczne i symbole zastępcze" />
  <Card title="JSON pakietu" href="/producten/bundel-json" />
  <Card title="Akcje produktu" href="/producten/productacties" />
</Cards>


# JSON pakietu (/pl-PL/producten/bundel-json)

Karta **Dodatkowe linie faktury** zapisuje pakiet jako JSON w produkcie, pod kluczem `invoiceBundle`. Przy importach używasz tej samej struktury. Do zwykłego użytku ta strona nie jest potrzebna: pola i ich opis znajdziesz w [Krokach pakietu](/producten/bundel-velden).

## Struktura [#structuur]

| Pole | Znaczenie |
|------|-----------|
| `invoiceBundle.version` | Zawsze `1` |
| `invoiceBundle.steps` | Lista kroków, maksymalnie 40. Kolejność kroków to kolejność linii podrzędnych na fakturze |

Każdy krok jest krokiem produktu albo krokiem informacyjnym.

### Krok produktu [#productstap]

| Pole | Znaczenie |
|------|-----------|
| `productId` | Istniejący produkt w Twojej organizacji. Wymagane |
| `quantity` | Liczba większa od 0, domyślnie `1`. Ilość linii bez formuły albo gdy formuła zwraca `true` |
| `quantityScale` | Opcjonalne. `"anchor_line_quantity"` mnoży każdą obliczoną ilość przez ilość linii głównej |
| `description` | Opcjonalne. Tekst linii faktury zamiast nazwy produktu; formuła może dla każdej linii podać własny `description` |
| `style` | Opcjonalne. `DEFAULT` lub `INFO` |
| `billOncePerInvoice` | Opcjonalne. `true` przy kilku liniach głównych na fakturze przypisuje krok tylko do pierwszej linii głównej |
| `extendAccessMethod` | Opcjonalne. `{ "daysAfterPeriodEnd": <liczba całkowita, 0 do 3660> }`, zobacz [Przedłużenie NFC](#nfc-verlenging) |
| `formula` | Opcjonalne. TypeScript, który określa, jakie linie daje krok, zobacz [Formuła](#formule) |

### Krok informacyjny [#inforestap]

```json
{
  "stepKind": "info",
  "description": "Inclusief toeristen-, gemeente- en provincietaksen"
}
```

`description` jest wymagane, a krok informacyjny nie ma `productId`. Za pomocą `style` (`DEFAULT` lub `INFO`) wybierasz styl linii, domyślnie jest to `INFO`. Formuła, która zwraca `false`, pomija linię informacyjną.

## Formuła [#formule]

`formula` to TypeScript, który przy zapisie faktury zwraca `true` (jedna linia z `quantity`), `false` (brak linii), liczbę (ilość) albo listę linii `{ "quantity", "description", "unitPrice", "accessMethodValue" }`. Jakie pola i listy możesz czytać i co robi każda postać, opisano w [Formule dla kroku](/producten/bundel-velden#formule-per-stap). Formuła, która się nie kompiluje, jest odrzucana przy zapisie produktu. W JSON formuła jest jednym ciągiem znaków, w którym `\n` oznacza koniec wiersza.

```json
"formula": "return {customer.customFields.exemptFromSurcharges} !== true;"
```

## Przedłużenie NFC [#nfc-verlenging]

Ma sens tylko wtedy, gdy produkt główny ma jako akcję **Przedłuż okres zajęcia miejsca**.

```json
"extendAccessMethod": { "daysAfterPeriodEnd": 20 }
```

Gdy linia takiego kroku zostanie opłacona, Tillor ustawia ważność metod dostępu klienta na datę końcową linii głównej plus `daysAfterPeriodEnd` dni kalendarzowych. Domyślnie ważność trwa do 23:59 w strefie czasowej organizacji albo do dnia tygodnia i godziny ustawionych w **Przedłuż metodę dostępu** w produkcie głównym. Tam ustawiasz też, jakie typy i statusy się liczą. Bez daty końcowej w linii głównej nic się nie dzieje. Gdy włączone jest **Nie skracaj przy przedłużeniu**, Tillor pomija metody, których ważność przypada już na nową datę lub później. `accessMethodValue` w linii wskazuje metodę tej linii; samo przedłużenie podąża za ustawieniami produktu głównego.

Po udanym przedłużeniu na osi czasu faktury pojawia się wpis odsyłający do płatności.

## Przykład: objaśnienie, dopłata za NFC, wynajem licznika i psy [#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="Uwaga">
Upewnij się, że wszystkie wartości `productId` w krokach produktu istnieją w Twoim katalogu. Kroki z nieznanym produktem Tillor pomija.
</Callout>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Kroki pakietu" href="/producten/bundel-velden" />
  <Card title="Ustawianie dodatkowych linii faktury" href="/producten/bundel-instellen" />
</Cards>


# Kroki pakietu (/pl-PL/producten/bundel-velden)

Ta strona opisuje pola w karcie **Dodatkowe linie faktury** na stronie produktu. Jak zbudować pakiet, wyjaśniono w [Ustawianiu dodatkowych linii faktury](/producten/bundel-instellen).

## Krok produktu [#productstap]

Krok produktu Tillor zamienia na zero, jedną lub kilka linii faktury z tym produktem. Bez formuły jest to jedna linia z ustawioną ilością; za pomocą [formuły](#formule-per-stap) sam decydujesz, czy, ile i jakie linie powstaną.

| Pole | Co robi |
|------|---------|
| **Produkt** | Produkt, który trafia do linii podrzędnej, na przykład dopłata za NFC lub wynajem licznika. Wymagane |
| **Ilość** | Ilość linii, gdy krok nie ma formuły albo gdy formuła zwraca `true`. Większa niż 0 |
| **Pomnóż przez ilość wiersza kotwicy** | Mnoży każdą obliczoną ilość przez ilość linii głównej, na przykład 0,5 przy pół roku Opłaty za postój. Wynik jest zaokrąglany do dwóch miejsc po przecinku. Linie, które w ten sposób wyjdą na 0, Tillor pomija; linia, którą formuła sama zwróci z ilością 0, zostaje |
| **Opis (opcjonalnie)** | Zastępuje nazwę produktu na linii faktury. Formuła zwracająca linie może nadać każdej linii własny opis |
| **Styl linii** | **Domyślny (produkt)**, **DEFAULT** lub **INFO**. Przy **INFO** linia podrzędna staje się szarym objaśnieniem w PDF i w edytorze |
| **Raz na fakturę** | Istotne tylko wtedy, gdy na tej samej fakturze są dwie lub więcej linii głównych z pakietem. Krok należy wtedy tylko do pierwszej linii głównej w kolejności na fakturze |
| **Dodatkowe dni po końcu wiersza głównego (metody dostępu)** | Ma sens tylko wtedy, gdy produkt główny ma jako akcję **Przedłuż okres zajęcia miejsca**. Gdy linia tego kroku zostanie opłacona, Tillor przedłuża metody dostępu klienta do daty końcowej linii głównej plus ta liczba dni; typy i statusy pochodzą z **Przedłuż metodę dostępu** w produkcie głównym, zobacz [Przedłużanie NFC przez pakiet](/producten/bundel-instellen#nfc-verlengen-via-de-bundel) |
| **Formuła** | Opcjonalne. TypeScript, który określa, czy krok trafia na fakturę, z jaką ilością albo jakie dokładnie linie, zobacz [Formuła dla kroku](#formule-per-stap) |

## Krok informacyjny [#inforestap]

Krok informacyjny to sam tekst, bez produktu i kwoty. Tillor pokazuje go jako linię objaśnienia.

| Pole | Co robi |
|------|---------|
| **Tekst linii informacyjnej** | Widoczny tekst, na przykład "Inclusief toeristen-, gemeente- en provincietaksen". Wymagane |
| **Styl linii** | Domyślnie **INFO**. Możesz wybrać **DEFAULT**, jeśli chcesz pokazać linię jako zwykłą |
| **Formuła** | Opcjonalne. Jeśli formuła zwraca `false`, linia informacyjna zostaje pominięta |

Jeśli krok informacyjny znajduje się pod linią główną, PDF automatycznie dodaje **↳** przed tekstem.

## Formuła dla kroku [#formule-per-stap]

Każdy krok może mieć **Formułę**: TypeScript, tak jak [formuła taryfy](/terreinen#tariefformule), który Tillor wykonuje przy zapisie faktury z tym pakietem. Dzięki temu krok może zależeć od klienta, zajęcia miejsca, terenu, liczników lub metod dostępu, na przykład poprzez [własne pole](/eigen-velden), w którym zapisujesz wyjątek.

### Co zwraca formuła [#wat-de-formule-teruggeeft]

| Zwrócona wartość | Skutek |
|------------------|--------|
| `true` | Jedna linia z ustawioną **Ilością** |
| `false` lub `null` | Brak linii |
| Liczba większa niż 0 | Jedna linia z tą liczbą jako ilością |
| Lista linii | Dokładnie te linie, w tej kolejności. Pusta lista oznacza brak linii |

Linia na takiej liście to obiekt z następującymi polami:

| Pole | Znaczenie |
|------|-----------|
| `quantity` | Wymagane. Ilość, 0 lub więcej. Linia z 0 zostaje, także przy **Pomnóż przez ilość wiersza kotwicy** |
| `description` | Opcjonalne. Opis tej linii; w przeciwnym razie **Opis** kroku, a w przeciwnym razie nazwa produktu |
| `unitPrice` | Opcjonalne. Cena jednostkowa z VAT, jak taryfa produktu; w przeciwnym razie taryfa produktu. `0` tworzy darmową linię |
| `accessMethodValue` | Opcjonalne. Wartość metody dostępu, której dotyczy ta linia (UID tagu NFC), na potrzeby przedłużenia przy płatności |

### Co formuła może czytać [#wat-de-formule-kan-lezen]

Pola czytasz w nawiasach klamrowych, tak jak w automatyzacjach. Menu **Zmienna** przy polu pokazuje wszystko, co jest dostępne, łącznie z Twoimi własnymi polami.

| Zmienna | Co to jest |
|---------|------------|
| `{customer.…}` | Klient na fakturze, na przykład `{customer.createdAt}` lub `{customer.customFields.meterhuurVrijgesteld}` |
| `{occupation.…}` | Zajęcie miejsca linii głównej. Jeśli produkt główny nie ma akcji **Przedłuż okres zajęcia miejsca**, jest to jedyne zajęcie klienta; puste (`null`), jeśli klient zajmuje kilka terenów |
| `{terrain.…}` | Teren tego zajęcia |
| `{anchor.…}` | Linia główna: `{anchor.quantity}` (na przykład 0,5 przy pół roku), `{anchor.terrainId}`, `{anchor.occupationId}` i `{anchor.endDate}` |
| `{meters}` | Lista liczników w zakresie: na terenie linii głównej przy **Przedłuż okres zajęcia miejsca**, w przeciwnym razie na wszystkich terenach zajmowanych przez klienta. Każdy licznik ma `name`, `provider` (na przykład `ICY`), `type` (na przykład `ELECTRICITY`, `GAS`), metadane swojego dostawcy (na przykład `icyMetadata.switchState` dla włączonego zasilania), swój `terrain` i `customFields` |
| `{accessMethods}` | Lista metod dostępu klienta, od najstarszej, każdego typu i statusu. Każda metoda ma `type` (na przykład `NFC`), `status` (na przykład `ACTIVE`), `value`, czytelną `label` (znana nazwa tagu NFC, w przeciwnym razie wartość) i `customFields` |

Listy `{meters}` i `{accessMethods}` Tillor ładuje tylko wtedy, gdy formuła z nich korzysta.

### Przykłady [#voorbeelden]

Pominięcie kroku dla klientów zwolnionych:

```ts
if ({customer.customFields.exemptFromSurcharges} === true) return false;
return true;
```

Jedna linia na każdy licznik energii elektrycznej ICY z włączonym zasilaniem, a dla klientów od 2026 także z wyłączonym:

```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}` }));
```

Pierwszy tag NFC za darmo jako objaśnienie, każdy kolejny według taryfy produktu (dwa kroki z tym samym produktem albo jeden krok, który zwraca oba rodzaje linii):

```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}`,
}));
```

Jedna linia z liczbą psów z własnego pola klienta, bez linii, gdy nie ma psów:

```ts
const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));
return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];
```

Za pomocą **Wstaw przykład** pod polem dostajesz punkt wyjścia z tymi postaciami w komentarzu.

### Błędy [#fouten]

Formuły, która się nie kompiluje, nie można zapisać; komunikat pod polem mówi, co jest nie tak. Jeśli formuła zawiesza się przy zapisie faktury albo zwraca coś innego niż `true`, `false`, liczbę lub poprawne linie, zapis się nie udaje, a komunikat błędu zawiera nazwę kroku, żeby zepsuta formuła nigdy po cichu nie dodała ani nie pominęła linii.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Ustawianie dodatkowych linii faktury" href="/producten/bundel-instellen" />
  <Card title="JSON pakietu" href="/producten/bundel-json" />
  <Card title="Zarządzanie licznikami" href="/meterbeheer" />
</Cards>


# Przegląd (/pl-PL/producten)

Produkt to taryfa lub usługa, którą umieszczasz w linii faktury: noc na terenie, abonament miesięczny, tag NFC lub kWh prądu. Każdy produkt ma cenę z VAT. Możesz też przypisać do niego akcje, które Tillor wykonuje automatycznie, na przykład przedłużenie zajęcia miejsca lub wydruk paragonu. Użytkownicy z uprawnieniem **Edycja produktów** mogą tworzyć i zmieniać produkty.

Wszystkie produkty znajdziesz w <UIPath>Administracja > Produkty</UIPath>.

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Przegląd produktów z produktem demonstracyjnym za jedną noc" />

<Callout type="info" title="Warto wiedzieć">
- Cena jest zawsze z VAT. Wybierasz 0%, 6%, 9%, 12% lub 21%.
- Zmiana ceny, konta księgowego lub akcji dotyczy linii, które dodasz później. Istniejące faktury się nie zmieniają.
- Nową cenę możesz zaplanować od dziś lub od późniejszego dnia, nie wstecz.
- Wyłączonego produktu nie można już wybrać na fakturach, ale zostaje on na istniejących fakturach.
- Usuniętego produktu nie da się przywrócić. Lepiej go wyłączyć.
- Dla każdej kombinacji typu klienta i typu licznika istnieje tylko jeden produkt z akcją **Zużycie licznika**.
- **Pokaż alert** może mieć maksymalnie 4000 znaków.
- Dla każdej drukarki ustawiasz maksymalnie 10 kopii przy automatycznym drukowaniu.
- Przy **Przedłuż metodę dostępu** liczysz maksymalnie 3660 dni po dacie końcowej.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Produkt nic nie robi, dopóki nie znajdzie się na fakturze. Jeśli produkt ma akcje, Tillor przenosi je na linię faktury. Zaksięgowanie i opłacenie uruchamiają te akcje, a ich wynik trafia do zajęcia miejsca, tagu lub drukarki.

```mermaid
flowchart TD
  P[Product met acties] --> R[Factuurregel op een conceptfactuur]
  R -- Boeken --> G[Geboekte factuur]
  G --> G1[Bezetting: Gefactureerd tot loopt op]
  G --> G2[Reservering aangemaakt bij Terrein vragen]
  G --> G3[Boeken geblokkeerd of contactgegevens gevraagd]
  G -- Betalen --> B[Betaalde factuur]
  B --> B1[Bezetting: Betaald tot loopt op]
  B --> B2[NFC-tag opgeladen]
  B --> B3[Toegangsmethode aangemaakt of verlengd]
  B --> B4[Bon of A4 afgedrukt]
```

Przykład z **Przedłuż okres zajęcia miejsca**: fakturujesz miesięczny czynsz klienta. Przy księgowaniu zajęcie miejsca jest do końca miesiąca oznaczone jako zafakturowane. Gdy tylko klient zapłaci, **Opłacone do** przesuwa się razem z nim. Dzięki temu na zajęciu miejsca widzisz, co jest już zafakturowane, a co już opłacone. Więcej na ten temat w [Zajęciach miejsc](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).

Faktura korygująca cofa to: zaksięgowanie ustawia **Zafakturowane do** z powrotem na początek linii, a opłacenie cofa **Opłacone do**. Zobacz [Przeksięgowanie wewnętrzne](/betalingsverwerking/interne-overboeking) na wypadek, gdy faktura korygująca jest rozliczana tylko z pierwotną fakturą.

## Co widzisz na liście [#wat-je-in-de-lijst-ziet]

| Kolumna | Zawartość |
|---------|-----------|
| **Nazwa** i **Opis** | Nazwa i objaśnienie, tak jak wpisano je w produkcie |
| **Info** | Typ klienta i typ licznika, tylko przy produktach z akcją **Zużycie licznika** |
| **Akcja** | Akcje ustawione w produkcie. Przy kilku akcjach kolumna pokazuje podsumowanie |
| **Cena (z VAT)** | Cena za jednostkę |
| **VAT %** | Stawka VAT |
| **Konto księgowe** | Numer konta księgowego, jeśli go wpisano |

W wierszu znajdziesz ikonę ołówka do otwarcia produktu i ikonę kosza do jego usunięcia. Obie są wyłączone, jeśli nie masz uprawnienia **Edycja produktów**.

### Wyszukiwanie i filtrowanie [#zoeken-en-filteren]

Wpisz tekst w pasku wyszukiwania, aby od razu przefiltrować listę. Dodatkowo możesz filtrować według **VAT**, **Typ klienta**, **Typ licznika**, **Typ akcji**, **Status** (<Status tone="success">Aktywny</Status> lub <Status>Wyłączony</Status>) i **Konta**. Za pomocą **Resetuj** czyścisz filtry jednym kliknięciem.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Tworzenie produktu" href="/producten/product-aanmaken" description="Ustawianie nazwy, ceny, VAT i konta księgowego" />
  <Card title="Edycja lub usuwanie produktu" href="/producten/product-bewerken" description="Zmiana danych, wyłączanie lub usuwanie" />
  <Card title="Planowanie zmiany ceny" href="/producten/prijzen-plannen" description="Nowa cena od daty i kalkulator VAT" />
  <Card title="Przypisywanie akcji do produktu" href="/producten/acties-instellen" description="Niech Tillor coś zrobi przy księgowaniu lub opłaceniu" />
  <Card title="Akcje produktu" href="/producten/productacties" description="Wszystkie akcje i ich ustawienia" />
  <Card title="Ustawianie dodatkowych linii faktury" href="/producten/bundel-instellen" description="Automatyczne dodawanie dopłat i objaśnień pod linią główną" />
  <Card title="Kroki pakietu" href="/producten/bundel-velden" description="Pola, klucze dynamiczne i placeholdery" />
  <Card title="JSON pakietu" href="/producten/bundel-json" description="Struktura pakietu dla importów" />
  <Card title="Przykłady z praktyki" href="/praktijk" description="Rozbudowane przykłady z praktyki" />
</Cards>

## Pojęcia [#begrippen]

- **Produkt**: cena i opis, które mogą trafić do linii faktury.
- **Akcja**: coś, co Tillor robi automatycznie, gdy linia faktury z tym produktem zostanie zaksięgowana lub opłacona.
- **Pakiet**: seria dodatkowych linii faktury, które Tillor umieszcza pod linią główną, na przykład dopłaty do Opłaty za postój.
- **Linia główna i linia podrzędna**: linia główna to linia z produktem pakietu, linie podrzędne to linie, które Tillor dodaje pod nią.
- **Zafakturowane do** i **Opłacone do**: do kiedy zajęcie miejsca jest zafakturowane, odpowiednio opłacone. Zobacz [Zajęcie miejsca](/begrippen#bezetting).
- **Konto księgowe**: numer konta w Twojej księgowości, na które księguje produkt.


# Planowanie zmiany ceny (/pl-PL/producten/prijzen-plannen)

Jeśli cena produktu zmienia się od określonego dnia, planujesz ją z góry. W tym dniu Tillor sam zmienia cenę produktu. Istniejące faktury zachowują swoje ceny.

<Requires permission="Edycja produktów" />

## Planowanie ceny [#een-prijs-plannen]

<Steps>
<Step>
### Otwórz produkt [#open-het-product]
Przejdź do <UIPath>Administracja > Produkty</UIPath> i otwórz produkt. Na dole strony znajdziesz kartę **Zaplanowane ceny**.

<DocScreenshot src="/screenshots/producten/product-price-changes.png" alt="Karta Zaplanowane ceny z jedną zaplanowaną i jedną zastosowaną ceną" />
</Step>
<Step>
### Wybierz datę [#kies-de-datum]
W polu **Obowiązuje od** wybierz dzień, w którym nowa cena zaczyna obowiązywać. Dzisiaj też można, dnia z przeszłości nie.
</Step>
<Step>
### Wpisz cenę [#vul-de-prijs-in]
Wpisz **Nowa cena (z VAT)**. W polu **Stawka VAT** zostaw **Obecna stawka VAT** albo wybierz inną stawkę, która obowiązuje od tego dnia. Możesz też wybrać [reżim bez VAT](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), na przykład **Odwrotne obciążenie (usługi UE)**; produkt ma wtedy od tego dnia 0% w tym reżimie.
</Step>
<Step>
### Zaplanuj cenę [#plan-de-prijs]
Kliknij **Zaplanuj cenę**. Cena pojawi się na liście ze statusem <Status tone="info">Zaplanowana</Status>.
</Step>
</Steps>

Jeśli jako datę wybierzesz dzisiaj, nowa cena obowiązuje od razu. Przy późniejszej dacie cena obowiązuje od początku tego dnia. Tillor liczy przy tym według strefy czasowej Twojej organizacji.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

Produkt dostaje nową cenę, a ewentualnie także nową stawkę VAT. Wiersz na liście dostaje status <Status tone="success">Zastosowana</Status>. Tillor wysyła e-mail na adres wsparcia Twojej organizacji albo, gdy go brak, na ogólny adres e-mail. Powiadomienie nazywa się **Zastosowano zaplanowaną cenę produktu** i pokazuje starą oraz nową cenę. Zobacz też [Powiadomienia](/notificaties).

Istniejące faktury się nie zmieniają. Nową cenę dostają tylko linie, które dodasz później.

## Zmiana lub usunięcie zaplanowanej ceny [#een-geplande-prijs-wijzigen-of-verwijderen]

- Jeśli zaplanujesz cenę na ten sam dzień, gdy jest już zaplanowana cena, nowa zastępuje starą.
- Kliknij ikonę kosza przy zaplanowanej cenie i potwierdź przyciskiem **Usuń zaplanowaną cenę**. Produkt zachowuje w tej dacie swoją obecną cenę.
- Cena ze statusem <Status tone="success">Zastosowana</Status> zostaje jako historia i nie możesz jej usunąć.

## Kalkulator VAT [#de-btw-calculator]

Obok pola ceny, zarówno przy **Nowa cena (z VAT)**, jak i przy **Cena (z VAT)** w **Ogólne**, jest ikona kalkulatora. Otwiera ona **Kalkulator VAT**.

<DocScreenshot src="/screenshots/producten/product-vat-calculator.png" alt="Kalkulator VAT ze stawką VAT, kwotą netto i brutto oraz zmianą ceny o procent" />

W kalkulatorze możesz:

- wpisać kwotę **Netto** lub **Brutto**. Druga kwota i VAT są od razu przeliczane.
- wybrać inną **Stawkę VAT**. Cena brutto jest wtedy liczona na nowo z kwoty netto.
- w polu **Zmień cenę o %** wpisać procent, na przykład 5 dla pięciu procent więcej albo -5 dla pięciu procent mniej, i kliknąć **Zastosuj**.

Kliknij **Użyj tej ceny**, aby wstawić cenę i stawkę VAT do formularza. Potem musisz jeszcze zapisać albo zaplanować cenę.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę wybrać daty z przeszłości">
Cena może obowiązywać tylko od dzisiaj lub później. Jeśli chcesz zmienić cenę wstecz, popraw same faktury.
</Accordion>
<Accordion title="Zaplanuj cenę jest wyszarzone">
Potrzebujesz do tego uprawnienia **Edycja produktów**.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Edycja lub usuwanie produktu" href="/producten/product-bewerken" />
  <Card title="Powiadomienia" href="/notificaties" />
</Cards>


# Tworzenie produktu (/pl-PL/producten/product-aanmaken)

Nowy produkt jest od razu dostępny na fakturach. Akcje i dodatkowe linie faktury ustawiasz potem na stronie produktu.

<Requires permission="Edycja produktów" />

<Steps>
<Step>
### Otwórz okno dialogowe [#open-het-dialoogvenster]

Przejdź do <UIPath>Administracja > Produkty</UIPath> i kliknij w prawym górnym rogu **Nowy produkt**.
</Step>
<Step>
### Wypełnij podstawowe dane [#vul-de-basisgegevens-in]

<DocScreenshot src="/screenshots/producten/product-create-dialog.png" alt="Okno Utwórz produkt z podstawowymi polami" />

| Pole | Co wpisujesz |
|------|--------------|
| **Nazwa** (wymagane) | Nazwa, która pojawia się na fakturach |
| **Opis** | Krótkie objaśnienie (opcjonalnie) |
| **Cena (z VAT)** | Kwota za jednostkę, z VAT |
| **VAT %** | Wybierz 0%, 6%, 9%, 12% lub 21% albo reżim bez VAT, taki jak **Odwrotne obciążenie (usługi UE)**. Zobacz [Odwrotne obciążenie i inne reżimy](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) |
| **Konto księgowe** | Numer konta księgowego dla Twojej księgowości (opcjonalnie) |
| **Pilnuj salda klienta na tym koncie** | Dla kaucji: odrzuca faktury, które sprowadziłyby saldo klienta poniżej zera. Zobacz [Pilnowanie salda klienta](#het-saldo-van-de-klant-bewaken) |
</Step>
<Step>
### Utwórz produkt [#maak-het-product-aan]

Kliknij **Utwórz**. Tillor otwiera stronę produktu, na której możesz dodać akcje i dodatkowe linie faktury.
</Step>
</Steps>

<Callout type="info">
Cena jest zawsze z VAT. Tillor oblicza kwotę VAT według wybranego procentu i pokazuje ją osobno na fakturze.
</Callout>

## Numer konta księgowego [#grootboeknummer]

Numerem konta księgowego łączysz produkt z kontem w swojej księgowości. Numer jest używany przy eksporcie do oprogramowania księgowego. Zostaw pole puste, jeśli nie chcesz łączyć produktu z własnym kontem.

Zmiana numeru konta księgowego dotyczy nowych linii faktury. Zaksięgowane faktury się nie zmieniają.

## Pilnowanie salda klienta [#het-saldo-van-de-klant-bewaken]

Dla kaucji zaznacz **Pilnuj salda klienta na tym koncie**. Tillor sumuje wtedy dla każdego klienta wszystkie zaksięgowane linie faktur na tym koncie i odrzuca każdą fakturę, która sprowadziłaby to saldo poniżej zera. Dzięki temu nie zwrócisz kaucji przez pomyłkę dwa razy. Ta opcja wymaga numeru konta księgowego.

Na fakturze widzisz pod linią saldo klienta na tym koncie oraz to, jakie będzie po tej fakturze. Wersje robocze się nie liczą. Zaksięgowanej faktury kaucji nie można też cofnąć do wersji roboczej ani przenieść do innego klienta, jeśli saldo spadłoby przez to poniżej zera.

Na karcie **Fakturowanie** klienta, w sekcji **Faktury**, jest tabela **Konta**: każde konto księgowe, na którym dla tego klienta coś zaksięgowano lub na którym jest [saldo otwarcia](#beginsaldi-van-voor-tillor), wraz z saldem. Także konto, które netto wynosi zero, pozostaje widoczne. Pilnowanego konta, na którym klient nie ma jeszcze nic zaksięgowanego, tam nie ma.

Jeśli co najmniej jeden produkt pilnuje konta księgowego, filtr **Zabezpieczenia** jest domyślnie ustawiony na **Wł.** i widzisz tylko pilnowane konta. Wyczyść filtr, aby zobaczyć także pozostałe konta, takie jak konta przychodów. Bez pilnowanych produktów filtr jest wyłączony i od razu widzisz wszystkie konta. Za pomocą filtra **Saldo** zostawiasz tylko konta, które nie wynoszą zero. Tarcza obok numeru pokazuje, które konta są pilnowane.

Rozwiń konto, a zobaczysz zaksięgowane faktury z linią na tym koncie, od najstarszej do najnowszej, z kwotą i **Saldo narastająco**: saldem po tej fakturze. Jeśli na koncie jest więcej niż 100 faktur, widzisz ostatnie 100. Saldo narastająco uwzględnia jednak starsze faktury.

Z uprawnieniem **Pomijanie salda konta** możesz mimo to zaksięgować. Podajesz wtedy uzasadnienie, które trafia na oś czasu faktury. Bez tego uprawnienia przycisk księgowania pozostaje wyszarzony, dopóki saldo spadłoby poniżej zera.

<Requires permission="Pomijanie salda konta" />

## Salda otwarcia sprzed Tillor [#beginsaldi-van-voor-tillor]

Kaucja, którą klient zapłacił, zanim zacząłeś korzystać z Tillor, nie znajduje się na żadnej fakturze w Tillor. Wpisz taką kwotę jako **saldo otwarcia** na koncie klienta. Liczy się ono w saldzie i w pilnowaniu, więc taką kaucję zwrócisz później zwyczajnie, bez uzasadnienia. Saldo otwarcia nie jest fakturą: nie dostaje numeru ani VAT i nie trafia do Twojej księgowości, bo Twoja dawna księgowość już je ma.

**Jeden klient:** otwórz klienta, zakładkę **Fakturowanie**, kartę **Konta**, i kliknij **Saldo otwarcia**. Wpisz konto (np. 428002), kwotę, datę dawnego salda i odniesienie, na przykład dokument z dawnego systemu. Kwota ujemna to kwota, którą klient jeszcze jest winien. Rozwiń konto, a zobaczysz saldo otwarcia na początku salda narastająco, z przyciskami do jego zmiany lub usunięcia. Pod saldem widać, jaka jego część jest saldem otwarcia.

**Wszyscy klienci naraz:** przejdź do <UIPath>Administracja > Faktury</UIPath> i kliknij **Importuj salda otwarcia**. Wklej wiersze z arkusza albo wybierz plik CSV, z wierszem nagłówka i kolumnami: klient (numer klienta w Tillor), konto, kwota, data, odniesienie i ewentualnie notatka. Kliknij **Sprawdź**: zobaczysz, które wiersze są nowe, które Tillor aktualizuje i których klientów nie znaleziono, plus sumę dla każdego konta. Porównaj tę sumę z bilansem swojej dawnej księgowości, a potem kliknij **Importuj**. Wiersz z odniesieniem, które klient ma już na tym koncie, aktualizuje to saldo otwarcia zamiast dodawać je podwójnie, więc import możesz spokojnie powtórzyć.

Salda otwarcia, które zostało już zwrócone, normalnie nie można usunąć ani zmniejszyć: saldo spadłoby wtedy poniżej zera. Jeśli masz uprawnienie **Pomijanie salda konta**, Tillor w takim przypadku prosi o uzasadnienie i mimo to wykonuje zmianę, na przykład aby usunąć stare, scalone saldo otwarcia klientowi, który swoją kaucję już w Tillor otrzymał z powrotem. Dotyczy to także importu, który sprowadza saldo poniżej zera. Każda zmiana trafia na oś czasu klienta, wraz z Twoim uzasadnieniem, jeśli pominąłeś pilnowanie.

<Requires permission="Zarządzanie saldami otwarcia" />

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Produkt jest od razu na liście i możesz go wybierać na fakturach w wersji roboczej.
- Na stronie produktu ustawiasz potem [akcje](/producten/acties-instellen), [dodatkowe linie faktury](/producten/bundel-instellen) i [zaplanowane ceny](/producten/prijzen-plannen).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę utworzyć ani zmienić produktu">
Tworzenie i zmiana wymagają uprawnienia **Edycja produktów**. Poproś administratora swojej organizacji o dodanie tego uprawnienia do Twojej roli.
</Accordion>
<Accordion title="Brakuje mi stawki VAT">
Możesz wybierać tylko spośród 0%, 6%, 9%, 12% i 21%. Innych stawek nie można ustawić.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Edycja lub usuwanie produktu" href="/producten/product-bewerken" />
  <Card title="Przypisywanie akcji do produktu" href="/producten/acties-instellen" />
  <Card title="VAT i podatki" href="/boekhouden/belasting" />
</Cards>


# Edycja lub usuwanie produktu (/pl-PL/producten/product-bewerken)

Na stronie produktu zmieniasz wszystko, co dotyczy produktu. Zmiany działają na nowe linie faktury.

<Requires permission="Edycja produktów" />

## Edycja produktu [#een-product-bewerken]

<Steps>
<Step>
### Otwórz produkt [#open-het-product]

Przejdź do <UIPath>Administracja > Produkty</UIPath> i kliknij nazwę produktu albo ikonę ołówka w wierszu.
</Step>
<Step>
### Zmień dane [#pas-de-gegevens-aan]

<DocScreenshot src="/screenshots/producten/product-detail.png" alt="Strona szczegółów produktu z kartami Ogólne, Dodatkowe linie faktury, Akcje linii faktury i Zdarzenia" />

Po lewej znajdziesz karty **Ogólne** i **Dodatkowe linie faktury**. Po prawej są **Akcje linii faktury** i **Zdarzenia**. W **Ogólne** są te same pola co przy tworzeniu, plus opcja **Wyłącz produkt**.
</Step>
<Step>
### Zapisz [#sla-op]

Kliknij **Zapisz** na dole karty **Dodatkowe linie faktury**. Ten przycisk zapisuje wszystkie zmiany na stronie, także te w **Ogólne** i **Akcje linii faktury**. Przycisk jest aktywny dopiero po wprowadzeniu zmiany.
</Step>
</Steps>

Jeśli chcesz, aby nowa cena obowiązywała dopiero od późniejszej daty, użyj karty **Zaplanowane ceny**. Zobacz [Planowanie zmiany ceny](/producten/prijzen-plannen).

W **Zdarzenia** widzisz oś czasu zmian produktu, takich jak cena, konto księgowe i akcje. Przy każdej zmianie podano czas, użytkownika i, jeśli to możliwe, różnicę między stanem przed i po.

## Wyłączanie produktu [#een-product-uitschakelen]

Zaznacz **Wyłącz produkt** i zapisz. Wyłączonego produktu nie można już wybrać na fakturach, ale zostaje on na liście i na istniejących fakturach. Na liście i na stronie produktu widzisz go jako <Status>Wyłączony</Status>. Dzięki temu zachowujesz historię, nie używając już produktu.

## Usuwanie produktu [#een-product-verwijderen]

<Steps>
<Step>
### Wybierz usuwanie [#kies-verwijderen]

Kliknij na liście ikonę kosza obok produktu. Na stronie produktu otwórz menu z trzema kropkami w nagłówku i wybierz **Usuń produkt**.
</Step>
<Step>
### Potwierdź [#bevestig]

<DocScreenshot src="/screenshots/producten/product-delete-dialog.png" alt="Okno potwierdzenia usunięcia produktu" />

Kliknij w oknie dialogowym **Usuń**.
</Step>
</Steps>

<Callout type="warn" title="Uwaga">
Usunięcia nie można cofnąć. Faktury, na których produkt już się znajduje, pozostają bez zmian. Jeśli produkt jest krokiem w pakiecie innego produktu, Tillor odtąd pomija ten krok. Jeśli chcesz tylko przestać używać produktu, lepiej go wyłącz.
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Nowa cena, inne konto księgowe lub inna akcja dotyczy linii, które dodasz później. Istniejące faktury pozostają takie, jakie były.
- Wyłączony produkt znika z listy wyboru na fakturach, ale pozostaje widoczny na liście produktów.
- Każda zmiana trafia na oś czasu **Zdarzenia** produktu, z użytkownikiem i czasem.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Zapisz jest wyszarzone">
Przycisk działa dopiero po wprowadzeniu zmiany i tylko z uprawnieniem **Edycja produktów**.
</Accordion>
<Accordion title="Pakiet nie jest zapisywany">
Każdy krok produktu w pakiecie musi mieć produkt, a każdy krok informacyjny musi mieć tekst. Uzupełnij to i zapisz ponownie. Zobacz [Ustawianie dodatkowych linii faktury](/producten/bundel-instellen).
</Accordion>
<Accordion title="Zapis nie udaje się przy produkcie z akcją Zużycie licznika">
Dla każdej kombinacji typu klienta i typu licznika może istnieć tylko jeden produkt z akcją **Zużycie licznika**. Jeśli ta kombinacja jest już w innym produkcie, zapis zostaje odrzucony. Zmień tamten produkt albo wybierz inną kombinację.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Przypisywanie akcji do produktu" href="/producten/acties-instellen" />
  <Card title="Planowanie zmiany ceny" href="/producten/prijzen-plannen" />
  <Card title="Ustawianie dodatkowych linii faktury" href="/producten/bundel-instellen" />
</Cards>


# Akcje produktu (/pl-PL/producten/productacties)

Akcje włączasz na stronie produktu, w karcie **Akcje linii faktury**. Jak to zrobić, opisano w [Przypisywaniu akcji do produktu](/producten/acties-instellen). Ta strona opisuje każdą akcję. Jak akcje przy księgowaniu i opłacaniu łączą się z zajęciami miejsc, tagami i drukarkami, zobaczysz w [Jak to się łączy?](/producten#hoe-hangt-dit-samen).

## Doładuj tag NFC [#nfc-tag-opladen]

Gdy faktura z tym produktem zostanie opłacona, Tillor automatycznie doładowuje tag NFC. Używaj tego dla produktów, dzięki którym klienci dostają saldo lub dostęp na tagu. Produkt nie ma dodatkowych pól.

## Okres [#periode]

Produkt oznacza usługę obejmującą okres czasu, taką jak cena dzienna, abonament tygodniowy lub stawka miesięczna.

| Pole | Znaczenie |
|------|-----------|
| **Na jednostkę** | Liczba jednostek na okres, minimum 1 |
| **Jednostka okresu** | **Dzień**, **Tydzień** lub **Miesiąc** |
| **Automatycznie przedłuż metody dostępu** | Przy opłaceniu Tillor przedłuża wszystkie metody dostępu klienta do daty końcowej okresu |
| **Pytaj o działkę** | Na linii faktury wybierasz teren. Przy księgowaniu Tillor tworzy rezerwację na ten pobyt |
| **Zamelduj przy rezerwacji** | Tylko z **Pytaj o działkę**. Gdy tylko faktura zostanie zaksięgowana, Tillor ustawia rezerwację na <Status tone="success">Zameldowana</Status> |
| **Zamelduj przy płatności** | Tylko z **Pytaj o działkę**. Gdy tylko faktura zostanie opłacona, Tillor ustawia rezerwację na <Status tone="success">Zameldowana</Status> |
| **Dorośli w cenie** | Tylko z **Pytaj o działkę**. Liczba dorosłych w rezerwacji, domyślnie 2. Możesz wpisać od 0 do 99 |

### Rezerwacje przy Pytaj o działkę [#reserveringen-bij-terrein-vragen]

- Rezerwacja dostaje ten sam przyjazd i wyjazd co linia faktury oraz wybrany teren jako preferencję. Skład grupy zmieniasz potem w samej rezerwacji.
- Jeśli cofniesz fakturę do wersji roboczej i zmienisz daty lub teren, Tillor przy ponownym księgowaniu aktualizuje tę samą rezerwację.
- Jeśli usuniesz teren albo wyłączysz **Pytaj o działkę**, rezerwacja zostaje anulowana. Rezerwacja, z której już wymeldowano, zostaje.
- Faktura korygująca anuluje rezerwację z pierwotnej faktury.
- Bez meldowania rezerwacja pozostaje <Status tone="info">Zarezerwowana</Status>. Tak działa zaliczka na rezerwację: teren i daty w przyszłości, bez przyjazdu.
- Jeśli obie opcje meldowania są włączone, liczy się księgowanie.
- Jeśli faktura jest już opłacona w chwili ponownego księgowania, Tillor melduje ponownie.

Na osi czasu faktury i rezerwacji widzisz tworzenie, zmianę, anulowanie i meldowanie, z odnośnikiem do drugiej strony.

## Przedłuż okres zajęcia miejsca [#bezetting-verlengen]

Za pomocą tej akcji faktura przedłuża zajęcie miejsca klienta na terenie, na przykład dla Opłaty za postój.

- Przy **księgowaniu** Tillor zmienia **Zafakturowane do** zajęcia miejsca.
- Przy **opłaceniu** Tillor zmienia **Opłacone do**.

Na linii faktury wybierasz teren. Przy księgowaniu i opłacaniu Tillor łączy aktywne zajęcie miejsca klienta na tym terenie. Tillor zapisuje też na linii kopię tego zajęcia, dzięki czemu później widzisz, o jakie zajęcie chodziło, także gdy zostało usunięte. Za pomocą **Zaokrąglij do granicy następnego okresu** na linii faktury wyrównujesz klientów w czasie do tego samego cyklu, według **Częstotliwość czynszu** zajęcia miejsca.

Jeśli wybierzesz teren, na którym klient nie ma jeszcze zajęcia miejsca, tworzysz ofertę. Taką linię możesz zaksięgować dopiero, gdy klient zajmuje ten teren.

| Pole | Znaczenie |
|------|-----------|
| **Termin płatności od początku zajęcia miejsca** | Przy księgowaniu Tillor ustawia termin płatności na datę początku okresu zajęcia miejsca na linii Opłaty za postój, zamiast standardowego terminu płatności lub terminu z okna księgowania. Przy ponownym księgowaniu pierwotny termin płatności zostaje |

Jeśli produkt ma dodatkowe linie faktury, Tillor dodaje linie podrzędne pod linią główną. Zobacz [Ustawianie dodatkowych linii faktury](/producten/bundel-instellen).

## Przedłuż metodę dostępu [#toegangsmethode-verlengen]

Za pomocą tej akcji opłacenie faktury przedłuża ważność metod dostępu klienta. Działa to na dwa sposoby:

- **Razem z Okres** na tej samej linii, na przykład czynsz miesięczny. Tillor przedłuża wybrane metody do daty końcowej okresu.
- **Przez pakiet** z linią główną Opłaty za postój i krokami NFC. Podstawą jest wtedy data końcowa linii głównej Opłaty za postój. Poniższe ustawienia pochodzą z produktu głównego, nie z produktu dopłaty w kroku NFC. Zobacz [Przedłużanie NFC przez pakiet](/producten/bundel-instellen#nfc-verlengen-via-de-bundel).

| Pole | Znaczenie |
|------|-----------|
| **Dni po dacie końca** | Dni kalendarzowe ponad datę końcową. 0 oznacza samą datę końcową, maksymalnie 3660. Przy pakietach ustawiasz to dla każdego kroku NFC |
| **Dzień tygodnia** | Opcjonalne. Ważność kończy się w najbliższym takim dniu tygodnia w okolicy daty docelowej. Domyślnie **Dowolny dzień** |
| **Godzina** | Opcjonalne. Godzina w strefie czasowej organizacji. Puste oznacza 23:59 |
| **Typy metod dostępu** | Wybierz co najmniej jeden typ spośród NFC, Kod QR, Rozpoznawanie tablic rejestracyjnych i Kod PIN. Widzisz tylko typy włączone dla Twojej organizacji |
| **Statusy** | Przedłużane są tylko metody z jednym z tych statusów: <Status tone="success">Aktywna</Status> lub <Status tone="warning">Miękko zablokowana</Status>. Domyślnie tylko **Aktywna** |
| **Nie skracaj przy przedłużeniu** | Metody, których **Ważne do** przypada już na nową datę lub później, są pomijane. Przy cofnięciu przez fakturę korygującą Tillor zawsze ustawia obliczoną datę |

Pod polem jest wiersz **Wynik na przykładzie**, który wyjaśnia, na który moment wypada ważność, na przykład "najbliższy wtorek w okolicy daty końcowej + 10 dni, o 13:00".

To nie to samo co **Automatycznie przedłuż metody dostępu** przy **Okres**. Ten przełącznik przedłuża przy opłaceniu produktu z samym **Okres**, bez osobnej akcji **Przedłuż metodę dostępu**.

## Utwórz metodę dostępu [#toegangsmethode-aanmaken]

Przy opłaceniu faktury Tillor tworzy dla klienta nową metodę dostępu. Pracownik kasy wybiera typ na linii faktury. Jeśli linia ma też akcję **Okres**, okres staje się ważnością metody dostępu.

| Pole | Znaczenie |
|------|-----------|
| **Typy metod dostępu** | Typy, spośród których wybiera pracownik kasy: Kod QR, Rozpoznawanie tablic rejestracyjnych lub Kod PIN. Przy jednym typie Tillor wybiera go automatycznie |
| **Metoda dostępu jest opcjonalna** | Księgowanie nigdy nie jest blokowane przez tę linię. Bez wybranego typu Tillor niczego nie tworzy |
| **Domyślna metoda dostępu** | Tylko przy kilku typach. Ten typ jest domyślnie zaznaczony na nowych liniach faktury i można go zmienić dla każdej linii. **Brak domyślnej (wybór na pozycji)** zostawia wybór otwarty |
| **Automatycznie drukuj kod QR** | Tylko z Kodem QR. Tillor drukuje bilet dostępu z kodem QR na drukarce paragonów zaraz po jego utworzeniu |
| **Automatycznie zamieniaj kody na tablicę rejestracyjną** | Nowe kody QR i PIN są zastępowane wykrytą tablicą rejestracyjną, gdy są używane przy bramie z kamerą. Można zmienić dla każdej linii |

Linię można zaksięgować dopiero po wybraniu typu, chyba że akcja jest opcjonalna. Przy Rozpoznawaniu tablic rejestracyjnych trzeba też wpisać numer rejestracyjny.

## Poproś o dane kontaktowe [#contactgegevens-vragen]

Na linii faktury pojawiają się pola na adres e-mail i numer telefonu. Tillor prosi o nie przy księgowaniu.

| Pole | Znaczenie |
|------|-----------|
| **Pytaj o adres e-mail** | Pokazuje pole e-mail na linii faktury |
| **Adres e-mail wymagany** | Tylko jeśli pytasz o adres e-mail. Księgowanie jest zablokowane, dopóki pole nie zostanie wypełnione |
| **Pytaj o numer telefonu** | Pokazuje pole telefonu na linii faktury |
| **Numer telefonu wymagany** | Tylko jeśli pytasz o numer telefonu. Księgowanie jest zablokowane, dopóki pole nie zostanie wypełnione |

## Zablokuj księgowanie [#boeken-blokkeren]

Używaj tego dla produktów, które powinny być tylko na fakturach w wersji roboczej. Jeśli taka linia jest na fakturze w wersji roboczej, nie możesz sfinalizować faktury. Nie ma dodatkowego pola. Tillor blokuje księgowanie, dopóki linia tam jest.

## Pokaż alert [#melding-tonen]

Pokazuje alert pod linią faktury, na przykład "Uwaga: używać tylko dla turystów jednodniowych". Przy księgowaniu ani opłacaniu nic się nie dzieje.

| Pole | Znaczenie |
|------|-----------|
| **Styl alertu** | **Informacja**, **Ostrzeżenie**, **Błąd**, **Powodzenie** lub **Neutralny** |
| **Treść alertu** | Tekst, maksymalnie 4000 znaków. Obsługiwany jest Markdown (pogrubienie, listy, linki) |

Pod tekstem od razu widzisz podgląd alertu. Tekst jest kopiowany na linię faktury. Późniejsze zmiany w produkcie nie zmieniają istniejących faktur.

## Zużycie licznika [#meterverbruik]

Za pomocą tej akcji produkt staje się taryfą za zużycie licznika. Tillor używa go przy otwartym zużyciu i przy automatycznym fakturowaniu odczytów liczników. Wybierasz dwa pola.

| Pole | Opcje |
|------|-------|
| **Typ klienta** | **Domyślny**, **Przyczepa kempingowa do wynajęcia dla pracowników**, **Pracownik holujący karawanę** |
| **Typ licznika** | **Elektryczność**, **Woda**, **Gaz** |

Dla każdej kombinacji typu klienta i typu licznika może istnieć tylko jeden produkt. Na liście obie wartości są w kolumnie **Info**. Jeśli klient nie ma własnego produktu dla swojego typu klienta, Tillor używa produktu dla **Domyślny** z tym samym typem licznika.

## Druk termiczny i druk A4 [#thermisch-printen-en-a4-printen]

Zaznacz **Druk termiczny** i **Druk A4** osobno. Gdy co najmniej jedno z nich jest włączone, pojawia się blok **Automatyczny druk**. Tam ustawiasz dla każdej drukarki, co jest drukowane przy opłaceniu faktury.

| Pole | Znaczenie |
|------|-----------|
| **Kopie druku termicznego** | Liczba egzemplarzy na drukarce termicznej (drukarce paragonów). 0 wyłącza tę drukarkę |
| **Kopie druku A4** | Liczba egzemplarzy na drukarce A4. 0 wyłącza A4 |
| **Czas druku** | **Użyj ustawień (według typu płatności)** (domyślnie), **Drukuj natychmiast** lub **Następny termin odcięcia** |

Dla każdej drukarki możesz ustawić maksymalnie 10 kopii. Przy **Użyj ustawień (według typu płatności)** obowiązuje ustawienie Twojej organizacji dla każdego typu płatności.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Przypisywanie akcji do produktu" href="/producten/acties-instellen" />
  <Card title="Ustawianie dodatkowych linii faktury" href="/producten/bundel-instellen" />
  <Card title="Zarządzanie licznikami" href="/meterbeheer" />
  <Card title="NFC" href="/nfc" />
</Cards>


# Rezerwacje (/pl-PL/reserveringen)

Dzięki rezerwacjom śledzisz pobyty na swoim parku: kto przyjeżdża kiedy, na które miejsce i z iloma gośćmi. Z poziomu rezerwacji obsługujesz też zameldowanie i wymeldowanie. Wszystkie rezerwacje widzisz na osi czasu w **Rezerwacje** oraz dla każdego klienta na zakładce **Rezerwacje**. Zacznij od [Tworzenia rezerwacji](#een-reservering-aanmaken).

<Callout type="info" title="Warto wiedzieć">
- Każda rezerwacja należy do klienta i automatycznie dostaje unikalny **Numer rezerwacji**. Tego numeru nie można zmienić.
- Data wymeldowania musi przypadać po dacie zameldowania. Tillor odrzuca ten sam dzień lub wcześniejszy.
- Numer rejestracyjny składa się z liter i cyfr, maksymalnie 10 znaków, bez spacji i myślników.
- Zameldowanie i anulowanie są możliwe tylko ze statusu **Zarezerwowana**. Po zameldowaniu nie można już anulować.
- Rezerwacja to nie to samo co zajęcie miejsca: rezerwacja to zamówienie pobytu, zajęcie miejsca łączy klienta z terenem na okres, zobacz [Zajęcia miejsc](/bezettingen).
- Notatki przy rezerwacji są wewnętrzne i nigdy nie są udostępniane klientowi.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Klant] --> R[Reservering]
  R -->|Inchecken| I[Gast op het terrein]
  I -->|Uitchecken| U[Verblijf afgerond]
  R -->|Reservering annuleren| A[Geannuleerd]
  R --> F[Facturen van de klant]
```

Faktury klienta znajdziesz w profilu klienta w **Fakturowanie**.

## Oś czasu [#de-tijdlijn]

Przejdź do **Rezerwacje** w menu głównym. Oś czasu pokazuje rezerwacje według terenu na kalendarzu. Za pomocą widoku wybierasz dzień, tydzień, miesiąc, kwartał lub rok, a do daty przeskakujesz przyciskiem **Przejdź do daty**.

<DocScreenshot src="/screenshots/reserveringen/reservations-list.png" alt="Oś czasu rezerwacji" />

- Kliknij lub przeciągnij po wolnym fragmencie, aby dodać rezerwację. W prawym górnym rogu jest też **Nowa rezerwacja**.
- Jeśli przeciągniesz rezerwację na inne daty, Tillor zapyta **Zaktualizować daty rezerwacji?** Dopiero po Twoim potwierdzeniu rezerwacja się zmienia.
- Menu kontekstowe rezerwacji zawiera **Wyświetl rezerwację**, **Kopiuj link** i **Anuluj rezerwację**.

## Tworzenie rezerwacji [#een-reservering-aanmaken]

Zanim zaczniesz:

- Potrzebujesz klienta. Jeśli jeszcze nie istnieje, utworzysz go przy rozpoczynaniu, zobacz [Zarządzanie klientami](/klantenbeheer).
- Wiesz, które miejsce chce gość? Wtedy je wybierz. W przeciwnym razie zostaw pole puste.

<Steps>
<Step>
### Rozpocznij rezerwację [#start-de-reservering]
<Tabs items={["Via Reserveringen", "Via het klantprofiel"]}>
<Tab value="Via Reserveringen">
Kliknij w prawym górnym rogu **Nowa rezerwacja**. Wybierz istniejącego klienta albo utwórz nowego.
</Tab>
<Tab value="Via het klantprofiel">
Otwórz klienta przez **Klienci**, przejdź do zakładki **Rezerwacje** i kliknij **Nowa rezerwacja**.
</Tab>
</Tabs>
</Step>
<Step>
### Wypełnij formularz [#vul-het-formulier-in]
Wszystkie pola opisano poniżej w [Formularzu rezerwacji](#het-reserveringsformulier).
</Step>
<Step>
### Utwórz rezerwację [#maak-de-reservering-aan]
Kliknij **Utwórz rezerwację**.
</Step>
</Steps>

### Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Rezerwacja dostaje status <Status tone="info">Zarezerwowana</Status> i numer rezerwacji.
- Jeśli **Automatyczny e-mail potwierdzający** jest włączony, klient dostaje potwierdzenie.
- Rezerwację znajdziesz na osi czasu i na zakładce **Rezerwacje** klienta.
- Jeśli chcesz, aby automatyzacja reagowała na nową lub zmienioną rezerwację, użyj wyzwalacza, zobacz [Wyzwalacze](/automatiseringen/triggers).

## Formularz rezerwacji [#het-reserveringsformulier]

### Daty i czas pobytu [#datums-en-verblijfsduur]

- **Zameldowanie**: wybierz datę przyjazdu.
- **Wymeldowanie**: wybierz datę wyjazdu. Po dacie zameldowania selektor wymeldowania otwiera się sam. Data wyjazdu musi przypadać po dacie przyjazdu.
- **Liczba nocy**: Tillor oblicza to sam.

### Liczby i zwierzęta [#aantallen-en-dieren]

Podaj liczbę **Dorośli** (minimum 1), **Dzieci**, **Maluchy** i **Zwierzęta** za pomocą przycisków plus i minus.

### Miejsce [#terrein]

- **Miejsce**: wybierz miejsce, jeśli gość ma preferencję. Lista pokazuje tylko miejsca dostępne do rezerwacji, bez aktywnego zajęcia, które są wolne w wybranym okresie. Nakładające się aktywne rezerwacje na tym samym miejscu Tillor wyklucza. Jeśli zmienisz daty, lista się odświeża. Brak preferencji? Zostaw pole puste.
- **Uwzględnij miejsca niedostępne do rezerwacji**: pokazuje też miejsca, których nie można rezerwować online, na przykład stałe miejsca roczne. Jeśli rezerwacja jest już na takim miejscu, ta opcja jest zaznaczona automatycznie.
- **Uwzględnij zajęte działki**: pokazuje też miejsca, które mają już zajęcie.

### Numery rejestracyjne [#nummerplaten]

Wpisz numer rejestracyjny, naciśnij **Enter** i powtórz dla każdej tablicy. Krzyżyk na tablicy usuwa ją. Numery rejestracyjne mogą zawierać tylko litery i cyfry, maksymalnie 10 znaków.

Numery rejestracyjne przy rezerwacji można znaleźć przez wyszukiwanie. Dostęp przy szlabanie ustawiasz osobno, u klienta na zakładce **Kontrola dostępu**, zobacz [Kontrola dostępu](/toegangscontrole).

### Notatki [#notities]

Użyj pola notatek do wewnętrznych uwag, takich jak specjalne życzenia lub ustalenia.

### Preferencje komunikacji [#communicatievoorkeuren]

- **Automatyczny e-mail potwierdzający**: wysyła potwierdzenie po utworzeniu.
- **Płatność online**: pozwala klientowi zapłacić za rezerwację online.

## Podgląd i edycja rezerwacji [#een-reservering-bekijken-en-bewerken]

Kliknij rezerwację na osi czasu lub w profilu klienta, aby otworzyć stronę szczegółów.

<DocScreenshot src="/screenshots/reserveringen/reservation-detail.png" alt="Strona szczegółów rezerwacji" />

- **Szczegóły rezerwacji** (po lewej): pełny formularz. Zmień, co chcesz, i kliknij **Zapisz**. Za pomocą **Anuluj** przywracasz pierwotne wartości. Obok tytułu jest **Kopiuj link do rezerwacji**, przydatny do wklejenia klikalnego linku w dokumencie.
- **Akcje rezerwacji** (po prawej): przyciski opisane poniżej.
- **Komentarze** (po prawej): wewnętrzna dyskusja o tej rezerwacji.
- **Aktywność** (po prawej): oś czasu z utworzeniem, zameldowaniem, wymeldowaniem, anulowaniem, cofnięciem i zmienionymi danymi, z czasem i użytkownikiem. Przy zmianie widzisz, które pola zostały zmienione (przed / po).

## Zameldowanie, wymeldowanie i anulowanie [#inchecken-uitchecken-en-annuleren]

Na stronie szczegółów akcje znajdują się w **Akcje rezerwacji**. Każda akcja wymaga potwierdzenia.

| Akcja | Kiedy możliwa | Wynik |
|---|---|---|
| **Zamelduj** | Status <Status tone="info">Zarezerwowana</Status> | Status <Status tone="success">Zameldowana</Status> |
| **Wymelduj** | Status <Status tone="success">Zameldowana</Status> | Status <Status>Wymeldowana</Status> |
| **Anuluj rezerwację** | Tylko przed zameldowaniem | Status <Status>Anulowana</Status> |
| **Cofnij anulowanie** | Tylko przed zameldowaniem | Z powrotem <Status tone="info">Zarezerwowana</Status> |
| **Cofnij zameldowanie** | Przy błędnym zameldowaniu. Jeśli gość został już wymeldowany, najpierw cofnij wymeldowanie | Z powrotem <Status tone="info">Zarezerwowana</Status> |
| **Cofnij wymeldowanie** | Przy błędnym wymeldowaniu | Z powrotem <Status tone="success">Zameldowana</Status> |

Dodatkowo są **Wyślij formularz potwierdzenia do klienta (SMS)** i **Utwórz zadanie**. Za pomocą ostatniego tworzysz zadanie z tej rezerwacji.

Anulowanej rezerwacji nie można zameldować ani wymeldować. Najpierw cofnij anulowanie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor mówi: Rezerwacja nie została utworzona">
Komunikat brzmi **Nie udało się utworzyć rezerwacji.** Sprawdź, czy wybrano klienta i czy data wymeldowania przypada po dacie zameldowania. Ten sam dzień lub wcześniejszy jest odrzucany.
</Accordion>
<Accordion title="Tillor mówi: Rezerwacja nie została zaktualizowana">
Twoje zmiany nie zostały zapisane. Sprawdź daty (wymeldowanie musi przypadać po zameldowaniu), numery rejestracyjne i liczbę dorosłych, i kliknij **Zapisz** ponownie.
</Accordion>
<Accordion title="Tillor mówi: Zameldowanie nie powiodło się">
Rezerwacja musi mieć status Zarezerwowana. Jeśli jest już zameldowana, wymeldowana lub anulowana, zameldowanie nie jest możliwe. Odśwież stronę i sprawdź, jaki jest teraz status. Jeśli jest anulowana, najpierw użyj **Cofnij anulowanie**.
</Accordion>
<Accordion title="Tillor mówi: Wymeldowanie nie powiodło się">
Wymeldowanie jest możliwe tylko przy rezerwacji, która jest zameldowana. Jeśli gość nie został jeszcze zameldowany albo jest już wymeldowany, to nie zadziała.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się anulować">
Anulowanie jest możliwe tylko przed zameldowaniem. Jeśli gość jest już zameldowany, najpierw użyj **Cofnij zameldowanie**, a potem anuluj.
</Accordion>
<Accordion title="Miejsca nie ma na liście">
Lista pokazuje tylko miejsca dostępne do rezerwacji, bez zajęcia, które są wolne w wybranym okresie. Sprawdź daty. Zaznacz **Uwzględnij miejsca niedostępne do rezerwacji** lub **Uwzględnij zajęte działki**, jeśli chodzi Ci o takie miejsce.
</Accordion>
<Accordion title="Numer rejestracyjny nie jest dodawany">
Numer rejestracyjny może zawierać tylko litery i cyfry i mieć maksymalnie 10 znaków. Usuń spacje i myślniki.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Rezerwacja**: zamówienie pobytu. Zobacz [rezerwacja](/begrippen#reservering).
- **Zarezerwowana, Zameldowana, Wymeldowana, Anulowana**: cztery statusy rezerwacji.
- **Numer rezerwacji**: automatyczny numer, za pomocą którego odnajdziesz rezerwację.
- **Zajęcie miejsca**: klient na terenie przez okres, niezależnie od rezerwacji. Zobacz [zajęcie miejsca](/begrippen#bezetting).
- **Oś czasu**: przegląd rezerwacji według terenu na kalendarzu.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie klientami" href="/klantenbeheer" />
  <Card title="Zajęcia miejsc" href="/bezettingen" />
  <Card title="Kontrola dostępu" href="/toegangscontrole" />
  <Card title="Przetwarzanie płatności" href="/betalingsverwerking" />
  <Card title="Przykłady z praktyki" href="/praktijk" />
</Cards>


# Udostępnianie zadań (/pl-PL/taken/delen)

Chcesz pokazać zadania komuś, kto nie pracuje w Tillor, albo zobaczyć je we własnym kalendarzu? Utwórz wtedy link do udostępniania. Są dwa rodzaje.

| Rodzaj | Co to jest |
|---|---|
| **Strona do udostępnienia** | Tablica tylko do odczytu z tym, co jest do zrobienia. Podąża za zadaniami, więc zmiany w Tillor widać na niej od razu |
| **Kalendarz (ICS)** | Subskrypcja kalendarza, na przykład w Kalendarzu Google, Outlooku lub Kalendarzu Apple |

## Tworzenie linku [#een-link-maken]

1. Kliknij ikonę udostępniania w prawym górnym rogu strony zadań (podpowiedź **Udostępnij ten widok**). Tę samą ikonę znajdziesz też na karcie panelu **Zadania dla Pana/Pani**
2. W polu **Rodzaj linku** wybierz **Strona do udostępnienia** lub **Kalendarz (ICS)**
3. W polu **Treść** wybierz, co udostępniasz: **Moje przypisane zadania** lub jeden ze swoich widoków. Jeśli otwierasz okno z poziomu widoku, jest on już zaznaczony
4. W razie potrzeby zawęź treść za pomocą **Filtry**: **Status**, **Priorytet**, **Przypisano do**, **Etykieta**, **Widok**, **Powiązane z** i **Zablokowane**. Filtry są zapisywane w linku i tylko zawężają to, co już pokazuje źródło
5. Kliknij **Utwórz link**

<DocScreenshot src="/screenshots/taken/task-share-dialog.png" alt="Okno udostępniania zadań z rodzajem linku, treścią i filtrami" />

W sekcji **Wcześniejsze linki** znajdują się wszystkie linki, które utworzyłeś dla tego źródła. Dla każdego linku możesz:

- **Kopiuj link**
- W przypadku linku do kalendarza wybrać **Dodaj do kalendarza**, co od razu otwiera subskrypcję w Twojej aplikacji kalendarza
- **Unieważnij** (po potwierdzeniu). Link przestaje wtedy działać. Pozostałe linki nadal są ważne. Unieważniony link zostaje na liście z oznaczeniem **Unieważniony**

<Callout type="warn">
Link do udostępniania jest prywatny, ale każdy, kto go ma, może zobaczyć zadania, także bez logowania. Udostępniaj go tylko osobom, które mają do tego prawo, i unieważnij go, gdy przestanie być potrzebny.
</Callout>

## Strona do udostępnienia [#de-deelbare-pagina]

Strona pokazuje zadania pogrupowane, a przy każdym zadaniu nazwę, status, priorytet, termin, etykiety i imiona przypisanych współpracowników. Nie ma przycisków do wprowadzania zmian. Przy dużej grupie zobaczysz **[liczba] z [razem]** zadań.

Domyślnie widać tylko otwarte zadania, chyba że sam ustawisz filtr statusu albo udostępnisz widok. Jeśli nie ma nic do zrobienia, zobaczysz **Teraz nie ma nic do zrobienia.**

## Kalendarz [#de-agenda]

W kalendarzu pojawiają się zadania z **terminem** lub **przypomnieniem**. Zadań bez daty w nim nie ma.

- Powtarzające się przypomnienia pojawiają się jako seria, a przy każdym przypomnieniu dostajesz powiadomienie
- Bez przypomnienia dostajesz powiadomienie godzinę przed terminem
- Ukończone zadania pozostają widoczne jeszcze przez dwa tygodnie, jako ukończone, a potem znikają
- W przypadku widoku kalendarz podąża za widokiem, niezależnie od tego, do kogo przypisane są zadania. Jeśli twórca linku nie widzi już widoku, link przestaje działać

<Callout type="info">
W Kalendarzu Google dla subskrybowanego kalendarza musisz też włączyć domyślne powiadomienia, w przeciwnym razie powiadomienia nie dotrą.
</Callout>

## Co dzieje się dalej? [#wat-gebeurt-er-daarna]

- Link działa od razu i działa tak długo, aż go unieważnisz. Każdy, kto ma link, może zobaczyć zadania, także bez logowania.
- Strona do udostępnienia podąża za zadaniami: zmiany w Tillor widać na niej od razu.
- Subskrypcja kalendarza aktualizuje się sama w Twojej aplikacji kalendarza i wysyła powiadomienie godzinę przed terminem lub przy każdym przypomnieniu.
- Jeśli unieważnisz link, przestaje działać tylko ten jeden link. Pozostałe linki nadal są ważne, a unieważniony link zostaje na liście z oznaczeniem **Unieważniony**.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pokazuje, że utworzenie linku się nie udało">
Link nie został utworzony. Sprawdź, czy w polu **Treść** wybrano źródło, i spróbuj ponownie. Komunikat **Nie udało się wczytać linków.** oznacza, że lista wcześniejszych linków się nie otworzyła. Otwórz okno ponownie.
</Accordion>
<Accordion title="Strona pokazuje Teraz nie ma nic do zrobienia">
Nie ma zadań, które pasują do źródła i filtrów. Strona do udostępnienia domyślnie pokazuje tylko otwarte zadania.
</Accordion>
<Accordion title="Kalendarz nie pokazuje moich zadań">
W kalendarzu są tylko zadania z terminem lub przypomnieniem. Jeśli twórca linku nie widzi już widoku, link także przestaje działać.
</Accordion>
<Accordion title="Nie dostaję powiadomień w Kalendarzu Google">
Włącz w Kalendarzu Google także domyślne powiadomienia dla subskrybowanego kalendarza.
</Accordion>
<Accordion title="Chcę, żeby link przestał działać">
Wybierz przy linku **Unieważnij** i potwierdź w oknie **Unieważnić ten link?**. Jeśli się nie uda, zobaczysz **Nie udało się unieważnić linku**: spróbuj ponownie.
</Accordion>
</Accordions>


# Filtrowanie (/pl-PL/taken/filteren)

Nad zadaniami znajduje się pasek wyszukiwania z przyciskami filtrów obok. Filtry należą do widoku: jeśli je zapiszesz, decydują o tym, jakie zadania pokazuje widok. W widoku filtrowanym są to zadania spełniające filtry. W liście są to ręcznie dodane zadania, które spełniają także filtry.

<DocScreenshot src="/screenshots/taken/task-filter-status.png" alt="Filtr statusu z opcjami Włączać i Wykluczać oraz czterema statusami" />

## Zawsze widoczne filtry [#altijd-zichtbare-filters]

| Filtr | Co wybierasz |
|---|---|
| **Status** | Jeden lub więcej statusów |
| **Priorytet** | Jeden lub więcej priorytetów |
| **Przypisano do** | Jednego lub więcej współpracowników albo **Ja** dla siebie |
| **Etykieta** | Jedną lub więcej etykiet |
| **Widok** | Zadania, które należą do innego (ręcznego) widoku |
| **Zablokowane** | **Zablokowane** lub **Niezablokowane** |
| **Powiązane z** | Rodzaj rekordu, do którego należy zadanie, na przykład klient, działka, faktura lub rezerwacja |
| **Tekst** | Słowa, które nazwa lub opis zawiera albo właśnie nie zawiera, zobacz poniżej |
| **Termin** | Zakres czasu, zobacz poniżej |

W filtrach z listą na górze wybierasz **Włączać** (zadania z wybranymi wartościami) lub **Wykluczać** (zadania bez tych wartości). W filtrze **Powiązane z** wybierasz rodzaj elementu: **Klient**, **Faktura**, **Rezerwacja**, **Licznik**, **Działka**, **Komentarz**, **Rozmowa**, **Połączenie telefoniczne**, **Transakcja bankowa** lub **Produkt**.

## Filtrowanie według tekstu [#filteren-op-tekst]

Filtrem **Tekst** pokazujesz tylko zadania, których nazwa lub opis zawiera albo właśnie nie zawiera fragmentu tekstu. Wielkość liter nie ma znaczenia.

1. Kliknij **Tekst**
2. Wybierz **Zawiera** lub **Nie zawiera**
3. Wpisz tekst w polu **Tekst w nazwie lub opisie**, na przykład `Verzekering vervallen:`
4. Kliknij **Dodaj** albo naciśnij Enter

Powtórz to dla każdego tekstu, który chcesz dodać. Każdy tekst to osobny filtr, więc możesz łączyć **Zawiera** i **Nie zawiera**: na przykład `caravan`, ale nie `Verzekering vervallen:`. Krzyżykiem obok tekstu go usuwasz. Na przycisku widać sam tekst albo liczbę tekstów, jeśli jest ich więcej.

<Callout>
To, czy zadanie musi spełniać **wszystkie** teksty, czy **jeden** z nich, zależy od wyboru w sekcji [Łączenie wielu filtrów](#meerdere-filters-combineren). Jeśli chcesz wykluczyć kilka tekstów, zostaw tam **Wszystkie filtry**.
</Callout>

## Filtrowanie według daty [#filteren-op-datum]

**Termin** działa ze stałymi opcjami, które przesuwają się razem z dniem, albo z własnym zakresem.

- **Zaległe**, **Dzisiaj**, **Jutro**, **Ten tydzień**, **Przyszły tydzień**, **Ten miesiąc**
- **Bez daty** (zadania bez terminu) i **Z datą**
- **Własny zakres**: wybierz datę początkową i końcową w kalendarzu i kliknij **Zastosuj zakres**. Dzień końcowy liczy się w całości

<DocScreenshot src="/screenshots/taken/task-filter-deadline.png" alt="Filtr terminu ze stałymi opcjami i kalendarzem dla własnego zakresu" />

Jeśli klikniesz wybraną opcję jeszcze raz, filtr zniknie.

## Łączenie wielu filtrów [#meerdere-filters-combineren]

Gdy masz dwa lub więcej filtrów, pojawia się menu wyboru:

- **Wszystkie filtry** - zadanie musi pasować do każdego filtra
- **Dowolny filtr** - wystarczy, że zadanie pasuje do jednego z filtrów

Przyciskiem **Wyczyść filtry** usuwasz wszystkie filtry naraz.

## Przykłady [#voorbeelden]

- *Wszystko, co trzeba skończyć dzisiaj i nadal jest otwarte*: ustaw filtr **Termin** na **Dzisiaj** i **Status** na wszystko oprócz **Ukończone**
- *Zadania, na które muszę poczekać*: ustaw filtr **Status** na **Oczekuje na odpowiedź** i **Przypisano do** na **Ja**
- *Wszystko oprócz powiadomień o wygasłych ubezpieczeniach*: ustaw filtr **Tekst** na **Nie zawiera** `Verzekering vervallen:`
- *Wszystko wokół jednego klienta*: otwórz klienta. Na karcie **Zadania** na stronie klienta są wszystkie zadania powiązane z tym klientem

## Co dzieje się dalej? [#wat-gebeurt-er-daarna]

- Filtry na ekranie zawężają to, co widzisz. Dopiero gdy zapiszesz je przyciskiem **Zapisz widok**, należą do widoku, a współpracownicy widzą ten sam wybór.
- Filtry możesz zapisać także we wbudowanym widoku **Wszystkie**. Obowiązują wtedy wszystkich w Twojej organizacji. Potrzebujesz do tego uprawnienia **Zarządzanie etykietami i wspólnymi widokami**.
- W widoku filtrowanym zadania pojawiają się i znikają same, w miarę jak spełniają filtry lub przestają je spełniać.
- Pasek wyszukiwania nigdy nie jest zapisywany.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę już żadnych zadań">
Sprawdź, czy jakiś filtr jest aktywny, na przykład filtr statusu wykluczający **Ukończone**, albo **Wszystkie filtry**, gdy miałeś na myśli jeden z filtrów. Przyciskiem **Wyczyść filtry** zaczniesz od nowa.
</Accordion>
<Accordion title="Filtr zniknął po odświeżeniu">
Nie został zapisany. Wybierz **Zapisz widok** na pasku **Niezapisane zmiany**.
</Accordion>
<Accordion title="Nie mogę zapisać filtrów w widoku Wszystkie">
Przycisk **Zapisz widok** jest wyszarzony, jeśli nie masz uprawnienia **Zarządzanie etykietami i wspólnymi widokami**, bo widok **Wszystkie** obowiązuje całą organizację. Poproś o nie administratora albo utwórz własny widok z tymi samymi filtrami.
</Accordion>
<Accordion title="Zadania współpracownika nie ma na liście">
Widzisz tylko zadania, które możesz zobaczyć. Zadanie w osobistym widoku współpracownika jest dla Ciebie niewidoczne. Zobacz [Zadania prywatne](/taken/prive-taken).
</Accordion>
<Accordion title="Filtr Termin z własnym zakresem nic nie pokazuje">
Po wybraniu daty początkowej i końcowej kliknij **Zastosuj zakres**.
</Accordion>
</Accordions>


# Tabela, tablica i kalendarz (/pl-PL/taken/indelingen)

Te same zadania możesz oglądać na trzy sposoby. W prawym górnym rogu otwórz **Wyświetlanie**, aby wybrać:

- **Układ** - **Tabela**, **Tablica** lub **Kalendarz**. Ten wybór jest dostępny tylko w zapisanych widokach, nie w widoku **Wszystkie**
- **Grupuj według** - jak zadania są dzielone na grupy lub kolumny
- **Sortuj według** i **Kolejność** - **Rosnąco** lub **Malejąco**
- **Rodzaj** - czy widok jest **Lista** czy **Widok filtrowany**, zobacz [Widoki](/taken/weergaven#twee-soorten-weergaven). To również jest dostępne tylko w zapisanych widokach
- **Ukończone** - jak długo ukończone zadania pozostają widoczne

<DocScreenshot src="/screenshots/taken/task-view-display-options.png" alt="Menu Wyświetlanie z układem, rodzajem, grupowaniem, sortowaniem i ukończonymi zadaniami" />

Zmiany pozostają propozycją, dopóki ich nie zapiszesz, zobacz [Zapisywanie lub odrzucanie zmian](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

## Ukrywanie ukończonych zadań [#voltooide-taken-verbergen]

W polu **Ukończone** w menu **Wyświetlanie** decydujesz, jak długo ukończone zadanie pozostaje w widoku:

| Wybór | Co widzisz |
|---|---|
| **Pokaż wszystkie** | Wszystkie ukończone zadania (domyślnie) |
| **Ukryj** | Żadnych ukończonych zadań |
| **Ostatni dzień** | Zadania ukończone w ostatnim dniu |
| **Ostatni tydzień** | Zadania ukończone w ostatnim tygodniu |
| **Ostatni miesiąc** | Zadania ukończone w ostatnim miesiącu |

Liczy się od chwili, gdy zadanie ustawiono jako **Ukończone**. Komentarz lub nowa nazwa tego nie zmienia. Jeśli ponownie otworzysz zadanie, od razu wraca do widoku. Jeśli widok ma już filtr statusu wykluczający ukończone zadania, ten filtr nadal obowiązuje.

## Grupowanie [#groeperen]

| Grupowanie | Wynik |
|---|---|
| **Bez grupowania** | Wszystkie zadania na jednej liście |
| **Status** | Jedna grupa na status |
| **Priorytet** | Jedna grupa na priorytet |
| **Przypisany** | Jedna grupa na współpracownika |
| **Etykieta** | Jedna grupa na etykietę |
| **Klient** | Jedna grupa na klienta |
| **Termin** | Grupy takie jak **Po terminie**, **Dzisiaj**, **W tym tygodniu**, **Później** i **Bez terminu** |
| **Własne kolumny** | Kolumny, które tworzysz sam, tylko w zapisanych widokach |

Zadanie z kilkoma przypisanymi współpracownikami lub etykietami znajduje się w grupie każdego z nich.

## Sortowanie [#sorteren]

Możesz sortować według **Ręcznie**, **Termin**, **Priorytet**, **Status**, **Nazwa**, **Utworzono** lub **Zaktualizowano**. Przy **Ręcznie** kolejność ustalasz sam, przeciągając karty. Przy pozostałych opcjach kolejność wyznacza pole, a przeciąganie w kolumnie nie ma efektu, poza własnymi kolumnami.

## Tabela [#tabel]

Tabela pokazuje jeden wiersz na zadanie. Przy grupowaniu dostajesz blok na grupę. W sekcji **Kolumny** w menu wyświetlania włączasz lub wyłączasz kolumny: **Zadanie**, **Status**, **Priorytet**, **Termin**, **Widoki**, **Przypisany**, **Powiązane** i **Etykieta**. Kolumna **Powiązane** pokazuje wszystkie elementy, do których należy zadanie. Kolumna **Zadanie** jest zawsze widoczna.

Przy dużej liczbie zadań Tillor najpierw wczytuje ich część. Przewiń w dół lub kliknij **Wczytaj więcej**, aby zobaczyć resztę.

## Tablica [#bord]

Tablica pokazuje każdą grupę jako kolumnę, w stylu kanban. Kliknij u góry kolumny **Nowe zadanie**, aby utworzyć w niej zadanie. Dostaje ono automatycznie wartość kolumny, na przykład status lub przypisanego współpracownika.

Przeciągnij kartę zadania do innej kolumny, a zadanie przejmie wartość tej kolumny:

- przy tablicy według **Status** zmienia się status
- przy **Priorytet** zmienia się priorytet
- przy **Przypisany** zmienia się przypisany współpracownik
- przy **Etykieta** i **Klient** zmienia się etykieta lub klient
- przy **Własne kolumny** zadanie przenosi się do tej kolumny

Przy tablicy według **Termin** nie możesz przeciągać kart do innej kolumny, bo trzeba by wymyślić termin. Zmień termin w samym zadaniu.

Jeśli w kolumnie jest więcej zadań, niż się wyświetla, na dole widać **Jeszcze [liczba]**. Karta, która jest zablokowana przez inne zadania lub je blokuje, też to pokazuje, na przykład **Zablokowane przez 1 zadanie**.

### Własne kolumny [#eigen-kolommen]

W **Własne kolumny** sam tworzysz kolumny, takie jak *Do zaplanowania*, *Zamówione* i *Gotowe*:

1. W **Wyświetlanie** w polu **Grupuj według** wybierz **Własne kolumny** (albo wybierz to już przy tworzeniu)
2. Kliknij po prawej stronie tablicy **Nowa kolumna** i nadaj jej nazwę
3. W menu kolumny wybierz **Edytuj**, aby zmienić nazwę, lub **Usuń**
4. Przeciągaj kolumny za tytuł, aby zmienić kolejność

<DocScreenshot src="/screenshots/taken/task-view-own-columns.png" alt="Tablica z własnymi kolumnami Do zaplanowania, Zamówione i Gotowe oraz Nowa kolumna" />

Nowe własne kolumny zaczynają się puste. Każde zadanie w widoku jest wtedy najpierw w **Brak kolumny**, dopóki go nie przydzielisz. W liście możesz ukryć te zadania polem wyboru **Pokaż zadania bez kolumny**. W widoku filtrowanym pozostają widoczne, bo inaczej nigdy nie dałoby się ich przydzielić.

<Callout type="warn">
Jeśli przejdziesz z **Własne kolumny** na inne grupowanie i to zapiszesz, własne kolumny tego widoku zostaną usunięte razem z miejscem każdego zadania w nich. Tego nie można cofnąć. Tillor pokazuje wcześniej ostrzeżenie.
</Callout>

### Przypisywanie zadań do listy [#taken-toewijzen-aan-een-lijst]

W tablicy listy, dopóki są zadania, których jeszcze w niej nie ma, pojawia się przycisk **Przypisz zadania**. Otwiera on dodatkową kolumnę **Poza tym widokiem** z zadaniami, które spełniają filtry widoku, ale jeszcze w nim nie są. Szukaj w **Filtruj zadania...** i przeciągnij zadanie do kolumny, aby dodać je do widoku. Kliknij przycisk jeszcze raz, aby zamknąć kolumnę.

## Kalendarz [#kalender]

Kalendarz pokazuje siatkę miesiąca z zadaniami w dniu ich **terminu**. Tydzień zaczyna się w poniedziałek, a dni podążają za strefą czasową Twojej organizacji. Zadań bez terminu w kalendarzu nie ma.

- Strzałkami przechodzisz do poprzedniego lub następnego miesiąca, a przyciskiem **Dziś** wracasz do bieżącego miesiąca
- Na każdy dzień widzisz maksymalnie trzy zadania. Kliknij **+[liczba] więcej**, aby zobaczyć resztę dnia
- Kliknij zadanie, aby otworzyć szczegóły
- Przeciągnij zadanie na inny dzień, aby przenieść termin. Godzina pozostaje taka sama, zmienia się tylko dzień
- Ukończone zadania są przekreślone, znajdują się pod otwartymi zadaniami danego dnia i nie można ich przeciągać

Grupowanie w kalendarzu nie ma wpływu: wszystkie zadania są w tej samej siatce.

## Co dzieje się dalej? [#wat-gebeurt-er-daarna]

- Twoje zmiany w **Wyświetlanie** są najpierw propozycją na Twoim ekranie. Dopiero po **Zapisz widok** obowiązują wszystkich, którzy widzą widok.
- Jeśli przeciągniesz kartę do innej kolumny, samo zadanie się zmienia. Przy tablicy według **Status** zmienia się status, a współpracownicy widzą to od razu.
- Przeciągnięcie karty w kalendarzu przenosi termin na ten dzień. Godzina pozostaje taka sama.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie mogę przeciągnąć karty do innej kolumny">
Przy tablicy według **Termin** nie jest to możliwe, bo Tillor musiałby wymyślić termin. Zmień termin w zadaniu. Zadania w kalendarzu przeciągasz na inny dzień, z wyjątkiem ukończonych zadań.
</Accordion>
<Accordion title="Tillor mówi, że nie udało się przenieść zadania">
Widzisz **Nie udało się przenieść zadania**. Karta wraca na stare miejsce. Spróbuj ponownie.
</Accordion>
<Accordion title="Brakuje opcji Układ lub Rodzaj">
Są dostępne tylko w zapisanych widokach, nie w widoku **Wszystkie**.
</Accordion>
<Accordion title="Zadania nie ma w kalendarzu">
Kalendarz pokazuje zadania w dniu ich terminu. Zadania bez terminu w nim nie ma.
</Accordion>
<Accordion title="Moje zadania są w Brak kolumny">
Przy nowych własnych kolumnach wszystkie zadania zaczynają w **Brak kolumny**, dopóki ich nie przydzielisz. Przeciągnij je do właściwej kolumny.
</Accordion>
<Accordion title="Moje własne kolumny zniknęły">
Przeszedłeś na inne grupowanie i zapisałeś to. Tillor usuwa wtedy własne kolumny i nie można tego cofnąć. Tillor wcześniej o tym ostrzega.
</Accordion>
</Accordions>


# Przegląd (/pl-PL/taken)

Za pomocą systemu zadań śledzisz, co trzeba zrobić w Twoim parku i kto ma to zrobić. Zadanie może mieć termin, przypomnienie, jednego lub więcej przypisanych współpracowników albo grup, etykiety, załączniki, podzadania, poświęcony czas oraz powiązanych klientów, działki, faktury, rezerwacje, liczniki, rozmowy lub transakcje bankowe.

Zadania oglądasz przez **widoki**. Widok to zapisany sposób patrzenia na zadania, na przykład *Otwarte zadania*, *Moje zadania* lub *Konserwacja*. Każdy widok jest kartą u góry strony.

## Gdzie znajdziesz zadania [#waar-vind-je-taken]

- **Zadania** w menu bocznym: strona główna ze wszystkimi Twoimi widokami
- **Panel**: karta **Zadania dla Pana/Pani** pokazuje zadania przypisane do Ciebie albo Twój ulubiony widok
- **Klienci > [klient] > Zadania**: wszystkie zadania powiązane z klientem
- **Otwarte zadania**: blok na stronie klienta, rezerwacji, faktury, działki i licznika

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Strona zadań z kartami widoków i tablicą według statusu" />

U góry są widoki jako karty. Pod nimi jest pasek wyszukiwania i filtry, a po prawej przyciski **Wyświetlanie**, **Obserwuj** i udostępniania. Niżej widzisz zadania, tutaj jako tablicę według statusu. Najedź na znaczki ℹ, aby zobaczyć wyjaśnienie.

## Jak to się łączy? [#hoe-hangt-dit-samen]

Zadanie to jedna rzecz, a widoki to sposoby oglądania zadań. Zadania powstają dzięki współpracownikom lub automatyzacjom. Automatyzacja może też czekać na zadanie.

```mermaid
flowchart LR
  A["Współpracownik tworzy zadanie<br/>na stronie zadań lub z poziomu klienta, faktury albo licznika"] --> T["Zadanie"]
  B["Automatyzacja tworzy zadanie<br/>krok Utwórz zadanie, w imieniu Przepływu pracy"] --> T
  T --> L["Lista<br/>pokazuje tylko zadania, które sam do niej dodasz"]
  T --> G["Widok filtrowany<br/>pokazuje każde zadanie spełniające filtry"]
  L --> Z["Widoczność widoku<br/>decyduje, kto widzi zadanie"]
  T -- "Współpracownik wybiera przycisk w zadaniu" --> W["Automatyzacja już nie czeka<br/>i działa dalej"]
  T -- "Zmienia się status lub przypisanie" --> S["Automatyzacja może od tego wystartować"]
```

- Jeśli umieścisz zadanie w widoku, samo zadanie się nie zmienia. Tylko widok dostaje je do siebie.
- Widok filtrowany nie usuwa z siebie zadań: pojawiają się lub znikają same, zależnie od tego, czy spełniają filtry.
- Zadanie utworzone przez automatyzację to zwykłe zadanie. Jeśli ma przyciski wyboru (krok **Poproś o decyzję**), automatyzacja czeka, aż ktoś wybierze przycisk. Zobacz [Zadania z przyciskami wyboru](/taken/taakdetails#taken-met-keuzeknoppen) i [Zadania w automatyzacjach](/automatiseringen/acties/taken).

## Szybki start [#snel-aan-de-slag]

1. Otwórz **Zadania** w menu bocznym
2. Kliknij **Nowy widok**. Wpisz **Nazwa** i wybierz w polach **Widoczność**, **Treść**, **Kolumny** i **Zacznij od** to, co chcesz. Następnie kliknij **Nowy widok** na dole okna
3. Kliknij u góry kolumny **Nowe zadanie**, nadaj zadaniu nazwę i kliknij **Utwórz**
4. Kliknij zadanie, aby otworzyć szczegóły: status, priorytet, termin, przypisani współpracownicy i więcej
5. Zaznacz pole po lewej stronie zadania, gdy będzie gotowe

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Okno Nowy widok z nazwą, widocznością, treścią, kolumnami i filtrem początkowym" />

Bez własnych widoków zawsze możesz wrócić do wbudowanego widoku **Wszystkie**, który pokazuje wszystkie zadania, które możesz zobaczyć. Filtry zapisane w widoku **Wszystkie** obowiązują całą organizację.

## Statusy [#statussen]

| Status | Znaczenie |
|---|---|
| **Oczekujące** | Zadanie jest zaplanowane, ale jeszcze go nie zaczęto |
| **W toku** | Nad zadaniem aktywnie się pracuje |
| **Oczekuje na odpowiedź** | Możesz kontynuować dopiero, gdy ktoś inny, na przykład klient lub dostawca, coś zrobi lub odpowie |
| **Ukończone** | Zadanie jest zakończone |

Tak wygląda ten sam rodzaj zadania przed odhaczeniem i po nim. Na górze jest otwarte zadanie, pod nim ukończone: tytuł jest przekreślony, a status to **Ukończone**.

<DocScreenshot src="/screenshots/taken/task-card-open.png" alt="Przed: otwarte zadanie ze statusem W toku" />

<DocScreenshot src="/screenshots/taken/task-card-done.png" alt="Po: ukończone zadanie z przekreślonym tytułem i statusem Ukończone" />

Ukończone zadanie opada na dół w ręcznie posortowanej liście lub kolumnie. Jeśli ustawisz zadanie nadrzędne jako **Ukończone**, ukończone zostaną też otwarte podzadania. Jeśli potem ponownie otworzysz zadanie, podzadania pozostaną ukończone.

Widok może po pewnym czasie ukrywać ukończone zadania, zobacz [Ukrywanie ukończonych zadań](/taken/indelingen#voltooide-taken-verbergen).

## Priorytety [#prioriteiten]

Zadanie ma priorytet **Niski**, **Średni**, **Wysoki** lub **Pilny**.

## Elementy [#onderdelen]

<Cards>
  <Card
    title="Widoki"
    href="/taken/weergaven"
    description="Tworzenie, udostępnianie, duplikowanie i obserwowanie list oraz widoków filtrowanych"
  />
  <Card
    title="Tabela, tablica i kalendarz"
    href="/taken/indelingen"
    description="Wybierz, jak pokazywane są zadania, grupuj i sortuj"
  />
  <Card
    title="Filtrowanie"
    href="/taken/filteren"
    description="Znajdowanie zadań według statusu, terminu, klienta, powiązanego elementu i więcej"
  />
  <Card
    title="Szczegóły zadania"
    href="/taken/taakdetails"
    description="Wszystko, co możesz zapisać w zadaniu, od podzadań i poświęconego czasu po drukowanie"
  />
  <Card
    title="Zadania prywatne"
    href="/taken/prive-taken"
    description="To, kto widzi zadanie, zależy od widoków, w których się znajduje"
  />
  <Card
    title="Etykiety"
    href="/taken/labels"
    description="Zarządzanie etykietami i automatyczne ustawianie terminu"
  />
  <Card
    title="Powiadomienia"
    href="/taken/meldingen"
    description="Przypomnienia, terminy i dzienne podsumowanie widoku"
  />
  <Card
    title="Udostępnianie zadań"
    href="/taken/delen"
    description="Tworzenie strony tylko do odczytu lub subskrypcji kalendarza"
  />
  <Card
    title="Zadania na innych stronach"
    href="/taken/taken-op-andere-paginas"
    description="Tworzenie zadań z poziomu klientów, faktur, rozmów i więcej"
  />
</Cards>

<Callout type="info" title="Warto wiedzieć">
- Nie ma osobnych uprawnień do zadań. Kto pracuje w Tillor, może tworzyć i edytować zadania. To, jakie zadania widzisz, zależy od widoków, w których się znajdują. Zobacz [Zadania prywatne](/taken/prive-taken)
- Nowe zadanie może mieć do 50 podzadań. Podzadania mają tylko jeden poziom
- Jeśli ustawisz zadanie jako **Ukończone**, otwarte podzadania też zostaną ukończone
- Kto obserwuje widok, dostaje co rano o 07:00 podsumowanie, z najwyżej 15 zadaniami na listę
- Działający timer zatrzymuje się po dziesięciu minutach bez ruchu myszą i bez użycia klawiatury
- Etykieta z polem **Docelowy termin (dni)** automatycznie nadaje termin zadaniom bez terminu
- Usuniętego zadania nie można przywrócić
</Callout>

## Pojęcia [#begrippen]

- **Zadanie**: praca, którą śledzisz, ze statusem, priorytetem, terminem i ewentualnie przypisanymi współpracownikami
- **Widok**: karta na stronie zadań z własnym sposobem pokazywania zadań, zobacz [Widoki](/taken/weergaven)
- **Lista**: widok, który pokazuje tylko zadania, które sam do niego dodasz
- **Widok filtrowany**: widok, który pokazuje każde zadanie spełniające filtry
- **Podzadanie**: część zadania, jako lista kontrolna
- **Blokada**: zadanie, które musi być gotowe, zanim inne zadanie będzie mogło wystartować
- **Przepływ pracy**: użytkownik, w imieniu którego [automatyzacja](/begrippen#automatisering) tworzy zadania

Więcej terminów znajdziesz na [liście pojęć](/begrippen).


# Etykiety (/pl-PL/taken/labels)

Etykiety nadają zadaniom kategorię, na przykład *Konserwacja*, *Reklamacje* lub *Sezon*. Możesz filtrować i grupować według etykiet. Etykieta ma nazwę, kolor i opcjonalnie opis.

## Zarządzanie etykietami [#labels-beheren]

Przejdź do <UIPath>Ustawienia > Etykiety zadań</UIPath>. Tę stronę widzisz, jeśli możesz przeglądać lub edytować ogólne ustawienia swojej organizacji. Przegląd ma kolumny **Etykieta**, **Opis** i **Zadania** (liczba zadań z daną etykietą).

<DocScreenshot src="/screenshots/taken/task-labels-settings.png" alt="Ustawienia, strona Etykiety zadań z etykietami Administracja, Konserwacja i Recepcja" />

- **Nowa etykieta** tworzy etykietę z polami **Nazwa**, **Opis**, **Kolor** i opcjonalnie **Docelowy termin (dni)**
- **Edytuj etykietę** zmienia te dane później
- **Usuń etykietę** usuwa etykietę i wcześniej pokazuje, na ilu zadaniach się znajduje. Etykieta znika ze wszystkich tych zadań

Etykietę możesz też utworzyć podczas edycji zadania: wpisz nazwę w polu **Etykiety** i wybierz **Utwórz [nazwa]**.

## Automatyczne ustawianie terminu [#een-deadline-automatisch-instellen]

<DocScreenshot src="/screenshots/taken/task-label-dialog.png" alt="Okno tworzenia etykiety z nazwą, opisem, kolorem i docelowym terminem" />

Przy etykiecie możesz wpisać **Docelowy termin (dni)**, na przykład *7*. Zadanie bez terminu, które dostanie tę etykietę, dostaje wtedy własny termin: tyle dni później, licząc od chwili utworzenia zadania lub dodania etykiety.

- Dzieje się to przy tworzeniu zadania z tą etykietą albo gdy dodasz etykietę później
- Jeśli zadanie ma już termin, pozostaje bez zmian
- Jeśli zadanie ma kilka etykiet z celem, obowiązuje najmniejsza liczba dni
- Jeśli zostawisz pole puste, etykieta nie ustawia terminu

To przydatne przy etykietach takich jak *Reklamacja* (w ciągu 2 dni) lub *Follow-up oferty* (w ciągu 7 dni).

## Co dzieje się dalej? [#wat-gebeurt-er-daarna]

- Nową etykietę możesz od razu nadawać zadaniom, w samym zadaniu i w menu szybkim.
- Etykieta z polem **Docelowy termin (dni)** od tej chwili automatycznie nadaje termin zadaniom bez terminu.
- Jeśli usuniesz etykietę, znika ze wszystkich zadań, na których była. Zadania pozostają.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę strony Etykiety zadań">
Nie masz uprawnień do przeglądania ogólnych ustawień swojej organizacji. Poproś administratora o zmianę uprawnień.
</Accordion>
<Accordion title="Tillor pokazuje, że utworzenie etykiety się nie udało">
Wpisz **Nazwa** (najwyżej 50 znaków) i spróbuj ponownie. Przy edycji i usuwaniu komunikaty brzmią **Nie udało się zaktualizować etykiety** i **Nie udało się usunąć etykiety**.
</Accordion>
<Accordion title="Moje zadanie nie dostało terminu z etykiety">
Termin z etykiety trafia tylko na zadania bez terminu. Jeśli zadanie ma już termin, zostaje on bez zmian. Przy kilku etykietach z celem obowiązuje najmniejsza liczba dni.
</Accordion>
</Accordions>


# Powiadomienia (/pl-PL/taken/meldingen)

Tillor informuje Cię o zadaniach przez e-mail i powiadomienia push.

## Przypomnienia i terminy [#herinneringen-en-deadlines]

Jeśli zadanie ma **Przypomnienie** lub **Termin**, w oknie szczegółów w sekcji **Powiadomienia** wybierasz, czy chcesz **E-mail** i/lub **Powiadomienie push**. Oba są domyślnie włączone. Jeśli wyłączysz oba, nikt nie dostanie powiadomienia o tym zadaniu.

- Przypomnienie włącza się w ustawionym momencie, z tytułem *Przypomnienie o zadaniu*
- Powiadomienie o terminie włącza się, gdy termin zostanie osiągnięty, a zadanie nie jest jeszcze ukończone
- Ukończone zadania nie wysyłają już przypomnienia ani powiadomienia o terminie
- Powtarzające się przypomnienie włącza się przy każdym powtórzeniu, aż zadanie zostanie ukończone lub harmonogram dobiegnie końca

Powiadomienie trafia do przypisanych współpracowników, także do członków przypisanej grupy. Jeśli nikt nie jest przypisany, trafia do twórcy zadania. E-mail pokazuje podgląd zadania ze statusem i przyciskiem do jego otwarcia.

## Przypisanie, cofnięcie przypisania i ukończenie [#toewijzen-ontkoppelen-en-voltooien]

- Jeśli zadanie zostanie Ci przypisane, także przez grupę, do której należysz, dostajesz powiadomienie (**Przydzielono nowe zadanie**). Jeśli przypiszesz zadanie sobie, nie dostajesz powiadomienia
- Jeśli ktoś usunie Cię z zadania, dostajesz powiadomienie, że przydział zadania został cofnięty (**Cofnięto przydział zadania**)
- Gdy zadanie zostanie ukończone, powiadomienie dostają przypisani współpracownicy i twórca, z wyjątkiem osoby, która ukończyła zadanie. Powiadomienie jest wysyłane z opóźnieniem około minuty. Jeśli ktoś w tym czasie ponownie otworzy zadanie, nie zostanie już wysłane

## Obserwowanie widoku [#een-weergave-volgen]

Przyciskiem **Obserwuj** (w prawym górnym rogu zapisanego widoku) co rano o 07:00 dostajesz e-mail z podsumowaniem tego widoku. E-mail ma temat *Dzienne podsumowanie* z nazwą widoku i zawiera trzy listy:

- **Zaległe** - otwarte zadania, których termin minął
- **Na dziś** - otwarte zadania, które trzeba skończyć dzisiaj
- **Zmienione od ostatniego podsumowania** - otwarte zadania zmienione od Twojego poprzedniego podsumowania

Każda lista pokazuje maksymalnie 15 zadań z terminem. Na dole jest przycisk **Otwórz widok**, który przenosi bezpośrednio do widoku.

- Jeśli we wszystkich trzech listach nic nie ma, tego dnia nie dostajesz e-maila
- Przycisk zmienia się w **Obserwujesz**. Kliknij go, aby przestać obserwować. Możesz obserwować każdy widok, który widzisz, także widoki współpracowników
- Jeśli stracisz dostęp do widoku, na przykład dlatego, że właściciel ustawi go tylko dla siebie albo go usunie, automatycznie przestajesz go obserwować
- Widzisz tylko zadania, które możesz zobaczyć

<Callout type="info">
Wbudowanego widoku **Wszystkie** nie możesz obserwować, ponieważ nie jest to zapisany widok.
</Callout>

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie dostaję przypomnienia ani powiadomienia o terminie">
Sprawdź w zadaniu w sekcji **Powiadomienia**, czy włączone jest **E-mail** lub **Powiadomienie push**. Powiadomienie trafia do przypisanych współpracowników albo do twórcy, jeśli nikt nie jest przypisany. Ukończone zadania nie wysyłają już powiadomień.
</Accordion>
<Accordion title="Nie dostaję powiadomienia, gdy przypisuję zadanie sobie">
Tak ma być. Powiadomienie **Przydzielono nowe zadanie** dostajesz tylko wtedy, gdy zadanie przypisze Ci ktoś inny.
</Accordion>
<Accordion title="Nie dostaję dziennego podsumowania">
Nie obserwujesz widoku (przycisk **Obserwuj** powinien pokazywać **Obserwujesz**) albo w sekcjach **Zaległe**, **Na dziś** i **Zmienione od ostatniego podsumowania** nic nie ma. Wtedy tego dnia nie wysyłamy e-maila. Przestajesz też automatycznie obserwować widok, gdy nie możesz go już zobaczyć.
</Accordion>
<Accordion title="Tillor pokazuje, że aktualizacja obserwowania się nie udała">
Zmiana nie została zapisana. Kliknij **Obserwuj** jeszcze raz.
</Accordion>
</Accordions>


# Zadania prywatne (/pl-PL/taken/prive-taken)

Zadanie jest prywatne, jeśli znajduje się tylko w widokach osobistych. Nie musisz niczego w tym celu ustawiać: widoki, w których jest zadanie, decydują o tym, kto je widzi.

## Zasady [#de-regels]

| Gdzie jest zadanie | Kto je widzi |
|---|---|
| W żadnym widoku | Wszyscy użytkownicy organizacji |
| W co najmniej jednym widoku **Publiczny** | Wszyscy użytkownicy organizacji |
| Tylko w widokach osobistych (**Tylko Ty** lub **Udostępniony**) | Twórca zadania, przypisani współpracownicy i grupy oraz właściciel i wybrane osoby i grupy tych widoków |

Podzadania podążają za zadaniem nadrzędnym. Zadanie, którego nie możesz zobaczyć, nie pojawia się nigdzie: ani w listach, wynikach wyszukiwania, filtrach, panelu, przy kliencie, w kalendarzu, ani w powiadomieniach, i nie możesz go też otworzyć przez link.

## Przykład [#voorbeeld]

Jan tworzy osobisty widok *Moje pomysły* z widocznością **Tylko Ty**. Dodaje do tej listy zadanie *Zapytać o ofertę na nowy szlaban*.

- Tylko Jan widzi to zadanie. Jego współpracownicy nie widzą go nigdzie
- Jan przypisuje zadanie Piotrowi. Teraz Piotr też widzi zadanie, choć nigdy nie widział widoku Jana
- Jan udostępnia *Moje pomysły* Annie (**Udostępniony**). Teraz Anna też widzi zadanie
- Jan dodaje zadanie do widoku *Konserwacja*, który jest **Publiczny**. Od tej chwili widzi je cały zespół
- Jeśli Jan usunie zadanie z *Konserwacja*, a zadanie nie jest nigdzie indziej w publicznym widoku, znów jest prywatne

Gdyby Jan nie umieścił zadania w żadnym widoku, widzieliby je wszyscy.

## Kto decyduje o widoczności widoku [#wie-bepaalt-de-zichtbaarheid-van-een-weergave]

Tylko właściciel widoku osobistego może zmienić, komu widok jest udostępniony, albo ustawić go jako **Publiczny**. Współpracownik, któremu udostępnisz widok, może edytować zadania w widoku, ale nie może zmieniać widoczności ani usunąć widoku. Zobacz [Widoki](/taken/weergaven#wie-ziet-een-weergave).

<Callout type="warn">
Dodanie zadania prywatnego do widoku publicznego sprawia, że widzi je każdy. Tillor najpierw prosi o potwierdzenie pytaniem **Upublicznić to zadanie?**. Możesz wtedy wybrać **Zachowaj jako prywatne** lub **Upublicznij**. To samo pytanie pojawia się, gdy usuwasz zadanie z jego ostatniego widoku publicznego. Jeśli ustawisz widok osobisty zawierający zadania jako **Publiczny**, te zadania staną się widoczne dla wszystkich bez osobnego pytania.
</Callout>

## Wskazówki [#tips]

- Jeśli chcesz przekazać zadanie prywatne, przypisz je współpracownikowi albo udostępnij mu widok
- Zadanie liczy się jako "w widoku", gdy dodasz je do listy lub umieścisz we własnej kolumnie widoku. Samo pokazanie go przez filtr nie sprawia, że jest w widoku
- Powiadomienia o zadaniu prywatnym, na przykład o terminie, trafiają tylko do osób, które mogą zobaczyć zadanie

## Problemy? [#problemen]

<Accordions>
<Accordion title="Współpracownik nie widzi mojego zadania">
Zadanie jest tylko w widokach osobistych. Przypisz je współpracownikowi, udostępnij mu widok albo umieść zadanie w widoku publicznym.
</Accordion>
<Accordion title="Tillor pyta Upublicznić to zadanie?">
Dodajesz zadanie prywatne do widoku publicznego albo usuwasz je z jego ostatniego widoku publicznego. Wybierz **Zachowaj jako prywatne** lub **Upublicznij**.
</Accordion>
<Accordion title="Nie widzę już zadania, które wczoraj jeszcze miałem">
Być może zadanie zostało powiązane z innym widokiem albo widok, w którym było, nie jest już dla Ciebie widoczny. Zapytaj twórcę zadania lub właściciela widoku.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Widoki" href="/taken/weergaven" />
  <Card title="Szczegóły zadania" href="/taken/taakdetails" />
</Cards>


# Szczegóły zadania (/pl-PL/taken/taakdetails)

W oknie szczegółów zadania zapisujesz wszystko: kto je wykonuje, kiedy ma być gotowe, ile w nim czasu i z czym jest powiązane. Kliknij zadanie, aby otworzyć okno. Po lewej są nazwa, opis i elementy takie jak podzadania i komentarze. Po prawej są właściwości, takie jak status, priorytet i termin. Zmiany w istniejącym zadaniu są zapisywane od razu. Tylko opis zapisujesz sam przyciskiem **Zapisz**.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Okno zadania z opisem, podzadaniami, komentarzami oraz po prawej właściwościami, polami niestandardowymi, powiązanymi elementami i załącznikami" />

Zadanie możesz też otworzyć bezpośrednio przez link. Skopiuj go z menu z trzema kropkami w prawym górnym rogu okna, zobacz [Menu zadania](#het-menu-van-de-taak).

## Tworzenie zadania [#een-taak-aanmaken]

Zadania tworzysz w różnych miejscach: na górze kolumny tablicy (**Nowe zadanie**), na karcie **Zadania dla Pana/Pani** na pulpicie, na stronie klienta albo z rozmowy, faktury lub innego elementu, zobacz [Zadania na innych stronach](/taken/taken-op-andere-paginas).

1. Kliknij **Nowe zadanie**
2. Wpisz **Nazwa**. Reszta jest opcjonalna
3. Ewentualnie dodaj podzadania w polu **Dodaj podzadanie**: wpisz nazwę i naciśnij Enter. Możesz dodać ich do 50
4. Kliknij **Utwórz** albo naciśnij Cmd lub Ctrl razem z Enter

<DocScreenshot src="/screenshots/taken/task-create-dialog.png" alt="Okno Nowe zadanie z nazwą i dwoma podzadaniami" />

Na górze okna jest widok, do którego trafi zadanie. Jeśli tworzysz zadanie z kolumny tablicy, automatycznie dostaje ten widok i tę kolumnę. Możesz wybrać inny albo usunąć widok.

Jako osoba przypisana jesteś wpisany Ty sam. Jeśli usuniesz siebie i nie wybierzesz nikogo, zadanie nie ma przypisanej osoby. Blokady i poświęcony czas dodajesz po utworzeniu zadania.

## Właściwości [#eigenschappen]

- **Status** i **Priorytet** - zobacz [przegląd](/taken#statussen)
- **Przypisano do** - jeden lub więcej współpracowników albo [grup](/gebruikers/groepen). Szukaj w polu **Szukaj osób lub grup...**. Jeśli przypiszesz grupę, zadanie dotyczy wszystkich, którzy w danej chwili do niej należą
- **Klient** - powiąż jednego lub więcej klientów przyciskiem **Dodaj klienta**
- **Etykiety** - zobacz [Etykiety](/taken/labels). Brakującą etykietę utworzysz od razu, wpisując nazwę i wybierając **Utwórz [nazwa]**
- **Termin** - ostateczna data, wraz z godziną. Jeśli termin minął, czas względny jest czerwony
- **Przypomnienie** - data i godzina, o której chcesz dostać powiadomienie, ewentualnie powtarzalne
- **Powiadomienia** - gdy ustawisz przypomnienie lub termin, wybierasz, czy chcesz **E-mail** i/lub **Powiadomienie push**. Obie opcje są domyślnie włączone
- **Utworzone przez** - kto utworzył zadanie
- **Pola niestandardowe** - pola, które Twoja organizacja sama dodała do zadań. Zmiany są zapisywane od razu. Zobacz [Pola niestandardowe](/eigen-velden)
- **Widok** - kliknij nazwę widoku w lewym górnym rogu, aby wybrać, na których listach jest zadanie i w której kolumnie. Przy widoku filtrowanym wybierasz tylko kolumnę
- **Prywatne** - jeśli jest kłódka z napisem **Prywatne**, zadanie jest tylko w widokach osobistych, zobacz [Zadania prywatne](/taken/prive-taken)

Zadanie może też mieć **Opis**. Opis obsługuje Markdown do formatowania.

## Powtarzające się przypomnienia [#herhalende-herinneringen]

Przypomnienie może się powtarzać, aż zadanie zostanie ukończone:

1. Najpierw ustaw **Przypomnienie** (datę i godzinę)
2. Kliknij pole powtarzania poniżej (domyślnie **Nie powtarza się**)
3. Wybierz **Codziennie**, **Każdy dzień roboczy (pon – pt)**, **Co tydzień**, **Co miesiąc**, **Co rok** lub **Niestandardowe…**

Przy **Niestandardowe…** tworzysz własny harmonogram:

- **Powtarzaj co** - liczba dni, tygodni, miesięcy lub lat
- **Powtarzaj w** - przy harmonogramie tygodniowym dni tygodnia, w które przypomnienie może przyjść
- **Kończy się** - **Nigdy**, **W dniu** lub **Po** określonej liczbie razy

Jeśli przypomnienie wypada w dniu, który wykluczyłeś, przesuwa się bez powiadomienia na najbliższy dozwolony dzień. Powtarzanie kończy się, gdy zadanie ma status **Ukończone** albo harmonogram się skończy.

## Powiązane elementy [#gekoppelde-items]

W sekcji **Powiązane elementy** widzisz, z czym jest związane zadanie. Możesz powiązać po kilka elementów każdego rodzaju: działki, faktury, rezerwacje, liczniki, rozmowy telefoniczne, transakcje bankowe, produkty i rozmowy ze skrzynki. Zadanie może być też powiązane z komentarzem. Zadanie dotyczące transakcji bankowej tworzysz z menu transakcji w **Transakcje bankowe** przez **Utwórz zadanie**. Zadanie dotyczące produktu, na przykład sprawdzenia konta księgowego, tworzysz na stronie produktu z menu **⋯** przez **Utwórz zadanie**; otwarte zadania produktu są na górze tej strony.

Dodatkowy element powiążesz plusikiem przy **Powiązane elementy** (podpowiedź **Powiąż element**). Szukaj klienta, działki, licznika, faktury, rezerwacji lub produktu. Jeśli wybrany element należy do klienta, Tillor pyta **Powiązać też [klient]?**:

- **Powiąż oba** - zadanie pojawia się też przy kliencie
- **Tylko ten element** - klient nie jest powiązany z zadaniem

Przyciskiem **Odłącz** usuwasz powiązanie. Powiązane zadania, które są jeszcze otwarte, pojawiają się na stronie elementu w sekcji **Otwarte zadania**.

## Załączniki [#bijlagen]

W sekcji **Załączniki** dodajesz pliki do zadania. Kliknij plusik albo wklej plik, naciskając Cmd lub Ctrl i V w dowolnym miejscu okna.

## Podzadania [#subtaken]

Zadanie może mieć podzadania, czyli listę kontrolną w oknie szczegółów. Jest tylko jeden poziom: podzadanie samo nie może mieć podzadań.

1. Otwórz zadanie nadrzędne albo wypełnij je już podczas tworzenia zadania
2. W polu **Dodaj podzadanie** wpisz nazwę i naciśnij Enter
3. Zaznacz podzadanie, aby ustawić je jako **Ukończone**. Zaznacz je ponownie, aby je przywrócić
4. Kliknij nazwę, aby ją zmienić, albo kosz, aby usunąć podzadanie
5. Przeciągnij podzadanie za uchwyt, aby zmienić kolejność. Przyciskiem **Dodaj opis** dodasz podzadaniu też opis

Przy nowym zadaniu podzadania są tworzone razem z zadaniem, w kolejności, w jakiej je wpisałeś. Podzadania nie występują jako osobne karty na tablicach, w tabelach ani w kalendarzu. Na zadaniu widzisz licznik, taki jak **2/5**. Jeśli ustawisz zadanie nadrzędne jako **Ukończone**, wszystkie otwarte podzadania też zostaną ukończone. W drugą stronę nie musi tak być: możesz zakończyć zadanie nadrzędne, mimo że podzadania są otwarte.

## Blokady i zależności [#blokkades-en-afhankelijkheden]

Czasem zadanie może się zacząć lub zakończyć dopiero, gdy inne jest gotowe. W oknie szczegółów zapisujesz to tak:

- **Zablokowane przez** - zadania, które muszą być gotowe wcześniej. Dodaj je przyciskiem **Dodaj blokujące zadanie**
- **Blokuje inne zadania** - zadania, które czekają na to zadanie. Dodaj je przyciskiem **Dodaj zablokowane zadanie**

Przy każdej grupie widzisz, ile zadań jest jeszcze otwartych (na przykład **2 wciąż otwarte**). Szukaj zadań w polu **Szukaj zadań...** i usuń powiązanie przyciskiem **Usuń powiązanie**. Na karcie zadania pod nazwą jest wiersz taki jak **Zablokowane przez 1 zadanie**. Możesz filtrować po zablokowanych zadaniach, zobacz [Filtrowanie](/taken/filteren).

Blokada Cię nie powstrzymuje. Jeśli spróbujesz zaznaczyć zablokowane zadanie, Tillor pyta **Zakończyć zablokowane zadanie?** i kończy je dopiero, gdy wybierzesz **Zakończ mimo to**.

Blokadę dodasz też z menu z trzema kropkami w prawym górnym rogu okna, przez **Dodaj blokujące zadanie** i **Dodaj zablokowane zadanie**.

## Poświęcony czas [#bestede-tijd]

Obok **Poświęcony czas** w oknie szczegółów jest suma. Kliknij ją, aby zapisać czas.

<DocScreenshot src="/screenshots/taken/task-time-popover.png" alt="Poświęcony czas z przyciskiem Zacznij, polem do ręcznego wpisu i wpisami współpracowników" />

Masz dwa sposoby:

- **Timer**. Kliknij **Zacznij**, pracuj nad zadaniem i kliknij przycisk stopu, gdy skończysz. Czas jest zapisywany w zadaniu wraz z sekundami
- **Wpisanie po fakcie**. Wpisz czas trwania, na przykład **1:30**, **90** (minut), **1u 30m** lub **1.5h**. Wszystkie cztery oznaczają półtorej godziny. Ewentualnie dodaj notatkę w polu **Co zostało zrobione? (opcjonalnie)** i kliknij **Zapisz**

Czas jest zapisywany na dzień dzisiejszy. Na liście przy każdym wpisie widzisz, kto go dodał, datę, notatkę i czas trwania. Współpracownicy widzą swoje wpisy nawzajem, ale usunąć możesz tylko własne, przez kosz, który pojawia się po najechaniu myszą na wiersz.

### Timer [#de-timer]

- Działający timer biegnie dalej, gdy przejdziesz na inną stronę. Jest wtedy małą kartą w prawym dolnym rogu, z przyciskami do wstrzymania (**Wstrzymaj**), wznowienia (**Wznów**), **Zapisz etap** i zatrzymania (**Zakończ**). Kliknij nazwę zadania, aby wrócić
- Przyciskiem **Zapisz etap** zapisujesz dotychczasowy fragment, z krótką notatką o tym, czym się zajmowałeś, a timer działa dalej
- Możesz liczyć czas tylko na jednym zadaniu naraz. Dopóki Twój timer działa, **Zacznij** przy innych zadaniach jest wyłączone
- Jeśli przez dziesięć minut nie używasz myszy ani klawiatury, timer wstrzymuje się w ostatnim momencie, w którym byłeś aktywny
- Współpracownicy widzą w oknie zadania, że pracujesz (**Pracuje**) albo masz przerwę (**Wstrzymane**). Ten czas liczy się do sumy dopiero po zapisaniu

## Komentarze i aktywność [#opmerkingen-en-activiteit]

Na dole okna jest sekcja **Komentarze**. Przyciskiem **Dodaj komentarz** piszesz komentarz. W komentarzu możesz wspomnieć współpracowników, aby dostali powiadomienie. Pod spodem jest **aktywność**: oś czasu utworzenia i zmian, a przy zmianie widać, co było przed i po.

## Menu zadania [#het-menu-van-de-taak]

W prawym górnym rogu okna jest menu z trzema kropkami.

<DocScreenshot src="/screenshots/taken/task-dialog-menu.png" alt="Menu zadania z dodawaniem blokad, Drukuj, Kopiuj link i Usuń" />

- **Dodaj blokujące zadanie** i **Dodaj zablokowane zadanie** zapisują zależność
- **Drukuj** ma trzy opcje. **Drukuj (A4)** otwiera okno drukowania przeglądarki z plikiem PDF zadania. **Wyślij do drukarki A4** i **Wyślij do drukarki termicznej (POS)** wysyłają zadanie na Twoją drukarkę, na przykład drukarkę paragonów. Te dwie opcje wybierzesz tylko wtedy, gdy Twoja organizacja ma [connector](/connector) z drukarką, zobacz [Drukarka](/printer)
- **Kopiuj link** kopiuje link, który od razu otwiera zadanie. Kto otworzy link, musi mieć prawo do zobaczenia zadania
- **Usuń** jest na dole, zobacz [Usuwanie zadania](#een-taak-verwijderen)

Wydruk pokazuje nazwę, status, priorytet, termin i opis, a w sekcji **Powiązane elementy** klientów, faktury, rezerwacje, działki i liczniki, z którymi zadanie jest związane. Jeśli zadanie ma blokady, są też zadania, które je blokują, i zadania, które samo blokuje. Grupa bez elementów jest pomijana.

## Zadania z przyciskami wyboru [#taken-met-keuzeknoppen]

Niektóre zadania, na przykład z [automatyzacji z krokiem Poproś o decyzję](/automatiseringen/logica#vraag-om-een-beslissing), wymagają decyzji. Zamiast znacznika wyboru na zadaniu są przyciski, a nad nimi napis **Wybierz akcję, aby zakończyć to zadanie**. Klikasz przycisk i zadanie jest zakończone.

- Jeśli wybór wymaga uzasadnienia, Tillor najpierw otwiera okno z pytaniem **Dlaczego ten wybór?**, w którym wpisujesz notatkę
- Jeśli wybór wymaga potwierdzenia, Tillor najpierw pokazuje okno. Dokonanego wyboru nie da się już cofnąć z poziomu zadania
- Potem na zadaniu widać, jaki wybór został dokonany i przez kogo
- Wybierać może osoba przypisana do zadania oraz administrator. Jeśli nikt nie jest przypisany, wybierać może każdy, kto widzi zadanie

Tak zadanie i automatyzacja są ze sobą powiązane:

```mermaid
flowchart TD
  A["De automatisering bereikt de stap<br/>Vraag om een beslissing"] --> B["Tillor maakt een taak met jouw knoppen<br/>en de automatisering wacht"]
  B --> C{"Een collega kiest een knop"}
  C -- "Een optie" --> D["De taak staat op Voltooid<br/>de automatisering gaat via die optie verder"]
  C -- "Niemand kiest binnen de wachttijd" --> E["De automatisering gaat via Verlopen verder<br/>de taak blijft bestaan"]
  C -- "De taak wordt verwijderd" --> E
```

Zadanie utworzone przez automatyzację, które może zakończyć tylko przepływ, pokazuje zamiast znacznika wyboru tekst **Kończy ją automatyzacja**. Nie możesz go wtedy ukończyć i w menu nie ma **Usuń**.

## Szybka zmiana statusu i zaznaczanie [#status-snel-wijzigen-en-afvinken]

Bez otwierania okna możesz:

- Zaznaczyć pole po lewej od nazwy zadania, aby ustawić zadanie jako **Ukończone**. Jeśli je odznaczysz, wraca do **W toku**
- Kliknąć trzy kropki na karcie zadania albo kliknąć kartę prawym przyciskiem myszy, aby otworzyć szybkie menu z **Edytuj**, **Status**, **Priorytet**, **Przypomnienie**, **Termin**, **Etykiety**, **Widoki** i **Usuń**. **Etykiety** są tam tylko wtedy, gdy istnieją etykiety, a **Widoki** tylko wtedy, gdy są listy, do których sam dodajesz zadania

<DocScreenshot src="/screenshots/taken/task-actions-menu.png" alt="Szybkie menu karty zadania" />

## Usuwanie zadania [#een-taak-verwijderen]

Wybierz **Usuń** w szybkim menu zadania albo w menu z trzema kropkami w oknie zadania i potwierdź. Nie można tego cofnąć, a ewentualne podzadania znikają razem z nim. Usunięcie jest zapisywane w [dzienniku aktywności](/activiteitenlog).

Przy zadaniu, które może zakończyć tylko automatyzacja, **Usuń** nie ma w menu. Jeśli takie zadanie zostanie mimo to usunięte w inny sposób, automatyzacja czekająca na jego zakończenie kończy się błędem.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Zmiany w istniejącym zadaniu są zapisywane od razu. Tylko opis zapisujesz sam przyciskiem **Zapisz**.
- Jeśli przypiszesz zadanie, ten współpracownik (albo członkowie grupy) dostaje powiadomienie. Zobacz [Powiadomienia](/taken/meldingen).
- Jeśli ustawisz zadanie jako <Status tone="success">Ukończone</Status>, otwarte podzadania też zostają ukończone, a przypisani współpracownicy i autor dostają powiadomienie, z wyjątkiem Ciebie. W ręcznie sortowanej liście zadanie opada na dół.
- Przypomnienie lub termin wysyła powiadomienia, dopóki zadanie nie zostanie ukończone.
- Zadanie utworzone przez [automatyzację](/automatiseringen/acties/taken) może samo uruchomić automatyzację, na przykład przy zmianie statusu albo gdy ktoś wybierze przycisk wyboru.
- Usunięcia nie można cofnąć. Usunięcie jest zapisywane w [dzienniku aktywności](/activiteitenlog).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pyta Zakończyć zablokowane zadanie?">
Zadanie czeka jeszcze na jedno lub więcej nieukończonych zadań (zobacz **Zablokowane przez**). Najpierw zakończ te zadania albo wybierz **Zakończ mimo to**.
</Accordion>
<Accordion title="Widzę tekst zamiast znacznika wyboru">
Przy **Kończy ją automatyzacja** nie możesz sam ukończyć zadania. Kończy je automatyzacja. Jeśli zadanie ma przyciski pod **Wybierz akcję, aby zakończyć to zadanie**, kliknij przycisk.
</Accordion>
<Accordion title="Nie mogę użyć przycisków na zadaniu">
Wybierać może osoba przypisana do zadania oraz administrator. Jeśli nikt nie jest przypisany, wybierać może każdy, kto widzi zadanie. Przy komunikacie **Nie udało się zapisać wyboru** spróbuj ponownie.
</Accordion>
<Accordion title="Przycisk Zacznij timera jest szary">
Twój timer już działa na innym zadaniu. Możesz liczyć czas tylko na jednym zadaniu naraz. Najpierw zatrzymaj tamten timer.
</Accordion>
<Accordion title="Mój timer stał, a ja pracowałem">
Po dziesięciu minutach bez myszy i klawiatury timer wstrzymuje się w ostatnim momencie, w którym byłeś aktywny. Użyj **Wznów**, aby kontynuować.
</Accordion>
<Accordion title="Zapisanie czasu się nie udaje">
Wpisz czas trwania, który Tillor rozumie, na przykład **1:30**, **90**, **1u 30m** lub **1.5h**. Jeśli mimo to się nie uda, zobaczysz komunikat **Nie udało się zapisać czasu** i spróbuj ponownie. Usunąć możesz tylko własne wpisy.
</Accordion>
<Accordion title="Drukowanie na drukarce nie działa">
**Wyślij do drukarki A4** i **Wyślij do drukarki termicznej (POS)** wybierzesz tylko wtedy, gdy Twoja organizacja ma connector z drukarką. **Drukuj (A4)** działa zawsze. Jeśli coś pójdzie nie tak, zobaczysz komunikat **Nie udało się wygenerować pliku PDF zadania**.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się zaktualizować zadania">
Zmiana nie została zapisana. Spróbuj ponownie albo odśwież stronę.
</Accordion>
<Accordion title="Nie mogę usunąć zadania">
Przy zadaniu, które może zakończyć tylko automatyzacja, **Usuń** nie ma w menu. Poza tym każdy współpracownik, który widzi zadanie, może je usunąć.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Widoki" href="/taken/weergaven" />
  <Card title="Etykiety" href="/taken/labels" />
  <Card title="Zadania w automatyzacjach" href="/automatiseringen/acties/taken" />
</Cards>


# Zadania na innych stronach (/pl-PL/taken/taken-op-andere-paginas)

Zadania nie istnieją w oderwaniu od reszty. Tworzysz je z elementu, którego dotyczą, i tam też je widzisz.

## Tworzenie zadania z innego elementu [#een-taak-maken-vanuit-een-ander-item]

Zadanie jest automatycznie powiązane z elementem. Jeśli w sprawę zaangażowany jest klient, możesz powiązać go z zadaniem. Domyślnie zadanie jest przypisane do Ciebie.

| Gdzie | Przycisk |
|---|---|
| Strona klienta | **Utwórz zadanie** w menu akcji klienta |
| Faktura | **Utwórz zadanie** w menu akcji |
| Licznik | **Utwórz zadanie** w menu akcji |
| Rezerwacja | **Utwórz zadanie** |
| Działka | **Utwórz zadanie** |
| Rozmowa w skrzynce | **Utwórz zadanie** |
| Rozmowa telefoniczna | **Utwórz zadanie** |
| Komentarz | Ikona zadania przy komentarzu (podpowiedź **Utwórz zadanie z tego komentarza**) |
| Transakcja bankowa | **Utwórz zadanie** w menu akcji transakcji w <UIPath>Administracja > Transakcje bankowe</UIPath> |

## Przypomnienie o dalszych krokach przy komentarzu [#een-opvolgherinnering-bij-een-opmerking]

Przy komentarzu jest też ikona zegara, dzięki której przypomnisz sobie (lub wspomnianym współpracownikom), żeby wrócić do tego komentarza. Tworzy ona zadanie w stylu *Wróć do tego komentarza* albo *Sprawdź, czy [imię] to zauważył*. Gdy później oznaczysz komentarz jako załatwiony, to zadanie jest automatycznie kończone.

## Otwarte zadania przy elemencie [#openstaande-taken-bij-een-item]

Na stronie klienta, rezerwacji, faktury, działki i licznika jest blok **Otwarte zadania** z zadaniami, które nie są jeszcze ukończone i są powiązane z tym elementem. Jeśli nie ma otwartych zadań, blok się nie pojawia.

Na stronie <UIPath>Klienci > [klient] > Zadania</UIPath> znajdziesz wszystkie zadania klienta. Otwierasz ją na karcie **Zadania** na stronie klienta. Ukończone zadania są zwinięte pod **Ukończone zadania**, razem z ich liczbą.

<DocScreenshot src="/screenshots/taken/customer-tasks.png" alt="Karta Zadania na stronie klienta z przyciskiem Nowe zadanie i zadaniami klienta" />

## Na pulpicie [#op-het-dashboard]

Karta **Zadania dla Pana/Pani** pokazuje zadania przypisane do Ciebie. Gwiazdką wybierasz ulubiony widok, który ma się tam pokazywać zamiast nich, zobacz [Widoki](/taken/weergaven#een-favoriete-weergave-voor-het-dashboard). Możesz tam też od razu utworzyć zadanie albo udostępnić zadania.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Zadanie jest powiązane z elementem, z którego je utworzyłeś. Widzisz je w sekcji **Powiązane elementy** w zadaniu.
- Dopóki zadanie nie jest ukończone, znajduje się w bloku **Otwarte zadania** na stronie tego elementu i powiązanego klienta.
- Zadanie dotyczące dalszych kroków przy komentarzu kończy się samo, gdy oznaczysz komentarz jako załatwiony.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie widzę przycisku Utwórz zadanie">
Na niektórych stronach przycisk jest w menu akcji, na przykład przy kliencie, fakturze lub liczniku. Poszukaj tam trzech kropek.
</Accordion>
<Accordion title="Brakuje bloku Otwarte zadania">
Blok pojawia się tylko wtedy, gdy z elementem są powiązane nieukończone zadania.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się utworzyć zadania">
Zadanie nie zostało zapisane. Wpisz nazwę i spróbuj ponownie.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Szczegóły zadania" href="/taken/taakdetails" />
  <Card title="Widoki" href="/taken/weergaven" />
</Cards>


# Widoki (/pl-PL/taken/weergaven)

Na górze strony **Zadania** jest rząd kart. Każda karta to widok. Pierwsza karta, **Wszystkie**, jest wbudowana: pokazuje każde zadanie i nie można jej edytować, przesuwać ani usuwać. Możesz jednak zapisać w niej filtry i ustawienia widoku dla całej organizacji. Wszystkie pozostałe widoki tworzysz sam.

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Karty z widokami na górze strony zadań" />

## Dwa rodzaje widoków [#twee-soorten-weergaven]

Podczas tworzenia w polu **Zawartość** wybierasz rodzaj widoku.

| Rodzaj | Co robi |
|---|---|
| **Widok filtrowany** | Pokazuje każde zadanie spełniające filtry, jak zapisane wyszukiwanie. Nowe pasujące zadania pojawiają się same |
| **Lista** | Pokazuje tylko zadania, które sam do niej dodasz |

Lista jest przydatna dla stałego zbioru, na przykład *Przygotowanie sezonu*. Widok filtrowany jest przydatny dla wszystkiego, co spełnia regułę, na przykład *Wszystkie pilne zadania, które czekają na klienta*.

Rodzaj możesz później zmienić w **Widok** (u góry po prawej) w polu **Rodzaj**. Nie zrobisz tego w widoku **Wszystkie**. Jeśli zamienisz listę na widok filtrowany, zadania dodane do niej ręcznie zostaną od niej odłączone. Tillor najpierw prosi o potwierdzenie, bo nie można tego cofnąć.

## Tworzenie widoku [#een-weergave-aanmaken]

1. Kliknij **Nowy widok** po prawej stronie kart
2. Wpisz **Nazwa** i ewentualnie **Opis**
3. W polu **Widoczność** wybierz, kto widzi widok: **Publiczny**, **Tylko Ty** lub **Udostępniony**. Przy **Udostępniony** w polu **Udostępnij** wybierasz współpracowników i grupy
4. W polu **Zawartość** wybierz **Widok filtrowany** albo **Lista**
5. W polu **Kolumny** wybierz, jak zadania są podzielone: **Własne kolumny**, **Status**, **Przypisano do** lub **Bez grupowania**
6. W polu **Zacznij od** wybierz filtr początkowy: **Wszystkie zadania**, **Otwarte zadania** lub **Moje zadania**
7. Kliknij **Nowy widok** na dole okna

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Okno Nowy widok" />

Domyślnie widok ma ustawione **Publiczny**, **Widok filtrowany**, **Status** i **Otwarte zadania**. Jeśli wybierzesz **Bez grupowania**, dostaniesz tabelę. Przy pozostałych wyborach zaczynasz od tablicy. Dostosujesz to później, zobacz [Tabela, tablica i kalendarz](/taken/indelingen).

Widok filtrowany ustawiony jako tabela wygląda tak. Filtry są nad tabelą i tutaj są już zapisane.

<DocScreenshot src="/screenshots/taken/task-view-filtered.png" alt="Widok filtrowany Pilne zadania jako tabela, z filtrami priorytetu i statusu" />

## Kto widzi widok [#wie-ziet-een-weergave]

| Wybór | Kto widzi widok |
|---|---|
| **Publiczny** | Wszyscy użytkownicy organizacji (widok organizacji) |
| **Tylko Ty** | Tylko Ty (widok osobisty). Na karcie jest kłódka |
| **Udostępniony** | Ty oraz współpracownicy i grupy wybrani w polu **Udostępnij**. Na karcie jest ikona kilku osób |

W polu **Udostępnij** wybierasz osoby i grupy z jednej listy. [Grupa](/gebruikers/groepen) liczy się w składzie, jaki ma w danej chwili: kto później dołączy do grupy, też zobaczy widok, a kto z niej odejdzie, już go nie zobaczy.

Tylko właściciel widoku osobistego może zmienić, komu jest on udostępniony, albo uczynić go widocznym dla wszystkich. Współpracownicy, którym go udostępnisz, mogą w nim pracować, ale nie decydują, kto jeszcze go widzi, i nie mogą go usunąć. Jeśli ustawisz widok jako **Publiczny**, lista wybranych osób i grup przestaje obowiązywać.

<Callout type="warn">
Widoczność widoku decyduje też o tym, kto widzi zadania w tym widoku. Przeczytaj [Zadania prywatne](/taken/prive-taken), zanim umieścisz zadania w widoku osobistym.
</Callout>

## Edycja, duplikowanie i usuwanie widoku [#een-weergave-bewerken-dupliceren-of-verwijderen]

Kliknij prawym przyciskiem myszy kartę widoku i wybierz:

- **Edytuj** - zmień nazwę, opis, widoczność i kolumny. Filtry, sortowanie i układ pozostają takie, jak zostały zapisane. **Zawartość** i **Zacznij od** wybierasz tylko przy tworzeniu; rodzaj zmienisz później w **Widok**
- **Duplikuj** - tworzy kopię o nazwie *[nazwa] (kopia)* i od razu ją otwiera
- **Usuń** - po potwierdzeniu widok znika. Same zadania pozostają i tracą tylko ten widok

Przeciągaj karty, aby zmienić kolejność. Nowa kolejność jest zapisywana od razu.

## Zapisywanie lub odrzucanie zmian [#wijzigingen-opslaan-of-verwerpen]

Gdy zmienisz filtry lub ustawienia widoku, najpierw są one tylko na Twoim ekranie. U góry po prawej pojawia się pasek z **Niezapisane zmiany** i dwoma przyciskami:

- **Zapisz widok** zapisuje zmiany w widoku
- **Odrzuć** przywraca zapisaną wersję

We wbudowanym widoku **Wszystkie** zapisujesz zmiany dla wszystkich w Twojej organizacji, tak jak w widoku publicznym. Potrzebujesz do tego uprawnienia **Zarządzanie etykietami i wspólnymi widokami**. Bez tego uprawnienia w widoku **Wszystkie** możesz zmiany tylko odrzucić przyciskiem **Odrzuć**.

Pasek wyszukiwania (**Szukaj zadań...**) nigdy nie jest zapisywany razem z widokiem: zawęża tylko to, co widzisz teraz.

## Ulubiony widok na pulpicie [#een-favoriete-weergave-voor-het-dashboard]

<DocScreenshot src="/screenshots/taken/dashboard-tasks-card.png" alt="Karta pulpitu Zadania dla Pana/Pani z przyciskami ulubionego widoku i udostępniania" />

Na pulpicie karta **Zadania dla Pana/Pani** domyślnie pokazuje zadania przypisane do Ciebie. Możesz zamiast tego powiązać z nią widok:

1. Kliknij gwiazdkę w prawym górnym rogu karty
2. Wybierz widok z listy. Wybierz **Zadania dla Pana/Pani**, aby wrócić do własnych przypisanych zadań

Możesz mieć jeden ulubiony widok naraz i dotyczy on tylko Ciebie. Jeśli widok został później usunięty albo przestał być dla Ciebie widoczny, pulpit znów pokazuje Twoje zadania.

## Obserwowanie widoku [#een-weergave-volgen]

Przyciskiem **Obserwuj** u góry po prawej codziennie rano dostajesz e-mail z tym, co w tym widoku wymaga uwagi. Jak to działa, opisano w [Powiadomienia](/taken/meldingen#een-weergave-volgen).

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Nowy widok pojawia się jako karta na górze strony zadań. Widok filtrowany od razu pokazuje wszystkie pasujące zadania, a nowe pasujące zadania pojawiają się w nim same.
- Przy **Publiczny** widok widzą wszyscy użytkownicy Twojej organizacji. Przy **Tylko Ty** widzisz go tylko Ty, a przy **Udostępniony** Ty oraz wybrani współpracownicy i grupy.
- Jeśli usuniesz widok, zadania pozostają. Tracą tylko ten widok.
- Jeśli zamienisz listę na widok filtrowany, zadania dodane do niej ręcznie zostaną odłączone.
- Widok, który obserwujesz, wysyła Ci co rano podsumowanie. Zobacz [Powiadomienia](/taken/meldingen#een-weergave-volgen).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pokazuje, że nie udało się utworzyć widoku">
Widzisz **Nie udało się utworzyć widoku**. Sprawdź, czy wpisałeś **Nazwa**, i spróbuj ponownie. Jeśli nadal nie działa, sprawdź połączenie z internetem. Przy duplikowaniu komunikat brzmi **Nie udało się zduplikować widoku** i obowiązuje to samo.
</Accordion>
<Accordion title="Nie mogę edytować ani usunąć karty Wszystkie">
**Wszystkie** jest wbudowany i pokazuje każde zadanie, które możesz zobaczyć. Nazwa, położenie i widoczność są stałe. Możesz jednak zapisać w nim filtry i ustawienia widoku, dla całej organizacji. Jeśli chcesz wyboru tylko dla siebie, utwórz własny widok.
</Accordion>
<Accordion title="Współpracownik nie może upublicznić ani usunąć widoku">
Tylko właściciel widoku osobistego decyduje, komu jest on udostępniony, i może go upublicznić lub usunąć. Współpracownicy, którym go udostępnisz, mogą natomiast edytować w nim zadania.
</Accordion>
<Accordion title="Widzę pasek Niezapisane zmiany">
Zmieniłeś filtry lub ustawienia widoku i są one na razie tylko na Twoim ekranie. Wybierz **Zapisz widok**, aby je zachować, albo **Odrzuć**, aby wrócić. W widoku **Wszystkie** potrzebujesz do tego uprawnienia **Zarządzanie etykietami i wspólnymi widokami**; bez niego możesz tam tylko odrzucić.
</Accordion>
<Accordion title="Zadania nie ma na mojej liście">
Lista pokazuje tylko zadania, które sam do niej dodasz. Jeśli chcesz, aby wszystko, co spełnia regułę, trafiało do niej samo, wybierz w polu **Rodzaj** widok filtrowany.
</Accordion>
<Accordion title="Kolejność kart nie zapisuje się">
Wtedy Tillor pokazuje **Nie udało się zmienić kolejności widoków**. Przeciągnij karty jeszcze raz.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Tabela, tablica i kalendarz" href="/taken/indelingen" />
  <Card title="Filtrowanie" href="/taken/filteren" />
  <Card title="Zadania prywatne" href="/taken/prive-taken" />
</Cards>


# Działki (/pl-PL/terreinen)

Działka to miejsce w Twoim parku: parcela, domek, miejsce dla kamperów lub stałe miejsce. Tutaj tworzysz działki, nadajesz im typ i taryfę oraz podłączasz do nich liczniki. Potem umieszczasz na nich klientów przez [zajęcie](/bezettingen) lub [rezerwację](/reserveringen). Znajdziesz je w <UIPath>Park > Działki</UIPath>.

<DocScreenshot src="/screenshots/park/terrains-list.png" alt="Przegląd działek z demonstracyjną działką 12" />

## Jak to się łączy? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  T[Terrein] --> M[Meters]
  T --> Tar[Berekend tarief]
  K[Klant] -->|bezetting| T
  Tar --> F[Facturen]
  M --> V[Verbruik van de klant]
  V --> F
```

Do działki należy wszystko, co dotyczy tego miejsca. Taryfa wynika z powierzchni i pól niestandardowych działki. Liczniki na działce dostarczają zużycie, a to zużycie trafia do klienta z aktywnym zajęciem. Zobacz też [Zarządzanie licznikami](/meterbeheer#hoe-hangt-dit-samen).

<Callout type="info" title="Warto wiedzieć">
- Nazwa jest wymagana i może mieć maksymalnie 255 znaków.
- **Do rezerwacji** jest przy nowej działce domyślnie wyłączone.
- Powierzchnię Tillor oblicza, gdy obrysujesz działkę na mapie. Nie wpisujesz jej sam.
- **Ostatnie działki** liczy działki z ostatnich 7 dni.
- Działka ma maksymalnie jedno aktywne zajęcie naraz.
- Obliczona taryfa jest liczona od nowa, gdy zapiszesz działkę, a dla wszystkich działek, gdy zapiszesz formułę taryfy.
- Jeśli usuniesz typ działki, działki pozostają, ale nie mają już typu.
</Callout>

## Tworzenie nowej działki [#een-nieuw-terrein-aanmaken]

Zanim zaczniesz: jeśli potrzebujesz typów działek (takich jak **Miejsce** lub **Chalet**) albo pól niestandardowych, utwórz je najpierw. Zobacz [Typy działek](#terreintypes) i [Pola niestandardowe](/eigen-velden).

<Steps>
<Step>
### Kliknij Utwórz nowy teren [#klik-op-nieuw-terrein-aanmaken]
Przycisk jest u góry po prawej w <UIPath>Park > Działki</UIPath>.

<DocScreenshot src="/screenshots/park/terrain-create-dialog.png" alt="Okno tworzenia działki" />
</Step>
<Step>
### Wpisz dane [#vul-de-gegevens-in]
Wymagana jest tylko **Nazwa**. Poza tym możesz wpisać:

- **Opis**, czyli objaśnienie.
- **Typ terenu**, albo zostaw **Bez typu**.
- **Pola niestandardowe**, które Twoja organizacja sama dodała, takie jak dopłata lub numer licznika gazu.
- **Do rezerwacji**, jeśli klienci mogą rezerwować działkę online.
- **Lokalizacja**, aby od razu wskazać działkę na mapie.
</Step>
<Step>
### Kliknij Utwórz działkę [#klik-op-terrein-aanmaken]
Działka jest na liście. Jeśli nie obrysowałeś lokalizacji, zrobisz to później na planie, zobacz [Mapa](/kaart#terreingrenzen-intekenen).
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Działka pojawia się na liście i w statystykach na górze: **Łączna liczba działek**, **Ostatnie działki**, **Działki do rezerwacji**, **Działki niedostępne do rezerwacji** i **Łączna powierzchnia** (tylko działek z obrysowaną lokalizacją).
- Tillor oblicza **Obliczona taryfa** z formuły taryfy Twojej organizacji.
- Na stronie szczegółów możesz podłączać liczniki, dodawać komentarze i oglądać historię.

## Przeglądanie i edycja działki [#een-terrein-bekijken-en-bewerken]

Kliknij działkę na liście. Na górze są nazwa, opis, powierzchnia, liczba liczników, informacja, czy jest do rezerwacji, **Klient** z aktywnym zajęciem oraz data utworzenia i zmiany. W formularzu **Aktualizuj działkę** zmieniasz:

- **Nazwa**, **Typ terenu**, **Opis**, **Do rezerwacji** i **Pola niestandardowe**.
- **Powierzchnia** i **Obliczona taryfa** są tylko do odczytu.

Zapisz przyciskiem **Aktualizuj działkę**. Obok formularza są **Lokalizacja**, **Liczniki** i **Historia zajętości**. Niżej są **Komentarze** (widoczne tylko dla współpracowników), **Zdarzenia** z podglądem przed i po dla każdego zmienionego pola oraz **Rezerwacje**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Szczegóły działki z podłączonymi licznikami" />

## Podłączanie liczników do działki [#meters-aan-een-terrein-hangen]

Na karcie **Liczniki** wybierz **Dodaj licznik**, a potem **Przypisz licznik**. Na liście są tylko liczniki bez działki. Przy każdym liczniku widzisz typ, wskaźnik statusu i ostatni odczyt. Z menu (...) wybierasz **Odłącz od działki**; ta opcja jest tylko tutaj. Całą drogę do klienta opisano w [Powiązanie licznika z klientem](/meterbeheer/meter-koppelen).

## Typy działek [#terreintypes]

Typami działek dzielisz działki, na przykład **Miejsce**, **Chalet** lub **Miejsce dla kamperów**. Typ widzisz na liście działek (kolumna **Typ**, z filtrem), możesz kolorować według niego mapę i jest w eksporcie. Zarządzasz nimi w <UIPath>Pomoc > Ustawienia > Typy terenów</UIPath>.

<Requires permission="Edycja ustawień" />

<DocScreenshot src="/screenshots/instellingen/settings-terrain-types.png" alt="Ustawienia > Typy terenów" />

Tabela **Wszystkie typy terenów** pokazuje dla każdego typu **Nazwa**, **Kolor mapy**, **Opis** i liczbę **Działki**. Szukaj w polu **Szukaj typów terenów...**. Ołówkiem edytujesz typ, koszem go usuwasz.

<Steps>
<Step>
### Kliknij Nowy typ terenu [#klik-op-nieuw-terreintype]
</Step>
<Step>
### Wpisz dane [#vul-de-gegevens-in-1]
Podaj **Nazwa**, ewentualnie **Opis**, i wybierz **Kolor mapy**. Niebieski jest wybrany domyślnie.
</Step>
<Step>
### Kliknij Utwórz [#klik-op-aanmaken]
</Step>
</Steps>

<DocScreenshot src="/screenshots/instellingen/terrain-type-create-dialog.png" alt="Okno tworzenia typu terenu" />

Typ powiązujesz z działką w polu **Typ terenu**. Kolor mapy widzisz na planie, gdy w **Warstwy** ustawisz kolory na **Typ terenu**, zobacz [Mapa](/kaart#lagen-en-kleuren).

## Eksport działek [#terreinen-exporteren]

Kliknij **Eksportuj wszystkie działki** (u góry po prawej), aby pobrać plik Excel. Zawiera on dla każdej działki dane podstawowe, typ terenu, pola niestandardowe i obliczenie taryfy (suma częściowa, dopłaty i suma). Użyj go na przykład do corocznej kontroli taryf.

## Jak powstaje taryfa [#hoe-het-tarief-tot-stand-komt]

**Obliczona taryfa** wynika z formuły taryfy Twojej organizacji. Formuła liczy na podstawie powierzchni i pól niestandardowych działki. Które to pola, ustalasz sam. Formuła domyślna używa pól o kluczach `locationSurcharge`, `gasMeterNumber`, `electricityMeterSurcharge` i `staticPrice`. Jeśli utworzyłeś je w <UIPath>Pomoc > Ustawienia > Pola niestandardowe</UIPath>, działają tak:

1. **Powierzchnia**: obrysowana powierzchnia, w progach za m².
2. **Dopłata za licznik gazu**: dochodzi, jeśli pole z numerem licznika gazu jest wypełnione.
3. **Dopłata za lokalizację**: kwota, którą wpisujesz.
4. **Dopłata za prąd**: kwota, którą wpisujesz.
5. **Cena stała**: jeśli to pole jest wypełnione, ta kwota zastępuje obliczoną taryfę, a Tillor pomija formułę.

Jeśli chcesz zmienić taryfę na dany rok, zmień pola niestandardowe, sprawdź w **Obliczona taryfa**, czy się zgadza, i zapisz przyciskiem **Aktualizuj działkę**.

### Formuła taryfy [#tariefformule]

<Requires permission="Edycja formuły taryfy parceli" />

W <UIPath>Ustawienia > Taryfa parceli</UIPath> sam określasz, jak taryfa jest obliczana. Kto mógł już edytować ustawienia, dostał prawo **Edycja formuły taryfy parceli**. Formuła to fragment TypeScriptu (języka programowania), który zwraca roczną taryfę w euro albo nazwane części, które razem tworzą taryfę, takie jak `Subtotaal` i `Toeslag gasmeter`. Każda część dostaje własną kolumnę w eksporcie.

- Pola działki odczytujesz przez `{terrain.veld}`, na przykład `{terrain.surfaceArea}` lub `{terrain.customFields.locationSurcharge}`. Przyciskiem **Zmienna** albo wpisując `{` wybierasz spośród wszystkich pól, także własnych.
- Po prawej stronie formuły od razu wypróbowujesz ją na jednej ze swoich działek. Błąd widzisz tam z numerem wiersza. Formuły, która nie działa, nie można zapisać.
- Przyciskiem **Przywróć domyślną** wracasz do formuły, od której zaczynała każda organizacja.
- W automatyzacjach odczytujesz taryfę jako `{terrain.calculatedTariff.total}`.

<Callout type="warn" title="Uwaga">
Formuła działa w izolacji: może liczyć tylko na podstawie pól działki, bez innych danych i bez internetu. Formuła, która liczy zbyt długo, jest przerywana i nie daje taryfy.
</Callout>

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pokazuje Działka nie została utworzona">
Działka nie została zapisana. Sprawdź, czy **Nazwa** jest wpisana i nie ma więcej niż 255 znaków, i spróbuj ponownie.
</Accordion>
<Accordion title="Powierzchnia jest pusta lub wynosi 0">
Powierzchnia pochodzi tylko z lokalizacji na mapie. Obrysuj działkę w <UIPath>Park > Mapa</UIPath>, zobacz [Mapa](/kaart#terreingrenzen-intekenen). Działki bez lokalizacji nie liczą się do **Łączna powierzchnia**.
</Accordion>
<Accordion title="Obliczona taryfa się nie zgadza">
Sprawdź pola niestandardowe działki (dopłaty i numer licznika gazu). Jeśli wypełniono **Cena stała**, zastępuje ona obliczoną taryfę. Jeśli formuła została zmieniona, sprawdź w Taryfa parceli, czy test na tej działce się zgadza.
</Accordion>
<Accordion title="Nie widzę Taryfa parceli w ustawieniach">
Potrzebujesz prawa **Edycja formuły taryfy parceli**. Poproś o nie administratora.
</Accordion>
<Accordion title="Licznika nie ma na liście przy Dodaj licznik">
Ten licznik jest już podłączony do innej działki. Najpierw odłącz go tam.
</Accordion>
<Accordion title="Nie mogę utworzyć zajęcia na tej działce">
Działki z aktywnym zajęciem nie ma na liście wyboru. Najpierw zakończ trwające zajęcie.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Działka**: miejsce w Twoim parku. Zobacz [Pojęcia](/begrippen#terrein).
- **Typ terenu**: podział, taki jak **Miejsce** lub **Chalet**, z kolorem mapy.
- **Do rezerwacji**: klienci mogą rezerwować działkę online.
- **Obliczona taryfa**: taryfa, którą Tillor oblicza z formuły.
- **Pole niestandardowe**: pole, które Twoja organizacja sama dodaje. Zobacz [Pojęcia](/begrippen#eigen-veld).
- **Zajęcie**: klient na działce przez pewien okres. Zobacz [Pojęcia](/begrippen#bezetting).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie licznikami" href="/meterbeheer" description="Podłączanie liczników do działek i fakturowanie zużycia" />
  <Card title="Zajęcia" href="/bezettingen" description="Umieszczanie klientów na działce" />
  <Card title="Mapa" href="/kaart" description="Obrysowywanie granic działek" />
</Cards>


# Kontrola dostępu (/pl-PL/toegangscontrole)

Dzięki Kontroli dostępu decydujesz, kto może wjechać na Twój park, i śledzisz, kto jest w środku. Nadajesz klientowi metodę dostępu (tablica rejestracyjna, tag NFC, kod QR lub kod PIN), obsługujesz szlabany ze swojego ekranu i sprawdzasz, kto i kiedy przeszedł przez który punkt dostępu. Metodę dostępu tworzysz w profilu klienta, zobacz [dodawanie metody dostępu](#een-toegangsmethode-toevoegen).

<DocScreenshot src="/screenshots/toegangscontrole/stats-overview.png" alt="Kontrola dostępu ze statystykami u góry" />

Liczby u góry obejmują wszystkie wejścia, ostatnie 24 godziny, dozwolone i zablokowane próby oraz Twoje aktywne punkty dostępu. Pod nimi znajdują się szybkie akcje, pojazdy w parku, dziennik dostępu i operacje kontrolera.

<Callout type="info" title="Warto wiedzieć">
- Pojazd staje się **Duch**, jeśli przez 7 dni nie był widziany przy żadnym punkcie dostępu, a miał status **W środku**.
- Metodę dostępu QR tworzysz za jednym razem do 100 sztuk, każdą z własnym kodem.
- Kod PIN składa się z 4 do 8 cyfr i musi być unikalny w Twojej organizacji.
- Każda tablica rejestracyjna, każdy tag NFC i każdy kod QR może wystąpić w Twojej organizacji tylko raz.
- Metoda dostępu, która nie mieści się w okresie **Data od** i **Data do**, nie daje dostępu.
- Tablica ze statusem **Miękko zablokowany** jest zablokowana tylko w godzinach otwarcia recepcji.
- Wygasła tablica może domyślnie jeszcze przez 2 dni poza godzinami otwarcia wyjechać (maksymalnie 30). Zobacz [Ustawienia kontroli dostępu](/gebruikers/instellingen-toegangscontrole).
- Pojazd pojawia się w profilu klienta przez zarejestrowaną tablicę albo przez tag NFC lub kod QR, którym klient wjechał.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Metoda dostępu to klucz klienta. Punkt dostępu (szlaban lub brama) to drzwi. Pomiędzy nimi jest sprzęt na Twoim parku: kamera odczytująca tablice albo urządzenie odczytujące tagi i kody QR (kontroler dostępu) oraz [łącznik](/connector). Łącznik to urządzenie, które łączy Tillor ze sprzętem na Twoim parku.

```mermaid
flowchart TD
  K[Klant] --> M[Toegangsmethode<br/>kenteken, NFC-tag, QR-code of pincode]
  M -->|Tillor stuurt de lijst door| C[Connector in je park]
  C --> L[Camera of kaartlezer<br/>bij de ingang]
  L -->|toegestaan| P[Toegangspunt gaat open]
  L -->|geweigerd| W[Toegangspunt blijft dicht]
  L -->|elke poging wordt gemeld| LOG[Toegangslogboek in Tillor]
```

Co to dla Ciebie oznacza:

- Jeśli zmienisz lub usuniesz metodę dostępu w Tillor, Tillor przekaże to przez łącznik do sprzętu. Wynik zobaczysz w **Operacje kontrolera**.
- Jeśli łącznik jest offline, nowe lub zmienione metody dostępu pozostają w statusie **Oczekujące**, aż znów się połączy.
- Także szlaban otwierany z Tillor dostaje polecenie zwykle przez łącznik. Jeśli jest offline, szlaban się nie otworzy.

Element Kontrolery w menu głównym dotyczy czegoś innego: ekranów z czytnikiem tagów przy prysznicach, drzwiach i punktach ładowania. Zobacz [Kontrolery](/controllers). Sprzęt przy szlabanach konfiguruje support Tillor podczas uruchomienia.

## Obsługa punktów dostępu [#toegangspunten-bedienen]

W **Szybkie akcje** dla każdego aktywnego punktu dostępu jest przycisk. Ten blok widzisz tylko wtedy, gdy skonfigurowano co najmniej jeden punkt dostępu lub kontroler dostępu.

<DocScreenshot src="/screenshots/toegangscontrole/quick-actions.png" alt="Szybkie akcje z punktami dostępu i przyciskami zarządzania" />

<Steps>
<Step>
### Kliknij przycisk punktu dostępu [#klik-op-de-knop-van-het-toegangspunt]
Napis brzmi **Otwórz [nazwa]**.
</Step>
<Step>
### Potwierdź [#bevestig]
Otworzy się okno z pytaniem, czy na pewno chcesz otworzyć punkt dostępu. Kliknij **Tak, otwórz [nazwa]**.

<DocScreenshot src="/screenshots/toegangscontrole/barrier-confirm-dialog.png" alt="Potwierdzenie otwarcia punktu dostępu" />
</Step>
</Steps>

Tillor wyświetli **Punkt dostępu otwarty**. Zamknąć można tylko wtedy, gdy punkt dostępu to obsługuje. Wtedy obok przycisku otwierania jest strzałka w dół: wybierz w niej **Zamknij [nazwa]** i potwierdź przez **Tak, zamknij [nazwa]**.

### Przyciski zarządzania w Szybkich akcjach [#beheerknoppen-in-snelle-acties]

Obok punktów dostępu, zależnie od Twojego sprzętu, są przyciski do konserwacji. Używaj ich tylko wtedy, gdy coś nie działa.

| Przycisk | Co robi | Kiedy |
|---|---|---|
| **Resetuj APB** | Czyści pamięć o tym, kto ostatnio wszedł lub wyszedł, według typu: **Dla kart NFC…** lub **Dla kodów QR…**. | Ludzie nie mogą przejść, bo brama uważa, że już są w środku (lub na zewnątrz). APB oznacza anti-passback. |
| **Synchronizuj logi urządzeń** | Każe łącznikowi pobrać wszystkie nowe wiersze z kontrolerów dostępu. | W dzienniku dostępu brakuje ostatnich przejść. |
| **Wyczyść pamięć podręczną łącznika** | Łącznik czyści swoje lokalne dane i pobiera wszystko od nowa z Tillor. | Sprzęt zachowuje się inaczej niż metody dostępu w Tillor. |
| **Wyczyść śmieciowe odczyty LPR** | Usuwa tylko bezpieczne wiersze-duchy z listy tablic. Zarejestrowane i powiązane tablice zostają. | Na liście są tablice, które nigdzie nie pasują. |

## Zarządzanie metodami dostępu w profilu klienta [#toegangsmethoden-beheren-via-het-klantprofiel]

Metody dostępu dodajesz, zmieniasz i usuwasz w profilu klienta.

### Dodawanie metody dostępu [#een-toegangsmethode-toevoegen]

Metoda dostępu należy do klienta i daje mu dostęp do parku. Zarządzasz nimi w profilu klienta.

Zanim zaczniesz:

- Klient istnieje w Tillor.
- Dla NFC potrzebujesz tagu, który jeszcze do nikogo nie należy. Jeśli nie ma wolnego tagu, lista pokazuje **Nie znaleziono dostępnych kart NFC - wszystkie są już przypisane.**
- Typ **Kod PIN** jest na liście tylko wtedy, gdy włączono go dla Twojej organizacji.

<Steps>
<Step>
### Otwórz zakładkę Kontrola dostępu [#open-het-tabblad-toegangscontrole]
Przejdź do <UIPath>Klienci > klient > Kontrola dostępu</UIPath>. U góry jest tabela **Metody dostępu** (oznaczenie **1** na zrzucie ekranu poniżej).

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Profil klienta Kontrola dostępu z tabelą Metody dostępu i tablicą 1-DOC-2026" />
</Step>
<Step>
### Kliknij Dodaj i wybierz typ [#klik-op-toevoegen-en-kies-het-type]
<DocScreenshot src="/screenshots/toegangscontrole/access-method-create-dialog.png" alt="Okno nowej metody dostępu" />

Typu nie można potem zmienić. Jeśli potrzebujesz innego typu, dodaj nową metodę dostępu.
</Step>
<Step>
### Wypełnij dane [#vul-de-gegevens-in]
To, co wpisujesz, zależy od typu:
</Step>
</Steps>

<Tabs items={["Tablica", "NFC", "Kod QR", "Kod PIN"]}>
<Tab value="Tablica">
W polu **Tablica rejestracyjna** wpisz numer. Tillor zamieni go na wielkie litery. Marka, model i kolor są opcjonalne.
</Tab>
<Tab value="NFC">
W **Karty NFC** wybierz z listy wolny tag. Możesz szukać po numerze tagu.
</Tab>
<Tab value="Kod QR">
Kod tworzy sam Tillor. W polu **Ilość** tworzysz do 100 osobnych metod dostępu QR naraz, każdą z własnym kodem. Zaznacz **Drukuj bilet termiczny natychmiast**, aby każdy nowy kod QR od razu wysłać jako bilet wjazdowy do drukarki termicznej. Adres drukarki ustawiasz w ustawieniach organizacji. Na bilecie znajdują się **Ważne od** i **Ważne do** w strefie czasowej Twojej organizacji.
</Tab>
<Tab value="Kod PIN">
Wpisz 4 do 8 cyfr albo kliknij **Generuj**. Kod PIN musi być unikalny w Twojej organizacji. Przy kodzie PIN brakuje akcji **Synchronizuj z systemem bram**.
</Tab>
</Tabs>

Dla każdego typu możesz dodatkowo wypełnić:

| Pole | Znaczenie |
|---|---|
| **Data od**, **Data do** | Okres, w którym metoda dostępu działa. Puste oznacza brak ograniczenia. |
| **Status** | **Aktywny**, **Nieaktywny**, **Zablokowany** lub **Miękko zablokowany** (zobacz [statusy](#statussen-van-toegangsmethoden)). |
| **Automatyczna konwersja na tablicę rejestracyjną** | Tylko przy kodzie QR i PIN. Jeśli ktoś użyje kodu przy bramie z kamerą, Tillor zastępuje kod odczytaną tablicą. Domyślnie wyłączone. |
| **Nie przedłużaj automatycznie** | Data końcowa pozostaje niezmieniona, gdy opłacana jest faktura z automatycznym przedłużeniem. |
| **Notatki** | Notatki wewnętrzne. |

Następnie kliknij **Dodaj**, aby zapisać.

#### Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Metoda dostępu pojawia się w tabeli, a Tillor wysyła ją przez łącznik do sprzętu. Śledzisz to w **Operacje kontrolera**, ze statusem <Status tone="info">Oczekujące</Status>, <Status tone="warning">Przetwarzanie</Status>, <Status tone="success">Zakończone</Status> lub <Status tone="error">Niepowodzenie</Status>.
- Zmieniona lub usunięta metoda dostępu jest przekazywana w ten sam sposób.
- Każda próba wejścia pojawia się w dzienniku dostępu, także odrzucone.
- Pojazd jest powiązany z klientem przez zarejestrowaną tablicę albo dlatego, że klient wjechał z tagiem NFC lub kodem QR, podczas gdy kamera odczytała też tablicę. To ostatnie działa nawet wtedy, gdy tablica nie jest zarejestrowana.

#### Edycja, wysyłanie lub usuwanie metody dostępu [#een-toegangsmethode-bewerken-versturen-of-verwijderen]

Kliknij trzy kropki po prawej stronie metody dostępu.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-actions-menu.png" alt="Menu akcji metody dostępu" />

| Akcja | Do czego |
|---|---|
| **Edytuj** | Zmiana okresu, statusu lub danych pojazdu. |
| **Synchronizuj z systemem bram** | Ponowne wysłanie do sprzętu. Tillor wyświetli **Synchronizacja zażądana**. Nie przy kodzie PIN. |
| **Wyślij powiadomienie** | Wysyła klientowi osobisty link do QR e-mailem, SMS-em lub WhatsAppem (okno **Wyślij kod QR**). |
| **Kopiuj osobisty URL** | Kopiuje link do karty klienta, zobacz [Portfel cyfrowy](#digitale-wallet-qr-code). |
| **Pobierz kod QR**, **Drukuj bilet termiczny** | Tylko przy kodzie QR. |
| **Usuń** | Usuwa metodę dostępu. Tego nie można cofnąć. Zaznaczając pola w tabeli, usuwasz kilka naraz. |

#### Statusy metod dostępu [#statussen-van-toegangsmethoden]

| Status | Znaczenie |
|---|---|
| <Status tone="success">Aktywny</Status> | Daje dostęp, o ile okres się zgadza. |
| <Status>Nieaktywny</Status> | Nie daje dostępu. Działa jak Zablokowany, z wyraźniejszą nazwą. |
| <Status tone="error">Zablokowany</Status> | Nie daje dostępu. |
| <Status tone="warning">Miękko zablokowany</Status> | Przy tablicy zablokowany tylko w godzinach otwarcia recepcji. Poza nimi pojazd może jeszcze wjechać i wyjechać. |

## Portfel cyfrowy (kod QR) [#digitale-wallet-qr-code]

Przy metodzie dostępu QR kopiujesz osobisty link dla gościa. Otwiera on stronę **Karta dostępu** z kodem QR. Jeśli Apple Wallet lub Google Wallet są skonfigurowane dla Twojego środowiska, są też przyciski do zapisania karty.

<Steps>
<Step>
### Skopiuj link [#kopieer-de-link]
Otwórz trzy kropki przy metodzie dostępu QR i kliknij **Kopiuj osobisty URL**. Tillor wyświetli **Link skopiowany**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-personal-url-menu.png" alt="Menu akcji metody dostępu QR z opcją Kopiuj osobisty URL" />
</Step>
<Step>
### Wyślij link gościowi [#stuur-de-link-naar-de-gast]
Gość widzi kod QR, ważność oraz, jeśli dostępne, **Dodaj do Apple Wallet** i **Dodaj do Google Wallet**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-public-view-wallet.png" alt="Strona gościa Karta dostępu z kodem QR i przyciskami wallet" />
</Step>
</Steps>

Karta wallet używa tego samego kodu QR, ważności i statusu co w Tillor. Na iPhonie z iOS 27 karta pojawia się jako Poster Generic, opcjonalnie z własnym tłem i kwadratowym kodem QR. Starsze iPhone'y pokazują klasyczny układ. Na iOS 27 na karcie są też skróty: **Wskazówki dojazdu** otwiera Apple Maps do lokalizacji punktu dostępu (lub środka mapy parku), a jeśli w danych firmy ustawiono stronę internetową, pojawia się przycisk do tej strony. Tło i lokalizację ustawiasz w **Ustawienia**, zobacz [Organizacja](/gebruikers/organisaties). Na iPhonie karta może pojawić się na ekranie blokady, gdy gość jest w pobliżu. Na Androidzie gość zapisuje kartę w Google Wallet.

### Sprawdzanie, gdzie zapisano kartę [#zien-waar-de-pas-is-opgeslagen]

Jeśli gość dodał kartę, obok wartości QR widać małą ikonę wallet, z liczbą, gdy urządzeń jest więcej niż jedno. Najedź na nią kursorem, aby zobaczyć:

- czy karta jest w **Apple Wallet na iPhonie** czy **Google Wallet na Androidzie** i na ilu urządzeniach
- kiedy karta była **Ostatnio dodano** i **Karta zaktualizowana**, w Apple także **Ostatnia synchronizacja**
- czy karta została **Wydano przez** **Pracownik** czy **Link osobisty**

Google nie powiadamia, gdy gość usuwa kartę. W Google Wallet karta pozostaje więc jako zapisana.

### Ponowne wysłanie karty wallet [#een-wallet-pas-opnieuw-versturen]

Jeśli karta QR się zmienia, na przykład ważność, Tillor sam wysyła aktualizację do portfeli. Jeśli mimo to widać starą wersję, wybierz w menu **Synchronizuj kartę Wallet**. Tillor poda, ile urządzeń dostało aktualizację. Jeśli karta nie jest jeszcze nigdzie zarejestrowana, zobaczysz **Nie zarejestrowano jeszcze żadnego urządzenia do aktualizacji.** Ta pozycja menu pojawia się dopiero, gdy karta została dodana do portfela.

## Pojazdy w parku [#voertuigen-in-het-park]

Tabela **Pojazdy w parku** śledzi dla każdej tablicy, czy pojazd jest w środku. Odczyt przy wjeździe ustawia pojazd na **W środku**, odczyt przy wyjeździe na **Wyjechał**.

Każdy wiersz pokazuje tablicę, status, klienta, moment wjazdu, ostatni moment, w którym pojazd był widziany przy punkcie dostępu, i ten punkt dostępu. Tabela domyślnie pokazuje pojazdy, które są **W środku** lub **Duch**. Filtrami pokażesz też pojazdy, które wyjechały, przefiltrujesz po punkcie dostępu albo wyszukasz po tablicy lub nazwie klienta.

| Status | Znaczenie |
|---|---|
| <Status tone="success">W środku</Status> | Wjechał przez wjazd i jeszcze nie wyjechał. |
| <Status tone="warning">Duch</Status> | Miał status W środku, ale od 7 dni nie był widziany przy żadnym punkcie dostępu. |
| <Status>Wyjechał</Status> | Wyjechał przez wyjazd. |

Pojazd-duch powstaje zwykle dlatego, że kamera nie odczytała tablicy przy wyjeździe albo odczytała ją błędnie przy wjeździe. Jeśli tablica zostanie później ponownie zobaczona przy wjeździe, pojazd znów ma status **W środku**.

### Zajętość parku [#parkbezetting]

Karta **Zajętość parku** pokazuje, ile pojazdów jest w środku: **Obecnie w środku**, **Szczyt** w wybranym okresie oraz liczbę **Wjazdy** i **Wyjazdy**. Pierwszy wykres pokazuje przebieg, godzinowo do tygodnia i dziennie przy dłuższym okresie. **Popularne godziny** pokazują dla każdej godziny doby średnią liczbę pojazdów i przyjazdów. Dzięki temu widzisz na przykład, kiedy jest dość tłoczno, aby otworzyć gastronomię. Wybierakiem okresu w prawym górnym rogu wybierasz dzisiaj, 7 dni, 30 dni, 90 dni, wszystko lub własny zakres.

## Dziennik dostępu [#toegangslogboek]

Dziennik dostępu pokazuje każdą próbę wejścia, z datą, metodą dostępu, klientem (jeśli znany), punktem dostępu i statusem.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Dziennik dostępu z tablicami, klientem i statusem" />

Filtruj i szukaj po tablicy lub wartości (przy NFC także po etykiecie karty), zakresie dat, statusie, typie metody dostępu, punkcie dostępu lub kliencie. Przez **Eksportuj** po prawej stronie paska narzędzi pobierasz dziennik jako plik Excel.

| Status | Znaczenie |
|---|---|
| Dozwolony | Dostęp został przyznany. |
| Zablokowany | Dostęp został odrzucony. |
| Nieaktywny | Metoda dostępu jest nieaktywna. |
| Wygasły | Metoda dostępu wygasła. |
| Nieprawidłowy | Metoda dostępu jest nieprawidłowa. |
| Odmowa | Dostęp został aktywnie odrzucony. |
| Miękko zablokowany | Dostęp jest miękko zablokowany. |
| Błąd urządzenia | Wystąpił problem z urządzeniem. |
| Brak pojazdu | Nie wykryto żadnego pojazdu. |
| APB - niezgodność kierunku | Brama blokuje przejazd, bo kierunek się nie zgadza (anti-passback). |
| Nieznany | Nie udało się ustalić statusu. |
| Komunikat systemowy | Komunikat samego systemu. |

## Historia stanu bram [#hekstatusgeschiedenis]

Pod dziennikiem dostępu znajduje się też **Historia stanu bram**: kiedy punkt dostępu był **Otwarta**, **Zamknięta** lub **W ruchu**, ze **Źródło** zgłoszenia. Jeśli stan nie jest znany, widnieje **Nieznany**. Filtruj po statusie lub punkcie dostępu. Jeśli lista jest pusta, nie otrzymano jeszcze żadnych zgłoszeń stanu.

## Operacje kontrolera [#controller-operaties]

Poniżej znajdują się **Operacje kontrolera**. To polecenia, które Tillor wysyła do kontrolerów dostępu, takie jak **Utwórz**, **Aktualizuj**, **Usuń** i **Synchronizuj**. Dzięki temu widzisz, kiedy karta lub kod QR dotarły do punktu dostępu.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Operacje kontrolera z poleceniami i ich statusem" />

Polecenie ma status <Status tone="info">Oczekujące</Status>, <Status tone="warning">Przetwarzanie</Status>, <Status tone="success">Zakończone</Status> lub <Status tone="error">Niepowodzenie</Status>. Ikoną oka po prawej stronie wiersza otwierasz szczegóły.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Brakuje bloku Szybkie akcje">
Blok pojawia się tylko wtedy, gdy skonfigurowano punkt dostępu lub kontroler dostępu. Jeśli nic nie ma, support Tillor nie połączył jeszcze sprzętu.
</Accordion>
<Accordion title="Tillor mówi: Nie udało się otworzyć punkt dostępuu">
Punkt dostępu nie zareagował. Najczęściej łącznik jest offline lub urządzenie jest niedostępne. Sprawdź łącznik, zobacz [Łącznik niepołączony](/connector#problemen), i spróbuj ponownie.
</Accordion>
<Accordion title="Tillor mówi: Ta wartość poświadczenia jest już używana">
Każda tablica, każdy tag NFC i kod QR może wystąpić w Twojej organizacji tylko raz. Przy tablicy Tillor podaje, u którego klienta już jest. Najpierw usuń lub zmień tę metodę dostępu.
</Accordion>
<Accordion title="Klient z ważną tablicą nie może wjechać">
Sprawdź w dzienniku dostępu, jaki status dostała próba. **Wygasły** lub **Nieaktywny**: sprawdź **Data od**, **Data do** i **Status** metody dostępu. **Miękko zablokowany**: tablica jest zablokowana w godzinach otwarcia recepcji. **Błąd urządzenia** lub **Brak pojazdu**: kamera niczego nie odczytała, sprawdź sprzęt. Jeśli metoda dostępu jest dobra, a brama nadal odmawia, sprawdź w **Operacje kontrolera**, czy ostatnia zmiana ma status **Zakończone**.
</Accordion>
<Accordion title="Nowa metoda dostępu jeszcze nie działa przy bramie">
Sprawdź w **Operacje kontrolera**, czy polecenie ma status <Status tone="success">Zakończone</Status>. Jeśli ma **Oczekujące**, łącznik prawdopodobnie jest offline. Jeśli **Niepowodzenie**, wybierz przy metodzie dostępu **Synchronizuj z systemem bram**.
</Accordion>
<Accordion title="Ludzie są odrzucani z APB - niezgodność kierunku">
Brama uważa, że już są w środku (lub na zewnątrz). Kliknij **Resetuj APB** w Szybkich akcjach i wybierz **Dla kart NFC…** lub **Dla kodów QR…**. Potwierdź przez **Resetuj**.
</Accordion>
<Accordion title="Lista tagów NFC jest pusta">
Na liście są tylko tagi, które jeszcze do nikogo nie należą. Najpierw usuń tag od innego klienta, zobacz [Zarządzanie tagami](/nfc/nfc-tags#wat-kun-je-met-een-tag-doen).
</Accordion>
<Accordion title="Pojazd ma status Duch">
Pojazd nie był widziany od 7 dni. Zwykle po prostu odjechał, a kamera tego nie zobaczyła. Sam znów będzie **W środku**, jeśli tablica zostanie ponownie odczytana przy wjeździe.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Metoda dostępu**: klucz klienta, czyli tablica rejestracyjna, tag NFC, kod QR lub kod PIN.
- **Punkt dostępu**: szlaban, brama lub drzwi, które się otwierają.
- **Kontroler dostępu**: urządzenie przy punkcie dostępu, które odczytuje tagi i kody QR.
- **Łącznik**: urządzenie na Twoim parku, które łączy Tillor ze sprzętem. Zobacz [Łącznik](/connector).
- **APB (anti-passback)**: zasada, że nie można dwa razy przejść przez bramę w tym samym kierunku.
- **Pojazd-duch**: pojazd, który figuruje jako w środku, ale od 7 dni nie był widziany.

Więcej wyjaśnień znajdziesz w [liście pojęć](/begrippen).

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Łącznik" href="/connector" description="Urządzenie, które łączy Tillor ze sprzętem" />
  <Card title="NFC" href="/nfc" description="Parowanie tagów i zarządzanie saldem" />
  <Card title="Ustawienia kontroli dostępu" href="/gebruikers/instellingen-toegangscontrole" description="Tolerancja dla wygasłych tablic" />
  <Card title="Zarządzanie klientami" href="/klantenbeheer" />
</Cards>


# Pogoda (/pl-PL/weer)

Na stronie **Pogoda** widzisz dzień po dniu pogodę w lokalizacji Twojego parku, dzięki czemu możesz zestawić szczyt zużycia lub tłok z pogodą. Tillor używa tych danych także przy licznikach i rezerwacjach.

<Callout type="info" title="Warto wiedzieć">
- Pogoda jest przypisana do środka mapy Twojej organizacji. Jeśli jest on ustawiony błędnie, pogoda się nie zgadza.
- Tillor pobiera pogodę co noc i uzupełnia brakujące dni z przeszłości.
- Domyślnie widzisz ostatnie 14 dni.
- Dzień z oznaczeniem **Archiwum** jest ostateczny. Dzień z oznaczeniem **Prognoza** może się jeszcze zmienić.
</Callout>

## Otwieranie strony [#de-pagina-openen]

Przejdź do <UIPath>Park > Pogoda</UIPath>.

<DocScreenshot src="/screenshots/weer/weather-overview.png" alt="Park > Pogoda z prognozą dzienną" />

Pod **Prognoza dzienna** widać lokalizację, na przykład **Centrum mapy: 50.8503, 4.3517**. To środek mapy Twojego parku. Ustawiasz go w <UIPath>Ustawienia > Karta</UIPath>. Jeśli go przesuniesz, pogoda podąży za nowym miejscem. Zobacz [Mapa](/kaart).

Zobaczysz:

- dużą kartę dla ostatniego dnia z temperaturą, warunkami, temperaturą najwyższą i najniższą oraz ilością deszczu. Obok dnia widnieje **Archiwum** dla dnia już ostatecznego albo **Prognoza** dla dnia, który może jeszcze zostać zaktualizowany
- pod nią kafelek dla każdego dnia, z warunkami, takimi jak **Bezchmurnie**, **Częściowe zachmurzenie**, **Pochmurno**, **Mgła**, **Mżawka**, **Deszcz**, **Przelotne opady**, **Śnieg** lub **Burza**, temperaturą najwyższą i najniższą oraz opadem w mm. Dzisiejszy dzień ma kolorową ramkę
- **Brak danych dla tego dnia** przy dniu, dla którego Tillor nic nie ma

## Wybór innego okresu [#een-andere-periode-kiezen]

Domyślnie widzisz ostatnie 14 dni. Kliknij w prawym górnym rogu **Wybierz okres**, aby wybrać inny okres: **Dzisiaj**, **Wczoraj**, **Ostatnie 7 dni**, **Ostatni miesiąc**, **Ostatnie 3 miesiące**, **Wszystkie** lub **Zakres niestandardowy** w kalendarzu. Własny zakres potwierdzasz przyciskiem **Zastosuj**.

## Brak danych pogodowych [#nog-geen-weergegevens]

Jeśli widzisz **Brak danych pogodowych**, pogoda nie została jeszcze pobrana. Tillor pobiera ją co noc dla środka mapy Twojej organizacji i uzupełnia też brakujące dni z przeszłości. Spróbuj innego okresu lub wróć następnego dnia. Sprawdź też, czy środek mapy jest prawidłowy.

## Gdzie jeszcze zobaczysz pogodę [#waar-zie-je-het-weer-nog-meer]

- Na stronie licznika, w **Zużycie i trendy**: przy dniu szczytowym widać temperaturę, a przy podwyższonym zużyciu podsumowanie ostatnich 7 dni. Zobacz [Zarządzanie licznikami](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).
- Na osi czasu rezerwacji i na wykresach pojazdów w parku, przy pogodzie danego dnia.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Widzę Brak danych pogodowych">
Pogoda nie została jeszcze pobrana. Spróbuj innego okresu lub wróć następnego dnia i sprawdź, czy środek mapy jest prawidłowy.
</Accordion>
<Accordion title="Pogoda nie pasuje do mojego parku">
Środek mapy jest ustawiony w innym miejscu. Przesuń go w <UIPath>Ustawienia > Karta</UIPath>, zobacz [Mapa](/kaart#kaartstandaard-instellen). Pogoda podąży za nowym miejscem.
</Accordion>
<Accordion title="Przy dniu widnieje Brak danych dla tego dnia">
Dla tego dnia Tillor nic nie ma. Dane uzupełnią się same, gdy staną się dostępne.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Mapa" href="/kaart" description="Ustawianie środka mapy Twojego parku" />
  <Card title="Zarządzanie licznikami" href="/meterbeheer" description="Zużycie i trendy według licznika" />
</Cards>


# Przegląd (/pl-PL/api-referentie)

Ta dokumentacja jest generowana bezpośrednio z API Tillor. Każdy endpoint ma własną stronę z parametrami, treścią żądania, możliwymi odpowiedziami i przykładami kodu. W panelu bocznym endpointy są pogrupowane tematycznie.

## Wysyłanie żądania [#een-request-versturen]

Każde żądanie wymaga Twojego klucza API w nagłówku `x-api-key`. Endpointy pod `/orgs/{organizationId}` działają w obrębie jednej organizacji.

```http
GET https://api.tillor.eu/orgs/org_abc123/customers
x-api-key: tkn_xxx
```

Klucz API tworzysz w aplikacji, w swoim koncie. Jak to działa, jakie obowiązują limity zapytań i jak bezpiecznie przechowywać klucze, przeczytasz w [HTTP API](/ontwikkelaars/http).

## Kto może wywołać endpoint [#wie-mag-een-endpoint-aanroepen]

Każda strona endpointu pokazuje na górze, w sekcji **Dostęp**, kto może go wywołać. W większości przypadków jest to członek organizacji z określonym uprawnieniem, na przykład `customers:read`. Klucz API działa z uprawnieniami osoby, która go utworzyła; jeśli klucz ma zakresy, uprawnienie musi być też w nich. W przeciwnym razie API odpowiada `403`.

Specyfikacja zawiera tę samą informację dla każdego endpointu w `x-tillor-access`, z `access` (kto) i `permissions` (wystarczy jedno).

## Wypróbowanie w playgroundzie [#uitproberen-in-de-playground]

Na każdej stronie endpointu możesz od razu wysłać żądanie. Jeśli jesteś zalogowany w Tillor w tej samej przeglądarce, playground używa Twojej sesji i nie potrzebujesz klucza API. W przeciwnym razie wpisz swój klucz API w polu **Authorization**. Zmień parametry i kliknij **Send**.

Playground komunikuje się z prawdziwym API Twojej organizacji: `POST`, `PUT` lub `DELETE` zmienia więc prawdziwe dane.

<Callout type="warn" title="Użyj organizacji testowej">
Endpointy zapisujące wypróbowuj na organizacji testowej, nie na działającym parku.
</Callout>

## Pobieranie specyfikacji [#specificatie-downloaden]

Pełna specyfikacja jest dostępna jako OpenAPI 3.1 pod adresem [tillor.eu/api/openapi.json](https://tillor.eu/api/openapi.json). Zaimportuj ją do Postmana lub Insomnii albo wygeneruj z niej klienta.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="HTTP API" description="Uwierzytelnianie, limity zapytań i konwencje" href="/ontwikkelaars/http" />
  <Card title="Webhooki" description="Odbieranie zdarzeń pod własnym adresem URL" href="/ontwikkelaars/webhooks" />
</Cards>


# Zarządzanie kontrolerem (/pl-PL/controllers/controller-beheren)

Na stronie kontrolera zmieniasz jego dane i wykonujesz konserwację. Ustawienia takie jak ACL, sieć i aktualizacje znajdziesz osobno w [Ustawieniach kontrolera](/controllers/settings).

Zanim zaczniesz:

- Kontroler jest zatwierdzony, zobacz [Parowanie kontrolera](/controllers/controller-koppelen).

## Zmiana nazwy, typu i grupy [#naam-type-en-groep-wijzigen]

<Steps>
<Step>
### Otwórz kontroler [#open-de-controller]
Przejdź do <UIPath>Kontrolery > Przegląd</UIPath> i kliknij kontroler.
</Step>
<Step>
### Zmień formularz [#pas-het-formulier-aan]
W **Ustawienia kontrolera** wybierasz **Nazwa**, **Typ** (**Prysznic**, **Dostęp** lub **Stacja ładowania**) oraz **Grupa**.
</Step>
<Step>
### Kliknij Zapisz [#klik-op-opslaan]
Tillor wyświetli **Kontroler zaktualizowany** i prześle ustawienia do kontrolera.
</Step>
</Steps>

## Ponowne uruchomienie kontrolera [#een-controller-herstarten]

Jeśli kontroler nie reaguje prawidłowo, uruchom go ponownie z Tillor.

<Tabs items={["Na stronie szczegółów", "W przeglądzie"]}>
<Tab value="Na stronie szczegółów">
Otwórz menu akcji (trzy kropki) i wybierz **Uruchom ponownie kontroler**.

<DocScreenshot src="/screenshots/controllers/controller-actions-menu.png" alt="Menu akcji kontrolera z opcją Uruchom ponownie kontroler" />
</Tab>
<Tab value="W przeglądzie">
Kliknij ikonę restartu w wierszu kontrolera.
</Tab>
</Tabs>

Na ekranie pojawi się **Ponowne uruchamianie**, a potem kontroler połączy się ponownie.

Menu akcji zawiera też **Wyświetl logi w Grafana**. Otwiera ono dzienniki kontrolera w innym programie, przeznaczonym dla supportu. Ostatnie logi znajdziesz na samej stronie kontrolera, w karcie **Konsola**.

## Aktualizacja do nowej wersji [#bijwerken-naar-een-nieuwe-versie]

Jeśli obok numeru wersji widać strzałkę w górę, dostępny jest nowszy <Term term="firmware">firmware</Term> (oprogramowanie). Najedź na nią, aby zobaczyć wersję (**Dostępna aktualizacja**), i kliknij, aby uruchomić aktualizację. Tillor wyświetli **Aktualizacja OTA uruchomiona**. Kiedy kontrolery aktualizują się same, przeczytasz w [Aktualizacje firmware](/controllers/updates).

## Usuwanie kontrolera [#een-controller-verwijderen]

W menu akcji wybierz **Usuń kontroler** i potwierdź w **Usuń kontroler**. Kontroler zniknie z listy. Potem może ponownie poprosić o zatwierdzenie.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Po restarcie kontroler ponownie łączy się z Tillor. To chwilę trwa.
- Po aktualizacji kontroler uruchamia się ponownie sam. Zostaw zasilanie włączone, gdy ekran pokazuje **Aktualizacja** z wartością procentową.
- Usunięty kontroler nie daje już dostępu.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor mówi: Restart nie powiódł się">
Nie udało się uruchomić kontrolera ponownie, najczęściej dlatego, że jest offline. Sprawdź zasilanie i sieć, zobacz [Problemy z połączeniem](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="Tillor mówi: Aktualizacja OTA nie powiodła się">
Nie udało się uruchomić aktualizacji. Sprawdź, czy kontroler jest online i czy **Pomiń aktualizacje OTA** ma wartość **Nie**, zobacz [Aktualizacje firmware](/controllers/updates).
</Accordion>
<Accordion title="Tillor mówi: Aktualizacja nie powiodła się">
Nie udało się zapisać formularza. Spróbuj jeszcze raz i sprawdź, czy nazwa jest wpisana.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Ustawienia kontrolera" href="/controllers/settings" description="ACL, sieć, aktualizacje i przekaźnik" />
  <Card title="Aktualizacje firmware" href="/controllers/updates" description="Okno aktualizacji i częstotliwość" />
</Cards>


# Parowanie kontrolera (/pl-PL/controllers/controller-koppelen)

Nowy kontroler zacznie działać dla Twojej organizacji dopiero po tym, jak go zatwierdzisz. Nazywa się to adopcją: mówisz w Tillor, że to urządzenie należy do Twojego parku. Potem możesz nadać mu typ i grupę, zobacz [Zarządzanie kontrolerem](/controllers/controller-beheren).

Zanim zaczniesz:

- Masz zasilanie i sieć (kabel lub Wi-Fi) w miejscu, gdzie stanie kontroler.
- Jeśli używasz Wi-Fi, masz pod ręką nazwę sieci i hasło.
- Otwórz Tillor najlepiej w tej samej sieci co kontroler. W przeciwnym razie czasem nie zobaczysz jego zgłoszenia.

## Podłączanie i zatwierdzanie kontrolera [#de-controller-aansluiten-en-goedkeuren]

<Steps>
<Step>
### Podłącz kontroler [#sluit-de-controller-aan]
Włącz zasilanie. Ekran pokazuje **Łączenie...**, a potem to, czego jeszcze brakuje.
</Step>
<Step>
### Daj mu sieć [#geef-hem-een-netwerk]
<Tabs items={["Kabel sieciowy", "Wi-Fi"]}>
<Tab value="Kabel sieciowy">
Podłącz kabel sieciowy. Kontroler połączy się sam, nie musisz niczego ustawiać.
</Tab>
<Tab value="Wi-Fi">
Dotknij na ekranie **Skonfiguruj Wi-Fi**, wybierz swoją sieć, wpisz hasło i potwierdź. Ekran pokaże **Połączono**. Zobacz [Konfiguracja Wi-Fi na ekranie](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).
</Tab>
</Tabs>
</Step>
<Step>
### Otwórz Kontrolery w Tillor [#open-controllers-in-tillor]
Przejdź do <UIPath>Kontrolery > Przegląd</UIPath>. Gdy tylko kontroler ma połączenie, pojawia się na liście z komunikatem **Oczekuje na zatwierdzenie**. Ekran kontrolera pokazuje **Aktywuj kontroler** wraz z numerem urządzenia. Ten numer to <Term term="eFuse ID">eFuse ID</Term>, numer seryjny urządzenia. Sprawdź, czy jest taki sam jak na liście.
</Step>
<Step>
### Kliknij Zatwierdź [#klik-op-goedkeuren]
Kliknij ptaszek (**Zatwierdź**) w wierszu. Tillor wyświetli **Zatwierdzono** i kontroler zostanie dodany do Twojej organizacji.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Ekran kontrolera pokazuje **Zeskanuj kod QR** i **Zeskanuj swój tag**. Jest gotowy do użycia.
- Tillor automatycznie wysyła do kontrolera dane połączenia i ustawienia. Nie musisz niczego wypełniać.
- Jego pierwsze skanowanie tworzy tag w Tillor, jeśli jeszcze go tam nie było.
- Krzyżykiem (**Odrzuć**) odrzucasz zgłoszenie. Wtedy kontroler nie dostaje dostępu do Twojej organizacji.
- Jeśli kiedyś odłożysz kontroler lub go wymienisz, usuń go, zobacz [Zarządzanie kontrolerem](/controllers/controller-beheren#een-controller-verwijderen). Potem może ponownie wysłać zgłoszenie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Kontrolera nie ma na liście">
Ekran musi pokazywać **Aktywuj kontroler**, zanim kontroler się pojawi. Jeśli nadal widnieje **Skonfiguruj Wi-Fi** lub **Łączenie...**, nie jest jeszcze online. Otwórz też Tillor z tej samej sieci co kontroler i odśwież stronę. Więcej kroków znajdziesz w [Kontroler nie pojawia się w Tillor](/controllers/troubleshooting/verbinding#controller-verschijnt-niet-in-tillor).
</Accordion>
<Accordion title="Tillor mówi: Zatwierdzenie nie powiodło się">
Nie udało się zatwierdzić adopcji. Spróbuj jeszcze raz. Jeśli błąd się powtarza, sprawdź, czy zegar kontrolera jest prawidłowy, i skontaktuj się z supportem. Zobacz [Adopcja nie powiodła się](/controllers/troubleshooting/verbinding#adoptie-mislukt-of-credentials-worden-geweigerd).
</Accordion>
<Accordion title="Ekran zostaje na Łączenie...">
Poczekaj 1 do 2 minut. Jeśli nic się nie zmienia, sprawdź kabel lub sygnał Wi-Fi. Zobacz [Ekran zostaje na Łączenie...](/controllers/troubleshooting/verbinding#scherm-blijft-op-verbinden).
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Zarządzanie kontrolerem" href="/controllers/controller-beheren" description="Nazwa, grupa, restart i usuwanie" />
  <Card title="Komunikaty na ekranie" href="/controllers/troubleshooting/scherm" description="Co pokazuje kontroler" />
</Cards>


# Przegląd (/pl-PL/controllers)

Kontroler to małe urządzenie z okrągłym ekranem dotykowym na Twoim parku, przy prysznicu, drzwiach lub punkcie ładowania. Gość przykłada do niego tag <Term term="NFC">NFC</Term> albo skanuje kod QR z ekranu, a Tillor decyduje, czy może. Tu przeczytasz, co robi kontroler i jak łączy się z klientami i saldem. Nowy kontroler uruchamiasz według [Parowanie kontrolera](/controllers/controller-koppelen).

Kontrolery znajdziesz w menu głównym w **Kontrolery**. Szlabany i kontrolery dostępu przy Twojej bramie do nich nie należą, zobacz [Kontrola dostępu](/toegangscontrole).

<Callout type="info" title="Warto wiedzieć">
- Kontroler zgłasza się do Tillor co 15 sekund. Po około 35 sekundach bez kontaktu Tillor pokazuje go jako offline.
- Po 5 minutach bez kontaktu zespół Tillor dostaje powiadomienie.
- Kontroler zapamiętuje maksymalnie 8 sieci Wi-Fi.
- Kontrola dostępu przez kontroler (ACL) jest domyślnie wyłączona. Włącz **ACL włączone** w [ustawieniach](/controllers/settings), aby tagi były sprawdzane.
- Domyślnie codziennie sprawdza, czy jest nowa wersja oprogramowania. Aktualizacja startuje tylko w oknie aktualizacji, jeśli je ustawisz.
- Domyślnie czeka na Tillor 1000 milisekund (1 sekundę), zanim przełączy się dalej, w ustawieniu **Limit czasu API ACL**.
- Przy krótkiej przerwie płatność tagiem nadal działa. Płatność kodem QR na chwilę nie działa.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Kontroler sam nie decyduje, kto może przejść. Odczytuje tag i pyta Tillor. Tam jest zapisane, do którego klienta należy tag, dla jakich grup dostępu obowiązuje i ile ma salda.

```mermaid
flowchart TD
  G[Gast houdt tag tegen het scherm] --> C[Controller]
  C -->|vraagt of het mag| T[Tillor]
  T --> K[Klant van de tag]
  T --> A[Toegangsgroepen en saldo]
  T -->|toestaan of weigeren| C
  C -->|toont het resultaat| G
  T --> TR[Transactie in de tag-geschiedenis]
```

- Każdy kontroler ma **Typ** (**Prysznic**, **Dostęp** lub **Stacja ładowania**) i ewentualnie **Grupę**. To, które tagi mogą tu wejść, ustalasz grupami dostępu tagu, zobacz [Zarządzanie tagami](/nfc/nfc-tags).
- Jeśli kontroler na chwilę nie może połączyć się z Tillor, przy **Lokalnie najpierw** używa danych, które sam zapamiętał, zobacz [Ustawienia](/controllers/settings).
- Tag, którego nie ma jeszcze w Tillor, jest tworzony, gdy po raz pierwszy zostanie przyłożony do kontrolera.

## Co widzisz w Tillor? [#wat-zie-je-in-tillor]

- **Przegląd kontrolerów**: wszystkie kontrolery z wersją, typem, grupą, użyciem i informacją, kiedy były **Ostatnio widziane**. Kontrolery, które chcą zostać sparowane, mają status **Oczekuje na zatwierdzenie**.
- **Szczegóły kontrolera**: status, sieć, obciążenie kontrolera, sieci Wi-Fi, zdarzenia i karta **Konsola** z logami.
- **Zarządzanie**: restart, aktualizacja i usuwanie, zobacz [Zarządzanie kontrolerem](/controllers/controller-beheren).

## Elementy [#onderdelen]

<Cards>
  <Card title="Parowanie kontrolera" href="/controllers/controller-koppelen" description="Podłączanie i zatwierdzanie" />
  <Card title="Zarządzanie kontrolerem" href="/controllers/controller-beheren" description="Nazwa, grupa, restart i usuwanie" />
  <Card title="Konfiguracja sieci Wi-Fi" href="/controllers/wifi-netwerken" description="Do 8 sieci według priorytetu" />
  <Card title="Ustawienia kontrolera" href="/controllers/settings" description="ACL, sieć, aktualizacje i przekaźnik" />
  <Card title="Aktualizacje firmware" href="/controllers/updates" description="Okno aktualizacji i częstotliwość" />
  <Card title="Komunikaty na ekranie" href="/controllers/troubleshooting/scherm" description="Co oznacza komunikat na ekranie?" />
  <Card title="Problemy z połączeniem" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, połączenie z Tillor i adopcja" />
  <Card title="Słowniczek" href="/controllers/lexicon" description="Pojęcia takie jak OTA, adopcja i ACL" />
</Cards>

## Pojęcia [#begrippen]

- **Kontroler**: urządzenie z ekranem i czytnikiem tagów.
- **Tag**: karta, opaska lub breloczek gościa. Zobacz [NFC](/nfc).
- **Adopcja**: parujesz nowy kontroler ze swoją organizacją.
- **ACL**: lista, która określa, czy tag może przejść. Zobacz [słowniczek](/controllers/lexicon).
- **Firmware**: oprogramowanie w urządzeniu.

Więcej wyjaśnień znajdziesz w [liście pojęć](/begrippen).


# Słowniczek (/pl-PL/controllers/lexicon)

Przegląd terminów, które spotkasz, pracując z kontrolerami. Przy każdym terminie jest wyjaśnienie oraz, w bloku cytatu, co mamy na myśli zwykłymi słowami.

## A [#a]

<LexiconList>
<LexiconEntry
  term="ACL"
  termAlt="(Access Control List)"
  definition="Kontrola dostępu przez kontroler. Gdy ACL jest włączone, sprawdza, czy karta NFC jest uprawniona; gdy wyłączone, karty są skanowane, ale nie weryfikowane. Priorytet ACL określa, czy najpierw sprawdza lokalnie, czy pyta Tillor online."
  simple="Kontroler zagląda do listy, czy Twoja karta może przejść. Ta lista nazywa się ACL."
/>
<LexiconEntry
  term="Adoptie"
  definition="Sparowanie kontrolera z Twoją organizacją w Tillor. Po adopcji kontroler dostaje odpowiednie ustawienia i może połączyć się z Tillor."
  simple="Mówisz w Tillor „ten kontroler jest nasz”. Potem kontroler zna Twoją organizację i współpracuje."
/>
<LexiconEntry
  term="API"
  definition="Odpytywanie Tillor online przy kontroli dostępu. Przy API najpierw kontroler zawsze pyta Tillor; przy Lokalnie najpierw robi to dopiero wtedy, gdy karty nie ma lokalnie."
  simple="Kontroler pyta Tillor online, czy karta może przejść. To pytanie online nazywamy API."
/>
</LexiconList>

## C [#c]

<LexiconList>
<LexiconEntry
  term="Controller"
  definition="Fizyczne urządzenie stojące na Twoim parku. Kontroler odczytuje karty NFC, sprawdza dostęp i komunikuje się z Tillor."
  simple="Urządzenie przy prysznicu lub drzwiach, do którego przykładasz tag."
/>
<LexiconEntry
  term="Credentials"
  definition="Dane logowania lub dane połączenia. Po adopcji kontroler automatycznie dostaje właściwe dane, aby połączyć się z Tillor."
  simple="Dane logowania, którymi kontroler po adopcji bezpiecznie łączy się z Tillor. Dostaje je automatycznie - nie musisz niczego wpisywać."
/>
</LexiconList>

## E [#e]

<LexiconList>
<LexiconEntry
  term="eFuse ID"
  termAlt="(Electronic Fuse ID)"
  definition="Unikalny numer identyfikacyjny zapisany w sprzęcie kontrolera. Każdy kontroler ma inny eFuse ID - po nim Tillor rozpoznaje, które to urządzenie."
  simple="Numer „odcisku palca” urządzenia. Jak numer seryjny, ale wypalony w układzie."
/>
</LexiconList>

## F [#f]

<LexiconList>
<LexiconEntry
  term="Firmware"
  definition="Oprogramowanie, które działa na kontrolerze. Dzięki aktualizacjom firmware kontroler dostaje nowe funkcje i ulepszenia."
  simple="Program w urządzeniu. Jak telefon, który dostaje aktualizację."
/>
</LexiconList>

## N [#n]

<LexiconList>
<LexiconEntry
  term="NFC"
  definition="Near Field Communication - technika, którą kontroler odczytuje karty, opaski i breloczki. Przykładasz tag do ekranu, aby go zeskanować."
  simple="Sposób, w jaki kontroler odczytuje Twój tag. Przykładasz tag - bez kodu kreskowego i PIN-u."
/>
</LexiconList>

## O [#o]

<LexiconList>
<LexiconEntry
  term="OTA"
  termAlt="(Over-The-Air)"
  definition="Aktualizacje przez internet, bez podłączania czegokolwiek. Kontroler sam pobiera i instaluje nowy firmware."
  simple="Urządzenie samo pobiera nowe oprogramowanie przez internet. Nie musisz nic robić - dzieje się samo."
/>
</LexiconList>

## R [#r]

<LexiconList>
<LexiconEntry
  term="Relais"
  definition="Przełącznik w kontrolerze, którym możesz sterować punktem dostępu lub innym urządzeniem."
  simple="Przycisk w urządzeniu, który może otworzyć lub zamknąć punkt dostępu."
/>
</LexiconList>

## S [#s]

<LexiconList>
<LexiconEntry
  term="Scherm"
  definition="Okrągły ekran dotykowy kontrolera. Pokazuje status zwykłym językiem (gotowe, zapłacono, odmowa, brak połączenia), kod QR do płatności online i na nim ustawiasz Wi-Fi. Czytnik tagów jest za ekranem."
  simple="Okrągły ekranik, do którego przykładasz tag. Mówi, co się dzieje."
/>
</LexiconList>

## T [#t]

<LexiconList>
<LexiconEntry
  term="Tag"
  definition="Nośnik NFC, który dostaje gość: karta, opaska, breloczek lub naklejka. Tag jest w Tillor powiązany z klientem i może mieć saldo."
  simple="Karta, opaska lub breloczek, którym bierzesz prysznic lub wchodzisz."
/>
<LexiconEntry
  term="Tillor"
  definition="Platforma do zarządzania parkiem. Kontroler łączy się z Tillor, aby sprawdzać dostęp i wymieniać dane."
  simple="Program, w którym pracujesz - na komputerze lub tablecie. Kontroler z nim rozmawia."
/>
</LexiconList>

## U [#u]

<LexiconList>
<LexiconEntry
  term="Updatevenster"
  definition="Przedział czasu, w którym kontroler może się aktualizować (np. między 02:00 a 04:00). Poza tym oknem nie są wykonywane żadne aktualizacje."
  simple="Sam wybierasz, kiedy urządzenie może się aktualizować. Na przykład tylko w nocy, aby w dzień nikomu to nie przeszkadzało."
/>
</LexiconList>


# Ustawienia kontrolera (/pl-PL/controllers/settings)

To strona referencyjna do ustawień kontrolera. Znajdziesz je w <UIPath>Kontrolery > Przegląd > [nazwa kontrolera]</UIPath>, w formularzu pod nagłówkiem. Kliknij **Zapisz**, aby zastosować zmiany. Tillor prześle następnie ustawienia do kontrolera. Nazwę, typ i grupę zmienisz w [Zarządzanie kontrolerem](/controllers/controller-beheren).

## Konfiguracja ACL [#acl-configuratie]

<Term term="ACL">ACL</Term> (Access Control List) określa, jak kontroler sprawdza dostęp. *Innymi słowy: jak urządzenie sprawdza, czy karta jest uprawniona.*

| Ustawienie | Znaczenie |
| ---------- | --------- |
| **ACL włączone** | Ustaw na **Tak**, aby używać kontroli dostępu przez kontroler. Przy **Nie** karty są skanowane, ale nie weryfikowane. Domyślnie **Nie**. |
| **Priorytet ACL** | **Lokalnie najpierw**: kontroler sprawdza najpierw własną pamięć, potem Tillor. *Przydatne, gdy internet na chwilę zniknie.* **API najpierw**: zawsze od razu pyta Tillor. Domyślnie **Lokalnie najpierw**. |
| **Limit czasu <Term term="API">API</Term> ACL** | Jak długo (w milisekundach) kontroler czeka na Tillor, zanim przełączy się dalej. Domyślnie 1000 ms (1 sekunda). |

<Callout type="info" title="Kiedy Lokalnie najpierw?">
Wybierz **Lokalnie najpierw**, jeśli chcesz, aby kontroler działał także podczas tymczasowych awarii internetu. Kontroler zapisuje uprawnienia dostępu lokalnie.
</Callout>

## Konfiguracja internetu [#internetconfiguratie]

| Ustawienie | Znaczenie |
| ---------- | --------- |
| **Główne połączenie sieciowe** | **Wi-Fi** lub **Ethernet** (kabel sieciowy). To połączenie, które kontroler próbuje jako pierwsze. Domyślnie **Wi-Fi**. |
| **Sieci Wi-Fi** | Lista sieci Wi-Fi, które zna kontroler, maksymalnie 8. Zobacz [Konfiguracja sieci Wi-Fi](/controllers/wifi-netwerken). |

## Konfiguracja aktualizacji [#updateconfiguratie]

Zobacz [Aktualizacje <Term term="firmware">firmware</Term>](/controllers/updates), gdzie znajdziesz szerokie wyjaśnienie częstotliwości aktualizacji, okna aktualizacji i pomijania aktualizacji OTA.

| Ustawienie | Znaczenie |
| ---------- | --------- |
| **Częstotliwość aktualizacji** | Jak często urządzenie sprawdza, czy jest nowa wersja: **Co godzinę**, **Codziennie** lub **Co tydzień**. |
| **Okres aktualizacji od/do** | *Kiedy urządzenie może się aktualizować?* Np. 02:00-04:00 = tylko w nocy. |
| **Pomiń aktualizacje <Term term="OTA">OTA</Term>** | Ustaw na **Tak**, jeśli urządzenie nie ma już pobierać żadnych aktualizacji. *Przydatne tymczasowo, ale normalnie zostaw Nie.* |

## Sterowanie przekaźnikiem [#relais-aansturing]

<Term term="relais">Przekaźnik</Term> to przełącznik w urządzeniu. *Możesz nim na przykład otwierać lub zamykać punkt dostępu.*

| Ustawienie | Znaczenie |
| ---------- | --------- |
| **Typ przekaźnika** | Obecnie obsługiwany jest tylko **Wewnętrzny**. |
| **Port przekaźnika** | Numer portu przekaźnika. Domyślnie 1. |

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Konfiguracja sieci Wi-Fi" href="/controllers/wifi-netwerken" description="Sieci i priorytet" />
  <Card title="Aktualizacje firmware" href="/controllers/updates" description="Okno aktualizacji i ustawienia OTA" />
  <Card title="Komunikaty na ekranie" href="/controllers/troubleshooting/scherm" description="Co pokazuje ekran kontrolera" />
</Cards>


# Komunikaty na ekranie (/pl-PL/controllers/troubleshooting/scherm)

Kontroler ma okrągły <Term term="scherm">ekran dotykowy</Term>. Pokazuje on zwykłym językiem, co robi kontroler: tytuł, linijkę wyjaśnienia pod nim i kolorową ramkę. *Nie musisz więc pamiętać kolorów: po prostu jest napisane.* Poniżej znajdziesz każdy komunikat i to, co z nim zrobić.

## Gotowy do użycia [#klaar-voor-gebruik]

| Na ekranie | Znaczenie |
| ---------- | --------- |
| **Zeskanuj kod QR** i **Zeskanuj swój tag**, z **Do zapłaty** i kwotą | Kontroler jest gotowy. Gość przykłada tag do ekranu lub skanuje kod QR telefonem. |
| Kod QR szary i przekreślony | Kontroler chwilowo nie ma połączenia z Tillor. Płatność tagiem nadal działa, płatność online kodem QR na chwilę nie. |

## Skanowanie tagu [#een-tag-scannen]

Tag <Term term="NFC">NFC</Term> skanujesz, krótko przykładając go do ekranu, jak przy płatności zbliżeniowej.

| Na ekranie | Znaczenie |
| ---------- | --------- |
| **Chwileczkę** - Płatność jest przetwarzana | Tag został odczytany, kontroler pyta Tillor, czy może. Przytrzymaj tag jeszcze chwilę przy ekranie. |
| **Płatność udana!** z pobraną kwotą i saldem | Zapłacono. Prysznic lub urządzenie startuje. |
| **Witaj** z nazwą gościa | Dostęp przyznany, przy drzwiach lub obiekcie bez płatności. |

Jeśli tag zostanie odrzucony, powód widać na ekranie:

| Na ekranie | Co się dzieje | Co robisz |
| ---------- | ------------- | --------- |
| **Tag nierozpoznany** - Ten tag tu nie pasuje | Tag nie należy do Twojego parku. | Daj gościowi tag z parku. |
| **Tag nierozpoznany** - To nie jest prawidłowy tag | Kontroler nie potrafi odczytać tego rodzaju tagu. | Użyj tagu, który dostałeś przez Tillor. |
| **Skanowanie nie powiodło się** - Tag nie został dobrze odczytany | Tag został zabrany zbyt szybko. | Przyłóż tag do ekranu jeszcze raz, nieco dłużej. |
| **Płatność odrzucona** - Brak dostępu | Ten tag nie może używać tego kontrolera. | Sprawdź w Tillor grupę dostępu tagu. |
| **Płatność odrzucona** - Tag nie jest powiązany | Tag nie jest jeszcze przypisany do klienta. | Powiąż tag w Tillor z klientem. |
| **Płatność odrzucona** - Niewystarczające saldo | Na tagu jest za mało środków. Saldo jest podane obok. | Doładuj tag w recepcji. |
| **Serwer niedostępny** | Nie udało się przetworzyć płatności. | Spróbuj później; zobacz [Problemy z połączeniem](/controllers/troubleshooting/verbinding). |
| **Aktualizacja tagu nie powiodła się** | Nie udało się zapisać salda na tagu. | Przyłóż tag do ekranu jeszcze raz i zostaw go, aż komunikat zniknie. |

<Callout type="info" title="Jedno skanowanie na przyłożenie">
Pozostawienie tagu na ekranie nic nie daje: każde przyłożenie liczy się jako jedno skanowanie. Chcesz zeskanować ponownie? Zabierz tag i przyłóż go znowu do ekranu.
</Callout>

## Uruchamianie i łączenie [#opstarten-en-verbinden]

| Na ekranie | Ramka | Znaczenie | Co robisz |
| ---------- | ----- | --------- | --------- |
| **Łączenie...** | Niebieska | Kontroler się uruchamia i szuka połączenia z internetem i z Tillor. | Poczekaj 1-2 minuty. |
| **Skonfiguruj Wi-Fi** - Wybierz sieć Wi-Fi na ekranie | Fioletowa | Kontroler nie ma jeszcze sieci. | Dotknij **Skonfiguruj Wi-Fi** i wybierz sieć; zobacz [Konfiguracja Wi-Fi na ekranie](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). |
| **Skonfiguruj Wi-Fi** - Dane Wi-Fi odrzucone | Fioletowa | Hasło jest (już) nieprawidłowe. | Wpisz hasło ponownie na ekranie. |
| **Aktywuj kontroler** - Aktywuj urządzenie … w Tillor | Fioletowa | Kontroler czeka na <Term term="adoptie">adopcję</Term>. | W Tillor przejdź do **Kontrolery** i kliknij **Zatwierdź** (✓). |
| **Rozłączono** - próba ponownego połączenia | Czerwona | Połączenie z internetem zniknęło. Kontroler sam próbuje ponownie. | Zobacz [Problemy z połączeniem](/controllers/troubleshooting/verbinding#verbinding-verbroken). |
| **Rozłączono** - Zbyt długo offline | Czerwona | Kontroler jest zbyt długo bez połączenia. Płatności są wyłączone, dopóki połączenie nie wróci. | Przywróć połączenie sieciowe. |

## Aktualizacje i restart [#updates-en-herstarten]

| Na ekranie | Ramka | Znaczenie |
| ---------- | ----- | --------- |
| **Aktualizacja** z wartością procentową | Bursztynowa | Aktualizacja <Term term="firmware">firmware</Term> jest pobierana i instalowana. Zostaw zasilanie włączone. |
| **Ponowne uruchamianie** | Żółta | Kontroler się restartuje, po aktualizacji lub dlatego, że w Tillor kliknąłeś **Uruchom ponownie kontroler**. |

## Awarie [#storingen]

| Na ekranie | Znaczenie | Co robisz |
| ---------- | --------- | --------- |
| **Czytnik tagów niedostępny** | Czytnik tagów nie startuje. Kontroler próbuje go sam naprawić. | Poczekaj minutę. Jeśli komunikat nie znika, [uruchom kontroler ponownie](/controllers/controller-beheren#een-controller-herstarten). |
| **Brak połączenia** - Łączenie z kontrolerem | Ekran nie dostaje sygnału od reszty kontrolera. | Uruchom kontroler ponownie. Jeśli nic się nie zmienia, skontaktuj się z supportem Tillor. |
| Ekran pozostaje czarny | Kontroler nie ma zasilania. | Sprawdź zasilacz i okablowanie. |

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Problemy z połączeniem" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, połączenie z Tillor i adopcja" />
  <Card title="Ustawienia kontrolera" href="/controllers/settings" description="ACL, sieć, aktualizacje i przekaźnik" />
</Cards>


# Problemy z połączeniem (/pl-PL/controllers/troubleshooting/verbinding)

Jeśli kontroler nie łączy się prawidłowo, jego <Term term="scherm">ekran</Term> pokazuje, na jakim etapie jest problem. Poniżej dla każdego komunikatu opisano, co się dzieje i co zrobić. Wszystkie komunikaty znajdziesz w [Komunikatach na ekranie](/controllers/troubleshooting/scherm).

## Konfiguracja Wi-Fi na ekranie [#wifi-instellen-op-het-scherm]

Jeśli na ekranie widnieje **Skonfiguruj Wi-Fi**, kontroler nie ma jeszcze sieci. Przy kablu sieciowym (Ethernet) nie musisz nic robić; w przypadku Wi-Fi konfigurujesz sieć na samym kontrolerze:

1. Dotknij **Skonfiguruj Wi-Fi**
2. Wybierz swoją sieć z listy. Przy każdej sieci widać siłę sygnału: zielony oznacza dobry, pomarańczowy średni, czerwony słaby
3. Wpisz hasło na klawiaturze ekranowej i potwierdź
4. Ekran pokaże **Połączono** - Wi-Fi jest skonfigurowane

Jeśli Twojej sieci nie ma na liście, dotknij opcji ponownego wyszukiwania. Chcesz później zmienić sieć? Przytrzymaj palec na ekranie, gdy kontroler jest gotowy, albo zmień ją w [ustawieniach](/controllers/settings#internetconfiguratie) w Tillor.

| Komunikat | Rozwiązanie |
| --------- | ----------- |
| **Połączenie nie powiodło się** - Sprawdź hasło | Wpisz hasło ponownie; zwróć uwagę na wielkie litery. |
| **Połączenie nie powiodło się** - Nie znaleziono sieci | Przenieś kontroler bliżej punktu dostępowego lub wybierz inną sieć. |
| **Połączenie nie powiodło się** - Wyszukiwanie sieci nie powiodło się | Dotknij ponownego wyszukiwania. Jeśli problem się powtarza, uruchom kontroler ponownie. |
| **Skonfiguruj Wi-Fi** - Dane Wi-Fi odrzucone | Zapisane hasło nie jest już prawidłowe. Wprowadź je ponownie na ekranie. |

## Aktywacja kontrolera [#controller-activeren]

**Znaczenie:** Kontroler czeka na <Term term="adoptie">adopcję</Term> - nie jest jeszcze połączony z Tillor. *Urządzenie jest gotowe, ale jeszcze nie wie, do której organizacji należy.* Na ekranie widnieje **Aktywuj kontroler** wraz z numerem urządzenia.

**Rozwiązanie:**
1. W Tillor przejdź do **Kontrolery**
2. Znajdź wiersz **Oczekuje na zatwierdzenie** z tym samym numerem (<Term term="eFuse ID">eFuse ID</Term>)
3. Kliknij **Zatwierdź** (✓), aby powiązać kontroler z Twoją organizacją

## Połączenie przerwane [#verbinding-verbroken]

**Znaczenie:** Połączenie z internetem zostało utracone. Kontroler automatycznie próbuje połączyć się ponownie. *Urządzenie straciło kontakt z Tillor i próbuje go odzyskać.*

Dopóki przerwa jest krótka, goście nadal mogą płacić swoim tagiem; kod QR jest wtedy szary i przekreślony. Jeśli widnieje **Zbyt długo offline**, płatności są wyłączone do czasu przywrócenia połączenia.

W Tillor kontroler jest oznaczany jako offline po około 35 sekundach bez kontaktu. Po 5 minutach zespół Tillor otrzymuje powiadomienie.

**Możliwe przyczyny:**
- **Utracono połączenie Wi-Fi** - sprawdź, czy sieć Wi-Fi jest dostępna
- **Awaria internetu** - kontroler nie może połączyć się z Tillor
- **Tillor jest tymczasowo niedostępny**

**Rozwiązanie:**
- Poczekaj kilka minut - kontroler sam próbuje połączyć się ponownie
- Sprawdź, czy inne urządzenia w tej samej sieci mają internet
- Sprawdź [ustawienia Wi-Fi](/controllers/settings) kontrolera (nazwa sieci, hasło)
- Upewnij się, że kontroler znajduje się w zasięgu punktu dostępowego Wi-Fi, albo użyj kabla sieciowego

## Ekran zatrzymuje się na Łączenie... [#scherm-blijft-op-verbinden]

**Znaczenie:** Kontroler jeszcze się uruchamia lub łączy. Pod tytułem widać etap, na którym się znajduje, na przykład *Nawiązywanie połączenia z internetem* lub *Sprawdzanie aktualizacji*.

**Rozwiązanie:**
- Poczekaj 1-2 minuty - uruchamianie chwilę trwa
- Jeśli kontroler zatrzymuje się na *Nawiązywanie połączenia z internetem*: sprawdź kabel sieciowy lub [skonfiguruj Wi-Fi ponownie](#wifi-instellen-op-het-scherm)
- Sprawdź, czy sygnał Wi-Fi jest wystarczająco silny

## Kontroler nie pojawia się w Tillor [#controller-verschijnt-niet-in-tillor]

**Znaczenie:** Kontroler nie jest jeszcze widoczny do adopcji.

**Możliwe przyczyny:**
- Kontroler nie ma połączenia z internetem (nie może połączyć się z Tillor)
- Kontroler jeszcze się uruchamia
- Otwierasz Tillor z innej sieci niż ta, do której podłączony jest kontroler - wnioski o adopcję bywają wtedy niewidoczne

**Rozwiązanie:**
1. Sprawdź, czy kontroler ma zasilanie i czy ekran jest włączony
2. Zobacz, co pokazuje ekran: przy **Skonfiguruj Wi-Fi** lub **Łączenie...** kontroler nie jest jeszcze online
3. Poczekaj, aż ekran pokaże **Aktywuj kontroler** i na liście pojawi się wiersz **Oczekuje na zatwierdzenie** - może to chwilę potrwać
4. Otwórz Tillor z tej samej sieci co kontroler lub skontaktuj się z pomocą techniczną
5. Odśwież stronę Kontrolery w Tillor (nowe wnioski pojawiają się też automatycznie)

## Adopcja nie powiodła się lub dane uwierzytelniające są odrzucane [#adoptie-mislukt-of-credentials-worden-geweigerd]

<Term term="adoptie">Adopcja</Term> to powiązanie kontrolera z Twoją organizacją; <Term term="credentials">dane uwierzytelniające</Term> to dane połączenia, które się z tym wiążą.

**Znaczenie:** Powiązanie z Tillor się nie udało. *Nie udało się powiązać urządzenia z Twoją organizacją.*

**Rozwiązanie:**
- Sprawdź, czy zegar kontrolera jest ustawiony prawidłowo (duża różnica czasu może zablokować powiązanie)
- Po wgraniu firmware lub nowym kluczu kontroler musi zostać zatwierdzony ponownie
- Spróbuj adopcji jeszcze raz przez **Zatwierdź** (✓)
- Jeśli problem się utrzymuje, skontaktuj się z pomocą techniczną - ma ona dostęp do logów

## Aktualizacja OTA zawiesza się lub kończy błędem [#ota-update-blijft-hangen-of-faalt]

Aktualizacja <Term term="OTA">OTA</Term> to aktualizacja <Term term="firmware">firmware</Term> przez internet. Podczas aktualizacji ekran pokazuje **Aktualizacja** z wartością procentową.

**Znaczenie:** Aktualizacja firmware nie została ukończona. *Urządzenie próbowało zainstalować nowe oprogramowanie, ale się nie udało.*

**Rozwiązanie:**
- Poczekaj, aż [<Term term="updatevenster">okno aktualizacji</Term>](/controllers/updates) będzie aktywne - aktualizacje odbywają się tylko w tym oknie
- Sprawdź, czy kontroler ma stabilne połączenie z internetem
- Tymczasowo włącz [Pomiń aktualizacje OTA](/controllers/updates#ota-updates-overslaan), jeśli chcesz najpierw ustabilizować kontroler

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Komunikaty na ekranie" href="/controllers/troubleshooting/scherm" description="Co oznacza komunikat na ekranie?" />
  <Card title="Ustawienia kontrolera" href="/controllers/settings" description="Konfiguracja Wi-Fi i sieci" />
</Cards>


# Aktualizacje firmware (/pl-PL/controllers/updates)

Kontroler sam pobiera nowe oprogramowanie przez internet, tak jak Twój telefon. To oprogramowanie nazywa się <Term term="firmware">firmware</Term>. Ty decydujesz, **kiedy** i **jak często** może to robić. Domyślnie sprawdza codziennie, czy jest coś nowego. Chcesz od razu rozpocząć aktualizację? Zrobisz to ze strony kontrolera, zobacz [Zarządzanie kontrolerem](/controllers/controller-beheren#bijwerken-naar-een-nieuwe-versie).

## Częstotliwość aktualizacji [#updatefrequentie]

Kontroler okresowo sprawdza, czy dostępna jest nowa wersja firmware:

| Opcja | Znaczenie |
| ----- | --------- |
| **Co godzinę** | Sprawdza aktualizacje co godzinę. |
| **Codziennie** | Sprawdza raz dziennie (domyślnie). |
| **Co tydzień** | Sprawdza raz w tygodniu. |

Po sprawdzeniu aktualizacja jest wykonywana tylko wtedy, gdy jest nowsza wersja. Jeśli ustawisz okno aktualizacji, bieżąca godzina musi też mieścić się w tym oknie. *Czyli: urządzenie sprawdza, czy jest coś nowego, ale instaluje to tylko w godzinach, które ustawisz.*

## Okno aktualizacji [#updatevenster]

Okno aktualizacji to przedział czasu, w którym kontroler może się aktualizować. Jeśli wypełnisz **Okres aktualizacji od** i **Okres aktualizacji do**, aktualizacje są wykonywane tylko w tych godzinach. *Mówiąc prosto: sam wybierasz, kiedy urządzenie może się aktualizować - na przykład tylko w nocy.*

**Przykład:** Jeśli ustawisz **Okres aktualizacji od** na 02:00 i **Okres aktualizacji do** na 04:00, aktualizacja odbywa się tylko między 02:00 a 04:00. Dzięki temu kontroler nie uruchomi się ponownie w środku dnia w godzinach największego ruchu.

### Konfiguracja [#instellen]

1. Przejdź do <UIPath>Kontrolery > Przegląd > [nazwa kontrolera]</UIPath>
2. Przewiń do **Konfiguracja aktualizacji**
3. Wybierz **Częstotliwość aktualizacji** (Co godzinę, Codziennie lub Co tydzień)
4. Wypełnij **Okres aktualizacji od** (np. 02:00)
5. Wypełnij **Okres aktualizacji do** (np. 04:00)
6. Kliknij **Zapisz**

## Pomijanie aktualizacji OTA [#ota-updates-overslaan]

<Term term="OTA">OTA</Term> oznacza Over-The-Air: aktualizacje przez internet. Jeśli ustawisz **Pomiń aktualizacje OTA** na **Tak**, kontroler nie instaluje już nowego firmware. Kontroler pozostaje na bieżącej wersji. *Innymi słowy: urządzenie nie aktualizuje się już samo przez OTA.*

**Kiedy z tego korzystać?**

- Tymczasowo, gdy nie chcesz żadnych zmian w czasie dużego ruchu
- Dla kontrolerów testowych lub demonstracyjnych, które mają pozostać na stałej wersji

<Callout type="info" title="Zalecenie">
Zostaw **Pomiń aktualizacje OTA** domyślnie na **Nie**. Aktualizacje często zawierają ulepszenia i poprawki bezpieczeństwa.
</Callout>

## Co się dzieje podczas aktualizacji? [#wat-gebeurt-er-tijdens-een-update]

1. Kontroler wykrywa nową wersję <Term term="firmware">firmware</Term>
2. Firmware jest pobierany
3. Ekran pokazuje **Aktualizacja** z wartością procentową - kontroler jest aktualizowany
4. Kontroler uruchamia się ponownie automatycznie; ekran pokazuje **Ponowne uruchamianie**
5. Po ponownym uruchomieniu aktywna jest nowa wersja

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Aktualizacja rozpoczyna się tylko wtedy, gdy jest nowsza wersja, a godzina mieści się w Twoim oknie aktualizacji.
- Podczas aktualizowania i ponownego uruchamiania ekran pokazuje **Aktualizacja** i **Ponowne uruchamianie**. Dlatego zaplanuj okno na noc.
- Jeśli ustawisz **Pomiń aktualizacje OTA** na **Tak**, kontroler pozostaje na bieżącej wersji, dopóki tego nie cofniesz.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Kontroler się nie aktualizuje">
Sprawdź, czy **Pomiń aktualizacje OTA** jest ustawione na **Nie** i czy godzina mieści się w Twoim oknie aktualizacji. Sprawdź też połączenie kontrolera z internetem. Więcej znajdziesz w [Aktualizacja OTA zawiesza się lub kończy błędem](/controllers/troubleshooting/verbinding#ota-update-blijft-hangen-of-faalt).
</Accordion>
<Accordion title="Ekran zatrzymuje się na Aktualizacja">
Zostaw zasilanie włączone i poczekaj kilka minut. Jeśli nic się nie zmienia, uruchom kontroler ponownie i skontaktuj się z pomocą techniczną.
</Accordion>
<Accordion title="Tillor pokazuje: Aktualizacja OTA nie powiodła się">
Nie udało się rozpocząć aktualizacji. Sprawdź, czy kontroler jest online, i spróbuj ponownie.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Ustawienia kontrolera" href="/controllers/settings" description="Przegląd wszystkich ustawień" />
  <Card title="Komunikaty na ekranie" href="/controllers/troubleshooting/scherm" description="Aktualizacja i Ponowne uruchamianie" />
</Cards>


# Konfiguracja sieci Wi-Fi (/pl-PL/controllers/wifi-netwerken)

Kontroler może znać kilka sieci Wi-Fi i sam przełącza się na najlepszą. To przydatne, gdy Twój park ma własny punkt dostępowy w kilku miejscach. Ustawiasz je na stronie kontrolera. Jeśli kontroler nie ma jeszcze żadnej sieci, lepiej skonfigurować Wi-Fi na samym ekranie, zobacz [Konfiguracja Wi-Fi na ekranie](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).

Zanim zaczniesz:

- Kontroler jest zatwierdzony, zobacz [Powiązanie kontrolera](/controllers/controller-koppelen).
- Dla każdej sieci znasz nazwę (SSID) i hasło. Sieć otwarta nie ma hasła.

## Dodawanie sieci [#netwerken-toevoegen]

<Steps>
<Step>
### Otwórz kontroler [#open-de-controller]
Przejdź do <UIPath>Kontrolery > Przegląd</UIPath> i kliknij kontroler. Przewiń do **Sieci Wi-Fi**.
</Step>
<Step>
### Dodaj sieć [#voeg-een-netwerk-toe]
Kliknij **Dodaj sieć** i wypełnij **Nazwa sieci (SSID)** oraz **Hasło**. Dla sieci otwartej zostaw hasło puste. Powtórz to dla każdej sieci.
</Step>
<Step>
### Ustaw kolejność [#zet-ze-in-volgorde]
Przeciągnij wiersz za uchwyt po lewej stronie. Kolejność to priorytet: kontroler próbuje sieci, które ma w zasięgu, od góry do dołu.

<DocScreenshot src="/screenshots/controllers/controller-wifi-networks.png" alt="Sieci Wi-Fi z dwiema sieciami ułożonymi według priorytetu" />
</Step>
<Step>
### Kliknij Zapisz [#klik-op-opslaan]
Przycisk **Zapisz** znajduje się na dole formularza. Tillor przesyła następnie listę do kontrolera.
</Step>
</Steps>

Sieć usuwasz przyciskiem minus (**Usuń sieć**).

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Kontroler sprawdza każdą sieć osobno. Jeśli pierwsza sieć zniknie lub hasło się nie zgadza, używa następnej.
- Na stronie szczegółów pod **Znane sieci Wi-Fi, według priorytetu** widać, jak radzi sobie każda sieć:

| Status | Znaczenie |
|---|---|
| <Status tone="success">Połączono</Status> | Kontroler używa teraz tej sieci. |
| <Status>Zweryfikowana</Status> | Sieć działa, ale kontroler używa teraz innej sieci. |
| <Status tone="info">Jeszcze niezweryfikowana</Status> | Kontroler nie mógł jeszcze przetestować tej sieci. |
| <Status tone="warning">Niepowodzenie</Status> | Sieć nie działa. Przy niej podany jest powód, na przykład błędne hasło, nie znaleziono sieci lub brak dostępu do internetu. |

- Przy każdej sieci widać, czy jest **w zasięgu** czy **poza zasięgiem**, czasem z siłą sygnału w dBm. Sieci wprowadzone na ekranie mają oznaczenie **dodana na wyświetlaczu**.
- Jeśli lista jest pusta, w Tillor nie ustawiono żadnych sieci. Sieci dodane przez kogoś na ekranie pozostają zapisane na kontrolerze.
- Starsze kontrolery, które znają tylko jedną sieć, pokazują zamiast tego jeden komunikat o ostatniej zmianie, na przykład **Zmiana Wi-Fi nie została jeszcze potwierdzona** lub **Dane Wi-Fi odrzucone**. Kontroler pozostaje wtedy połączony z poprzednią siecią.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Dodaj sieć jest wyszarzone">
Kontroler zapamiętuje maksymalnie 8 sieci. Tillor informuje o tym komunikatem **Kontroler zapamiętuje do 8 sieci.** Najpierw usuń sieć, której już nie potrzebujesz.
</Accordion>
<Accordion title="Tillor pokazuje: Wpisz nazwę sieci">
Jeden wiersz nie ma nazwy sieci. Wpisz nazwę lub usuń wiersz.
</Accordion>
<Accordion title="Tillor pokazuje: Ta sieć jest już na liście">
Każda nazwa sieci może wystąpić tylko raz. Usuń zduplikowany wiersz.
</Accordion>
<Accordion title="Sieć ma status Niepowodzenie">
Przeczytaj powód przy sieci. Sprawdź nazwę i hasło. Kontroler sam próbuje ponownie, a pozostałe sieci nadal działają.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Problemy z połączeniem" href="/controllers/troubleshooting/verbinding" description="Wi-Fi i połączenie z Tillor" />
  <Card title="Ustawienia kontrolera" href="/controllers/settings" description="Preferencje sieci i inne ustawienia" />
</Cards>


# Podręcznik Tillor (/pl-PL)

<HomeHero title="Jak to zrobić w Tillor?">
  Wyjaśnienia według zadań dla recepcji, administracji i działu technicznego. Wyszukaj to, co chcesz zrobić, albo zacznij od swojej roli.
</HomeHero>

<HomeSection title="Nad czym pracujesz?" description="Zadania, które pojawiają się najczęściej, według roli.">

<RoleCard title="Recepcja" description="Przyjmowanie gości, meldowanie i odpowiadanie na pytania." href="/reserveringen" icon={<ConciergeBellIcon />}>

- [Wyszukiwanie lub tworzenie klienta](/klantenbeheer)
- [Tworzenie rezerwacji](/reserveringen)
- [Meldowanie gościa z użyciem pobytu](/bezettingen#een-bezetting-aanmaken)
- [Odpowiadanie na wiadomości w skrzynce](/inbox)

</RoleCard>

<RoleCard title="Administracja" description="Faktury, płatności i połączenie z Twoją księgowością." href="/facturen" icon={<LandmarkIcon />}>

- [Tworzenie i księgowanie faktury](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken)
- [Rejestrowanie płatności](/facturen/betalingen-registreren)
- [Przedłużanie pobytu przez fakturę](/bezettingen#facturatie-bezetting-verlengen)
- [Raporty płatności do Twojej księgowości](/boekhouden/betalingsrapporten)

</RoleCard>

<RoleCard title="Dział techniczny" description="Szlabany, liczniki, kontrolery i tablety na terenie." href="/controllers" icon={<CpuIcon />}>

- [Otwieranie lub zamykanie punktu dostępu](/toegangscontrole#toegangspunten-bedienen)
- [Powiązanie licznika z terenem](/meterbeheer/meter-koppelen)
- [Co oznacza komunikat na ekranie?](/controllers/troubleshooting/scherm)
- [Konfiguracja kiosku](/mobiele-app/kiosk-inrichten)

</RoleCard>

<RoleCard title="Programiści" description="Połącz Tillor z własnymi systemami lub stroną internetową." href="/ontwikkelaars" icon={<BracesIcon />}>

- [Tworzenie klucza API](/ontwikkelaars/http)
- [Odbieranie webhooków](/ontwikkelaars/webhooks)
- [Zdarzenia w czasie rzeczywistym przez SSE](/ontwikkelaars/sse)
- [Łączenie narzędzi AI przez MCP](/ontwikkelaars/mcp)

</RoleCard>

</HomeSection>

<HomeSection title="Dalej">

<HomeLink title="Nowy w Tillor?" description="Logowanie, odnajdywanie się w systemie i konfiguracja parku." href="/aan-de-slag" icon={<RocketIcon />} />

<HomeLink title="W praktyce" description="Cztery rozbudowane przykłady łączące kilka modułów." href="/praktijk" icon={<RouteIcon />} />

<HomeLink title="Pojęcia" description="Krótkie wyjaśnienia słów, które spotkasz w Tillor." href="/begrippen" icon={<RocketIcon />} />

<HomeLink title="Co nowego" description="Ostatnie zmiany w Tillor, miesiąc po miesiącu." href="/wat-is-nieuw" icon={<SparklesIcon />} />

<HomeLink title="Tablety i kioski" description="Aplikacja Tillor na tabletach w recepcji lub na zewnątrz." href="/mobiele-app" icon={<TabletSmartphoneIcon />} />

<HomeLink title="Status systemu" description="Czy wszystko działa? Sprawdź awarie i prace konserwacyjne." href="https://status.tillor.eu" icon={<ActivityIcon />} />

</HomeSection>


# Wysyłanie polecenia do tabletu (/pl-PL/mobiele-app/acties-op-afstand)

Po prawej stronie strony urządzenia, niezależnie od otwartej zakładki, znajduje się panel **Zdalne działania**. Tam wysyłasz polecenie do urządzenia i pobierasz zrzut ekranu. To, co urządzenie zgłasza samo, przeczytasz w [Diagnostyce i historii](/mobiele-app/diagnose-en-geschiedenis).

<Requires permission="Edycja ustawień" />

Zanim zaczniesz:

- Urządzenie musi być połączone. Polecenie przechodzi przez aktywne połączenie z aplikacją. Jeśli urządzenie jest offline, panel pokazuje **Urządzenie jest offline: polecenia dotrą dopiero po ponownym połączeniu.** Tillor mówi wtedy, że polecenie zostało wysłane, ale tablet go nie widzi.
- **Uruchom ponownie urządzenie** działa tylko wtedy, gdy Tillor jest właścicielem tabletu. Zobacz [Konfiguracja kiosku](/mobiele-app/kiosk-inrichten).

## Wysyłanie polecenia [#een-opdracht-versturen]

<Steps>
<Step>
### Otwórz urządzenie [#open-het-toestel]
Przejdź do <UIPath>Ustawienia > Tablety i kioski</UIPath> i kliknij wiersz urządzenia.
</Step>
<Step>
### Wybierz polecenie [#kies-de-opdracht]
W panelu **Zdalne działania** kliknij polecenie. Zobaczysz komunikat **Wysłano do urządzenia** albo **Nie udało się połączyć z urządzeniem**, jeśli nie dało się go wysłać.

<DocScreenshot src="/screenshots/tablets/remote-actions.png" alt="Zdalne działania i blok Zrzut ekranu" />
</Step>
</Steps>

Polecenia:

- **Pokaż nazwę na ekranie** wyświetla nazwę urządzenia dużą czcionką na krótko. Przydatne, gdy obok siebie stoją dwa tablety i chcesz wiedzieć, który masz otwarty.
- **Odtwórz dźwięk testowy** odtwarza dźwięk powiadomienia, z głośnością ustawioną w zakładce **Paragony i dźwięk**.
- **Wybudź ekran** wybudza urządzenie z trybu nocnego lub z **Uśpij ekran**.
- **Uśpij ekran** wygasza ekran, także poza porą nocną.
- **Uśpij na 30 sekund** robi to samo, a potem sam się budzi. Dzięki temu sprawdzisz, czy ekran znów się włącza, bez czekania do rana.
- **Uruchom ponownie urządzenie** uruchamia tablet od nowa. Na tablecie, którego Tillor nie jest właścicielem, przycisk pozostaje szary.
- **Zainstaluj aktualizację** instaluje gotową aktualizację aplikacji.
- **Uruchom aplikację ponownie** uruchamia tylko aplikację Tillor, nie tablet.

## Pobieranie zrzutu ekranu [#een-schermafbeelding-opvragen]

<Steps>
<Step>
### Kliknij Pobierz zrzut ekranu [#klik-op-schermafbeelding-opvragen]
W bloku **Zrzut ekranu** wysyła to prośbę do tabletu.
</Step>
<Step>
### Poczekaj na obraz [#wacht-op-het-beeld]
Tillor czeka chwilę i odświeża obraz, gdy tylko tablet go prześle. Pod zdjęciem widać, kiedy zostało zrobione.
</Step>
</Steps>

Obraz pokazuje to, co aplikacja wyświetla w danym momencie: ekran startowy, pokaz slajdów, paragon lub ekran uśpienia. To nie jest wideo na żywo.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tablet wykonuje polecenie od razu. Każde polecenie poza usypiającymi wybudza też ekran.
- Każde polecenie trafia do [historii urządzenia](/mobiele-app/diagnose-en-geschiedenis#geschiedenis).
- Zrzut ekranu pozostaje w panelu, dopóki nie pobierzesz nowego.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Tillor pokazuje Nie udało się połączyć z urządzeniem">
Polecenie nie dotarło do urządzenia. Zwykle jest ono offline. Poczekaj, aż status znów będzie **Połączono**, i wyślij polecenie ponownie.
</Accordion>
<Accordion title="Przycisk Uruchom ponownie urządzenie jest szary">
Tillor nie jest właścicielem tabletu. Najpierw skonfiguruj go zgodnie z opisem w [Konfiguracji kiosku](/mobiele-app/kiosk-inrichten). Do tego czasu możesz używać tylko **Uruchom aplikację ponownie**.
</Accordion>
<Accordion title="Zrzut ekranu nie przychodzi">
Urządzenie jest offline lub aplikacja jest zbyt stara. W tym drugim przypadku Tillor informuje o tym z góry: **Aplikacja na tym urządzeniu jest zbyt stara, aby robić zrzuty ekranu.** Zainstaluj nowszą wersję. Dopóki nigdy nie pobrano obrazu, widać **Nie zażądano jeszcze zrzutu ekranu.**
</Accordion>
<Accordion title="Ekran pozostaje czarny po Wybudź ekran">
Zdalne wybudzanie działa tylko wtedy, gdy aplikacja jest też w wyjątku dotyczącym baterii. Zobacz [Bateria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Diagnostyka i historia" href="/mobiele-app/diagnose-en-geschiedenis" description="Co urządzenie zgłasza samo" />
  <Card title="Zarządzanie tabletem lub kioskiem" href="/mobiele-app/tablets-en-kiosken" description="Wysyłanie ustawień" />
</Cards>


# Diagnostyka i historia (/pl-PL/mobiele-app/diagnose-en-geschiedenis)

Pod panelem **Zdalne działania** znajdują się dwa bloki, które pomagają sprawdzić tablet: **Diagnostyka** (co urządzenie zgłosiło ostatnio) i **Historia** (dziennik). Polecenie wyślesz w tym samym panelu, zobacz [Wysyłanie polecenia do tabletu](/mobiele-app/acties-op-afstand).

<DocScreenshot src="/screenshots/tablets/diagnostics.png" alt="Diagnostyka i historia na stronie urządzenia" />

## Diagnostyka [#diagnose]

**Diagnostyka** to ostatni komunikat urządzenia, a nie pomiar na żywo. Myślnik oznacza, że aplikacja nie przesłała tej informacji.

| Dane | Znaczenie |
|---|---|
| **Ostatnio widziane** | Kiedy urządzenie ostatnio miało kontakt |
| **Połączenie** | Wi-Fi lub sieć komórkowa |
| **Ekran** | **Włączony** lub **Uśpiony** |
| **Wolne miejsce** | Wolne miejsce na tablecie, w GB |
| **Język urządzenia** i **Strefa czasowa** | Język i strefa czasowa systemu Android lub iOS. To nie jest język aplikacji wybrany w zakładce **Urządzenie** |
| **Kompilacja**, **Wersja środowiska uruchomieniowego** | Jaka wersja aplikacji jest na tablecie |
| **Ostatnia aktualizacja aplikacji** i **Ostatnie sprawdzenie aktualizacji** | Kiedy aplikacja była ostatnio aktualizowana lub sprawdzana |
| **Błąd aktualizacji** | Pojawia się, gdy ostatnie sprawdzenie lub instalacja się nie powiodły |
| **Zarejestrowano** | Kiedy to urządzenie po raz pierwszy trafiło na listę |

## Historia [#geschiedenis]

**Historia** pokazuje dla każdego urządzenia:

- kiedy urządzenie się zalogowało
- kiedy Ty wysłałeś ustawienia lub polecenie
- kiedy aplikacja została zaktualizowana
- kiedy urządzenie przeszło w tryb offline i kiedy wróciło online

Dziennik odświeża się sam. **Brak zdarzeń.** oznacza, że nic jeszcze nie zostało zapisane.

## Powiadomienia [#meldingen]

Powiadomienie o braku połączenia lub o baterii pojawia się tylko wtedy, gdy **Powiadomienia** w zakładce **Urządzenie** są włączone, i nie w porze nocnej.

- Powiadomienie o braku połączenia: urządzenie nie zgłaszało się przez 10 minut.
- Powiadomienie o baterii: poniżej 15% bez ładowarki. Tillor nie wysyła go ponownie, dopóki urządzenie nie zostanie podłączone do ładowarki lub wyraźnie się nie doładuje.

Powiadomienie trafia do osób, które zarządzają ustawieniami. Zobacz [Powiadomienia](/notificaties).

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Wysyłanie polecenia do tabletu" href="/mobiele-app/acties-op-afstand" description="Wybudzanie, ponowne uruchamianie i zrzut ekranu" />
  <Card title="Ustawienia urządzenia" href="/mobiele-app/toestelinstellingen" description="Zakładka Urządzenie z Powiadomieniami" />
</Cards>


# Przegląd (/pl-PL/mobiele-app)

Aplikacja Tillor działa na tablecie, kiosku lub telefonie w Twoim parku, na **iOS** i **Androidzie**. Goście i współpracownicy widzą w niej ekran startowy, paragony i prośby o podpis. Z Tillor w przeglądarce wysyłasz do tych urządzeń ustawienia i polecenia. Tablet, który ma pozostać kioskiem, konfigurujesz w [Konfiguracji kiosku](/mobiele-app/kiosk-inrichten).

<Callout type="warn" title="To nie pełna aplikacja webowa">
Aplikacja nie zastępuje Tillor w przeglądarce. Zarządzanie rezerwacjami, tworzenie faktur czy rejestrowanie płatności robisz w przeglądarce.
</Callout>

## Jak to się łączy? [#hoe-hangt-dit-samen]

Urządzenie pojawia się w Tillor samo, gdy ktoś otworzy aplikację i się zaloguje. To, co potem ustawisz w Tillor, trafia do urządzenia przez aktywne połączenie. W drugą stronę urządzenie regularnie zgłasza się do Tillor, dzięki czemu widzisz, czy nadal jest połączone.

```mermaid
flowchart LR
  A[Ktoś otwiera aplikację<br/>i się loguje] --> B[Urządzenie jest w<br/>Ustawienia > Tablety i kioski]
  B --> C[Wybierasz ustawienia<br/>i klikasz Zapisz i wyślij]
  C --> D[Tablet je stosuje]
  E[Wysyłasz paragon,<br/>PDF lub prośbę o podpis] --> D
  D --> F[Urządzenie zgłasza baterię,<br/>połączenie i wersję]
  F --> B
```

Jeśli urządzenie jest offline, ustawienia i polecenia dotrą dopiero po ponownym połączeniu. Zobacz [Tablety i kioski](/mobiele-app/tablets-en-kiosken).

<Callout type="info" title="Warto wiedzieć">
- Nowe urządzenie pojawia się na liście w ciągu minuty od zalogowania.
- Tillor oznacza urządzenie jako offline po 10 minutach bez komunikatu. Dzieje się tak tylko, gdy **Powiadomienia** są włączone, i nie w porze nocnej.
- Powiadomienie o baterii pojawia się poniżej 15% bez ładowarki.
- Pokaz slajdów ma maksymalnie 20 zdjęć. Na ekranie startowym możesz ustawić sześć dodatkowych przycisków.
- Nie ma osobnego hasła do aplikacji. Logujesz się tak jak w przeglądarce, przez Microsoft, Google lub Apple.
</Callout>

## Instalacja aplikacji i logowanie [#de-app-installeren-en-inloggen]

Twoja organizacja udostępnia plik instalacyjny lub link (wersja wewnętrzna, TestFlight lub sklep z aplikacjami, zależnie od sposobu wdrożenia). Nie masz jeszcze dostępu? Zapytaj administratora lub pomoc techniczną Tillor.

1. Otwórz aplikację po instalacji.
2. Zaloguj się przez **Microsoft**, **Google** lub **Apple**. To to samo konto co w przeglądarce, zobacz [Logowanie](/inloggen).
3. Wybierz swoją organizację, jeśli masz ich więcej niż jedną.

## Co potrafi aplikacja [#wat-de-app-kan]

- **Wyświetlanie plików PDF i obrazów**: od razu na ekranie startowym, gdy Tillor wyśle dokument na urządzenie.
- **Skanowanie kart prepaid**: odczyt karty NFC i podgląd danych karty oraz klienta.
- **Sygnał dźwiękowy płatności**: dźwięk przy opłaconej fakturze.
- **Kiosk**: pozostawienie ekranu włączonego, regulacja jasności i wyświetlanie logo Twojej organizacji.

## Co Tillor widzi na urządzeniu [#wat-tillor-van-het-toestel-ziet]

Aplikacja regularnie wysyła do Tillor nazwę, model, system operacyjny, wersję aplikacji, stan baterii i połączenie sieciowe (Wi-Fi lub sieć komórkowa). Widzisz to na liście urządzeń i na stronie urządzenia. Pod **Konto** > **Aktywne sesje** znajdziesz te same urządzenia jako sesje aplikacji, z **Metadane aplikacji**. Tam też zakończysz sesję.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Aplikacja nie łączy się">
Sprawdź Wi-Fi lub sieć komórkową oraz to, czy jesteś zalogowany do właściwej organizacji. Zaktualizuj aplikację do najnowszej wersji. Jeśli to nie pomaga, wyloguj się i zaloguj ponownie. Jeśli problem nie znika, skontaktuj się z administratorem.
</Accordion>
<Accordion title="Urządzenia nie ma na liście">
Otwórz aplikację, zaloguj się i wybierz właściwą organizację. Urządzenie pojawi się w ciągu minuty w **Ustawienia** > **Tablety i kioski**. Jeśli widzisz tam **Brak urządzeń**, żadne urządzenie jeszcze się nie zalogowało.
</Accordion>
</Accordions>

## Pojęcia [#begrippen]

- **Tablet**: tablet z aplikacją Tillor, na przykład w recepcji.
- **Kiosk**: tablet zablokowany na aplikacji Tillor, tak aby goście nie mogli z niej wyjść.
- **Urządzenie**: każda instalacja aplikacji widoczna w Tillor, niezależnie od rodzaju.
- **Nocny odpoczynek**: godziny, w których ekran jest wyłączony lub czarny.
- **Blokada ekranu**: wzór lub kod PIN na samym tablecie, co innego niż blokada kiosku.

Więcej wyjaśnień znajdziesz w [liście pojęć](/begrippen).

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Tablety i kioski" href="/mobiele-app/tablets-en-kiosken" description="Urządzenia na liście, zapisywanie i wysyłanie ustawień" />
  <Card title="Konfiguracja kiosku" href="/mobiele-app/kiosk-inrichten" description="Blokowanie tabletu z Androidem" />
  <Card title="Ustawienia urządzenia" href="/mobiele-app/toestelinstellingen" description="Wszystkie ustawienia według zakładek" />
  <Card title="Zdalne działania" href="/mobiele-app/acties-op-afstand" description="Wybudzanie, ponowne uruchamianie i zrzut ekranu" />
  <Card title="Logowanie" href="/inloggen" description="Dostęp do konta przez Microsoft, Google lub Apple" />
  <Card title="Kontrolery" href="/controllers" description="Sprzęt w Twoim parku" />
</Cards>


# Konfiguracja kiosku (/pl-PL/mobiele-app/kiosk-inrichten)

Dzięki kioskowi zablokujesz tablet z Androidem na aplikacji Tillor. Goście widzą ekran startowy, pokaz slajdów lub paragon i nie wchodzą do ustawień Androida. Po awarii zasilania tablet znów uruchamia się w Tillor. Ta strona opisuje jednorazową konfigurację. Przełączniki, które ustawiasz potem, opisano w [Ustawieniach urządzenia](/mobiele-app/toestelinstellingen#kiosk).

Bez poniższych kroków możesz włączyć **Zablokuj aplikację**, ale wtedy Android używa tylko przypinania ekranu. Wymaga to potwierdzenia na tablecie, a gość może je opuścić. Status w zakładce **Kiosk** pokazuje wtedy **Przypinanie ekranu. Ten tablet nie jest skonfigurowanym kioskiem.**

Pełna blokada obowiązuje dopiero wtedy, gdy Tillor jest właścicielem urządzenia. W zakładce **Kiosk** przeczytasz to jako **Skonfigurowany kiosk: blokada jest pełna.**

<Callout type="warn">
To działa na Androidzie. Na iOS możesz używać aplikacji jako kiosku do paragonów i ekranu startowego, ale nie możesz ustawić jej jako właściciela urządzenia. Przyciski w **Zarządzanie Androidem** pozostają wtedy zablokowane, z komunikatem **Dostępne, gdy ten tablet jest skonfigurowany jako kiosk.**
</Callout>

## Zanim zaczniesz [#voor-je-begint]

Potrzebujesz komputera z programem `adb`. To bezpłatny program Google, którym obsługujesz tablet z Androidem przez kabel USB. To jednorazowa czynność dla każdego tabletu, przeznaczona dla osób z odrobiną wiedzy technicznej. Jeśli się nie uda, zapytaj pomoc techniczną Tillor.

Zanim zaczniesz:

- Przywróć tablet do ustawień fabrycznych albo użyj tabletu, na którym nie ma jeszcze dodatkowego konta Google. Android odmawia ustawienia aplikacji jako właściciela, gdy na urządzeniu jest już jakieś konto.
- Aplikacja Tillor musi być zainstalowana i zalogowana do Twojej organizacji.
- W ustawieniach Androida włącz **Debugowanie USB** (Opcje programisty).
- Połącz tablet kablem z komputerem. `adb devices` musi pokazać tablet jako `device`, a nie jako `unauthorized`.

## Tillor jako właściciel tabletu [#tillor-als-eigenaar-van-de-tablet]

Właściciel urządzenia z Androidem może to, czego zwykła aplikacja nie może, na przykład naprawdę zablokować tablet. Nadaj Tillor tę rolę następującym poleceniem na komputerze:

```bash
adb shell dpm set-device-owner eu.tillor.app/expo.modules.tillorkiosk.KioskAdminReceiver
```

Jeśli polecenie się powiedzie, Android odpowie, że właściciel został ustawiony. Jeśli zakończy się komunikatem o kontach, usuń konta lub zacznij od nowa od resetu fabrycznego. To polecenie możesz wykonać tylko raz. Inny właściciel wymaga ponownego resetu.

Następnie w Tillor otwórz **Ustawienia** > **Tablety i kioski**, ustaw rodzaj na **Kiosk** i zapisz. W zakładce **Kiosk** kafelek **Urządzenie kiosk** powinien być teraz zielony. Pozostałe dwa kafelki zmienią się, gdy wyślesz **Aplikacja jako ekran główny** i **Usuń blokadę ekranu**. Wyjaśnienie tych kafelków znajdziesz w [Kiosk](/mobiele-app/toestelinstellingen#kiosk).

## Bateria: nie pozwól aplikacji zasnąć [#batterij-de-app-niet-laten-inslapen]

Android, a zwłaszcza Xiaomi z HyperOS, przerywa połączenie aplikacji, która według systemu "śpi". Kiosk przechodzi wtedy w tryb offline w środku nocy, nawet jeśli ekran powinien być wyłączony przez nocny odpoczynek.

Jeśli Tillor jest właścicielem, aplikacja sama prosi o wyłączenie optymalizacji baterii. Na większości tabletów to okno, w którym dotykasz **Zezwól**. Na Xiaomi HyperOS otwiera zamiast tego stronę baterii Tillor: wybierz tam **Bez ograniczeń**. Jeśli to pominiesz, aplikacja zapyta ponownie po następnym restarcie, a połączenie w nocy pozostanie zawodne.

Żadna aplikacja nie może sama ustawić tego wyjątku, nawet jako właściciel urządzenia. Zostaje więc jedno dotknięcie na tablet albo polecenie poniżej.

Jeśli to okno się nie pojawi, ustaw wyjątek podczas konfiguracji z komputera:

```bash
adb shell dumpsys deviceidle whitelist +eu.tillor.app
```

Potem aplikacja powinna w tle nadal komunikować się z Tillor, także gdy ekran jest wyłączony.

## Usuwanie blokady ekranu [#schermvergrendeling-weghalen]

Wzór lub kod PIN na tablecie oznacza, że po każdym restarcie Android czeka na ekranie blokady. Kiosk jest wtedy czarny, dopóki ktoś nie podejdzie. Kafelek **Blokada ekranu** ostrzega o tym: **Ustawiono wzór lub kod PIN.**

1. Otwórz zakładkę **Kiosk**.
2. W **Zarządzanie Androidem** ustaw **Usuń blokadę ekranu** na **Włączone**.
3. Wybierz **Zapisz i wyślij**.

Tablet sam o to nie prosi. Blokada znika przy najbliższym wprowadzeniu wzoru lub kodu PIN przez kogoś, na przykład po restarcie. Potem restart kończy się w Tillor.

Nie chcesz czekać? Usuń wzór samodzielnie w ustawieniach Androida na tablecie. Kafelek zmieni się na **Brak wzoru i kodu PIN: ponowne uruchomienie kończy się w Tillor.**

<Callout type="info" title="Xiaomi: przyciski nawigacji">
Dopóki Tillor jest ekranem głównym, HyperOS przełącza nawigację z gestów na przyciski. Tillor ukrywa ten pasek, dopóki ktoś nie dotknie trzy razy ekranu startowego. Jeśli w aplikacji wybierzesz **Odblokuj tymczasowo**, wrócisz do ekranu głównego Xiaomi. Chcesz tam znów gestów? Włącz je w ustawieniach Androida.
</Callout>

## Co włączyć potem [#wat-je-daarna-aanzet]

Dla tabletu w obudowie w recepcji lub przy wejściu to przydatny zestaw. Wszystko znajduje się w zakładce **Kiosk**, o ile nie podano inaczej.

| Ustawienie | Stan | Dlaczego |
| --- | --- | --- |
| **Aplikacja jako ekran główny** | Włączone | Przycisk home otwiera Tillor. Zegar i bateria pozostają widoczne. |
| **Zablokuj aplikację** | Włączone | Goście nie mogą opuścić aplikacji. |
| **Ukryj interfejs systemu** | Włączone | Bez powiadomień, ostatnich aplikacji i menu zasilania. |
| **Zabezpiecz urządzenie** | Włączone | Bez resetu fabrycznego, trybu awaryjnego, transferu przez USB i usuwania. |
| **Nie gaś podczas ładowania** | Włączone | Ekran pozostaje włączony w godzinach otwarcia, dopóki ładowarka jest podłączona. Nocny odpoczynek nadal ma pierwszeństwo. |
| **Automatyczny czas** | Włączone | Nocny odpoczynek podąża za zegarem organizacji, a nie za źle ustawionym zegarem tabletu. |
| **Orientacja ekranu** | Pionowo lub poziomo | W **Ekran i uśpienie**, odpowiednio do obudowy. **Domyślnie** to automatyczny obrót. |

**Zablokuj głośność** utrzymuje głośność ustawioną w zakładce **Paragony i dźwięk**, aby gość nie mógł używać przycisków z boku.

Zapisz i sprawdź trzy kafelki na górze **Kiosk**. Zielony oznacza, że tablet zgłasza to w ten sposób. Ostrzeżenie oznacza, że ten krok jeszcze się nie udał.

## Nowa wersja aplikacji przez USB [#een-nieuwe-app-versie-over-usb]

**Zabezpiecz urządzenie** wyłącza debugowanie USB i transfer plików. **Zablokuj aplikację** trzyma tablet w aplikacji, przez co okna instalacji nie da się potwierdzić.

Zanim zainstalujesz wersję przez kabel:

1. Ustaw **Zablokuj aplikację** na **Wyłączone**.
2. Ustaw **Zabezpiecz urządzenie** na **Wyłączone**.
3. Wybierz **Zapisz i wyślij** i poczekaj, aż tablet zwolni blokadę.
4. Zainstaluj nową wersję. Na Xiaomi HyperOS prosi na tablecie o potwierdzenie instalacji przez USB: dotknij **Zainstaluj**.
5. Ustaw oba ustawienia z powrotem na **Włączone** i zapisz ponownie.

Jeśli zostawisz **Zabezpiecz urządzenie** włączone, `adb` nie zobaczy już tabletu. Wyjątek dla baterii i status właściciela pozostają przy zwykłej aktualizacji. Reset fabryczny je usuwa: wtedy zaczynasz od nowa od polecenia `dpm`.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Po restarcie lub awarii zasilania tablet znów uruchamia się w Tillor, na ekranie startowym.
- Goście nie mogą opuścić aplikacji i nie widzą powiadomień ani ostatnich aplikacji.
- Trzy kafelki na górze zakładki **Kiosk** pokazują to, co zgłasza sam tablet. Po zmianie może minąć chwila, zanim kafelki zrobią się zielone, bo tablet zgłasza się co 30 do 60 sekund.
- Zwykła aktualizacja aplikacji zachowuje status właściciela i wyjątek dla baterii. Reset fabryczny nie.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Polecenie zgłasza, że na urządzeniu są już konta">
Android odmawia ustawienia właściciela, gdy na tablecie jest konto. Usuń konta lub zacznij od nowa od resetu fabrycznego.
</Accordion>
<Accordion title="adb devices pokazuje unauthorized lub nic">
Potwierdź na tablecie okno z prośbą o zgodę dla komputera i sprawdź, czy **Debugowanie USB** jest włączone. Jeśli **Zabezpiecz urządzenie** jest włączone, `adb` nie widzi już tabletu: wyłącz to tak jak przy aktualizacji przez USB powyżej.
</Accordion>
<Accordion title="Zakładka Kiosk pokazuje Przypinanie ekranu. Ten tablet nie jest skonfigurowanym kioskiem.">
Tillor nie jest jeszcze właścicielem tabletu, więc Android używa tylko przypinania ekranu. Wykonaj polecenie właściciela, a potem wybierz **Zapisz i wyślij**.
</Accordion>
<Accordion title="Przyciski w Zarządzanie Androidem są zablokowane">
Obok widnieje komunikat **Dostępne, gdy ten tablet jest skonfigurowany jako kiosk.** Skonfiguruj tablet tak jak powyżej albo użyj tabletu z Androidem: na iOS to niemożliwe.
</Accordion>
<Accordion title="Kiosk jest czarny po restarcie">
Na tablecie jest ustawiony wzór lub kod PIN. Włącz **Usuń blokadę ekranu** i jednorazowo wprowadź wzór lub kod PIN albo usuń blokadę w ustawieniach Androida.
</Accordion>
<Accordion title="Kiosk przechodzi w tryb offline w nocy">
Android uśpił aplikację. Wyłącz optymalizację baterii dla Tillor, tak jak w sekcji Bateria powyżej.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Ustawienia urządzenia" href="/mobiele-app/toestelinstellingen#kiosk" description="Przełączniki w zakładce Kiosk" />
  <Card title="Ustawianie nocnego odpoczynku ekranu" href="/mobiele-app/nachtrust-instellen" description="Wyłączanie ekranu w nocy" />
  <Card title="Zarządzanie tabletem lub kioskiem" href="/mobiele-app/tablets-en-kiosken" description="Wysyłanie ustawień" />
</Cards>


# Ustawianie nocnego odpoczynku ekranu (/pl-PL/mobiele-app/nachtrust-instellen)

Tablet włączony przez całą noc zużywa prąd i może wypalić ekran. Dzięki nocnemu odpoczynkowi ekran jest wyłączony lub czarny w godzinach, gdy park jest zamknięty. Pozostałe opcje ekranu, takie jak przyciemnianie, znajdziesz w [Ustawieniach urządzenia](/mobiele-app/toestelinstellingen#scherm-en-slaap).

<Requires permission="Edycja ustawień" />

Zanim zaczniesz:

- Jeśli chcesz, aby ekran naprawdę się wyłączał i dał się zdalnie wybudzić, najpierw skonfiguruj tablet jako kiosk i dodaj aplikację do wyjątku dotyczącego baterii. Zobacz [Konfiguracja kiosku](/mobiele-app/kiosk-inrichten).
- Jeśli wybierasz godziny otwarcia organizacji, najpierw je uzupełnij. Zobacz [Organizacja](/gebruikers/organisaties#openingsuren).

## Ustawianie nocnego odpoczynku [#de-nachtrust-instellen]

<Steps>
<Step>
### Otwórz zakładkę Ekran i uśpienie [#open-het-tabblad-scherm-en-slaap]
Otwórz urządzenie przez <UIPath>Ustawienia > Tablety i kioski</UIPath> i kliknij kafelek **Ekran i uśpienie**. Znajdź grupę **Nocny odpoczynek**.
</Step>
<Step>
### Wybierz Tryb nocny [#kies-de-nachtstand]
<Tabs items={["Stałe godziny", "Gdy organizacja jest zamknięta"]}>
<Tab value="Stałe godziny">
Wybierz **Stałe godziny** i wypełnij **Od** i **Do**. Harmonogram przechodzący przez północ, na przykład od 22:00 do 07:00, jest dozwolony.
</Tab>
<Tab value="Gdy organizacja jest zamknięta">
Ekran podąża za godzinami otwarcia Twojej organizacji. Zmieniasz je w jednym miejscu, a wszystkie urządzenia się dostosowują.
</Tab>
</Tabs>
Przy **Wyłączony** Tillor nie planuje uśpienia.
</Step>
<Step>
### Wybierz Sposób uśpienia [#kies-de-slaapstijl]
**Czarna zasłona** nakłada czarną warstwę na obraz, a dotknięcie od razu go wybudza. **Ekran wyłączony** naprawdę wyłącza panel.
</Step>
<Step>
### Kliknij Zapisz i wyślij [#klik-op-opslaan-en-versturen]
W prawym górnym rogu grupy widać, kiedy przypada następne uśpienie.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Zakładka Ekran i uśpienie, nocny odpoczynek od 22:00 do 07:00" />

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Podczas nocnego odpoczynku ekran jest wyłączony lub czarny, także gdy **Utrzymuj ekran włączony** jest włączone. Nocny odpoczynek ma pierwszeństwo.
- Dotknięcie na chwilę wybudza ekran.
- Na końcu harmonogramu ekran wraca do normalnego działania.
- Podczas nocnego odpoczynku Tillor nie wysyła powiadomienia, że urządzenie jest offline.
- Jeśli chcesz wybudzić lub uśpić ekran poza harmonogramem, użyj [Zdalnych działań](/mobiele-app/acties-op-afstand).

## Problemy? [#problemen]

<Accordions>
<Accordion title="Ekran nie budzi się w nocy przez Wybudź ekran">
**Ekran wyłączony** działa w pełni na tablecie skonfigurowanym jako kiosk. Zdalne wybudzanie działa tylko wtedy, gdy aplikacja jest też w wyjątku dotyczącym baterii. Zobacz [Bateria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
<Accordion title="Tablet wyłącza się za wcześnie lub za późno">
Źle ustawiony zegar na tablecie przesuwa harmonogram. W zakładce **Kiosk** włącz **Automatyczny czas**, aby tablet korzystał z zegara organizacji.
</Accordion>
<Accordion title="Tablet jest w nocy offline">
Android usypia aplikację. Wyłącz optymalizację baterii dla Tillor, zobacz [Konfiguracja kiosku](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Konfiguracja kiosku" href="/mobiele-app/kiosk-inrichten" description="Właściciel urządzenia i bateria" />
  <Card title="Zdalne działania" href="/mobiele-app/acties-op-afstand" description="Wybudzanie lub usypianie ekranu" />
</Cards>


# Ustawianie ekranu startowego i pokazu slajdów (/pl-PL/mobiele-app/startscherm-en-diavoorstelling)

Ekran startowy to to, co widzą goście, gdy na ekranie nie ma paragonu: tekst powitalny, Twoje logo, przyciski i ewentualnie pokaz slajdów z plakatami lub zdjęciami parku. Tutaj to ustawiasz. Każde ustawienie z jego granicami opisano w [Ustawieniach urządzenia](/mobiele-app/toestelinstellingen#startscherm).

<Requires permission="Edycja ustawień" />

Zanim zaczniesz:

- Urządzenie znajduje się w <UIPath>Ustawienia > Tablety i kioski</UIPath>, zobacz [Zarządzanie tabletem lub kioskiem](/mobiele-app/tablets-en-kiosken).
- Zdjęcia to pliki JPEG, PNG lub WebP albo link `https` do obrazu.

## Zmiana tekstu powitalnego [#de-welkomsttekst-aanpassen]

<Steps>
<Step>
### Otwórz zakładkę Ekran startowy [#open-het-tabblad-startscherm]
Otwórz urządzenie i kliknij kafelek **Ekran startowy**. Pola **Tytuł powitalny** (maksymalnie 60 znaków) i **Podtytuł powitalny** (maksymalnie 120) znajdują się na górze.
</Step>
<Step>
### Wpisz tekst i wyślij [#vul-de-tekst-in-en-verstuur]
Zostaw pole puste, jeśli aplikacja może zachować własny tekst. Kliknij **Zapisz i wyślij**.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Zakładka Ekran startowy, z zaznaczonymi sekcjami Wygląd i Przyciski" />

## Dodawanie pokazu slajdów [#een-diavoorstelling-toevoegen]

<Steps>
<Step>
### Otwórz zakładkę Pokaz slajdów i przyciski [#open-het-tabblad-diavoorstelling-en-knoppen]
Kliknij ten kafelek. W **Wyświetlanie** wybierasz, jak pojawiają się zdjęcia.
</Step>
<Step>
### Wybierz sposób wyświetlania [#kies-de-weergave]
<Tabs items={["Jako tło", "Pełny ekran podczas bezczynności"]}>
<Tab value="Jako tło">
Zdjęcia zmieniają się za logo i przyciskami, zamiast tła Twojej organizacji. Goście mogą jednocześnie dotykać przycisków.
</Tab>
<Tab value="Pełny ekran podczas bezczynności">
Zdjęcia zajmują cały ekran, gdy nikt go nie dotyka. Dotknięcie przywraca ekran startowy. Jak długo trzeba czekać, ustawiasz w **Rozpocznij po**.
</Tab>
</Tabs>
</Step>
<Step>
### Dodaj zdjęcia [#voeg-fotos-toe]
Kliknij **Prześlij zdjęcie** albo wklej adres `https` przez **Dodaj link**. Możesz dodać do 20 zdjęć. Przy zdjęciu możesz ustawić podpis o długości maksymalnie 80 znaków.
</Step>
<Step>
### Ustaw czas [#stel-de-timing-in]
**Czas na zdjęcie** wynosi od 3 do 600 sekund. **Rozpocznij po** od 10 do 3600 sekund. W **Dopasowanie** wybierasz **Wypełnij ekran** (brzegi są przycinane) lub **Pokaż całe zdjęcie** (z czarnymi paskami).
</Step>
<Step>
### Kliknij Zapisz i wyślij [#klik-op-opslaan-en-versturen]
Tablet pokazuje pokaz slajdów, gdy tylko otrzyma ustawienia.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Zakładka Pokaz slajdów i przyciski, z trybem wyświetlania i dwoma dodatkowymi przyciskami" />

## Dodawanie dodatkowych przycisków [#extra-knoppen-toevoegen]

Dodatkowe przyciski to skróty na ekranie startowym, na przykład do mapy lub sieci dla gości. Możesz mieć ich sześć.

<Steps>
<Step>
### Kliknij Dodaj przycisk [#klik-op-knop-toevoegen]
Pojawia się pusty wiersz.
</Step>
<Step>
### Wypełnij przycisk [#vul-de-knop-in]
Podaj tekst, krótki opis i adres internetowy (tylko `https`). Wybierz ikonę z rzędu, a w **Kiedy pokazywać**, czy przycisk jest zawsze widoczny, czy dopiero po dotknięciu.
</Step>
<Step>
### Kliknij Zapisz i wyślij [#klik-op-opslaan-en-versturen-1]
</Step>
</Steps>

Ikona kosza usuwa przycisk. **Niech decyduje urządzenie** odrzuca listę z Tillor, dzięki czemu tablet używa własnych przycisków.

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tablet dostosowuje ekran startowy, gdy tylko otrzyma ustawienia. Tablet offline robi to, gdy znów się połączy.
- Jeśli ustawisz **Przycisk prepaid** lub **Przycisk ustawień** na **Po dotknięciu**, przycisk chowa się po liczbie sekund wpisanej w **Ukryj po**.
- Paragon, dokument lub prośba o podpis wysłane przez Tillor na tablet pojawiają się nad ekranem startowym i znów znikają.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Przesyłanie zdjęcia nie działa i Tillor pokazuje Przesyłanie nie powiodło się">
Plik nie jest JPEG, PNG ani WebP albo przesyłanie zostało przerwane. Spróbuj innego zdjęcia lub użyj **Dodaj link** z adresem obrazu.
</Accordion>
<Accordion title="Nie mogę dodać zdjęć">
Przyciski pojawiają się dopiero, gdy **Wyświetlanie** nie jest ustawione na **Wyłączone**. Jeśli na liście jest już 20 zdjęć, najpierw usuń jedno przez **Usuń zdjęcie**.
</Accordion>
<Accordion title="Pokaz slajdów się nie uruchamia">
Przy **Pełny ekran podczas bezczynności** uruchamia się dopiero po liczbie sekund z **Rozpocznij po** bez dotknięcia. Domyślnie dla nowego pokazu slajdów to 60 sekund. Sprawdź też, czy tablet ma już nowe ustawienia.
</Accordion>
<Accordion title="Mój przycisk niczego nie otwiera">
Adres musi zaczynać się od `https`. Sprawdź, czy link działa w przeglądarce.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Ustawienia urządzenia" href="/mobiele-app/toestelinstellingen" description="Wszystkie ustawienia i granice" />
  <Card title="Zarządzanie tabletem lub kioskiem" href="/mobiele-app/tablets-en-kiosken" description="Wysyłanie ustawień" />
</Cards>


# Zarządzanie tabletem lub kioskiem (/pl-PL/mobiele-app/tablets-en-kiosken)

Każdy tablet, kiosk lub telefon, na którym ktoś otworzy aplikację Tillor i wybierze organizację, pojawia się w Tillor. Stąd widzisz, czy urządzenie nadal jest połączone, i wysyłasz na nie ekran startowy, dźwięk oraz blokadę kiosku. To, co można ustawić, znajdziesz na każdej karcie w [Ustawienia urządzenia](/mobiele-app/toestelinstellingen).

<Requires permission="Instellingen bewerken" />

Zanim zaczniesz:

- Na urządzeniu musi być aplikacja Tillor i ktoś musi być zalogowany do Twojej organizacji. Jeśli tak nie jest, zobaczysz **Brak urządzeń**.
- Wysyłać ustawienia może tylko osoba z uprawnieniem **Edycja ustawień**.

## Wysyłanie ustawień na urządzenie [#instellingen-naar-een-toestel-sturen]

<Steps>
<Step>
### Otwórz listę [#open-de-lijst]
Przejdź do <UIPath>Ustawienia > Tablety i kioski</UIPath>. Każdy wiersz to jedna instalacja aplikacji. Widzisz nazwę, rodzaj (**Tablet**, **Kiosk** lub **Telefon**), model, wersję aplikacji, poziom baterii i informację, czy urządzenie jest połączone. **Ostatnio widziane** oznacza, że aplikacja od jakiegoś czasu niczego nie zgłosiła.

<DocScreenshot src="/screenshots/tablets/devices-list.png" alt="Ustawienia > Tablety i kioski z kioskiem Zelfbedieningskiosk" />
</Step>
<Step>
### Otwórz urządzenie [#open-het-toestel]
Kliknij wiersz urządzenia. Na górze widać nazwę i status. Pod nimi jest pole wyszukiwania i rząd kafelków, po jednym na kartę.

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Strona urządzenia Zelfbedieningskiosk z kafelkami kart i paskiem zapisu" />

Na kafelku widać, ile ustawień pochodzi z Tillor. **Wszystko na urządzeniu** oznacza, że na tej karcie nic jeszcze nie zostało na stałe ustawione. Po prawej cały czas widoczny jest panel **Zdalne działania**, zobacz [Zdalne działania](/mobiele-app/acties-op-afstand).
</Step>
<Step>
### Zmień ustawienia [#pas-de-instellingen-aan]
Wybierz kartę i zmień to, co chcesz. Prawie każdy przełącznik ma trzy położenia: **Urządzenie**, **Włączone** i **Wyłączone**. **Urządzenie** zostawia wybór dokonany na samym tablecie. **Włączone** i **Wyłączone** zastępują ten wybór po zapisaniu. Pod opisem widać, co robi aplikacja, gdy nikt niczego nie wybrał, na przykład **Domyślnie: Włączone**.
</Step>
<Step>
### Kliknij Zapisz i wyślij [#klik-op-opslaan-en-versturen]
Dopóki tego nie klikniesz, nic nie trafia na urządzenie. Gdy coś jest zmienione, na pasku widać **Niewysłane zmiany**, a karta ma zieloną kropkę. **Odrzuć zmiany** przywraca formularz do tego, co jest teraz na urządzeniu.

Przed zmianą i po niej, zanim ją wyślesz:

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Przed: strona urządzenia bez zmian" />

<DocScreenshot src="/screenshots/tablets/device-page-unsaved.png" alt="Po: zmienione ustawienie z napisem Niewysłane zmiany i zieloną kropką na karcie" />
</Step>
</Steps>

## To samo dla wszystkich urządzeń [#hetzelfde-voor-alle-toestellen]

Jeśli masz kilka urządzeń tego samego rodzaju, nie musisz ustawiać każdego osobno.

<Tabs items={["Jedno urządzenie", "Wszystkie urządzenia tego rodzaju"]}>
<Tab value="Jedno urządzenie">
Kliknij **Zapisz i wyślij**. Ustawienia dostaje tylko to urządzenie.
</Tab>
<Tab value="Wszystkie urządzenia tego rodzaju">
Kliknij **Zastosuj do wszystkich kiosków** (albo **tabletów**, albo **telefonów**, zależnie od rodzaju). Tillor kopiuje ustawienia tego urządzenia na pozostałe urządzenia tego samego rodzaju i od razu je wysyła, z komunikatem **Ustawienia skopiowane na pozostałe urządzenia**. Nazwa, rodzaj i powiadomienia pozostają przy każdym urządzeniu osobno. Język jest kopiowany.
</Tab>
</Tabs>

## Wyszukiwanie na wszystkich kartach [#zoeken-over-alle-tabbladen]

Nie wiesz, na której karcie jest dane ustawienie? Pole **Szukaj ustawień** przeszukuje wszystkie karty naraz. Kafelki zostają na miejscu, a pod nimi pojawia się lista wyników, pogrupowana według kart.

<DocScreenshot src="/screenshots/tablets/device-search.png" alt="Wyszukiwanie jasności z wynikami z karty Ekran i uśpienie" />

Wyszukiwanie `jasność` pokazuje reguły jasności z karty **Ekran i uśpienie**, a pod nimi inne karty, które też zawierają to słowo. **Otwórz kartę** zamyka wyszukiwanie i otwiera tę kartę, żebyś widział także resztę grupy. Jeśli niczego nie znajdziesz, zobaczysz **Brak ustawień pasujących do** wpisanej frazy.

## Zapomnienie urządzenia [#een-toestel-vergeten]

Menu z trzema kropkami w prawym górnym rogu strony urządzenia zawiera **Zapomnij urządzenie**. Użyj go dla tabletu, który nie jest już używany.

<DocScreenshot src="/screenshots/tablets/device-menu.png" alt="Menu z opcją Zapomnij urządzenie" />

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Tillor wyświetla **Ustawienia wysłane**. Tablet stosuje je od razu, jeśli jest połączony. Jeśli jest offline, dostaje je, gdy tylko ponownie połączy się z Tillor. Aplikacja zgłasza się co 30 do 60 sekund.
- Na stronie urządzenia i na liście widać, czy urządzenie jest połączone. Urządzenie zgłasza też z powrotem baterię, wersję aplikacji i połączenie, zobacz [Diagnostyka i historia](/mobiele-app/diagnose-en-geschiedenis).
- Każda zmiana trafia do historii urządzenia i do [dziennika aktywności](/activiteitenlog) Twojej organizacji.
- Zapomniane urządzenie znika z listy, a wysłane ustawienia znikają razem z nim. Jeśli aplikacja nadal na nim działa i ktoś jest zalogowany, urządzenie wróci w ciągu minuty, bez tych ustawień. Musisz wtedy ustawić je od nowa.
- Jeśli włączysz **Powiadomienia** na karcie **Urządzenie**, osoby zarządzające ustawieniami dostaną wiadomość, gdy urządzenie będzie offline przez 10 minut albo bateria spadnie poniżej 15% bez ładowarki.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Widzę Brak urządzeń">
Żaden tablet jeszcze się nie zgłosił. Otwórz aplikację Tillor na tablecie, zaloguj się i wybierz właściwą organizację. Urządzenie pojawi się w ciągu minuty.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się zapisać ustawień">
Zapis się nie udał, najczęściej z powodu niestabilnego połączenia albo braku uprawnienia **Edycja ustawień**. Spróbuj ponownie. Jeśli nadal się nie udaje, poproś administratora o to uprawnienie.
</Accordion>
<Accordion title="Tillor pokazuje Nie udało się skopiować ustawień">
**Zastosuj do wszystkich kiosków** się nie udało. Kliknij jeszcze raz. Jeśli to nie pomaga, zapisz urządzenie przyciskiem **Zapisz i wyślij** i otwieraj pozostałe urządzenia po kolei.
</Accordion>
<Accordion title="Tablet nic nie robi po mojej zmianie">
Sprawdź, czy urządzenie jest **Połączone**. Jeśli jest offline, zastosuje ustawienia, gdy tylko ponownie się połączy. Jeśli przełącznik jest ustawiony na **Urządzenie**, decyduje sam tablet. Wybierz **Włączone** lub **Wyłączone**, aby to zmienić.
</Accordion>
<Accordion title="Urządzenie wróciło po Zapomnij urządzenie">
Aplikacja nadal działa i ktoś jest zalogowany, więc urządzenie zgłasza się ponownie. Wyloguj się na tablecie, jeśli naprawdę chcesz się go pozbyć. W sekcji **Konto** > **Aktywne sesje** możesz zakończyć sesję aplikacji.
</Accordion>
<Accordion title="Tillor pokazuje Użyj od 4 do 6 cyfr">
**Kod do ustawień** na karcie **Ekran startowy** musi składać się z 4 do 6 cyfr albo być pusty. Dopiero wtedy możesz zapisać.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Ustawienia urządzenia" href="/mobiele-app/toestelinstellingen" description="Co znajduje się na każdej karcie" />
  <Card title="Konfiguracja kiosku" href="/mobiele-app/kiosk-inrichten" description="Zablokuj tablet z Androidem tak, aby goście nie mogli z niego wyjść" />
  <Card title="Zdalne działania" href="/mobiele-app/acties-op-afstand" description="Wybudzanie ekranu, ponowne uruchomienie i zrzut ekranu" />
</Cards>


# Ustawienia urządzenia (/pl-PL/mobiele-app/toestelinstellingen)

Znajdziesz tu wszystkie ustawienia urządzenia, karta po karcie, z ich wartościami domyślnymi i granicami. Jest ich sześć, każda jako kafelek nad formularzami. Jak tam dotrzeć, jak działa wyszukiwanie i kiedy coś trafia na urządzenie, opisano w [Zarządzanie tabletem lub kioskiem](/mobiele-app/tablets-en-kiosken). Ekran startowy krok po kroku opisano w [Ustawianie ekranu startowego i pokazu slajdów](/mobiele-app/startscherm-en-diavoorstelling), a nocny odpoczynek w [Ustawianie nocnego odpoczynku ekranu](/mobiele-app/nachtrust-instellen).

Każda reguła ma ikonę, krótkie wyjaśnienie i, gdy ma to sens, wartość domyślną aplikacji. Wybierz **Urządzenie** (albo zostaw liczbę pustą na **Domyślnie**), jeśli tablet może zachować własny wybór. **Włączone** i **Wyłączone** zastępują ten wybór.

Reguły, które działają tylko na skonfigurowanym kiosku, pokazują ostrzeżenie, dopóki tablet nie jest skonfigurowany: **Dostępne, gdy ten tablet jest skonfigurowany jako kiosk.** Te kroki opisano w [Konfiguracja kiosku](/mobiele-app/kiosk-inrichten).

## Ekran startowy [#startscherm]

Tekst powitalny, tło i przyciski, które widzą goście, gdy na ekranie nie ma paragonu.

### Tekst powitalny [#welkomsttekst]

**Tytuł powitalny** (maksymalnie 60 znaków) i **Podtytuł powitalny** (maksymalnie 120) są wyświetlane u góry ekranu startowego. Zostaw pole puste, jeśli aplikacja ma zachować własny tekst.

### Wygląd [#uiterlijk]

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Karta Ekran startowy, z zaznaczonymi sekcjami Wygląd i Przyciski" />

**Wygląd** (znacznik **1**):

- **Zdjęcie w tle** pokazuje tło organizacji za logo. Domyślnie włączone.
- **Przyciemnienie tła** to wartość procentowa od 0 do 90. Domyślnie 45, dzięki czemu logo i przyciski pozostają czytelne na jasnym zdjęciu.
- **Styl logo** to **Biała sylwetka** (domyślnie) albo **W kolorze na karcie**.

### Przyciski [#knoppen]

**Przyciski** (znacznik **2**):

- **Przycisk prepaid** otwiera saldo, doładowanie i płatność kartą NFC. Domyślnie włączony.
- **Przycisk ustawień** pokazuje przycisk prowadzący do ustawień na samym urządzeniu. Jeśli jest wyłączony, wejdziesz do nich, dotykając ekranu startowego trzy razy.
- **Kiedy pokazywać** to **Zawsze** albo **Po dotknięciu**. Przy **Po dotknięciu** wpisz **Ukryj po**, w sekundach. Potem przycisk znów znika, dopóki ktoś nie dotknie ekranu.
- **Kod do ustawień** to 4 do 6 cyfr. Urządzenie prosi o ten kod, zanim otworzą się jego własne ustawienia. Puste oznacza brak kodu. Czegoś innego niż 4 do 6 cyfr nie można zapisać.

## Pokaz slajdów i przyciski [#diavoorstelling-en-knoppen]

Zdjęcia, które ekran startowy wyświetla na zmianę, i dodatkowe przyciski prowadzące do strony internetowej.

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Karta Pokaz slajdów i przyciski, z wyświetlaniem i dwoma dodatkowymi przyciskami" />

### Pokaz slajdów [#diavoorstelling]

**Wyświetlanie** (znacznik **1**) ma trzy położenia:

- **Wyłączone** nie pokazuje zdjęć.
- **Jako tło** zmienia zdjęcia za logo i przyciskami, zamiast tła organizacji.
- **Pełny ekran podczas bezczynności** przejmuje cały ekran, gdy nikt go nie dotyka.

Gdy wyświetlanie nie jest ustawione na **Wyłączone**, możesz dodać do 20 zdjęć. **Prześlij zdjęcie** przyjmuje JPEG, PNG lub WebP. **Dodaj link** wkleja adres `https` obrazu. Do każdego zdjęcia możesz dodać podpis do 80 znaków.

- **Czas na zdjęcie** to czas, przez który każde zdjęcie pozostaje na ekranie, od 3 do 600 sekund. Nowy pokaz slajdów zaczyna od 10.
- **Rozpocznij po** dotyczy tylko pełnego ekranu: liczba sekund bez dotyku, zanim pokaz się zacznie, od 10 do 3600. Nowy pokaz slajdów zaczyna od 60.
- **Dopasowanie**: **Wypełnij ekran** przycina krawędzie, **Pokaż całe zdjęcie** zachowuje całe zdjęcie z czarnymi pasami. Nowy pokaz slajdów zaczyna od **Pokaż całe zdjęcie**.

Dotknięcie pokazu na pełnym ekranie przywraca ekran startowy.

### Dodatkowe przyciski [#extra-knoppen]

**Dodatkowe przyciski** (znacznik **2**) to skróty na ekranie startowym, na przykład do mapy albo sieci dla gości. Możesz mieć ich sześć.

Dla każdego przycisku wpisujesz tekst przycisku, krótki opis, adres strony i ikonę. Ikonę wybierasz z rzędu: mapa, strona internetowa, informacje, kalendarz, jedzenie i napoje, Wi-Fi, telefon albo bilety. **Kiedy pokazywać** działa tak samo jak przy przycisku prepaid: zawsze albo dopiero po dotknięciu i potem znów ukrycie.

**Dodaj przycisk** tworzy pusty wiersz. Ikona kosza usuwa przycisk. **Niech decyduje urządzenie** usuwa listę z Tillor, dzięki czemu tablet używa własnych przycisków. Ten sam komunikat widać, dopóki nie zapiszesz żadnych przycisków: nie ustawiono tu przycisków.

## Ekran i uśpienie [#scherm-en-slaap]

Jasność, orientacja, kolory i kiedy ekran wyłącza się w nocy.

### Jasność [#helderheid]

Szukasz ustawienia? Wpisz `jasność` w polu wyszukiwania, zobacz [Wyszukiwanie na wszystkich kartach](/mobiele-app/tablets-en-kiosken#zoeken-over-alle-tabbladen).

- **Tryb kiosku** utrzymuje włączony ekran, z paragonami, podpisywaniem i regulacją jasności. Domyślnie włączony na tablecie lub kiosku, wyłączony na telefonie.
- **Nie wyłączaj ekranu** zapobiega usypianiu ekranu. Domyślnie włączone, na telefonie wyłączone.
- **Przyciemniaj przy bezczynności** przechodzi do pełnej jasności po dotknięciu, a potem przyciemnia. Domyślnie włączone, na telefonie wyłączone.
- **Przyciemnij po** to liczba sekund bez dotyku, od 5 do 3600. Domyślnie 15.
- **Jasność po przyciemnieniu** to wartość procentowa w tym przyciemnionym stanie, od 0 do 100. Domyślnie 0,5%.

Nocny odpoczynek opisany niżej ma pierwszeństwo przed **Nie wyłączaj ekranu**: w godzinach snu ekran i tak się wyłączy lub zaczernieje.

### Wyświetlanie [#weergave]

- **Orientacja ekranu** to **Obracaj automatycznie** (domyślnie), **Pionowo** lub **Poziomo**. Zablokuj kiosk w obudowie, inaczej obraz będzie się obracał, gdy ktoś przechyli tablet.
- **Wygląd** to **Zgodnie z urządzeniem**, **Jasny** lub **Ciemny**.

### Nocny odpoczynek [#nachtrust]

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Karta Ekran i uśpienie, nocny odpoczynek od 22:00 do 07:00" />

**Tryb nocny** (znacznik **1**) ma trzy położenia:

- **Wyłączony** nie planuje snu.
- **Stałe godziny** używa **Od** i **Do**. Harmonogram przechodzący przez północ, na przykład od 22:00 do 07:00, jest dozwolony. W tym czasie ekran jest wyłączony, nawet jeśli przez resztę dnia ma pozostawać włączony. Dotknięcie wybudza go na chwilę.
- **Gdy organizacja jest zamknięta** podąża za godzinami otwarcia organizacji.

W prawym górnym rogu grupy widać, kiedy przypada następny sen.

**Sposób uśpienia**:

- **Czarna zasłona** nakłada czarną zasłonę na obraz. Ekran pozostaje dotykowy, więc dotknięcie od razu go budzi.
- **Ekran wyłączony** naprawdę wyłącza panel. Budzi się na końcu harmonogramu albo po **Wybudź ekran** w [Zdalne działania](/mobiele-app/acties-op-afstand). W pełni działa to na tablecie skonfigurowanym jako kiosk. Zdalne wybudzanie udaje się tylko wtedy, gdy aplikacja jest też na liście wyjątków baterii, zobacz [Bateria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).

## Paragony i dźwięk [#kassabonnen-en-geluid]

Co robi tablet, gdy Tillor wysyła dokument, i jakie dźwięki odtwarza.

<DocScreenshot src="/screenshots/tablets/tab-sound.png" alt="Karta Paragony i dźwięk" />

### Paragony i dokumenty [#kassabonnen-en-documenten]

Znacznik **1**:

- **Pokazuj paragony i dokumenty** wyświetla pliki PDF, obrazy i prośby o podpis na tym urządzeniu. Domyślnie włączone, na telefonie wyłączone. Wyłącz to na tablecie, który ma być tylko ekranem startowym i nie ma pokazywać paragonów.
- **Wyczyść po** to liczba sekund, przez które paragon pozostaje na ekranie, zanim urządzenie samo go usunie, od 5 do 900. Zostaw puste, aby czekać, aż Tillor wyczyści ekran.

### Dźwięk [#geluid]

Znacznik **2**. Wszystko poniżej jest domyślnie włączone, głośność na 100%.

- **Dźwięk przy uruchomieniu** jest odtwarzany, gdy aplikacja się uruchamia lub uruchamia ponownie.
- **Dźwięk paragonów i dokumentów** jest odtwarzany, gdy przychodzi paragon, obraz lub prośba o podpis.
- **Dźwięk płatności online** jest odtwarzany, gdy faktura zostanie opłacona online lub automatycznym przelewem.
- **Dźwięk niskiego poziomu baterii** odtwarza ostrzeżenie, gdy bateria jest prawie rozładowana, a ładowarka nie jest podłączona.
- **Głośność** to 0 do 100. Na kiosku możesz ją zablokować przez **Zablokuj głośność** na karcie **Kiosk**.

**Odtwórz dźwięk testowy** znajdziesz w [Zdalne działania](/mobiele-app/acties-op-afstand), nie na tej karcie.

## Kiosk [#kiosk]

Ma sens tylko na Androidzie. Konfigurację (właściciel urządzenia, bateria, USB) opisano w [Konfiguracja kiosku](/mobiele-app/kiosk-inrichten). Na tej karcie ustawiasz potem przełączniki.

<DocScreenshot src="/screenshots/tablets/tab-kiosk.png" alt="Karta Kiosk z kafelkami statusu i blokadą" />

### Status [#status]

Trzy kafelki (znacznik **1**) pokazują, co tablet zgłosił ostatnim razem. To nie są ustawienia.

- **Urządzenie kiosku** jest zielone przy **Skonfigurowany kiosk: blokada jest pełna.** Ostrzeżenie oznacza przypinanie ekranu (aplikacja nie jest właścicielem) albo że aplikacja w ogóle nie jest zablokowana. Kreska oznacza, że ta wersja aplikacji nie zgłasza jeszcze statusu.
- **Ekran startowy** jest zielony, gdy Tillor jest ekranem głównym. W przeciwnym razie widać, że Tillor jeszcze nim nie jest albo że aplikacja jeszcze tego nie zgłosiła.
- **Blokada ekranu** ostrzega, gdy na tablecie ustawiono wzór lub kod PIN. Po ponownym uruchomieniu urządzenie czeka wtedy na ekranie blokady. Zielone oznacza, że ponowne uruchomienie kończy się w Tillor.

### Blokada [#vergrendeling]

Znacznik **2**. Domyślnie te trzy są wyłączone, dopóki sam ich nie włączysz.

- **Aplikacja jako ekran główny** ustawia Tillor jako ekran główny. Zegar i bateria pozostają widoczne. Tylko Android i tylko z wersją aplikacji, która to obsługuje.
- **Zablokuj aplikację** utrzymuje tablet w aplikacji Tillor. Na skonfigurowanym kiosku gość nie może z niej wyjść. Bez tej konfiguracji Android wraca do przypinania ekranu: ktoś przy tablecie musi to potwierdzić i można je opuścić.
- **Ukryj interfejs systemu** usuwa powiadomienia, ostatnie aplikacje i menu zasilania. Zegar i bateria pozostają. Działa dopiero, gdy tablet jest skonfigurowany jako kiosk.

### Zarządzanie Androidem [#android-beheer]

<DocScreenshot src="/screenshots/tablets/tab-kiosk-android.png" alt="Zarządzanie Androidem na karcie Kiosk" />

Wszystko w tej grupie (znacznik **1**) dotyczy tylko skonfigurowanego kiosku. Na innym urządzeniu przy każdej regule widać ostrzeżenie, a przyciski są wyłączone. Domyślnie przełączniki są wyłączone. Dwie liczby są puste: tablet zachowuje wtedy własną jasność i wygaszanie.

- **Zabezpiecz urządzenie** blokuje reset, tryb awaryjny, nowych użytkowników, transfer USB, odinstalowanie i wymuszone zatrzymanie. Wyłącz to, zanim zainstalujesz aktualizację przez USB.
- **Usuń blokadę ekranu** usuwa wzór lub kod PIN. Zaczyna działać po jeszcze jednym wprowadzeniu tego wzoru lub kodu PIN.
- **Nie gaś podczas ładowania** utrzymuje ekran włączony w godzinach otwarcia, gdy ładowarka jest podłączona. Nocny odpoczynek i tak go wyłączy.
- **Zablokuj głośność** utrzymuje głośność z sekcji **Dźwięk**.
- **Aktualizacje w czasie snu** instaluje aktualizacje systemu, gdy ekran śpi, i odkłada je, dopóki tablet jest używany.
- **Automatyczny czas** wymaga automatycznej daty, godziny i strefy czasowej, aby sen pokrywał się z godzinami otwarcia.
- **Jasność ekranu** to stała jasność samego tabletu, od 1 do 100, z wyłączoną automatyczną jasnością. Pozostawienie pustego zachowuje ustawienie tabletu.
- **Wygaszanie ekranu** to liczba sekund (15 do 3600), po której Android wyłącza ekran, gdy aplikacja go nie utrzymuje. Pozostawienie pustego zachowuje ustawienie tabletu.

## Urządzenie [#toestel]

Nazwa, rodzaj, język i powiadomienia. **Zastosuj do wszystkich kiosków** przenosi język na pozostałe urządzenia tego samego rodzaju, a nazwę, rodzaj i powiadomienia zostawia bez zmian.

<DocScreenshot src="/screenshots/tablets/tab-general.png" alt="Karta Urządzenie z nazwą, rodzajem, językiem i powiadomieniami" />

Znacznik **1**:

- **Nazwa** to to, co widzisz na liście i na urządzeniu, na przykład `Zelfbedieningskiosk`. Maksymalnie 80 znaków.
- **Rodzaj** to **Tablet**, **Kiosk** lub **Telefon**. Rodzaj decyduje o tekście na **Zastosuj do wszystkich …** i o kilku wartościach domyślnych: na telefonie tryb kiosku, paragony, nie wyłączaj ekranu i przyciemnianie zaczynają jako wyłączone.
- **Język** to jedyna lista, która się zwija, bo opcji jest więcej, niż mieści się w rzędzie przycisków. **Domyślnie** podąża za językiem tabletu. W przeciwnym razie wybierasz język aplikacji Tillor. Nazwy są wyświetlane w danym języku.
- **Powiadomienia** powiadamiają osoby zarządzające ustawieniami, gdy to urządzenie jest offline od 10 minut albo bateria spadnie poniżej 15% bez ładowarki. W czasie nocnego odpoczynku nie przychodzi powiadomienie o braku połączenia. Domyślnie wyłączone.

<Callout type="info">
Język tutaj to język aplikacji na tablecie. Język systemu Android znajdziesz w **Diagnostyka**, jako **Język urządzenia**.
</Callout>


# Automatyzacje (/pl-PL/ontwikkelaars/automatiseringen)

Automatyzacje pozwalają Tillor samemu wykonywać działania, na przykład tworzyć zadania lub wywoływać Twój system. Opis dla użytkowników znajdziesz w [Automatyzacje](/automatiseringen). Ta strona opisuje to, co widzi integrator: wiadomość z kroku **Wyślij webhook**, **Żądanie API** na własny URL lub do API Tillor oraz sposób zbudowania przepływu, gdy zarządzasz nim przez API.

## Wysyłanie webhooka [#webhook-versturen]

Krok **Wyślij webhook** dostarcza własną wiadomość do jednego z [webhooków](/ontwikkelaars/webhooks) organizacji. To to samo dostarczanie co przy zwykłych zdarzeniach webhooka, z tym samym podpisem.

### Wiadomość [#het-bericht]

Krok wysyła `POST` z `Content-Type: application/json` i tymi nagłówkami:

| Header | Inhoud |
|---|---|
| `X-Webhook-Event-ID` | Unikalny identyfikator tego dostarczenia. Przy kolejnych próbach wartość pozostaje taka sama, więc możesz po niej usuwać duplikaty |
| `X-Webhook-Signature` | `sha256=<hex>`, HMAC-SHA256 treści z signing secret webhooka |

Treść ma tę samą kopertę co payload webhooka:

```json
{
  "event": "automation.invoice_unpaid",
  "data": {
    "invoice": "2026-0042",
    "amountOutstanding": 125.5
  },
  "timestamp": 1735689600000,
  "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d",
  "triggeredBy": null
}
```

| Veld | Beschrijving |
|---|---|
| `event` | **Nazwa zdarzenia**, którą wpisano w kroku. Dozwolony jest dowolny tekst, nazwa nie musi być na liście kluczy zdarzeń |
| `data` | **Ładunek** z kroku, po uzupełnieniu zmiennych, jako JSON |
| `timestamp` | Czas unixowy dostarczenia w milisekundach |
| `traceId` | Losowy UUID dla każdego dostarczenia. W odróżnieniu od zdarzeń z systemu nie jest to identyfikator śladu działania Tillor |
| `triggeredBy` | Zawsze `null` |

Nie ma `spanId`. Webhook nie musi być zapisany na klucz zdarzenia: wiadomość z automatyzacji jest zawsze dostarczana na wybrany endpoint, dopóki on istnieje i jest włączony.

Jak sprawdzić podpis, opisano w [Weryfikacja podpisu](/ontwikkelaars/webhooks#handtekening-verifiëren).

### Próby i wynik [#pogingen-en-uitkomst]

Tillor wykonuje w ramach kroku do 5 prób, z oczekiwaniem 1, 2, 4 i 8 sekund między nimi. Próba jest udana przy statusie 2xx. Także zablokowany cel, na przykład adres wewnętrzny, liczy się jako nieudana próba.

- Jeśli któraś próba się powiedzie, przepływ kontynuuje wyjściem **Powodzenie**
- Jeśli wszystkie pięć się nie powiedzie, przepływ kontynuuje przez **Niepowodzenie**. Wiadomość jest potem jeszcze ponawiana w tle według harmonogramu z [Zachowanie dostarczania i ponowienia](/ontwikkelaars/webhooks#leveringsgedrag-en-retries). Jeśli taka późniejsza próba się powiedzie, nie wróci to już do wykonania, bo ono poszło już dalej

Jeśli webhook już nie istnieje lub jest wyłączony, krok nie przechodzi przez **Niepowodzenie**. Wykonanie kończy się wtedy ze statusem **Niepowodzenie**.

## Żądanie API na własny URL [#api-verzoek-naar-een-eigen-url]

Przy **Żądanie API** i **Wyślij do** ustawionym na **Własny URL** automatyzacja wysyła żądanie HTTP na Twój serwer.

| Onderdeel | Gedrag |
|---|---|
| Metoda | `GET`, `POST`, `PUT`, `PATCH` lub `DELETE` |
| URL | Musi zaczynać się od `https://`. Zmienne są wstawiane w postaci zakodowanej |
| Treść | JSON. Przy `GET` i `DELETE` nie jest wysyłana. Z treścią Tillor ustawia `Content-Type: application/json` |
| Nagłówki | Dowolne. Wartości mogą zawierać zmienne. `Host`, `Content-Length`, `Transfer-Encoding` i `Connection` są ignorowane |
| Cel | Adresy prywatne i wewnętrzne są odrzucane, także gdy wskazuje na nie zwykła nazwa domeny |
| Przekierowania | Nie są śledzone. Odpowiedź 3xx liczy się jako nieudana |
| Limit czasu | 15 sekund |

<Callout type="warn" title="Brak podpisu">
W odróżnieniu od **Wyślij webhook** Tillor nie podpisuje tego żądania. Jeśli chcesz sprawdzać, że żądanie pochodzi z Twojej automatyzacji, umieść sekret w nagłówku i sprawdzaj go po swojej stronie. Nagłówki są zapisywane w postaci zaszyfrowanej, więc klucz lub token w nich jest bezpieczny.
</Callout>

Odpowiedź ze statusem 2xx kontynuuje przez **Powodzenie**, każdy inny status przez **Niepowodzenie**. Jeśli serwer jest nieosiągalny albo przekroczy limit czasu, wykonanie kończy się ze statusem **Niepowodzenie**.

## Żądanie API do API Tillor [#api-verzoek-naar-de-tillor-api]

Przy **Wyślij do** ustawionym na **Tillor API** automatyzacja wywołuje API własnej organizacji. Podajesz tylko ścieżkę, na przykład `/tasks`, a Tillor umieszcza ją po `/api/orgs/{orgId}`. Dokumentacja API jest w [OpenAPI](https://tillor.eu/api/openapi.json).

- **Tożsamość**: żądanie jest wykonywane jako użytkownik Przepływ pracy organizacji. Ma on wszystkie uprawnienia w tej organizacji i nigdzie indziej. Zmiany są więc zapisane na nazwę **Przepływ pracy**
- **Klucz niepotrzebny**: Tillor sam wykonuje wywołanie, bez klucza API i bez przechodzenia przez internet
- **Ścieżka**: musi zaczynać się od jednego `/`. `//`, `..` i `\` są niedozwolone. Dozwolony jest query string, na przykład `/tasks?terrainId=…&limit=1`. Zmienne w ścieżce są wstawiane w postaci zakodowanej
- **Zablokowane**: ścieżki `/automations` i `/automation-runs` są odrzucane, także z query stringiem, wielkimi literami, końcowym `/` lub kodowaniem procentowym. Automatyzacja nie może zarządzać automatyzacjami
- **Treść**: JSON, dla `POST`, `PUT` i `PATCH`. Przy `GET` i `DELETE` nie jest wysyłana
- **Menu wyboru**: w edytorze jest **Wybierz punkt końcowy API** z operacjami ze specyfikacji OpenAPI. Operacji wewnętrznych tam nie ma. Gdy wybierzesz jedną, Tillor uzupełnia metodę, ścieżkę i przykładową treść
- **Niepowodzenie**: odpowiedź 2xx kontynuuje przez **Powodzenie**. Status błędu, także 404 dla nieistniejącej ścieżki, idzie przez **Niepowodzenie**

### Odpowiedź w kolejnych krokach [#het-antwoord-in-latere-stappen]

Po żądaniu dostępne są te zmienne:

| Variabele | Inhoud |
|---|---|
| `{response.status}` | Kod statusu HTTP |
| `{response.body}` | Pierwsze 4000 znaków odpowiedzi jako tekst |
| `{response.data}` | Odpowiedź jako JSON. `null`, jeśli to nie jest JSON albo jest dłuższa niż 100 000 znaków. Listy adresujesz indeksem, na przykład `{response.data.items.0.id}` |

Drugie żądanie API w tym samym przepływie zastępuje `response`. Zmienne działają tak jak w [Zmienne i szablony](/automatiseringen/variabelen).

## Budowa przepływu [#de-opbouw-van-een-flow]

Automatyzacje możesz też tworzyć i zmieniać przez API. Operacje są w [OpenAPI](https://tillor.eu/api/openapi.json) pod tagiem `automations`. Odczyt wymaga uprawnienia `automations:read`, tworzenie i zmiana `automations:write` (albo wszystkich uprawnień). Sam użytkownik Przepływ pracy nigdy nie może ich wywołać. Wygodniej może być zbudować przepływ w edytorze i odczytać go jako przykład.

Nowa automatyzacja jest zawsze wyłączona. Włączenie przez `enabled` nie uda się, dopóki przepływ ma otwarte problemy, a włączonego przepływu nie można zapisać z problemami.

`definition` składa się z kroków (`nodes`), linii (`edges`) i opcjonalnie uwag (`notes`). Maksymalnie 100 kroków, 200 linii i 50 uwag.

```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
    }
  ]
}
```

Uwaga (`notes`) to wyjaśnienie na kanwie. Nigdy nie jest wykonywana i nie ma linii. `text` ma maksymalnie 2000 znaków, `width` i `height` są w pikselach.

Linia ma `sourceHandle`: wyjście kroku, z którego wychodzi.

| Stap (`type`) | Uitgangen (`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` | `id` każdej gałęzi, plus `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` |

Każda akcja oprócz `webhookSend` i `httpRequest` dostaje dodatkowe wyjście `error`, gdy `continueOnError` w `config` jest ustawione na `true`. Bez tego ustawienia nieudana akcja zatrzymuje wykonanie. Z tym ustawieniem przepływ kontynuuje przez `error`, ze zmiennymi `{error.message}` i `{error.step}` dla kolejnych kroków. Wyjście `skipped` jest używane, gdy krok nie miał nic do zrobienia, a `out` jest wtedy zwykłym wyjściem.

Przy `forEach` wyjście `each` uruchamia dla każdego elementu osobne wykonanie dla kolejnych kroków, a wyjście `done` jest zwykłą dalszą drogą samego przepływu.

Wyjście może prowadzić do wielu kroków. Wykonanie samo idzie dalej pierwszą linią i dla każdej innej linii uruchamia osobne wykonanie z tymi samymi danymi, które działa równolegle (tak jak wyjście `each` w `forEach`). Linie tworzące pętlę są odrzucane w edytorze. Przepływ ma dokładnie jeden `trigger`.

### Ustawienia kroków [#instellingen-per-stap]

Pola w `config` to pola z edytora. Pola tekstowe przyjmują zmienne w nawiasach klamrowych.

| Stap | Velden in `config` |
|---|---|
| `trigger` | `source` (`event`, `webhook`, `invoiceOverdue`, `dateReached`, `daily` lub `cron`), `webhookVersion` (przy `webhook`: tekst, zwiększ, aby zastąpić adres), `eventKey`, `date` (przy `dateReached`: ścieżka `record.veld` do kolumny `DateTime` modelu, który zdarzenie przesyła w całości, takiego jak `reservation.checkIn` lub `contact.birthday`, albo do zadeklarowanego klucza daty w kolumnie JSON, takiego jak `document.userMetadata.insuranceExpiryDate`; stare nazwy, takie jak `reservationCheckIn`, nadal działają), `dateOffset` (`{ "amount", "unit" }`), `dateDirection` (`before` lub `after`), `dateTime` (`exact`: godzina w dacie, albo `fixed`: dzień kalendarzowy daty w strefie czasowej organizacji, o `dateHour` i `dateMinute`, tekst taki jak `"9"` i `"0"`; przesunięcie liczy się na zegarze, a więc także przez zmianę czasu letniego i zimowego), `repeatYearly` (boolean: liczy się tylko dzień i miesiąc, co roku), `hour` i `minute` (tekst, na przykład `"8"` i `"0"`, minuta od 0 do 59), `cron` (pięć pól; dzień tygodnia może być `1#2` lub `1L`, szóste pole `W2:2026-10-05` powtarza co dwa tygodnie), `conditions`, `oncePerRecord` (boolean) |
| `condition` | `conditions` |
| `switch` | `field` (ścieżka zmiennej bez nawiasów klamrowych), `cases`: lista `{ "id", "key", "value" }`, gdzie `key` to nazwa gałęzi, a `value` to wartość, której pole musi być równe. Maksymalnie 8 gałęzi |
| `delay` | `mode` (`duration` lub `untilDate`), `duration` i `offset` jako `{ "amount", "unit" }`, gdzie `unit` to `seconds`, `minutes`, `hours`, `days` lub `weeks`, `dateField` (ścieżka zmiennej), `direction` (`before` lub `after`) |
| `taskCreate` | `title`, `description`, `assigneeIds`, `labelIds`, `assignActor`, `priority` (`LOW`, `MEDIUM`, `HIGH` lub `URGENT`), `viewId`, `laneId`, `subtasks` (jedno na wiersz), `dueIn` (`{ "amount", "unit" }`), `linkRecords` |
| `taskSetStatus` | `taskId`, `status` (`PENDING`, `IN_PROGRESS`, `WAITING` lub `COMPLETED`) |
| `taskFind` | `title` (dokładny tytuł), `linkedToRecords`, `onlyOpen`, `onlyTopLevel` (boolean) |
| `documentFind` | `customerId` (szablon), `documentType` (`INSURANCE_POLICY`, `INSURANCE_PAYMENT_PROOF`, `IDENTITY_CARD`, `SEPA_MANDATE`, `OTHER` lub puste), `onlyActive`, `onlyValid` (boolean). Wynik pod `foundDocument` |
| `documentUpdate` | `documentId` (szablon), `documentType` (puste zachowuje typ), `status` (`ACTIVE`, `ARCHIVED` lub puste) |
| `taskSetPriority` | `taskId`, `mode` (`raise`, `lower` lub `set`), `priority` (przy `set`), `maxPriority` (przy `raise`) |
| `taskUpdate` | `taskId`, `title`, `assigneeIds`, `assignActor`, `assigneeMode` (`add` lub `replace`), `labelIds`, `dueIn` (`{ "amount", "unit" }`, gdzie `unit` to `minutes`, `hours`, `days` lub `weeks`) |
| `invoiceReminderSend`, `invoiceSend`, `invoiceBook` | `invoiceId` |
| `invoicePrint` | `invoiceId`, `printer` (`a4`, `pos` lub `tablet`) |
| `paymentLinkCreate` | `invoiceId`, `method` (`any`, `BANCONTACT`, `IDEAL`, `CREDITCARD` lub `PAYCONIQ`) |
| `mandateRequest` | `customerId`, `mode` (`request` lub `reminder`) |
| `mandateCollect` | `invoiceId`, `delayDays` (tekst, domyślnie `"0"`, najwyżej 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` lub `task`), `taskId` (przy `task`) |
| `inboxReply` | `threadId`, `body`, `keepAssistant` |
| `inboxTag` | `threadId`, `tagIds`, `archive` |
| `customerUpdate` | `customerId`, `status` (`keep`, `DEFAULT`, `PREFERRED`, `VIP`, `WARNING` lub `BLACKLISTED`), `notes` |
| `reservationSetStatus` | `reservationId`, `action` (`checkIn`, `checkOut` lub `cancel`) |
| `accessMethodCreate` | `customerId`, `type` (`QR_CODE`, `LPR`, `PIN_CODE` lub `NFC`), `value`, `periodFrom`, `periodTo` (zmienne z datą, puste oznacza brak limitu) |
| `accessMethodUpdate` | `scope` (`one` lub `customer`), `accessMethodId` (przy `one`), `customerId` (przy `customer`), `status` (`keep`, `ACTIVE`, `SOFT_BLOCKED`, `BLOCKED` lub `INACTIVE`), `periodTo` |
| `accessMethodSendQr` | `accessMethodId`, `sendEmail`, `sendSms`, `sendWhatsApp`, `print` (`none`, `label` lub `thermal`) |
| `accessPointControl` | `accessPointId`, `action` (`open` lub `close`) |
| `meterSwitch` | `target` (`terrain` lub `meter`), `terrainId` (przy `terrain`), `meterId` (przy `meter`), `state` (`on` lub `off`) |
| `nfcTagUpdate` | `customerId`, `action` (`block`, `unblock`, `topUp` lub `lowBalance`), `amount` (przy `topUp`, w euro na tag) |
| `deviceCommand` | `deviceId`, `command` (`wake`, `sleep`, `reload`, `identify`, `testSound` lub `playSound`), `url` (przy `playSound`: ścieżka przesłanego dźwięku, tak jak wstawia ją edytor, albo link https do pliku mp3, wav lub m4a) |
| `deviceDisplay` | `kind` (`pdf` lub `image`), `url` (link https). Pojawia się na każdym tablecie ustawionym jako wyświetlacz, na przykład jako pdf faktury |
| `controllerRelay` | `target` (`controller` lub `event`: kontroler ze zdarzenia `controller:input:changed`, które uruchomiło przepływ), `controllerId` (przy `controller`), `relay` (tekst od `"1"` do `"6"`), `action` (`pulse`, `on` lub `off`), `durationSeconds` (przy `pulse`, tekst, od 0.001 do 3600 z ułamkami dziesiętnymi, takimi jak `"0.5"`; przekaźnik sam wraca do stanu spoczynku) |
| `controllerCommand` | `target` i `controllerId` jak przy `controllerRelay`, `command` (`reboot`, `rebootExtension`, `otaUpdate`, `forceOtaUpdate`, `extensionOtaUpdate` lub `refreshSettings`) |
| `deviceSlideshow` | `scope` (`displays` lub `device`), `mode` (`screensaver` lub `background`), `source` (`feed` lub `urls`). Przy `feed`: `itemsPath`, `imageField`, opcjonalnie pola filtrowania i sortowania |
| `openingHours`, `waitUntilOpen`, `waitUntilClosed` | Brak pól |
| `throttle` | `window` (`{ "amount", "unit" }`, gdzie `unit` to `minutes`, `hours`, `days` lub `weeks`), `key` (puste oznacza na rekord, który uruchomił przepływ) |
| `recordLookup` | `model` (`Customer`, `Reservation`, `Occupation`, `Invoice`, `Payment`, `Terrain`, `Task`, `Document`, `AccessMethod`, `NfcTag`, `Meter`, `InboxThread` lub `InboxMessage`), `recordId`. Wynik jest pod `found` plus model, na przykład `foundCustomer` |
| `forEach` | `source` (`customerAccessMethods`, `customerNfcTags`, `customerOpenInvoices`, `customerUpcomingReservations`, `customerOccupations`, `customerDocuments` (tylko `ACTIVE`) lub `terrainMeters`), `parentId` (identyfikator klienta lub terenu). Najwyżej 100 elementów, element jest pod `item` |
| `waitUntil` | `conditions`, `interval` i `timeout` (`{ "amount", "unit" }`, gdzie `unit` to `minutes`, `hours`, `days` lub `weeks`; interwał to co najmniej 5 minut) |
| `waitForEvent` | `eventKey`, `sameRecord` (boolean), `timeout` (`{ "amount", "unit" }`) |
| `approval` | `title`, `description`, `assigneeIds`, `timeout` (`{ "amount", "unit" }`). Zadanie jest pod `approvalTask.id` |
| Każda akcja oprócz `webhookSend` i `httpRequest` | `continueOnError` (boolean) |
| `webhookSend` | `webhookId`, `event`, `payload` (JSON jako tekst) |
| `httpRequest` | `target` (`tillor` lub `custom`), `method`, `path` (przy `tillor`), `url` (przy `custom`), `headers` (lista `{ "id", "key", "value" }`), `body` (JSON jako tekst) |

`conditions` ma postać `{ "match": "all" lub "any", "rules": [...] }`. Każda reguła to `{ "id", "field", "operator", "value", "values" }`. `operator` to `is`, `isNot`, `contains`, `greaterThan`, `lessThan`, `isOneOf`, `isEmpty` lub `isNotEmpty`. `values` używasz tylko przy `isOneOf`. Pusta lista reguł przepuszcza wszystko.

## Uruchamianie automatyzacji webhookiem [#een-automatisering-starten-met-een-webhook]

Automatyzacja z triggerem `webhook` uruchamia się po `POST` na jej własny adres:

```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"}'
```

- Pełny adres jest w edytorze przy triggerze albo przez `GET /automations/{id}/webhook-url` (z `automations:read`). Token jest sekretem; nagłówek do uwierzytelniania nie jest potrzebny
- Treść JSON staje się zmienną `body`, query string zmienną `query`, a moment odebrania zmienną `receivedAt`
- Odpowiedź `200` z `{ "accepted": true }`, gdy tylko wykonanie zostanie uruchomione. Błędny, zastąpiony lub wyłączony adres zwraca `404`, treść powyżej 100 KB zwraca `400`
- Wiele wywołań w krótkim czasie nie jest odrzucanych: każde ważne wywołanie uruchamia wykonanie. Użyj **Ignoruj powtórzenia** przy triggerze, jeśli to samo wywołanie może przyjść dwa razy, zobacz [Ignorowanie powtórzeń](/automatiseringen/triggers#herhalingen-negeren)

Automatyzacja nie może wywołać własnego webhooka przez **Żądanie API** do API Tillor.

## Wybór decyzji przez API [#een-beslissing-kiezen-via-de-api]

Zadanie kroku **Poproś o decyzję** ma jedną akcję na każdą opcję ustawioną w kroku. Pobierz zadanie, aby zobaczyć `actions` z ich `id`, i wybierz jedną przez `POST /tasks/{id}/actions/{actionId}/choose`. Jeśli opcja wymaga notatki, wyślij ją jako `{ "note": "..." }`. Wybór jest ostateczny: kończy zadanie i prowadzi automatyzację dalej wyjściem tej opcji. Wybierać mogą przypisani współpracownicy (także przez grupę) i administratorzy. Szczegóły w [OpenAPI](https://tillor.eu/api/openapi.json).

## Więcej do przeczytania [#meer-lezen]

- [Webhooki](/ontwikkelaars/webhooks) o podpisie, ponowieniach i liście zdarzeń
- [HTTP API](/ontwikkelaars/http) o uwierzytelnianiu i kontekście organizacji
- [Zmienne i szablony](/automatiseringen/variabelen) jako opis dla użytkowników


# Event-index (/pl-PL/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>


# Powiadomienia zewnętrzne (/pl-PL/ontwikkelaars/externe-notificaties)

Czy Twój system sam wysyła e-maile do klientów (newsletter, potwierdzenie rezerwacji, przypomnienie)? Zarejestruj je w Tillor. Pracownicy widzą je przy kliencie, na fakturze i w przeglądzie **Powiadomienia**, obok powiadomień wysyłanych przez sam Tillor.

Tillor **niczego nie wysyła**: rejestrujesz wiadomość, która została już wysłana. Powiadomienia zewnętrzne zawsze mają w aplikacji etykietę **Zewnętrzne** z nazwą Twojego źródła, dzięki czemu nigdy nie zostaną wzięte za powiadomienie Tillor.

## Dostęp [#toegang]

Użytkownik stojący za [kluczem API](/ontwikkelaars/http) potrzebuje w organizacji jednego z tych uprawnień. Administrator przyznaje je w uprawnieniach użytkowników organizacji, w grupie **Powiadomienia** (**Rejestrowanie powiadomień zewnętrznych** i **Zarządzanie powiadomieniami zewnętrznymi innych**).

| Permissie | Wat mag je |
|-----------|------------|
| `notifications:external:write` | Rejestrowanie powiadomień oraz aktualizowanie lub usuwanie **własnych** rejestracji |
| `notifications:external:manage-others` | Także aktualizowanie lub usuwanie rejestracji innych użytkowników lub integracji |

<Callout type="info" title="Jeden użytkownik na integrację">
Własność jest przypisana do użytkownika klucza API. Używaj dla każdej integracji osobnego użytkownika (usługowego), wtedy jedna integracja nigdy nie zmieni powiadomień innej.
</Callout>

## Endpointy [#endpoints]

Wszystkie ścieżki są pod `/api/orgs/:orgId`. Dokładne schematy: [OpenAPI](https://tillor.eu/api/openapi.json), tag `notifications`.

| Method | Pad | Beschrijving |
|--------|-----|--------------|
| POST | `/notifications/external` | Rejestracja powiadomienia |
| PATCH | `/notifications/external/{id}` | Aktualizacja statusu, czasów lub treści |
| DELETE | `/notifications/external/{id}` | Trwałe usunięcie |
| GET | `/notifications?source=EXTERNAL` | Lista zarejestrowanych powiadomień (filtruj też po `externalSource`, `externalReference`, `customerId`, `invoiceId`) |
| GET | `/notifications/{id}` | Pobranie jednego powiadomienia |

Powiadomień wysłanych przez sam Tillor nie możesz przez te endpointy zmienić ani usunąć; zwracają `404`.

## Rejestrowanie [#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 }]
    }
  }'
```

Wszystkie pola i limity znajdziesz w [OpenAPI](https://tillor.eu/api/openapi.json). Te pola mają reguły, które warto znać z góry:

| Veld | Regel |
|------|-------|
| `externalSource` | Nazwa Twojego systemu małymi literami, cyfry, `.`, `_` lub `-` (np. `mailchimp`). Pracownicy widzą tę nazwę przy powiadomieniu |
| `externalReference` | Twój własny identyfikator tej wiadomości, unikalny w obrębie `externalSource` |
| `name` | Krótka etykieta dla pracowników (np. „Boekingsbevestiging”). Można po niej wyszukiwać |
| `customerId` / `invoiceId` | Przynajmniej jedno z nich. Określa, gdzie powiadomienie się pojawi. Jeśli wyślesz tylko `invoiceId`, Tillor powiąże też klienta tej faktury. Nieznany identyfikator lub faktura innego klienta zwraca `400` |
| `status` | `SENT`, `FAILED`, `BOUNCED` lub `COMPLAINED`. Bez `sentAt` przy `SENT` Tillor używa momentu rejestracji |
| `sentAt`, `readAt`, `clickedAt` | ISO 8601 ze strefą czasową, np. `2026-09-19T08:15:00Z`. Inne wartości są odrzucane |
| `email.attachments` | Tylko metadane (`filename`, `contentType`, `size`). Same pliki nie są zapisywane |

### Bezpieczne ponawianie [#veilig-opnieuw-proberen]

`POST` jest idempotentny dla `externalSource` + `externalReference`. Jeśli wyślesz tę samą kombinację ponownie (na przykład po przekroczeniu czasu), otrzymasz **istniejące** powiadomienie i nic się nie zmieni. Aby coś zmienić, użyj `PATCH`.

<Callout type="warn" title="Bez danych osobowych w externalReference ani name">
`externalSource`, `externalReference` i `name` są zapisywane bez szyfrowania, ponieważ można po nich wyszukiwać. Używaj identyfikatora technicznego, nie adresu e-mail ani nazwiska. `externalReference` zawierający `@` jest odrzucany. Odbiorca, temat, treść i załączniki są natomiast zapisywane w postaci zaszyfrowanej.
</Callout>

## Aktualizacja i usuwanie [#bijwerken-en-verwijderen]

Przy `PATCH` wysyłaj tylko pola, które się zmieniają, na przykład gdy e-mail po czasie zostanie odrzucony:

```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` usuwa powiadomienie trwale, razem z treścią. Użyj go także, aby spełnić żądanie usunięcia danych (RODO).

`PATCH`, który niczego nie zmienia, nic nie robi: brak zmiany, brak zdarzenia. Jeśli zmienisz treść (etykietę, odbiorcę, nadawcę, temat, tekst, HTML lub załączniki) albo usuniesz powiadomienie, zostanie to zapisane w dzienniku aktywności klienta lub faktury, wraz z użytkownikiem, który to zrobił. Aktualizacje statusu, `readAt` lub `clickedAt` tam nie trafiają, dzięki czemu możesz dalej synchronizować otwarcia i kliknięcia.

## HTML i prywatność [#html-en-privacy]

Tillor pokazuje pracownikom HTML tak, jak otrzymał go klient, ale traktuje go jak treść niezaufaną:

- Przy zapisie usuwane są skrypty, formularze, iframe, embedy i atrybuty zdarzeń (`onclick`, ...). Linki otwierają się w nowej karcie
- Podgląd działa w odizolowanej ramce, bez skryptów i bez dostępu do sesji Tillor
- Zewnętrzne obrazy i czcionki **nie ładują się automatycznie**, więc otwarcie powiadomienia nie uruchamia piksela śledzącego. Pracownik może załadować obrazy dla każdego powiadomienia osobno

Nie licz więc na to, że śledzenie „otwarcia” w Twoim systemie zadziała, gdy pracownik obejrzy powiadomienie.

## Czego Tillor nie robi z powiadomieniami zewnętrznymi [#wat-tillor-niet-doet-met-externe-notificaties]

- Nie wysyła ich (ponownie) i nie ponawia automatycznie
- Nie pobiera aktualizacji statusu od Twojego dostawcy poczty: status aktualizujesz sam przez `PATCH`
- Nie wlicza ich do list **Nieudane powiadomienia**, **Odrzucone powiadomienia** i **Oczekujące powiadomienia** ani do liczników na górze przeglądu powiadomień, ponieważ Tillor nie może zweryfikować Twojego statusu. Są natomiast w sekcji **Ostatnia komunikacja**

## Webhooki i SSE [#webhooks-en-sse]

| Event | Wanneer |
|-------|---------|
| `notification-delivery:updated` | Przy rejestracji i przy każdym `PATCH`, który coś zmienia. Zawiera pełne powiadomienie |
| `notification-delivery:deleted` | Przy `DELETE`. Zawiera tylko `id`, `source`, `externalSource`, `externalReference`, `customerId` i `invoiceId` |

Pole `source` to `EXTERNAL` dla Twoich rejestracji i `INTERNAL` dla powiadomień Tillor. Filtruj po nim, jeśli chcesz pomijać własne zdarzenia. Zobacz [Webhooki](/ontwikkelaars/webhooks) i [SSE](/ontwikkelaars/sse).

## Powiązane [#gerelateerd]

- [HTTP API](/ontwikkelaars/http) - Klucze API, nagłówki i limity żądań
- [Webhooki](/ontwikkelaars/webhooks) - Odbieranie zdarzeń przez HTTP POST
- [OpenAPI](https://tillor.eu/api/openapi.json) - Pełne schematy


# HTTP API (/pl-PL/ontwikkelaars/http)

API Tillor to REST API. Uwierzytelniaj się kluczem API i wysyłaj odpowiednie nagłówki przy każdym żądaniu. Klucze API są przypisane **do konta** - jeden klucz działa dla wszystkich organizacji, do których masz dostęp.

## Dokumentacja API i OpenAPI [#api-referentie-en-openapi]

- **[Dokumentacja API](/api-referentie)** - Każdy endpoint z parametrami i przykładami; wypróbuj żądania bezpośrednio w przeglądarce
- **[Specyfikacja OpenAPI](https://tillor.eu/api/openapi.json)** - Pełna dokumentacja API w formacie JSON do generowania kodu lub importu do Postmana/Insomnii

---

## Klucze API [#api-sleutels]

### Tworzenie [#aanmaken]

Klucze API tworzysz w aplikacji Tillor w menu użytkownika w sekcji **Konto > Klucze API** (znacznik **1** = menu, znacznik **2** = Klucze API na zrzucie ekranu). Możesz je też utworzyć przez API z zalogowaną sesją (bez klucza API). Ścieżki oraz schematy żądań i odpowiedzi znajdziesz w [specyfikacji OpenAPI](https://tillor.eu/api/openapi.json) pod tagiem `api-keys`.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Klucze API w ustawieniach konta" />

Surowy klucz jest zwracany **jednorazowo** przy tworzeniu lub ponownym generowaniu. Przechowuj go bezpiecznie; później nie można go już pobrać.

### Ograniczanie uprawnień [#rechten-beperken]

Domyślnie klucz może wszystko, co możesz Ty sam, w każdej organizacji, do której należysz. W oknie klucza włącz **Ogranicz do wybranych uprawnień** i wybierz uprawnienia potrzebne integracji, na przykład tylko odczyt faktur. Ograniczony klucz otrzymuje w każdej organizacji część wspólną swoich uprawnień i Twojego członkostwa w niej: klucz nigdy nie może więcej niż Ty. Wywołanie poza wybranymi uprawnieniami zwraca `403 Forbidden`, tak samo jak dla użytkownika bez tego uprawnienia. Zmiana uprawnień obowiązuje w ciągu minuty. Przez API: `scopes` (lista identyfikatorów uprawnień, takich jak `invoices:read`, albo `null` dla wszystkich) przy tworzeniu i aktualizacji klucza.

### Użycie [#gebruik]

Wysyłaj klucz API w nagłówku `x-api-key`:

```http
x-api-key: tkn_xxx
```

Klucze mają prefiks `tkn_`. W endpointach organizacji identyfikator organizacji jest w ścieżce (`/orgs/org_abc123/...`); osobny nagłówek nie jest potrzebny.

### Limity żądań (rate limits) [#rate-limits]

- **Domyślnie:** 5000 żądań na 60 sekund na klucz
- Po przekroczeniu: `429 Too Many Requests` z `Retry-After`
- Każda odpowiedź dla klucza API zawiera nagłówki IETF `RateLimit-*`:

```http
RateLimit-Limit: 5000
RateLimit-Remaining: 4999
RateLimit-Reset: 58
RateLimit-Policy: 5000;w=60
```

`RateLimit-Reset` to liczba sekund do rozpoczęcia nowego okna. Klienci w przeglądarce mogą odczytać te nagłówki przez CORS (`Access-Control-Expose-Headers`).

### Bezpieczeństwo [#beveiliging]

<Callout type="warn" title="Uwaga">
- **Nigdy** nie ujawniaj kluczy API w kodzie po stronie klienta ani w publicznych repozytoriach
- Regularnie generuj klucze ponownie przez **Wygeneruj ponownie** w aplikacji (OpenAPI: `POST /api/api-keys/:id/renew`)
- Usuwaj nieużywane klucze przez `DELETE /api/api-keys/:id`
</Callout>

---

## Base URL i kontekst organizacji [#base-url-en-organisatie-context]

**Base URL:** `https://tillor.eu` (lub adres URL Twojego wdrożenia; OpenAPI podaje `{APP_URL}/api`)

**Ścieżki organizacji:** dodaj identyfikator organizacji do ścieżki:

```
/api/orgs/:orgId/...
```

**Przykład:**

```
GET https://tillor.eu/api/orgs/org_abc123/customers
```

**Wymagany nagłówek dla endpointów organizacji:** `x-api-key: tkn_xxx`. Identyfikator organizacji jest w ścieżce.

---

## Przykład: 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"
```

---

## Integracje (marketplace) [#integraties-marketplace]

Integracje organizacji (dawniej „apps” w API) używają jednego zasobu na typ pod `/api/orgs/:orgId/integrations/{integrationType}`. Wymagane uprawnienia to `organization:integrations:read` i `organization:integrations:write` (zastępują `organization:apps:*`).

| Method | Pad | Beschrijving |
|--------|------|-------------|
| GET | `/integrations/{integrationType}` | Status (`installed`, `available`) i zredagowane `settings` |
| POST | `/integrations/{integrationType}` | Instalacja (opcjonalnie `settings` w body; OAuth może zwrócić `redirectUrl`) |
| PUT | `/integrations/{integrationType}` | Aktualizacja ustawień (`settings` w body) |
| DELETE | `/integrations/{integrationType}` | Odinstalowanie |

Przy `GET` i po `PUT` pole `settings` zawiera tylko pola **publiczne** oraz dla każdego pola tajnego `{ configured: true }`. Hasła, klucze API i tokeny OAuth nie są zwracane. Zostaw pola tajne puste przy `PUT`, aby zachować istniejącą wartość.

Dokładne schematy znajdziesz w [specyfikacji OpenAPI](https://tillor.eu/api/openapi.json) (tag `integrations`).

---

## Powiązane [#gerelateerd]

- [Dokumentacja API](/api-referentie) - Każdy endpoint, do wypróbowania w przeglądarce
- [OpenAPI](https://tillor.eu/api/openapi.json) - Specyfikacja API (JSON)
- [MCP](/ontwikkelaars/mcp) - Połącz Cursor, Claude, ChatGPT lub Gemini przez OAuth
- [Powiadomienia zewnętrzne](/ontwikkelaars/externe-notificaties) - Rejestruj e-maile wysłane przez Twój własny system
- [Webhooki](/ontwikkelaars/webhooks) - Odbieraj zdarzenia przez HTTP POST
- [Przychodzący webhook automatyzacji](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - Uruchom automatyzację przez POST, bez klucza API
- [SSE](/ontwikkelaars/sse) - Strumieniuj zdarzenia przez Server-Sent Events
- [Przykłady](/ontwikkelaars/voorbeelden) - Przykłady kodu i payloadów


# Przegląd (/pl-PL/ontwikkelaars)

API Tillor zapewnia programistyczny dostęp do danych Twojej organizacji. Używaj kluczy API do uwierzytelniania, webhooków do zdarzeń wychodzących, SSE lub MQTT do strumieniowania w czasie rzeczywistym albo MCP, aby połączyć z Tillor narzędzia AI, takie jak Cursor, Claude, ChatGPT i Gemini.

## Co możesz zbudować? [#wat-kun-je-bouwen]

- **Integracje** - Połącz Tillor z własnymi systemami przez REST API
- **Webhooki** - Otrzymuj wiadomości HTTP POST, gdy zachodzą zdarzenia (faktura opłacona, klient utworzony itd.)
- **Uruchamianie automatyzacji** - Uruchom automatyzację z własnego systemu, wysyłając POST na jej [przychodzący webhook](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook)
- **Pulpity w czasie rzeczywistym** - Strumieniuj zdarzenia przez SSE lub MQTT, aby aktualizować dane w aplikacji na żywo
- **Narzędzia AI** - Pozwól Cursorowi, Claude, ChatGPT lub Gemini wywoływać API przez [MCP](/ontwikkelaars/mcp) (`https://mcp.tillor.dev`)

## Szybki start [#snel-aan-de-slag]

1. **Utwórz klucz API** w Tillor w sekcji *Konto > Klucze API*
2. **Wysyłaj klucz** w nagłówku `x-api-key` przy każdym żądaniu
3. **Umieść identyfikator organizacji w ścieżce** endpointów organizacji: `/orgs/org_abc123/...`

<Callout type="info" title="Te same zdarzenia">
Webhooki i SSE dostarczają dokładnie te same zdarzenia. Różnica: webhooki wysyłają HTTP POST na Twój adres URL, a SSE to długie połączenie, przez które odbierasz zdarzenia.
</Callout>

**Przydatne linki:** [Dokumentacja API](/api-referentie) - [OpenAPI](https://tillor.eu/api/openapi.json)

**Zakres:** klucze API są przypisane do konta (wszystkie organizacje); webhooki są przypisane do organizacji.

<Callout type="idea" title="Dokumentacja dla narzędzi AI">
Tę stronę możesz też wykorzystać jako tekst dla narzędzi AI: [`/llms.txt`](/llms.txt) (indeks), [`/llms-full.txt`](/llms-full.txt) (wszystkie strony razem) oraz pojedyncze strony, dopisując `.mdx` na końcu ścieżki (na przykład [`/ontwikkelaars/http.mdx`](/ontwikkelaars/http.mdx)). **Zapytaj AI (lokalnie)** w układzie dokumentacji ładuje pełny eksport (`/llms-full.txt`) do wbudowanego AI w Chrome, dzięki czemu nie musisz być na konkretnej stronie.
</Callout>

## Zobacz też [#zie-ook]

<Cards>
  <Card
    title="HTTP API"
    href="/ontwikkelaars/http"
    description="Klucze API, uwierzytelnianie, base URL i kontekst organizacji"
  />
  <Card
    title="MCP"
    href="/ontwikkelaars/mcp"
    description="Połącz Cursor, Claude, ChatGPT lub Gemini z Tillor przez OAuth"
  />
  <Card
    title="Powiadomienia zewnętrzne"
    href="/ontwikkelaars/externe-notificaties"
    description="Rejestruj e-maile, które Twój własny system wysłał do klientów"
  />
  <Card
    title="Webhooki"
    href="/ontwikkelaars/webhooks"
    description="Odbieraj zdarzenia przez HTTP POST na swój endpoint"
  />
  <Card
    title="Automatyzacje"
    href="/ontwikkelaars/automatiseringen"
    description="Wiadomość webhooka, żądanie API, przychodzące webhooki i budowa przepływu"
  />
  <Card
    title="SSE"
    href="/ontwikkelaars/sse"
    description="Strumieniuj zdarzenia w czasie rzeczywistym przez Server-Sent Events"
  />
  <Card
    title="MQTT"
    href="/ontwikkelaars/mqtt"
    description="Pub/sub przez MQTT ze ścisłym dostępem do tematów i JWT lub statycznymi danymi uwierzytelniającymi"
  />
  <Card
    title="Metadane Mollie"
    href="/ontwikkelaars/mollie-metadata"
    description="Przestrzeń nazw tillor w płatnościach Mollie"
  />
  <Card
    title="API czatu na stronie"
    href="/ontwikkelaars/website-chat"
    description="Własny interfejs czatu przez REST i SSE"
  />
  <Card
    title="Przykłady"
    href="/ontwikkelaars/voorbeelden"
    description="Przykłady kodu i payloadów dla HTTP, webhooków i SSE"
  />
</Cards>


# MCP (/pl-PL/ontwikkelaars/mcp)

Dzięki MCP (Model Context Protocol) narzędzia takie jak Cursor, Claude, ChatGPT i Gemini mogą wywoływać API Tillor w Twoim imieniu. Logujesz się raz przez OAuth; w konfiguracji nie musi być klucza API.

**URL:** `https://mcp.tillor.dev`

## Co możesz zrobić [#wat-je-ermee-kunt]

Po połączeniu w narzędziu AI możesz:

1. Przeglądać kategorie API i endpointy (z specyfikacji OpenAPI)
2. Wywoływać endpointy z własnymi uprawnieniami w wybranej organizacji

Odbywa się to przez to samo REST API co [HTTP API](/ontwikkelaars/http). To, co możesz zrobić, zależy od Twojego konta Tillor i uprawnień w tej organizacji. Połączenie przez OAuth wymaga uprawnienia **Autoryzacja aplikacji OAuth** (`oauth:consent`) w co najmniej jednej organizacji. Bez tego uprawnienia zgoda się nie powiedzie, a istniejące tokeny OAuth przestaną działać.

## Uwierzytelnianie [#authenticatie]

1. Narzędzie łączy się z `https://mcp.tillor.dev` bez tokenu
2. Wykrywanie OAuth i rejestracja odbywają się na hoście MCP; logowanie i zgoda w Tillor
3. Zatwierdzasz dostęp w przeglądarce
4. Następnie narzędzie wysyła token Bearer przy wywołaniach MCP

Jeśli narzędzie to obsługuje (Cursor, Gemini CLI), przekaż organizację w nagłówku:

```http
X-Tillor-Org-Id: org_abc123
```

Bez tego nagłówka (ChatGPT, aplikacja Gemini, Claude) przekazujesz `organizationId` w `call_api_endpoint`. Trasy organizacji znajdują się pod `/orgs/{organizationId}`; API samo uzupełnia wtedy nagłówek.

<Callout type="info" title="Klucz API nie jest potrzebny">
Dla hostowanego serwera MCP używasz OAuth (Connect / Authorize w narzędziu). W skryptach i własnych integracjach nadal używaj [kluczy API](/ontwikkelaars/http).
</Callout>

## Łączenie [#koppelen]

Wybierz swoje narzędzie:

<McpProviderGuide />

Możesz też otworzyć [selektor instalacji](https://install.apicommons.org/?config=eyJuYW1lIjoiVGlsbG9yIiwiZGVzY3JpcHRpb24iOiJUaWxsb3IgUkVTVCBBUEkgdmlhIE9BdXRoIiwicmVtb3RlIjp7InR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudGlsbG9yLmRldi9tY3AiLCJoZWFkZXJzIjp7IlgtVGlsbG9yLU9yZy1JZCI6Ijxvcmdhbml6YXRpb25JZD4ifX19) dla Cline, Zed, Warp, Codex i pozostałych.

## Narzędzia [#tools]

| Narzędzie | Cel |
|------|------|
| `list_api_categories` | Lista kategorii API |
| `list_api_endpoints` | Endpointy w kategorii, ze schematem wejścia |
| `get_api_endpoint_schema` | Schemat jednego endpointu według nazwy |
| `call_api_endpoint` | Wywołuje endpoint |

Nazwy endpointów nie są osobnymi narzędziami: użyj `call_api_endpoint`.

Pełną dokumentację REST nadal stanowi [OpenAPI](https://tillor.eu/api/openapi.json). MCP to warstwa nad nim, a nie osobne API produktu.

## Powiązane [#gerelateerd]

- [HTTP API](/ontwikkelaars/http) - Klucze API, nagłówki i base URL
- [OpenAPI](https://tillor.eu/api/openapi.json) - Pełna specyfikacja API
- [Dokumentacja API](/api-referentie) - Każdy endpoint, do wypróbowania w przeglądarce


# Metadane Mollie (/pl-PL/ontwikkelaars/mollie-metadata)

Mollie zapisuje metadane przy każdej płatności. Tillor odczytuje i zapisuje pola w przestrzeni nazw `tillor`. Powiązanie w aplikacji: [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).

Są trzy rodzaje:

1. **Metadane powiązania** - Tillor zapisuje je z powrotem w Mollie, aby płatność była rozpoznawalna
2. **Wskazówki ingestii** - ustawiasz je przy tworzeniu płatności Mollie
3. **Bezpośrednie metadane księgowe** - pominięcie Tillor w drodze do księgowości

## Metadane powiązania [#koppelingsmetadata]

```json
{
  "tillor": {
    "paymentId": "clx123...",
    "invoiceId": "clx456...",
    "customerId": "clx789...",
    "paymentGroupId": "clxgrp..."
  }
}
```

Tillor dopisuje `paymentId`, `invoiceId`, `customerId` i `paymentGroupId` w Mollie, gdy tylko płatność zostanie powiązana z fakturą, klientem lub [grupą płatności](/betalingsverwerking/groepen). Istniejące metadane inne niż Tillor pozostają bez zmian.

| Pole | Opis |
|------|---------------|
| `paymentId` | Płatność w Tillor |
| `invoiceId` | Faktura w Tillor |
| `customerId` | Klient w Tillor |
| `paymentGroupId` | Grupa płatności, także gdy grupa nie jest jeszcze powiązana z fakturą |

## Wskazówka ingestii: `descriptionSuffix` [#ingestie-hint-descriptionsuffix]

Ustawiasz ją sam przy tworzeniu płatności Mollie. Tillor używa jej w opisie płatności, gdy istnieje powiązanie z fakturą.

```json
{
  "tillor": {
    "descriptionSuffix": "Parkeerplaats P1"
  }
}
```

Format w Tillor: `INV/XXXX/XXXX - {suffix}`.

## Wskazówki ingestii dla grup płatności [#ingestie-hints-voor-betalingsgroepen]

Przydatne przy zmianach POS lub aktywnościach: zgrupuj wiele płatności, zanim zaksięgujesz fakturę.

```json
{
  "tillor": {
    "paymentGroupName": "Yoga sunrise - Lake Como",
    "paymentGroupExternalId": "act_42"
  }
}
```

Wystarczy jedno z pól. Oba razem są lepsze, gdy etykieta może się zmienić, a ID ma pozostać stabilne.

| Pole | Opis |
|------|---------------|
| `paymentGroupName` | Widoczna etykieta w Tillor. Dopasowuje istniejące otwarte grupy po nazwie albo staje się etykietą nowej grupy |
| `paymentGroupExternalId` | Stabilny klucz z Twojego systemu. Dopasowanie następuje po nim zamiast po nazwie; etykieta podąża za `paymentGroupName` |

1. Tillor szuka **otwartej** grupy z tym zewnętrznym ID (lub, bez ID, z tą nazwą).
2. Brak dopasowania? Powstaje nowa otwarta grupa. Jej nazwą jest `paymentGroupName`, a w razie braku `paymentGroupExternalId`.
3. Płatność trafia do grupy, gdy tylko zostanie w Tillor **opłacona**.
4. Grupy, które są już powiązane z fakturą, nie są ponownie używane.

Jeśli wskazówek nie było jeszcze w płatności Mollie, gdy Tillor zobaczył ją po raz pierwszy, grupa i tak zostanie uzupełniona, gdy płatność będzie **opłacona**, **nie** będzie powiązana z fakturą i **nie** będzie jeszcze w grupie. Dzieje się to przy następnej synchronizacji lub po przychodzącym powiadomieniu z Mollie.

<Callout type="info" title="Kiedy tego używać?">
Oznaczaj każdą płatność Mollie z poziomu swojego POS. Grupa pojawi się w *Administracja > Płatności*, w sekcji *Grupy płatności*.
</Callout>

<Callout type="warn" title="Nie łącz z invoiceId">
Zgrupowanej płatności nie można osobno powiązać z fakturą. Jeśli wyślesz jednocześnie wskazówki grupy i `invoiceId`, wygrywa grupa.
</Callout>

## Bezpośrednie metadane księgowe (`tillor.bookkeeping`) [#directe-boekhoudmetadata-tillorbookkeeping]

Nieznane płatności Mollie trafiają domyślnie na rachunek przejściowy **499000**. Dzięki `tillor.bookkeeping` Tillor księguje je na wskazanego klienta:

```json
{
  "tillor": {
    "bookkeeping": {
      "customerCode": "100001",
      "documentType": "INV",
      "department": "a",
      "fiscalYear": "2026",
      "documentNumber": "00042"
    }
  }
}
```

| Pole | Opis |
|------|---------------|
| `customerCode` | Kod klienta w księgowości - wymagane |
| `documentType` | Np. INV, UF |
| `department` | Dział |
| `fiscalYear` | Rok obrotowy |
| `documentNumber` | Numer dokumentu |

Jeśli `bookkeeping` jest obecne, płatność **nie** trafia do Tillor jako zwykła płatność. Metadane są używane przy tworzeniu raportu księgowego.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Mollie (aplikacja)" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Grupy płatności" href="/betalingsverwerking/groepen" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
</Cards>


# MQTT (/pl-PL/ontwikkelaars/mqtt)

Dane uwierzytelniające MQTT dają integracjom dostęp pub/sub w przestrzeni nazw tematów Twojej organizacji. Tworzysz je w Tillor w **Konto > Dla deweloperów** (dla każdej organizacji). Dostęp do tematów jest ograniczony do `tillor/{env}/{orgId}/integration` i podtematów (`{env}` = `prod`, `staging` lub `local`), chyba że statyczne dane uwierzytelniające mają `topicPrefix: null`.

Dla tych samych zdarzeń czasu rzeczywistego co [webhooki](/ontwikkelaars/webhooks) i [SSE](/ontwikkelaars/sse) używaj tych kanałów, a nie MQTT.

## Zarządzanie [#beheer]

| Metoda | Ścieżka | Opis |
|--------|------|---------------|
| POST | `/api/orgs/:orgId/mqtt/credentials` | Generowanie danych JWT (tymczasowych) |
| GET | `/api/orgs/:orgId/mqtt/static-credentials` | Pobranie statycznych danych uwierzytelniających |
| POST | `/api/orgs/:orgId/mqtt/static-credentials` | Utworzenie statycznych danych uwierzytelniających |
| DELETE | `/api/orgs/:orgId/mqtt/static-credentials/:id` | Usunięcie statycznych danych uwierzytelniających |

Uwierzytelnianie: `x-api-key`, z ID organizacji w ścieżce (tak samo jak w [HTTP API](/ontwikkelaars/http)). Pełne schematy żądań i odpowiedzi znajdziesz w [specyfikacji OpenAPI](https://tillor.eu/api/openapi.json).

## Dane uwierzytelniające [#credentials]

Są dwa warianty:

### JWT (tymczasowe) [#jwt-tijdelijk]

- **Zastosowanie:** Krótkie sesje, tymczasowy dostęp
- **Ważność:** Domyślnie 1 godzina; konfigurowalna od 1 minuty do 24 godzin przez `expiresInSeconds`
- **Idealne do:** Testów, tymczasowych połączeń lub gdy pobierasz tokeny dynamicznie
- **Tworzenie:** W Tillor w **Konto > Dla deweloperów** lub przez `POST /api/orgs/:orgId/mqtt/credentials` z opcjonalnym `{ "clientId": "...", "expiresInSeconds": 3600 }`
- **Odpowiedź:** `token` (użyj jako hasła MQTT), `clientId`, `brokerUrl`, `topicPrefix`, `expiresAt`
- **Nazwa użytkownika:** Zostaw puste przy łączeniu; uwierzytelnianie JWT używa tylko tokenu jako hasła.
- **ID klienta:** Przy łączeniu użyj dokładnie `clientId` z odpowiedzi (wraz z prefiksem środowiska, np. `prod-`).

Połączenie z brokerem przez **mqtts** sprawdza certyfikat serwera. Jeśli używasz **prywatnego** certyfikatu CA (a nie standardowego publicznego łańcucha), umieść PEM tego CA w środowisku swojego klienta.

### Statyczne dane uwierzytelniające [#statische-credentials]

- **Zastosowanie:** Długotrwałe integracje, połączenia zawsze włączone
- **Postać:** Stałe userName, clientId i password
- **Idealne do:** Integracji produkcyjnych, które pozostają stale połączone
- **Tworzenie:** W Tillor w **Konto > Dla deweloperów** lub przez `POST /api/orgs/:orgId/mqtt/static-credentials` z opcjonalnym `{ "name": "mijn-integratie", "topicPrefix": null }`
- **Odpowiedź:** `userName`, `clientId`, `password` (jednorazowo), `topicPrefix` (`null` = brak prefiksu, ACL `#`), opcjonalnie `brokerUrl`
- **Uwaga:** Hasło jest pokazywane tylko raz w odpowiedzi i później nie można go już pobrać

---

## Dostęp do tematów [#topic-toegang]

Subskrypcje tematów są **ściśle ograniczone**, chyba że `topicPrefix` ma wartość `null` (ACL `#`). Domyślnie możesz publikować i subskrybować tylko `tillor/{env}/{orgId}/integration` oraz `tillor/{env}/{orgId}/integration/#`.

- **Dozwolone tematy** - Tylko `tillor/{env}/{orgId}/integration` i podtematy (np. `tillor/{env}/{orgId}/integration/connector/access-point-operation`)
- **Brak obejścia przez wildcard** - Nawet z `#` lub `+` masz dostęp tylko do przestrzeni nazw swojej organizacji
- **Per organizacja** - Dane uwierzytelniające są przypisane do organizacji; nie masz dostępu do tematów innych organizacji

---

## Powiązane [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Pełna specyfikacja API
- [HTTP API](/ontwikkelaars/http) - REST API i klucze API
- [Webhooki](/ontwikkelaars/webhooks) - Te same zdarzenia przez HTTP POST
- [SSE](/ontwikkelaars/sse) - Strumieniowanie zdarzeń przez Server-Sent Events


# OAuth-clients (/pl-PL/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) (/pl-PL/ontwikkelaars/sse)

SSE udostępnia długotrwały strumień tych samych zdarzeń, które otrzymują [webhooki](/ontwikkelaars/webhooks). Użyj SSE, gdy wolisz trwałe połączenie od wywołań zwrotnych HTTP.

## Endpoint [#endpoint]

```
GET /api/orgs/:orgId/realtime/subscribe
```

## Uwierzytelnianie [#authenticatie]

SSE używa tego samego uwierzytelniania co pozostałe endpointy API:

- **x-api-key** - Twój klucz API

ID organizacji znajduje się w ścieżce URL.

## Filtrowanie zdarzeń [#event-filtering]

Użyj parametru zapytania `events`, aby filtrować według typu zdarzenia:

```
GET /api/orgs/:orgId/realtime/subscribe?events=invoice:created&events=invoice:paid
```

Użyj `events=*`, aby otrzymywać wszystkie zdarzenia (tak samo jak przy pominięciu parametru).

Wszystkie zdarzenia, uprawnienie dla każdego zdarzenia i przykładowy payload znajdziesz w [indeksie zdarzeń](/ontwikkelaars/events).

Kilka zdarzeń ma własny kanał (logi kontrolerów i I/O kontrolerów). Otrzymasz je tylko z `?channel=controller-logs` lub `?channel=controller-io`; indeks zdarzeń podaje kanał.

Tillor dostarcza tylko zdarzenia, do których zalogowany członek organizacji ma uprawnienie. Bez `bank-transactions:read` (lub sync) nie dostaniesz na przykład zdarzeń `bankAccountTransaction:*`, także gdy nie wysyłasz filtra `events`.

Powiązane dane z innej domeny podlegają tym samym regułom co API: bez `customers:read` zdarzenie `reservation:updated` przychodzi z `customer: null`, bez `payments:read` zdarzenie `invoice:paid` przychodzi z `payment: null`. Lista staje się wtedy `[]`.

---

## Format zdarzenia [#event-formaat]

Payload ma taką samą strukturę jak [dostarczenia webhooków](/ontwikkelaars/webhooks#webhook-payload):

| Pole | Typ | Opis |
|------|------|--------------|
| `event` | string | Klucz zdarzenia (np. `invoice:created`) |
| `data` | object | Payload specyficzny dla zdarzenia |
| `timestamp` | number | Unix timestamp (ms) w chwili wysłania zdarzenia |
| `traceId` | string | ID śladu OpenTelemetry akcji Tillor, która wywołała to zdarzenie (tak samo jak przy [webhookach](/ontwikkelaars/webhooks#webhook-payload)) |
| `spanId` | string (opcjonalnie) | Span w obrębie tego śladu |

W strumieniu SSE ten obiekt JSON znajduje się w wierszu `data:`; klucz zdarzenia jest też w wierszu `event:`. Przykład na poziomie protokołu znajdziesz w [przykładach SSE](/ontwikkelaars/voorbeelden/sse).

---

## Przykład: 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);
    }
  }
}
```

---

## Przykład: 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"
```

---

## Ponowne łączenie [#herverbinding]

Gdy połączenie zostanie przerwane, połącz się ponownie z tym samym URL i nagłówkami. Strumień nie obsługuje wznawiania; po ponownym połączeniu otrzymujesz tylko nowe zdarzenia.

---

## Powiązane [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Pełna specyfikacja API
- [HTTP API](/ontwikkelaars/http) - Klucze API i uwierzytelnianie
- [Webhooki](/ontwikkelaars/webhooks) - Te same zdarzenia przez HTTP POST
- [Przykłady](/ontwikkelaars/voorbeelden) - Przykłady kodu i payloadów


# Przykłady HTTP (/pl-PL/ontwikkelaars/voorbeelden/http)

Godziny otwarcia i święta dla publicznej strony: [API godzin otwarcia](/ontwikkelaars/voorbeelden/opening-hours).

## Żądanie API z 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"
```

## Tworzenie klucza 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"}'
```

## Tworzenie webhooka [#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
  }'
```


# Przegląd (/pl-PL/ontwikkelaars/voorbeelden)

Gotowe przykłady na start. Każdy przykład używa symboli zastępczych `org_abc123` i `tkn_xxx`; zastąp je własnym identyfikatorem organizacji i kluczem API.

<Cards>
  <Card
    title="Przykłady HTTP"
    href="/ontwikkelaars/voorbeelden/http"
    description="Przykłady cURL i żądań dla API Tillor"
  />
  <Card
    title="API godzin otwarcia"
    href="/ontwikkelaars/voorbeelden/opening-hours"
    description="Pobieranie rozwiązanych godzin otwarcia i nadchodzących świąt dla strony internetowej"
  />
  <Card
    title="Przykłady webhooków"
    href="/ontwikkelaars/voorbeelden/webhooks"
    description="Payloady zdarzeń i przykłady POST webhooków"
  />
  <Card
    title="Przykłady SSE"
    href="/ontwikkelaars/voorbeelden/sse"
    description="Node.js i cURL dla Server-Sent Events"
  />
</Cards>


# API godzin otwarcia (/pl-PL/ontwikkelaars/voorbeelden/opening-hours)

Użyj API **rozwiązanych** godzin otwarcia, jeśli na publicznej stronie pokazujesz godziny sezonowe (na przykład **Zomer** / **Winter**) lub nadchodzące **święta**. Tillor stosuje już wyjątki, okresy sezonowe i zwykły harmonogram tygodniowy oraz dodaje ustawowe święta z żądanego zakresu. Nie musisz tego implementować od nowa.

**Uprawnienie:** `organization:settings:read` lub `organization:settings:write`

<Callout type="warn" title="Klucz API zostaje po stronie serwera">
Wywołuj Tillor tylko z serwera (Route Handler Next.js, Server Component lub backend). Umieść klucz w zmiennych środowiskowych. Nigdy nie wysyłaj go do przeglądarki.
</Callout>

Uwierzytelnianie: zobacz [HTTP API](/ontwikkelaars/http). Wypróbuj endpoint w [dokumentacji API](/api-referentie) lub przez [OpenAPI](https://tillor.eu/api/openapi.json) (tag `organization-settings`).

## Endpoint [#endpoint]

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours
```

Nagłówki:

```http
x-api-key: tkn_xxx
```

Zastąp `org_abc123` ID swojej organizacji.

### Parametry zapytania [#queryparameters]

Użyj **albo** `date`, **albo** `from`/`to`. Nie łącz ich.

| Parametr | Znaczenie |
|-----------|-----------|
| *(brak)* | Dzisiaj w strefie czasowej organizacji |
| `date` | Jeden dzień kalendarzowy (`YYYY-MM-DD`) |
| `from` | Dzień początkowy (włącznie). Bez `to`: tylko ten dzień |
| `to` | Dzień końcowy (włącznie). Wymaga `from`. Maksymalnie **366** dni |
| `languageIsoCode` | Język nazw świąt (`NL`, `FR`, …). Domyślnie: język organizacji |

## Odpowiedź [#response]

Każdy element to jeden dzień kalendarzowy, już rozwiązany:

| Pole | Znaczenie |
|------|-----------|
| `timeZone` | Strefa czasowa IANA organizacji |
| `from` / `to` | Żądany zakres |
| `holidays` | Ustawowe święta, które nakładają się na `from`–`to` |
| `items[].date` | Dzień kalendarzowy `YYYY-MM-DD` |
| `items[].weekday` | `monday` … `sunday` |
| `items[].source` | `exception`, `period` lub `regular` |
| `items[].periodLabel` | Tylko przy `source: "period"`: etykieta z Tillor, na przykład `"Zomer"` lub `"Winter"` |
| `items[].holiday` | Tylko gdy ten dzień jest ustawowym świętem: `{ id, name, startDate, endDate }` |
| `items[].blocks` | Przedziały czasu w minutach od północy |
| `items[].closed` | `true`, gdy `blocks` jest puste |

Priorytet: **wyjątek** (święto lub własny zakres) → ostatni pasujący **okres sezonowy** → **zwykły** harmonogram tygodniowy.

Etykiety sezonów pochodzą z *Ustawienia > Godziny otwarcia*. Okresy mogą przechodzić przez przełom roku (na przykład od 1 listopada do 31 marca). Dni poza każdym okresem wracają do zwykłego harmonogramu tygodniowego (`source: "regular"`, bez `periodLabel`).

### Minuty na godzinę zegarową [#minuten-naar-kloktijd]

`startMinutes` / `endMinutes` to minuty od 00:00.

| Minuty | Godzina |
|--------:|------|
| 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")}`;
}
```

## Przykłady [#voorbeelden]

### Dzień w okresie sezonowym [#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, godziny letnie.

### Dzień poza okresami sezonowymi [#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 i 13:00–17:00.

### Zakres przekraczający granicę okresu [#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` |

## Nadchodzące święta [#komende-feestdagen]

Ustawowe święta są w tej samej odpowiedzi: `holidays` dla listy (nazwa + daty), `items[].holiday`, gdy dany dzień kalendarzowy jest świętem. Godziny pozostają rozwiązanym harmonogramem; święto bez wprowadzonego w Tillor wyjątku podąża za harmonogramem sezonowym lub tygodniowym (`source` nie jest wtedy `"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
    }
  ]
}
```

Powyższy przykład `items` jest skrócony; prawdziwa odpowiedź zawiera każdy dzień z zakresu. Ferie szkolne nie są częścią tego endpointu; nadal służy do nich `GET /holidays?kind=school`.

## Next.js (serwer) [#nextjs-server]

Dla widżetu tygodniowego lub „teraz otwarte” na publicznej stronie:

```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` to lista dla bloku „nadchodzące święta”. `items[].holiday` przydaje się w kalendarzu tygodniowym. `items[].periodLabel` to tekst sezonu (na przykład `"Zomer"` lub `"Winter"`). Cache na 1 godzinę zwykle wystarcza.

## Unieważnianie cache (webhook) [#cache-ongeldig-maken-webhook]

Przy każdej zmianie ustawień organizacji Tillor wysyła `organizationSettings:updated` (webhook i SSE). Subskrybuj to zdarzenie i pobierz godziny otwarcia ponownie. Payload jest celowo mały (bez adresów IP drukarek ani pełnego harmonogramu):

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

`openingHoursChanged` ma wartość `true`, gdy zmieni się harmonogram godzin otwarcia, strefa czasowa lub kraj domyślny - to wpływa na `GET .../opening-hours`. Przy `false` możesz zostawić cache godzin otwarcia bez zmian.

Przykład Route Handlera 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 });
}
```

Tworzenie webhooka: zobacz [Webhooki](/ontwikkelaars/webhooks). Klucz zdarzenia: `organizationSettings:updated` (uprawnienie `organization:settings:read` lub `organization:settings:write`).

## Pełny harmonogram (opcjonalnie) [#volledig-rooster-optioneel]

Potrzebny tylko wtedy, gdy chcesz sam pokazać kalendarz sezonów (etykiety + `fromMonth`/`untilDay`), bez rozwiązywania dzień po dniu:

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings
```

Odczytaj `openingHoursSchedule.periods` (etykiety takie jak `"Zomer"`) i `openingHoursSchedule.weekdays` (zwykły harmonogram). Dla samej strony internetowej najprostszym źródłem pozostaje `GET .../opening-hours`.

## MCP [#mcp]

W Cursorze lub Claude: endpoint `organizationSettings_listOpeningHours` (kategoria `organizationSettings`), argumenty `organizationId`, opcjonalnie `date` lub `from`/`to`, opcjonalnie `languageIsoCode`.

## Powiązane [#gerelateerd]

- [HTTP API](/ontwikkelaars/http) - uwierzytelnianie i nagłówki
- [Przykłady HTTP](/ontwikkelaars/voorbeelden/http) - ogólne przykłady cURL
- [Webhooki](/ontwikkelaars/webhooks) - `organizationSettings:updated` do unieważniania cache
- [Ustawienia organizacji](/gebruikers/organisaties) - ustawianie godzin otwarcia w Tillor


# Przykłady SSE (/pl-PL/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);
    }
  }
}
```

## Wiadomość SSE [#sse-bericht]

Wiadomość SSE (`text/event-stream`) wygląda tak:

```
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}

```

Wiersz SSE `event` to `message`. Wiersz `data` parsuj jako JSON: znajdziesz w nim zdarzenie Tillor (`event`), payload (`data`) i `timestamp` (ms). Ten sam obiekt JSON otrzymasz przez [webhooki](/ontwikkelaars/webhooks).


# Przykłady webhooków (/pl-PL/ontwikkelaars/voorbeelden/webhooks)

Te same zdarzenia co w [SSE](/ontwikkelaars/voorbeelden/sse). Struktura payloadu jest identyczna.

## Struktura opakowania [#wrapper-structuur]

```json
{
  "event": "entity:action",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

`traceId` należy do akcji Tillor, która wywołała zdarzenie (np. wywołanie API lub przetwarzanie wewnętrzne), a nie do późniejszej ponownej próby webhooka.

## Przykład POST webhooka [#webhook-post-voorbeeld]

Pełne żądanie POST webhooka wygląda tak:

```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"
}
```

## Payloady zdarzeń [#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
}
```

Unieważnianie cache na publicznej stronie opisano w [API godzin otwarcia](/ontwikkelaars/voorbeelden/opening-hours).

## Enumy [#enums]

| Encja | Enum | Wartości |
|--------|------|---------|
| 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`, … (pełna lista w 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` |


# Webhooki (/pl-PL/ontwikkelaars/webhooks)

Webhooki odbierają zdarzenia w czasie rzeczywistym przez HTTP POST na skonfigurowany przez Ciebie adres URL. Te same zdarzenia są dostępne także przez [SSE](/ontwikkelaars/sse). Webhooki są skonfigurowane **dla każdej organizacji** - każda organizacja ma własne webhooki.

## Zarządzanie [#beheer]

Pełne schematy żądań i odpowiedzi znajdziesz w [specyfikacji OpenAPI](https://tillor.eu/api/openapi.json).

| Metoda | Ścieżka | Opis |
|--------|------|-------------|
| GET | `/api/orgs/:orgId/webhooks` | Pobranie webhooków |
| GET | `/api/orgs/:orgId/webhooks/delivery-stats` | Pobranie statystyk dostarczeń |
| POST | `/api/orgs/:orgId/webhooks/retry-deliveries` | Ponowna próba dostarczeń. Body: `mode` (`failed` lub `force`) i opcjonalnie `id` dla jednego webhooka. `failed`: tylko dostawy ostatecznie nieudane, od razu. `force`: dostawy oczekujące i ostatecznie nieudane, w tle, z pominięciem czasów oczekiwania. |
| GET | `/api/orgs/:orgId/webhooks/:id` | Pobranie webhooka według ID |
| POST | `/api/orgs/:orgId/webhooks` | Utworzenie webhooka |
| PATCH | `/api/orgs/:orgId/webhooks/:id` | Aktualizacja webhooka |
| DELETE | `/api/orgs/:orgId/webhooks/:id` | Usunięcie webhooka |

## Tworzenie webhooka [#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, który przyjmuje żądania POST
- **subscribedEventKeys** - Tablica kluczy zdarzeń lub `["*"]` dla wszystkich zdarzeń. Pełną listę znajdziesz w Tillor w **Menu profilu → Dla deweloperów** przy **Dodaj webhooka** → **Subskrybowane wydarzenia**.

Kilka zdarzeń występuje tak często, że nie można ich wybrać i nie docierają też przez `*`, na przykład fizyczny stan szlabanów, pisanie w skrzynce odbiorczej, logi kontrolerów i obecność pojazdów. Nie ma ich na poniższej liście. To, które zdarzenia możesz wybrać, zależy też od Twoich uprawnień.
- **enabled** - `true`, aby włączyć dostarczanie

Możesz wybrać tylko zdarzenia, do których Twój członek organizacji ma odpowiednie uprawnienie (np. transakcje bankowe dla `bankAccountTransaction:*`). Wildcard `*` jest dostępny tylko dla członków z pełnym dostępem (`*`). Przy nieprawidłowej kombinacji API zwraca błąd. Webhook przekazuje pełny payload wraz z powiązanymi danymi (jak klient przy rezerwacji). Dlatego, aby utworzyć webhook, zmienić jego URL lub zdarzenia albo włączyć go ponownie, musisz mieć też prawo odczytu tych domen.

---

## Payload webhooka [#webhook-payload]

Każde dostarczenie webhooka to POST z:

**Nagłówkami:**
- `Content-Type: application/json`
- `X-Webhook-Event-ID` - stabilne unikalne ID tego logicznego dostarczenia (ta sama wartość przy ponownych próbach)
- `X-Webhook-Signature` - podpis HMAC-SHA256 body, format `sha256=<hex>` (zobacz [Weryfikacja podpisu](#handtekening-verifiëren))

**Body:**

```json
{
  "event": "invoice:created",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7",
  "triggeredBy": {
    "id": "usr_63x8jp68is",
    "name": "Niels"
  }
}
```

| Pole | Typ | Opis |
|------|------|--------------|
| `event` | string | Klucz zdarzenia (np. `invoice:created`) |
| `data` | object | Payload specyficzny dla zdarzenia |
| `timestamp` | number | Unix timestamp (ms) w chwili wysłania zdarzenia |
| `traceId` | string | ID śladu OpenTelemetry akcji Tillor, która wywołała to zdarzenie. Podaj je w kontakcie z supportem; nie jest tajne. |
| `spanId` | string (opcjonalnie) | Span w obrębie tego śladu |
| `triggeredBy` | object \| null | Użytkownik, który wykonał akcję (`id`, `name`). `null` przy akcjach systemowych (cron, synchronizacja banku, …) |

Pełne przykłady payloadów znajdziesz w [Przykładach](/ontwikkelaars/voorbeelden).

---

## Weryfikacja podpisu [#handtekening-verifiëren]

Każdy webhook ma własny **sekret podpisywania** (64 znaki hex, widoczny w tabeli webhooków przez **Pokaż sekret podpisywania** w *Menu profilu → Dla deweloperów*). Tillor podpisuje każdy POST tym sekretem, abyś mógł sprawdzić, że żądanie naprawdę pochodzi od Tillor i że body nie zostało zmienione.

**Jak podpisuje Tillor:**

1. Oblicz `HMAC-SHA256(signingSecret, raw_request_body)` (hex małymi literami).
2. Wyślij to jako `X-Webhook-Signature: sha256=<hex>`.

**Jak weryfikujesz Ty:**

1. Odczytaj **surowe** body żądania (przed parsowaniem JSON - inaczej hash się nie zgodzi).
2. Sam oblicz `HMAC-SHA256(signingSecret, raw_body)` w hex.
3. Porównaj z wartością po `sha256=` z nagłówka `X-Webhook-Signature` za pomocą porównania **constant-time**.

```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="Traktuj sekret jak hasło">
Sekret podpisywania możesz wyświetlić w Tillor przez **Pokaż sekret podpisywania** w tabeli webhooków. Przechowuj go jako sekret (zmienna środowiskowa, vault) i nigdy go nie loguj. Podejrzewasz wyciek? Usuń webhook i utwórz nowy; dostaniesz wtedy nowy sekret.
</Callout>

---

## Zachowanie dostarczania i ponowne próby [#leveringsgedrag-en-retries]

- Odpowiedz statusem **2xx**, aby potwierdzić sukces.
- Przy nieudanym dostarczeniu (status inny niż 2xx, błąd sieci lub zablokowany cel) Tillor automatycznie ponawia dostarczenie ze stopniowo coraz dłuższymi odstępami. Każda próba używa tego samego payloadu, tego samego podpisu i tego samego ID zdarzenia (idempotentnie).

| Próba | Czas oczekiwania od poprzedniej próby |
|---|---|
| 1 | od razu |
| 2 | 1 sekunda |
| 3 | 2 sekundy |
| 4 | 4 sekundy |
| 5 | 8 sekund |
| 6 | 5 minut |
| 7 | 30 minut |
| 8 | 2 godziny |
| 9 | 6 godzin |
| 10 | 24 godziny |

- Jeśli jedna z prób się powiedzie (2xx) → dostarczenie jest zakończone.
- Jeśli nie powiedzie się też próba 10 (po 24 h) → dostarczenie jest **ostatecznie oznaczone jako nieudane** i nie jest już ponawiane.
- Jeśli w międzyczasie webhook zostanie **wyłączony**, Tillor przestaje ponawiać próby.

```mermaid
flowchart TD
  A[Event uitgezonden] --> B[Levering naar jouw endpoint]
  B -- 2xx --> Z[Afgerond]
  B -- mislukt --> C[Opnieuw geprobeerd<br/>1s, 2s, 4s, 8s,<br/>5m, 30m, 2u, 6u, 24u]
  C -- 2xx --> Z
  C -- alle pogingen mislukt --> F[Definitief mislukt]
```

<Callout type="info" title="Idempotentność">
Każda ponowna próba używa tego samego `X-Webhook-Event-ID` i `X-Webhook-Signature`. Deduplikuj po swojej stronie według tego nagłówka, aby udana ponowna próba po wolnej odpowiedzi 200 nie spowodowała podwójnego przetworzenia.
</Callout>

### Powiadomienia przy utrzymujących się błędach [#meldingen-bij-aanhoudende-fouten]

Jeśli dostarczenia do endpointu webhooka stale się nie udają, Tillor wysyła **najwyżej dwa powiadomienia na incydent** (na endpoint):

1. **Po 5 minutach utrzymujących się błędów** - e-mail na adres e-mail organizacji (`supportEmail`, w przeciwnym razie `email`) oraz do członków organizacji z uprawnieniami do zmiany ustawień organizacji, a także push (jeśli włączony) dla tych członków. E-mail podaje, od kiedy dostarczenia się nie udają. Daty w e-mailu używają **strefy czasowej** z *Ustawienia > Ogólne* (domyślnie `Europe/Brussels`).
2. **Przy ostatecznym niepowodzeniu** - ci sami odbiorcy dostają jedno powiadomienie, gdy pierwsze zdarzenie w tym incydencie zostanie po wszystkich próbach ostatecznie oznaczone jako nieudane.

**Nie** dostajesz powiadomienia dla każdego nieudanego zdarzenia. Gdy wszystkie nieudane dostarczenia dla endpointu zostaną rozwiązane (dostarczone pomyślnie), kolejny incydent zaczyna się od nowa według tych samych reguł.

W **Menu profilu → Dla deweloperów** tabela webhooków pokazuje dla każdego endpointu zwięzły status dostarczeń (liczby oczekujące na ponowną próbę i ostatecznie nieudane). Kliknij ikonę **ℹ**, aby zobaczyć szczegóły, w tym pełny komunikat błędu i payload ostatniej próby.

- **Ponów próbę dostarczenia nieudanych dostaw** (↻): tylko dostawy ostatecznie nieudane dla tego webhooka.
- **Wymuś ponowną próbę** (⚡): wszystkie oczekujące i ostatecznie nieudane dostawy dla tego webhooka, niezależnie od zaplanowanych czasów oczekiwania. Tillor uruchamia to w tle, aby duże kolejki (np. tysiące zdarzeń) były przetwarzane bezpiecznie.
- **Wymuś ponowną próbę wszystkich** w prawym górnym rogu obok **Dodaj webhooka**: to samo dla wszystkich włączonych webhooków w organizacji.

---

## Typy zdarzeń [#event-types]

Klucze zdarzeń mają format `entity:action` lub `entity:subresource:action`. Pełną listę, z uprawnieniem dla każdego zdarzenia i przykładowym payloadem, znajdziesz w [indeksie zdarzeń](/ontwikkelaars/events). Ta strona jest generowana z kodu, więc zawsze jest kompletna. Te same klucze znajdziesz w Tillor w [Menu profilu → Dla deweloperów](https://tillor.eu/orgs/org_abc123/developers) przy **Dodaj webhooka** → **Subskrybowane wydarzenia**.


---

## Webhooki a SSE [#webhooks-vs-sse]

| Zastosowanie | Rekomendacja |
|----------|-------------|
| Integracja po stronie serwera | **Webhooki** - Twój serwer odbiera POST-y |
| Proste logowanie | **Webhooki** - Minimalna konfiguracja |
| Dashboard w czasie rzeczywistym, aktualizacje na żywo w aplikacji | [SSE](/ontwikkelaars/sse) - Jedno połączenie, małe opóźnienie. |
| Wiele typów zdarzeń, filtrowanie po stronie klienta | [SSE](/ontwikkelaars/sse) - Użyj parametru zapytania `events`, aby ograniczyć ruch. |

---

## Powiązane [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Pełna specyfikacja API
- [HTTP API](/ontwikkelaars/http) - REST API i klucze API
- [SSE](/ontwikkelaars/sse) - Te same zdarzenia przez Server-Sent Events
- [Automatyzacje](/ontwikkelaars/automatiseringen) - Wysyłanie własnych wiadomości z automatyzacji


# API czatu na stronie (/pl-PL/ontwikkelaars/website-chat)

Oficjalny widżet instalujesz w aplikacji: zobacz [Dodanie czatu na swojej stronie](/inbox/website-chat). Opcje fragmentu kodu znajdziesz w [Ustawieniach czatu na stronie](/inbox/website-chat-instellingen). Ta strona jest dla deweloperów: widget SDK dla własnego formularza i warstwa REST dla **własnego interfejsu czatu**. Zobacz [OpenAPI](https://tillor.eu/api/openapi.json), tag `inbox`.

## Widget SDK [#widget-sdk]

Po załadowaniu skryptu widżetu dostępny jest `window.TillorInbox`. Za jego pomocą przekazujesz dane kontaktowe z własnego formularza (strona kontaktowa, szczegóły ogłoszenia sprzedaży, zapytanie o ofertę). Wszystkie metody czekają, aż konfiguracja widżetu zostanie załadowana.

| Metoda | Opis |
|---------|--------------|
| `ready()` | Promise, który kończy się, gdy widżet jest załadowany |
| `getVisitor()` | Odczytuje zapisane dane kontaktowe z `localStorage` i wypełnione pola widżetu; synchronicznie, bez sieci |
| `setVisitor({ name?, firstName?, lastName?, email?, phone?, message?, customFields? }, options?)` | Wypełnia pola czatu bez wysyłania |
| `open()` | Otwiera okno czatu |
| `close()` | Zamyka okno czatu |
| `toggle()` | Otwiera lub zamyka okno czatu |
| `send({ body, name?, firstName?, lastName?, email?, phone?, message?, customFields?, open?, silent?, markSubmitted?, metadata? })` | Wysyła wiadomość z danymi kontaktowymi |

`getVisitor()` zwraca ten obiekt:

| Pole | Opis |
|------|--------------|
| `visitorId` | ID tego odwiedzającego w tej przeglądarce (`localStorage`) |
| `name` | Pełne imię i nazwisko (jedno pole w widżecie) |
| `firstName` / `lastName` | Wyprowadzone z `name` (pierwsze słowo / reszta) |
| `email`, `phone` | Dane kontaktowe |
| `customFields` | Dodatkowe pola z ustawień widżetu |
| `message` | Szkic w polu wiadomości |
| `detailsSubmitted` | Czy formularz odwiedzającego uchodzi za wypełniony |

Użyj `getVisitor()`, aby wstępnie wypełnić własny formularz z `localStorage` (ta sama przeglądarka, także po odświeżeniu strony).

Opcje dla `setVisitor` (drugi argument):

| Opcja | Domyślnie | Wyjaśnienie |
|-------|-----------|--------|
| `open` | `false` | Od razu otwiera okno czatu |
| `markSubmitted` | `false` | Ukrywa formularz odwiedzającego, gdy wszystkie wymagane pola są wypełnione |
| `onlyEmpty` | `false` | Nadpisuje tylko puste pola |
| `persist` | `false` | Zachowuje dane w `localStorage` (ta sama przeglądarka, także w nowej karcie) |

Opcje dla `send`:

| Opcja | Domyślnie | Wyjaśnienie |
|-------|-----------|--------|
| `open` | `false` | Otwiera okno czatu przed wysłaniem |
| `silent` | `true`, gdy `open` ma wartość false | Bez dźwięku i bez komunikatu o błędzie w widżecie; do sukcesu lub błędu użyj Promise |
| `markSubmitted` | `true` | Dane kontaktowe nie muszą być potem ponownie podawane w widżecie |
| `metadata` | - | Opcjonalne wskazówki dla Tillie (niewidoczne w oknie czatu); zobacz [metadata](#metadata-boekingsformulier) |

Przy `open: false` (domyślnie) przycisk czatu pozostaje zamknięty. Wiadomość mimo to trafia do Tillor; Twój własny formularz może podziękować lub pokazać błąd. Przy `open: true` okno czatu się otwiera, a odwiedzający widzi normalne zachowanie wysyłania (dźwięk, znaczniki, ewentualne błędy widżetu).

Chcesz użyć własnego przycisku zamiast pływającego przycisku czatu? Ustaw `data-launcher="false"` we fragmencie kodu i wywołaj `TillorInbox.open()`.

### `metadata` (formularz rezerwacji) [#metadata-boekingsformulier]

Użyj `metadata`, gdy masz na stronie własny formularz, a Tillie ma wysłać **wyłącznie potwierdzenie**, bez pytań uzupełniających (na przykład dlatego, że karta się potem zamyka).

| Klucz | Typ | Wyjaśnienie |
|---------|------|--------|
| `forceHandover` | `boolean` | Wiadomość z potwierdzeniem i przekazanie koledze, bez pytań wstępnych. Pomija też pauzę AI po wiadomości zespołu (zobacz `ignoreAiPause`) |
| `ignoreAiPause` | `boolean` | Tillie odpowiada także wtedy, gdy w trybie **Automatyczny** jest wstrzymana po wiadomości zespołu (30 minut). Przydatne przy cichym wysyłaniu formularza; połącz z `forceHandover` albo pozwól Tillie normalnie zbierać informacje |
| `handoverIntent` | `"reservation"` \| `"caravan_rental"` \| `"sale"` \| `"other"` | Opcjonalnie: przebieg przekazania (domyślnie wyprowadzany automatycznie z wiadomości) |
| `source` | `string` | Opcjonalna etykieta integracji dla Twojego zespołu (małe litery, cyfry, `-`, `_`; maks. 64 znaki) |

```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",
  },
});
```

### Zastąpienie formularza kontaktowego (ciche wysyłanie) [#contactformulier-vervangen-stille-verzending]

Użyj tego, gdy chcesz zachować istniejący formularz kontaktowy, ale kierować wiadomości przez Tillor bez otwierania okna czatu.

```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">Verstuur</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 = "Bedankt, we nemen snel contact op.";
      status.hidden = false;
      form.reset();
    } catch (error) {
      status.textContent = error instanceof Error ? error.message : "Versturen mislukt.";
      status.hidden = false;
    }
  });
</script>
```

Nie musisz ustawiać `open` ani `silent`: bez `open: true` okno pozostaje zamknięte, a Tillor traktuje wywołanie jako ciche wysłanie.

### Połączenie formularza kontaktowego (otwarcie czatu) [#contactformulier-koppelen-chat-openen]

Przekaż pola i otwórz okno czatu, aby odwiedzający zobaczył rozmowę:

```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">Verstuur</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>
```

Albo tylko wypełnij pola i otwórz okno, bez natychmiastowego wysyłania:

```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 },
);
```

Strona sprzedaży z natychmiastowym wysłaniem i otwarciem czatu:

```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,
});
```

Synchronizacja na żywo, gdy ktoś pisze:

```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,
  });
});
```

### Wczesne wywołanie (przed skryptem widżetu) [#vroeg-aanroepen-vóór-het-widget-script]

Jeśli wywołujesz metodę, zanim skrypt się załaduje, dodaj wywołanie do kolejki:

```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>
```

## Własny interfejs czatu [#eigen-chat-ui]

Jeśli zamiast widżetu budujesz własny interfejs czatu, użyj warstwy REST poniżej.

Uwierzytelnianie: nagłówek `X-Tillor-Inbox-Widget-Key` (wartość z *Ustawienia > Integracje > Czat na stronie*).

### Wskaźnik pisania [#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`, gdy odwiedzający pisze; `false`, gdy pole jest puste lub odwiedzający przestaje pisać (widżet wysyła `false` po około 4 sekundach bez wprowadzania)
- `visitorName` / `visitorEmail` / `visitorPhone` są opcjonalne
- Używaj tego samego `visitorId` co przy `POST …/inbox/website/messages` i `GET …/inbox/website/messages`

### Czas rzeczywisty (SSE) [#realtime-sse]

```http
GET /api/orgs/{orgId}/inbox/website/subscribe?visitorId=vis_…
X-Tillor-Inbox-Widget-Key: iwk_xxx
Accept: text/event-stream
```

| Zdarzenie | Kiedy |
|-------|-------|
| `inbox:website:message-created` | Nowa wiadomość zespołu lub AI |
| `inbox:website:message-updated` | Wiadomość zespołu lub AI zmieniona albo usunięta |
| `inbox:website:typing-changed` | Zmienia się `data.staffTyping` lub `data.staffOutboundSenderType` |

Kształt payloadu jest taki sam jak w [SSE organizacji](/ontwikkelaars/sse#event-formaat) (`event`, `data`, `timestamp`). Połącz się ponownie po przerwaniu; wznawianie nie jest obsługiwane.

Oficjalny widżet używa SSE jako głównej warstwy i pobiera `GET …/messages` ponownie co **5 sekund** jako rozwiązanie awaryjne (co **1 sekundę** przy otwartym panelu, gdy SSE na chwilę zniknie). Dzięki temu odpowiedzi są oznaczane jako **dostarczone**, dopóki odwiedzający jest na stronie.

### Aktywność odwiedzającego [#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` lub `navigation` (przy nawigacji także `url`). Twój zespół widzi te zdarzenia jako szary tekst informacyjny w rozmowie, zobacz [Rozmowy przez czat na stronie](/inbox/website-chat-gesprekken).

### Limity [#limieten]

`POST …/inbox/website/messages` i `POST …/inbox/website/attachments/upload` odpowiadają `429`, gdy odwiedzający lub sieć wysyła za dużo. Treść zawiera `data.reason` = `INBOX_WIDGET_RATE_LIMITED` i `data.retryAfterSeconds`. Limity na organizację:

| Ścieżka | Na odwiedzającego (`visitorId`) | Na sieć (adres IP) |
|---------|---------------------------------|--------------------|
| `messages` | 10 na minutę, 200 dziennie | 30 na minutę, 600 dziennie |
| `attachments/upload` | 10 na godzinę | 50 na godzinę |

Odczekaj `retryAfterSeconds` przed ponowną próbą i pokaż odwiedzającemu komunikat zamiast ponawiać automatycznie.

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Czat na stronie (aplikacja)" href="/inbox/website-chat" />
  <Card title="Ustawienia czatu na stronie" href="/inbox/website-chat-instellingen" />
  <Card title="SSE" href="/ontwikkelaars/sse" />
  <Card title="OpenAPI" href="https://tillor.eu/api/openapi.json" />
</Cards>


# Gość przy szlabanie (/pl-PL/praktijk/gast-aan-de-slagboom)

Gość podjeżdża pod szlaban parku rekreacyjnego Het Meer i musi móc przejechać bez pomocy recepcji. Ten przykład śledzi Jonasa Maesa od ustawienia jego metody dostępu do tego, co się dzieje, gdy ta metoda (już) nie działa. Zobaczysz, jak metoda dostępu, kontroler i punkt dostępu współpracują ze sobą.

```mermaid
flowchart LR
  A[Toegangsmethode bij de klant] --> B[Gast bij het toegangspunt]
  B --> C{Controller en Tillor controleren}
  C -->|geldig| D[Toegestaan, slagboom open]
  C -->|verlopen of geblokkeerd| E[Geweigerd, zichtbaar in het logboek]
```

Zanim zaczniesz:

- Twój park ma co najmniej jeden punkt dostępu połączony z Tillor. Znajdziesz go w **Szybkie akcje** na stronie **Kontrola dostępu** z przyciskiem **Otwórz [nazwa punktu dostępu]**.
- Kontroler przy szlabanie jest połączony z Twoją organizacją. Nowy kontroler pojawia się w **Kontrolery** ze statusem **Oczekuje na zatwierdzenie**, dopóki nie klikniesz **Zatwierdź**. Zobacz [Kontrolery](/controllers).
- Dla tagu NFC: tag musi już być w Tillor. Dzieje się to samo, gdy po raz pierwszy przyłożysz go do czytnika.

## Droga krok po kroku [#de-route-stap-voor-stap]

<Steps>
<Step>
### Dodaj metodę dostępu [#voeg-een-toegangsmethode-toe]
Przejdź do <UIPath>Klienci > Jonas Maes > Kontrola dostępu</UIPath> i kliknij **Dodaj**. Wybierz **Rodzaj** i w razie potrzeby uzupełnij **Data od** i **Data do**. Ten okres określa, kiedy metoda działa.

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Karta Kontrola dostępu z tabelą Metody dostępu" />

<Tabs items={["Kenteken", "QR-code", "NFC-tag"]}>
<Tab value="Kenteken">
Wybierz **Rozpoznawanie tablic rejestracyjnych** i wpisz **Tablica rejestracyjna**. Kamera przy punkcie dostępu odczytuje tablicę, a Tillor dopasowuje do niej klienta.
</Tab>
<Tab value="QR-code">
Wybierz **Kod QR**. Tillor sam tworzy kod. W menu przy metodzie skopiuj **Osobisty URL** i wyślij go Jonasowi. Otworzy stronę **Karta dostępu** i będzie mógł dodać kartę do Apple Wallet lub Google Wallet, jeśli jest to ustawione dla Twojego środowiska.
</Tab>
<Tab value="NFC-tag">
Wybierz **NFC** i wskaż dostępną kartę NFC z listy. Jeśli lista jest pusta, najpierw przyłóż tag do czytnika. Zobacz [Zarządzanie tagami](/nfc/nfc-tags).
</Tab>
</Tabs>

Zobacz [Kontrola dostępu](/toegangscontrole).
</Step>
<Step>
### Sprawdź kontroler i punkt dostępu [#controleer-controller-en-toegangspunt]
Kontroler lub kamera przy punkcie dostępu otrzymuje z Tillor listę ważnych metod. W **Operacje kontrolera** na stronie **Kontrola dostępu** widzisz, kiedy karta lub kod QR został przesłany do punktu dostępu. Jeśli operacji jeszcze tam nie ma, synchronizacja nadal trwa.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Operacje kontrolera z synchronizacją i akcjami białej listy" />
</Step>
<Step>
### Śledź, co się dzieje przy szlabanie [#volg-wat-er-aan-de-slagboom-gebeurt]
Blok **Dziennik dostępu** pokazuje każdą próbę z datą, metodą, klientem, punktem dostępu i statusem. Gość, który wjeżdża, jest w tabeli **Pojazdy w parku** ze statusem **W środku**. Gdy wyjedzie, status zmienia się na **Wyjechał**.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Dziennik dostępu z tablicami rejestracyjnymi, klientem i statusem" />
</Step>
<Step>
### Otwórz szlaban samodzielnie, gdy trzeba [#open-de-slagboom-zelf-als-het-nodig-is]
W **Szybkie akcje** kliknij **Otwórz [nazwa punktu dostępu]** i potwierdź przez **Tak, otwórz [nazwa punktu dostępu]**. Zamknięcie jest możliwe tylko wtedy, gdy punkt dostępu to obsługuje.
</Step>
</Steps>

## Co się dzieje przy wygasłej metodzie? [#wat-gebeurt-er-bij-een-verlopen-methode]

Gdy **Data do** minie, metoda nie daje już dostępu, a próba trafia do dziennika ze statusem **Wygasła**. Inne statusy, które możesz spotkać, to **Zablokowana**, **Nieaktywna** i **Odmowa**.

Dla tablic rejestracyjnych istnieje okres karencji, aby goście nie stali nocą przed zamkniętym wyjazdem. Jeśli **Zezwól na wyjazd wygasłych tablic** jest włączone (domyślnie), szlaban wyjazdowy nadal się otwiera w okresie karencji. Trwa on domyślnie 2 dni, maksymalnie 30. Działa tylko poza godzinami otwarcia. Jeśli recepcja jest otwarta, personel załatwia pojazd przy ladzie. Zablokowana lub nieaktywna tablica nigdy nie dostaje karencji, a tagi NFC i kody QR nie mają karencji. Ustawiasz to w <UIPath>Pomoc > Ustawienia > Kontrola dostępu</UIPath>, zobacz [Ustawienia kontroli dostępu](/gebruikers/instellingen-toegangscontrole).

## Co się dzieje potem? [#wat-gebeurt-er-daarna]

- Każda próba pozostaje w dzienniku dostępu. Możesz filtrować według klienta, statusu i punktu dostępu oraz eksportować do Excela.
- Pojazd, którego przez 7 dni nie widziano przy żadnym punkcie dostępu, dostaje status **Duch**. Jeśli tablica zostanie później ponownie zauważona przy wjeździe, status wraca na **W środku**.
- Jeśli przedłużysz **Data do** metody, zacznie ona znów działać po następnej synchronizacji z punktem dostępu.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Gość stoi przed zamkniętym szlabanem">
Znajdź próbę w dzienniku dostępu i przeczytaj status. **Wygasła** oznacza, że **Data do** minęła, **Zablokowana** lub **Nieaktywna**, że metoda jest wyłączona. Jeśli metoda jest w porządku, sprawdź **Operacje kontrolera**. Jeśli nie możesz tego szybko rozwiązać, otwórz szlaban przez **Szybkie akcje**.
</Accordion>
<Accordion title="W dzienniku nie ma żadnej próby">
Wtedy Tillor niczego nie otrzymał. Sprawdź, czy kontroler jest online i czy ekran pokazuje komunikat. Zobacz [Komunikaty na ekranie](/controllers/troubleshooting/scherm) i [Problemy z połączeniem](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="Tablica rejestracyjna nie jest rozpoznawana">
Sprawdź, czy tablica została wpisana bez spacji i literówek. Błędnie odczytana tablica może też sprawić, że pojazd pozostanie jako **Duch**.
</Accordion>
<Accordion title="Nie widzę karty NFC na liście">
Tag nie jest jeszcze znany w Tillor albo jest już przypisany do innego klienta. Najpierw przyłóż go do czytnika albo odepnij go od drugiego klienta.
</Accordion>
</Accordions>

## Zobacz też [#zie-ook]

<Cards>
  <Card title="Kontrola dostępu" href="/toegangscontrole" />
  <Card title="Kontrolery" href="/controllers" />
  <Card title="NFC" href="/nfc" />
  <Card title="Ustawienia kontroli dostępu" href="/gebruikers/instellingen-toegangscontrole" />
</Cards>


# Przegląd (/pl-PL/praktijk)

W większości zadań dotykasz więcej niż jednego modułu: nowy klient staje się zajęciem, umową, fakturą i płatnością. Te przykłady przechodzą taką drogę od początku do końca. Korzystają z organizacji demo, parku rekreacyjnego Het Meer, z klientem Jonasem Maesem i działką 12. Każdy krok odsyła do strony z pełnym wyjaśnieniem.

<Cards>
  <Card title="Pozyskanie klienta sezonowego" href="/praktijk/seizoensklant-binnenhalen" description="Klient, zajęcie, umowa najmu, faktura, płatność i raport płatności" />
  <Card title="Rozliczanie zużycia" href="/praktijk/verbruik-aanrekenen" description="Od licznika przy działce do automatycznej faktury za media" />
  <Card title="Domek holenderski się zwalnia" href="/praktijk/stacaravan-komt-vrij" description="Zakończenie zajęcia, zadanie końcowe i zwrot kaucji" />
  <Card title="Gość przy szlabanie" href="/praktijk/gast-aan-de-slagboom" description="Metoda dostępu, kontroler, punkt dostępu i co się dzieje po wygaśnięciu" />
</Cards>

## Jak to się łączy? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Klant] --> B[Bezetting]
  T[Terrein] --> B
  M[Meter] --> T
  B --> V[Verbruik]
  K --> O[Ondertekenverzoek]
  B --> F[Factuur]
  V --> F
  F --> P[Betaling]
  P --> R[Betalingsrapport]
  K --> TM[Toegangsmethode]
  TM --> TP[Toegangspunt]
  B -->|eindigt| A[Automatisering]
  A --> TK[Taak]
```

Czytaj przykłady jak drogę: możesz wejść w dowolnym punkcie. Jeśli chcesz jeszcze raz przejrzeć pojęcia, zajrzyj do [Pojęć](/begrippen).

## Pojęcia [#begrippen]

- **Zajęcie miejsca**: klient na terenie przez dłuższy okres. Zobacz [Zajęcie miejsca](/begrippen#bezetting).
- **Działka**: miejsce w Twoim parku. Zobacz [Działka](/begrippen#terrein).
- **Prośba o podpis**: plik PDF podpisywany online. Zobacz [Prośba o podpis](/begrippen#ondertekenverzoek).
- **Automatyzacja**: reguła, którą Tillor wykonuje sam. Zobacz [Automatyzacja](/begrippen#automatisering).


# Pozyskanie klienta sezonowego (/pl-PL/praktijk/seizoensklant-binnenhalen)

Pozyskanie klienta sezonowego w Tillor oznacza: utworzenie klienta, przypisanie mu działki, podpisanie umowy najmu, wystawienie faktury za postój i dopilnowanie, aby płatność trafiła do księgowości. Ten przykład prowadzi przez całą drogę na przykładzie Jonasa Maesa, który wynajmuje działkę 12 na sezon w Recreatiepark Het Meer. Każdy krok odsyła do strony z pełnym wyjaśnieniem.

```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]
```

Zanim zaczniesz:

- Działka 12 istnieje i nie ma aktywnego zajęcia miejsca. Jeśli je ma, nie pojawi się na liście wyboru w oknie **Utwórz zajęcie miejsca**.
- Istnieje produkt z akcją **Przedłuż okres zajęcia miejsca**, najczęściej opłata za postój. Zobacz [Powiązanie akcji z produktem](/producten/acties-instellen).
- Masz gotową umowę najmu w formacie pdf.
- Masz uprawnienie **Zarządzanie prośbami o podpis**, aby wysłać umowę do podpisu.
- Do podpisania zdalnego klient potrzebuje adresu e-mail lub numeru telefonu. Do mandatu SEPA potrzebny jest adres e-mail.

## Droga krok po kroku [#de-route-stap-voor-stap]

<Steps>
<Step>
### Utwórz klienta [#maak-de-klant-aan]
Przejdź do <UIPath>Klienci > Przegląd</UIPath> i kliknij **Utwórz nowego klienta**. Jeśli w kolejce czeka skan dowodu tożsamości, wybierz go z menu: Tillor uzupełni dane z dokumentu. W przeciwnym razie wybierz **Ręczny** i wypełnij **Imię**, **Nazwisko**, **Adres e-mail** i **Numer telefonu**.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Okno Utwórz nowego klienta" />

Po utworzeniu trafisz na profil Jonasa. Uzupełnij tam adres. Więcej znajdziesz w [Zarządzanie klientami](/klantenbeheer) i [Skany dokumentów tożsamości](/identiteitsscans).
</Step>
<Step>
### Przypisz Jonasowi działkę 12 [#geef-jonas-terrein-12]
Na jego profilu otwórz zakładkę **Przegląd**, przejdź do karty **Zajęcia miejsc** i kliknij **Utwórz zajęcie miejsca**. W polu **Działka** wybierz działkę 12. W razie potrzeby uzupełnij **Opłacone do**, **Typ** i **Częstotliwość czynszu**. Cena domyślnie pochodzi z działki.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Karta Zajęcia miejsc na profilu klienta" />

Jeśli działka 12 ma liczniki, możesz teraz wypełnić także **Początkowe odczyty liczników**. Zobacz [Zajęcia miejsc](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Wyślij umowę najmu do podpisu [#laat-het-huurcontract-tekenen]
Przejdź do <UIPath>Administracja > Podpisy</UIPath> i kliknij **Poproś o podpisy**. Wybierz Jonasa Maesa jako **Klient**, wgraj umowę, dodaj Jonasa jako osobę podpisującą z **Klient: Jonas Maes** i umieść pole podpisu. W razie potrzeby dodaj pracownika jako drugą osobę podpisującą.

<Tabs items={["Op afstand", "Aan de receptie"]}>
<Tab value="Op afstand">
Kliknij **Wyślij**. Jonas otrzyma e-mail z osobistym linkiem, a jeśli jest tylko numer telefonu, wiadomość SMS. Podpisuje na własnym urządzeniu i potwierdza 6-cyfrowym kodem.
</Tab>
<Tab value="Aan de receptie">
Kliknij **Wyślij**, otwórz prośbę i kliknij przy Jonasie **Podpisz na tablecie**. Wybierz **Z kodem** albo **Bez kodu**, jeśli tożsamość została sprawdzona przy recepcji. Umowa otworzy się na tablecie, z jego imieniem i nazwiskiem dużymi literami.
</Tab>
</Tabs>

Wszystkie szczegóły znajdziesz w [Prośba o podpisy](/handtekeningen/handtekening-vragen) i [Tak podpisuje odbiorca](/handtekeningen/ondertekenen).
</Step>
<Step>
### Zaksięguj opłatę za postój [#boek-het-staangeld]
Wróć do karty **Zajęcia miejsc** na profilu Jonasa, otwórz menu przy zajęciu miejsca i wybierz **Przedłuż zajęcie miejsca (faktura)**. Kliknij **Utwórz szkic faktury**. Tillor tworzy szkic faktury z produktem z akcją **Przedłuż okres zajęcia miejsca**. Sprawdź okres na fakturze i kliknij **Zaksięguj fakturę**.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Szkic faktury z przyciskiem Zaksięguj fakturę" />

Faktura otrzymuje numer i status <Status tone="success">Zarezerwowane</Status>. Zobacz [Księgowanie faktury](/facturen/boeken) i [Przedłużenie zajęcia miejsca](/bezettingen#facturatie-bezetting-verlengen).
</Step>
<Step>
### Wybierz, jak Jonas zapłaci [#kies-hoe-jonas-betaalt]
Księgowanie niczego nie wysyła do klienta. Teraz wybierasz, w jaki sposób wpłynie pieniądz.

<Tabs items={["Betaallink", "Incasso met mandaat", "Aan de receptie"]}>
<Tab value="Betaallink">
Kliknij **Wyślij powiadomienie** i wybierz kanał, na przykład **E-mail**. Jonas otrzyma przycisk **Zobacz i zapłać online** i zakończy płatność na przykład przez iDEAL lub Bancontact. Jeśli chce najpierw zapłacić tylko część, utwórz [link do płatności częściowej](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). Zobacz [Płatności online](/betalingsverwerking/online).
</Tab>
<Tab value="Incasso met mandaat">
Najpierw poproś o mandat przez <UIPath>Klienci > Jonas Maes > Fakturowanie</UIPath> i **Utwórz mandat**. Gdy status zmieni się na <Status tone="success">Aktywny</Status>, wybierz ten mandat na fakturze w polu **Mandat polecenia zapłaty**. Tillor pobiera kwotę dwa dni po zaksięgowaniu albo dwa dni po powiązaniu, jeśli faktura była już zaksięgowana. Zobacz [Podpisanie mandatu SEPA](/betalingsverwerking/mandaat) i [Pobranie należności z faktury](/betalingsverwerking/incasso).
</Tab>
<Tab value="Aan de receptie">
Kliknij **Dokonaj płatności** i wybierz **Terminal**, **Gotówka** lub **Przelew**. Zobacz [Rejestrowanie płatności](/betalingsverwerking/betaling-registreren).
</Tab>
</Tabs>
</Step>
<Step>
### Zobacz, jak wpływa płatność [#zie-de-betaling-binnenkomen]
W <UIPath>Administracja > Płatności</UIPath> znajdziesz płatność. Płatność online pojawia się, gdy Mollie ją potwierdzi. Polecenie zapłaty ma najpierw status <Status tone="warning">Aż do</Status>, a po kilku dniach zmienia się na <Status tone="success">Płatny</Status>. Gdy wszystko wpłynie, faktura ma status <Status tone="success">Płatny</Status>.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Przegląd wszystkich płatności" />

Więcej znajdziesz w [Wyszukiwanie płatności](/betalingsverwerking/betalingen-bekijken).
</Step>
<Step>
### Zobacz płatność w raporcie płatności [#zie-de-betaling-in-het-betalingsrapport]
Przejdź do <UIPath>Administracja > Raporty płatności</UIPath>. Dzisiejsze płatności znajdują się w raporcie ze statusem **Wersja robocza**. Tillor finalizuje raport przy najbliższej codziennej kontroli, w dni robocze o 09:00. Jeśli integracja z księgowością jest aktywna, Tillor sam przekazuje raport dalej.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Lista raportów płatności" />

Zobacz [Raporty płatności](/boekhouden/betalingsrapporten).
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Zajęcie miejsca Jonasa trwa. Działka 12 nie jest już dostępna dla innych klientów, a zużycie liczników na działce trafia do Jonasa.
- Gdy wszyscy podpiszą, prośba otrzymuje status <Status tone="success">Zakończona</Status>. Podpisany pdf ze stronami dowodowymi znajduje się w jego **Dokumenty**. Jeśli chcesz, aby automatyzacja coś wtedy zrobiła, na przykład utworzyła zadanie, użyj wyzwalacza **Prośba o podpis zakończona**.
- Przy księgowaniu faktury Tillor ustawia **Zafakturowane do** na koniec pozycji faktury. Po zapłacie przesuwa się **Opłacone do**. Zobacz [Opłacone do, typ, częstotliwość czynszu i cena](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).
- W następnym sezonie przedłużasz to samo zajęcie miejsca ponownie przez **Przedłuż zajęcie miejsca (faktura)**, albo dla wszystkich zajęć klienta naraz przez **Przedłuż wszystkie**.
- Płatności Mollie znajdują się w roboczym raporcie jako zaliczka u Mollie, do czasu poznania wypłaty.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Działki 12 nie ma na liście w oknie Utwórz zajęcie miejsca">
Działka może być powiązana tylko z jednym klientem naraz. Jeśli ma już aktywne zajęcie miejsca, nie pojawi się na liście. Najpierw zakończ to zajęcie, zobacz [Zakończenie zajęcia miejsca](/bezettingen#een-bezetting-beëindigen).
</Accordion>
<Accordion title="Nie mogę wysłać prośby o podpis">
Tillor sprawdza prośbę i mówi, czego brakuje: osoby podpisującej bez pola podpisu, osoby podpisującej bez adresu e-mail lub numeru telefonu albo pustego tytułu. Napraw to i spróbuj ponownie. Zobacz [Prośba o podpisy](/handtekeningen/handtekening-vragen#problemen).
</Accordion>
<Accordion title="Przycisk Zaksięguj fakturę jest szary">
Najedź myszą na przycisk, Tillor pokaże powód. Często brakuje daty początkowej lub końcowej w pozycji z zajęciem miejsca albo kwota przekracza maksimum powiązanego mandatu. Zobacz [Gdy księgowanie się nie udaje](/facturen/boeken#problemen).
</Accordion>
<Accordion title="Przedłuż zajęcie miejsca (faktura) nie daje użytecznej faktury">
Musi istnieć co najmniej jeden produkt z akcją **Przedłuż okres zajęcia miejsca**. Bez takiego produktu Tillor nie może zbudować pozycji. Utwórz produkt lub dodaj akcję, zobacz [Powiązanie akcji z produktem](/producten/acties-instellen).
</Accordion>
<Accordion title="Mandat SEPA jest szary w oknie Dokonaj płatności">
Jonas nie ma mandatu o statusie <Status tone="success">Aktywny</Status>, którego kwota maksymalna jest wystarczająco wysoka. Sprawdź kartę **Mandaty** na jego zakładce **Fakturowanie**.
</Accordion>
<Accordion title="Faktura ma status Aż do">
Płatność została rozpoczęta, ale pieniądze nie wpłynęły jeszcze ostatecznie. To normalne przy poleceniu zapłaty. Gdy płatność zostanie przetworzona, status zmieni się na **Płatny**. Zobacz [Statusy](/facturen/statussen).
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Rozliczanie zużycia" href="/praktijk/verbruik-aanrekenen" description="Ciąg dalszy: ile wody i prądu zużywa Jonas" />
  <Card title="Zajęcia miejsc" href="/bezettingen" />
  <Card title="Podpisy" href="/handtekeningen" />
  <Card title="Faktury" href="/facturen" />
  <Card title="Obsługa płatności" href="/betalingsverwerking" />
</Cards>


# Przyczepa stacjonarna się zwalnia (/pl-PL/praktijk/stacaravan-komt-vrij)

Gdy klient wyjeżdża z przyczepy stacjonarnej, pojawia się praca: przyczepę trzeba sprawdzić, a kaucja musi wrócić do klienta. Ten przykład pokazuje, jak Tillor to łączy. Kończysz zajęcie miejsca, automatyzacja tworzy zadanie kontrolne, współpracownik je wykonuje, a potem załatwiasz kaucję. Jako przykład służą Jonas Maes i działka 12 w Recreatiepark Het Meer, teraz jako najemca przyczepy stacjonarnej.

```mermaid
flowchart LR
  A[Bezetting stoppen] --> B[Automatisering]
  B --> C[Nalooptaak met subtaken]
  C --> D[Collega rondt af]
  D --> E[Waarborg terug via creditnota]
```

Zanim zaczniesz:

- Działka 12 ma typ działki **Przyczepa stacjonarna**, a Jonas ma na niej aktywne zajęcie miejsca. Zobacz [Typy działek](/terreinen#terreintypes).
- Jest gotowa automatyzacja, która po zakończeniu zajęcia miejsca tworzy zadanie. Jak ją zbudować, opisuje [Przykład: kontrola przyczepy do wynajęcia](/automatiseringen/voorbeeld-nalopen). W środowiskach demo jest już gotowa pod nazwą **Kontrola przyczepy do wynajęcia**, wstrzymana, dopóki nie włączysz przełącznika **Aktywna**.
- Dla kaucji: produkt kaucji ma włączoną opcję **Pilnuj salda klienta na tym koncie**. Zobacz [Pilnowanie salda klienta](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

## Droga krok po kroku [#de-route-stap-voor-stap]

<Steps>
<Step>
### Zakończ zajęcie miejsca [#stop-de-bezetting]
Otwórz profil Jonasa, na zakładce **Przegląd** przejdź do karty **Zajęcia miejsc**, otwórz menu przy zajęciu miejsca i wybierz **Usuń**. W polu **Data** wybierz dzień jego wyjazdu. Jeśli działka ma liczniki, wypełnij **Końcowe odczyty liczników**. Kliknij **Usuń**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu akcji przy zajęciu miejsca" />

Działka 12 jest potem znów wolna dla nowego zajęcia miejsca. Zobacz [Zakończenie zajęcia miejsca](/bezettingen#een-bezetting-beëindigen).
</Step>
<Step>
### Pozwól automatyzacji utworzyć zadanie kontrolne [#laat-de-automatisering-de-nalooptaak-maken]
Nie musisz nic robić. Automatyzacja uruchamia się, gdy zajęcie miejsca się kończy, i najpierw sprawdza, czy działka ma typ **Przyczepa stacjonarna**. Potem szuka, czy dla tej działki jest już otwarte zadanie **Kontrola**.

- Jeśli nie ma jeszcze otwartego zadania, tworzy zadanie **Kontrola działki 12** z pięcioma podzadaniami (**Sprzątanie**, **Wyposażenie**, **Internet + TV**, **Ramka z kodem QR** i **Kontrola drobnych prac**) i terminem po 7 dniach. Zadanie trafia też do współpracownika, który zakończył zajęcie miejsca.
- Jeśli otwarte zadanie już jest, na przykład dlatego, że przyczepa zwolniła się dwa razy krótko po sobie, nie tworzy drugiego. Priorytet istniejącego zadania rośnie o jeden stopień, aż do **Wysoki**.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Krok Utwórz zadanie kontrolne w automatyzacji" />

To, co zrobiła automatyzacja, śledzisz w [Testy i uruchomienia](/automatiseringen/testen-en-uitvoeringen).
</Step>
<Step>
### Wykonaj zadanie [#werk-de-taak-af]
Współpracownik znajdzie zadanie w karcie **Zadania dla Pana/Pani** na pulpicie, na zakładce **Zadania** Jonasa albo w widoku w sekcji **Zadania**. Zadanie jest powiązane z działką 12 i z Jonasem.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Okno zadania z opisem, podzadaniami i właściwościami" />

<Tabs items={["Met subtaken", "Met keuzeknoppen"]}>
<Tab value="Met subtaken">
Otwórz zadanie i odhaczaj każde podzadanie, gdy jest zrobione. Obok zadania widać licznik, na przykład **2/5**. Gdy wszystkie podzadania są gotowe, ustaw status na **Ukończone**. Jeśli ustawisz zadanie główne na **Ukończone**, otwarte podzadania zostaną ukończone razem z nim.
</Tab>
<Tab value="Met keuzeknoppen">
Jeśli rozszerzysz automatyzację o krok **Poproś o decyzję**, na przykład aby zdecydować, czy kaucja zostanie zwrócona w całości, na zadaniu pojawią się przyciski pod **Wybierz akcję, aby zakończyć to zadanie**. Jedno kliknięcie kończy zadanie. Jeśli wybór wymaga uzasadnienia, otworzy się **Dlaczego ten wybór?**. Dokonanego wyboru nie można potem cofnąć. Zobacz [Zadania z przyciskami wyboru](/taken/taakdetails#taken-met-keuzeknoppen) i [Poproś o decyzję](/automatiseringen/logica#vraag-om-een-beslissing).
</Tab>
</Tabs>
</Step>
<Step>
### Sprawdź saldo kaucji [#controleer-het-saldo-van-de-waarborg]
Otwórz profil Jonasa i przejdź do zakładki **Fakturowanie**. W tabeli **Konta** widzisz saldo na każdym koncie księgowym. Konto kaucji pokazuje, ile Jonas ma jeszcze do odzyskania.
</Step>
<Step>
### Utwórz fakturę korygującą kaucji [#maak-de-creditnota-voor-de-waarborg]
Otwórz fakturę kaucji Jonasa, kliknij trzy kropki w prawym górnym rogu i wybierz **Stornuj fakturę**. Tillor tworzy szkic faktury z tymi samymi pozycjami w kwotach ujemnych. Jeśli zatrzymujesz część, na przykład za szkody, zmień kwotę. Kliknij **Zaksięguj fakturę**. Faktura staje się **Faktura kredytowa**.

Tillor odrzuca fakturę, która sprowadziłaby saldo konta kaucji poniżej zera. Dzięki temu nie zwrócisz kaucji dwa razy. Zobacz [Storno faktury](/facturen/corrigeren#een-factuur-omkeren).
</Step>
<Step>
### Rozlicz kwotę [#verreken-het-bedrag]
Jeśli Jonas ma jeszcze nieopłaconą fakturę, na przykład za ostatnie zużycie, możesz rozliczyć kwotę metodą płatności **Przelew wewnętrzny**. Zobacz [Wykonanie przelewu wewnętrznego](/betalingsverwerking/interne-overboeking).
</Step>
</Steps>

<Callout type="info" title="Zwrot pieniędzy">
Tillor rejestruje fakturę korygującą i rozliczenie. Samą kwotę zwracasz na rachunek bankowy klienta przez swój bank.
</Callout>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Działka jest znów wolna. Nowy klient może na niej zająć miejsce lub dostać rezerwację.
- Otwarte okresy zużycia Jonasa są zamknięte, ze stanami końcowymi, które wpisałeś. Zużycie do daty końcowej zostaje zachowane i nadal możesz je zafakturować. Zobacz [Rozliczanie zużycia](/praktijk/verbruik-aanrekenen).
- Zadanie i akcje na nim są w osi czasu zadania i na profilu Jonasa. Zmiany zajęcia miejsca są na jego zakładce **Zdarzenia**.
- Faktura korygująca trafia do księgowości jak każda inna faktura.

## Problemy? [#problemen]

<Accordions>
<Accordion title="Nie utworzono zadania kontrolnego">
Sprawdź trzy rzeczy. Czy przełącznik **Aktywna** automatyzacji jest włączony? Czy typ działki 12 to **Przyczepa stacjonarna**? Sprawdź w [Testy i uruchomienia](/automatiseringen/testen-en-uitvoeringen), czy automatyzacja się uruchomiła i gdzie się zatrzymała.
</Accordion>
<Accordion title="Są dwa zadania kontrolne albo tylko jedno">
Automatyzacja szuka otwartego zadania o dokładnie takim samym tytule, **Kontrola** i nazwa działki, dla tej samej działki, tego samego klienta lub tej samej rezerwacji. Jeśli tytuł się nie zgadza, nie znajdzie istniejącego zadania i utworzy nowe. Otwarte zadanie dostaje tylko wyższy priorytet, nie drugie zadanie.
</Accordion>
<Accordion title="Nie mogę ukończyć zadania">
Jeśli widzisz **Kończy ją automatyzacja**, tylko automatyzacja może zakończyć zadanie, a zadanie nie ma przycisku **Usuń**. Zobacz [Szczegóły zadania](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
<Accordion title="Nie widzę przycisków wyboru">
Wybierać może osoba przypisana do zadania oraz administrator. Jeśli nikt nie jest przypisany, wybierać może każdy, kto widzi zadanie. Jeśli zamiast przycisków jest ptaszek, zadanie nie pochodzi z kroku **Poproś o decyzję**.
</Accordion>
<Accordion title="Zaksięguj fakturę jest szare przy fakturze korygującej kaucji">
Saldo konta kaucji spadłoby poniżej zera. Sprawdź tabelę **Konta** i kwotę na fakturze. Z uprawnieniem **Pomijanie salda konta** możesz mimo to zaksięgować, z uzasadnieniem, które trafi do osi czasu faktury.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Przykład: kontrola przyczepy do wynajęcia" href="/automatiseringen/voorbeeld-nalopen" description="Tak zbudujesz automatyzację samodzielnie" />
  <Card title="Zadania" href="/taken" />
  <Card title="Korekta faktury" href="/facturen/corrigeren" />
  <Card title="Zajęcia miejsc" href="/bezettingen" />
</Cards>


# Rozliczanie zużycia (/pl-PL/praktijk/verbruik-aanrekenen)

Rozliczanie zużycia w Tillor działa przez działkę: licznik należy do działki, klient trafia na działkę przez zajęcie miejsca, a zużycie licznika idzie na konto tego klienta. Ten przykład śledzi licznik prądu na działce 12 w Recreatiepark Het Meer, od przypisania do faktury Jonasa Maesa. Na końcu opisano, jak Tillor może też sam utworzyć i wysłać tę fakturę.

```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]
```

Zanim zaczniesz:

- Licznik już istnieje w <UIPath>Park > Liczniki</UIPath> i nie jest jeszcze przypisany do działki. Licznik, który już jest przypisany do działki, nie pojawia się na liście wyboru.
- Jonas ma aktywne zajęcie miejsca na działce 12. Zobacz [Pozyskanie klienta sezonowego](/praktijk/seizoensklant-binnenhalen). Bez zajęcia miejsca Tillor nie wie, do kogo należy zużycie.
- Do automatycznej faktury Jonas potrzebuje adresu e-mail lub numeru telefonu, a do automatycznego pobierania aktywnego mandatu.

## Droga krok po kroku [#de-route-stap-voor-stap]

<Steps>
<Step>
### Przypisz licznik do działki 12 [#koppel-de-meter-aan-terrein-12]
Przejdź do <UIPath>Park > Działki</UIPath>, otwórz działkę 12 i przewiń do karty **Liczniki**. Kliknij **Dodaj licznik**, wybierz licznik i kliknij **Przypisz licznik**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Strona szczegółów działki 12 z kartą Liczniki" />

Zobacz [Zarządzanie licznikami](/meterbeheer/meter-koppelen) i [Działki](/terreinen).
</Step>
<Step>
### Zapisz stan początkowy [#leg-de-beginstand-vast]
Jeśli Jonas jest już zapisany na działce 12, wpisz stan początkowy przy zajęciu miejsca. Jeśli dopiero tworzysz zajęcie miejsca, wypełnij **Początkowe odczyty liczników**. Jeśli zostawisz puste, Tillor weźmie ostatni znany stan. Dzięki temu pierwsza partia zużycia od razu startuje od właściwego stanu. Zobacz [Zajęcia miejsc](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Śledź odczyty liczników [#volg-de-meterstanden]
Inteligentne liczniki same przesyłają swój stan, zwykle codziennie lub co tydzień. Licznik ręczny odczytujesz i wpisujesz samodzielnie. Zobacz [Zarządzanie licznikami](/meterbeheer).

Zużycie zobaczysz w dwóch miejscach. Na stronie licznika w <UIPath>Park > Liczniki</UIPath> jest karta **Zużycie** z otwartym i rozliczonym zużyciem na klienta. Na profilu Jonasa jest karta **Odczyty**, ze wszystkimi licznikami na jego działkach.

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Strona licznika z kartą Zużycie" />

Jeśli ktoś wpisze stan niższy niż poprzedni, Tillor ostrzega. Jeśli stan mimo to jest poprawny (licznik wymieniono), Tillor zamyka bieżący okres i zaczyna nowy. Zobacz [Partie zużycia](/meterbeheer/consumptie-batches).
</Step>
<Step>
### Zobacz, co czeka na rozliczenie [#bekijk-wat-openstaat]
Przejdź do <UIPath>Klienci > Niezafakturowane zużycie</UIPath>. Widzisz na klienta kwotę łączną, **Ostatnia faktura za media** i liczbę liczników. Jonas pojawia się na liście, gdy tylko ma zużycie, którego nie ma jeszcze na fakturze.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Przegląd klientów z niezafakturowanym zużyciem" />
</Step>
<Step>
### Utwórz fakturę [#maak-de-factuur]
Masz dwa sposoby.

<Tabs items={["Vanuit de lijst", "Vanuit het klantprofiel"]}>
<Tab value="Vanuit de lijst">
Kliknij ikonę wysyłania na końcu wiersza Jonasa. Okno **Utwórz fakturę** pokazuje kwotę łączną, podział według typu i liczbę liczników. Zaznacz kanały, którymi Tillor od razu wyśle fakturę, i kliknij **Utwórz fakturę**. Tillor tworzy fakturę, księguje ją i wysyła. Jeśli Jonas ma mandat na faktury za media, jest on wybrany z góry w polu **Pobierz w ramach upoważnienia**.
</Tab>
<Tab value="Vanuit het klantprofiel">
Otwórz profil Jonasa i kliknij w karcie **Odczyty** **Zafakturuj zużycie**. Tillor tworzy dla każdego okresu zużycia pozycję główną, a pod nią pozycję informacyjną z datą i stanami liczników. Jeśli istnieje odpowiedni szkic faktury, pozycje trafiają na niego. Sprawdź fakturę, zaksięguj i wyślij ją samodzielnie. Zobacz [Księgowanie faktury](/facturen/boeken) i [Wysyłanie faktury](/facturen/versturen).
</Tab>
</Tabs>
</Step>
<Step>
### Pozwól Tillor zrobić to samemu [#laat-tillor-het-zelf-doen]
Otwórz profil Jonasa, przejdź do <UIPath>Klienci > Jonas Maes > Fakturowanie</UIPath> i otwórz kartę **Ustawienia faktury**. Tam ustawiasz:

- **Automatyczne fakturowanie za media**: dzień miesiąca. Jeśli wybierzesz 31, a miesiąc nie ma 31 dni, faktura trafi na ostatni dzień miesiąca.
- **Mandat**: mandat, którym Tillor pobiera należność za faktury za media. Zobacz [Pobranie należności z faktury](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
- **Kwota minimalna**: własna dolna granica dla Jonasa. Jeśli zostawisz puste, obowiązuje minimum organizacji w <UIPath>Pomoc > Ustawienia > Fakturowanie</UIPath>.

W wybranym dniu Tillor sam tworzy fakturę i ją wysyła. Jeśli otwarta kwota jest poniżej minimum, Tillor czeka do następnego dnia fakturowania.
</Step>
</Steps>

## Co dzieje się potem? [#wat-gebeurt-er-daarna]

- Zafakturowane okresy zużycia są zakończone. Jeśli zajęcie miejsca trwa dalej, Tillor rozpoczyna nowy okres od stanu końcowego poprzedniego, aby nie powstała luka.
- Gdy faktura jest zaksięgowana, toczy się dalej jak każda inna faktura: płatność, monit i raport płatności. Zobacz [Pozyskanie klienta sezonowego](/praktijk/seizoensklant-binnenhalen).
- Po zakończeniu zajęcia miejsca Tillor zamyka otwarte okresy. Zużycie do daty końcowej zostaje zachowane i nadal możesz je zafakturować.
- Jeśli usuniesz szkic faktury ze zużyciem, zużycie wraca do **Niezafakturowane zużycie**.

<Callout type="info" title="Zużycie wyraźnie powyżej normy">
Jeśli otwarte zużycie prądu lub wody jest co najmniej dwa razy wyższe niż zwykle u Jonasa, Tillor nie tworzy automatycznej faktury. Dostajesz e-mail na adres wsparcia organizacji. Sprawdź stan licznika i jeśli wszystko się zgadza, zafakturuj zużycie samodzielnie.
</Callout>

## Problemy? [#problemen]

<Accordions>
<Accordion title="Licznika nie ma na liście w oknie Dodaj licznik">
Lista pokazuje tylko liczniki bez działki. Jeśli licznik jest już przypisany do innej działki, najpierw go odłącz przez menu przy liczniku na tej działce, wybierając **Odłącz od działki**.
</Accordion>
<Accordion title="Jonas nie ma zużycia przy liczniku działki 12">
Zużycie trafia do klienta z aktywnym zajęciem miejsca na działce. Sprawdź, czy Jonas ma zajęcie miejsca na działce 12 i czy licznik jest przypisany do działki.
</Accordion>
<Accordion title="Jonasa nie ma w Niezafakturowane zużycie">
Lista domyślnie pokazuje tylko klientów bez automatycznego fakturowania. Ustaw filtr **Automatyczne fakturowanie** na **Z datą**, aby zobaczyć klientów z automatycznym dniem fakturowania.
</Accordion>
<Accordion title="Automatyczna faktura nie została utworzona">
Są dwie częste przyczyny. Otwarta kwota jest poniżej minimum, wtedy Tillor czeka do następnego dnia fakturowania. Albo zużycie jest wyraźnie powyżej normy, wtedy dostajesz e-mail na adres wsparcia, a faktura nie powstaje, dopóki ktoś jej nie sprawdzi. Zobacz [Zarządzanie licznikami](/meterbeheer/verbruik-factureren#automatisch-factureren).
</Accordion>
<Accordion title="Zużycie zostało już zafakturowane poza Tillor">
Otwórz okres w karcie **Odczyty** lub **Zużycie**, kliknij ikonę ostrzeżenia obok okresu i potwierdź przez **Tak, oznacz jako zafakturowane**. Okres zamyka się wtedy bez faktury. Możesz to cofnąć tylko dla okresów bez powiązania z fakturą.
</Accordion>
</Accordions>

## Zobacz także [#zie-ook]

<Cards>
  <Card title="Zarządzanie licznikami" href="/meterbeheer" />
  <Card title="Partie zużycia" href="/meterbeheer/consumptie-batches" description="Jak okresy zużycia są śledzone i fakturowane" />
  <Card title="Pobranie należności z faktury" href="/betalingsverwerking/incasso" />
  <Card title="Ustawienia fakturowania" href="/gebruikers/instellingen-facturatie" />
</Cards>