# Prezentare generală (/ro-RO/aan-de-slag) Pe această pagină parcurgeți prima zi în Tillor: de la autentificare până la prima factură. Ordinea contează, pentru că fiecare element se sprijină pe cel anterior. O ocupare are nevoie, de exemplu, de un client și de o parcelă, așa că pe acestea le creați mai întâi. Dacă preferați să urmați un exemplu din practică, consultați [Din practică](/praktijk). Dacă dați peste un termen pe care nu îl cunoașteți, căutați-l în [Termeni](/begrippen). ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Iată elementele de bază și ce au nevoie: ```mermaid flowchart LR I[Setări] --> T[Parcele] T --> B[Ocupare] T --> R[Rezervare] K[Clienți] --> B K --> R P[Produse] --> F[Factură] K --> F B --> F R --> F F --> Bet[Plată] ``` O factură aparține întotdeauna unui client. Un client pe o parcelă pentru o perioadă mai lungă se numește ocupare, iar o ședere cu dată de check-in și de check-out se numește rezervare. Produsele nu sunt obligatorii, dar asigură că prețul, TVA-ul și acțiunile de pe rândul facturii sunt corecte. - Dacă aveți mai multe organizații, după autentificare alegeți una. Dacă una lipsește, rugați administratorul să vă invite. - Elementele de meniu pe care le vedeți depind de drepturile dumneavoastră. Dacă nu vedeți ceva, cereți administratorului dreptul respectiv. - Fără parcelă nu puteți crea o ocupare. Fără client nu puteți crea o rezervare, o ocupare sau o factură. - Plățile în numerar, prin transfer și alte plăți manuale funcționează fără integrare. Pentru plata online sau cu cardul la terminal conectați Mollie. - Cea mai rapidă metodă de a găsi ceva este căutarea cu **Ctrl+K** sau **⌘K**. Înainte de a începe: - Aveți un cont Microsoft, Google sau Apple, iar administratorul v-a invitat în organizația dumneavoastră. Fără invitație nu vedeți nicio organizație. - Aveți drepturile pentru ceea ce doriți să faceți. Dacă vă lipsesc, elementul de meniu lipsește sau butonul este inactiv. ## Configurați-vă parcul [#je-park-inrichten] ### Autentificați-vă și alegeți organizația [#log-in-en-kies-je-organisatie] Autentificați-vă cu contul Microsoft, Google sau Apple. Dacă aveți acces la mai multe organizații, alegeți una. Dacă nu aveți încă acces, rugați administratorul să vă invite. Consultați [Autentificare](/inloggen). ### Verificați setările organizației [#loop-de-organisatie-instellingen-na] Deschideți Asistență > Setări. Sub **General** verificați fusul orar și țara implicită, iar sub **Program de funcționare** completați orele de deschidere. Sub **Facturare** găsiți, printre altele, termenul de scadență implicit și cotele de TVA. Colegii îi invitați sub **Utilizatori**. Consultați [Organizație](/gebruikers/organisaties). ### Creați-vă parcelele [#maak-je-terreinen-aan] Mergeți la Parc > Terenuri și adăugați locurile dumneavoastră, precum loturi, căsuțe și locuri fixe. Fără parcelă nu puteți crea o ocupare, iar contoarele le legați de o parcelă. Consultați [Terenuri](/terreinen). ### Creați-vă produsele [#maak-je-producten-aan] Mergeți la Administrare > Produse și creați tarifele și serviciile care apar pe facturi, cum ar fi nopțile de ședere. Un rând de factură poate exista și fără produs, dar cu un produs prețul, TVA-ul și eventualele acțiuni sunt corecte de la început. Consultați [Produse](/producten). ### Adăugați-vă clienții [#voeg-je-klanten-toe] Mergeți la Clienți > Prezentare generală și creați un client. Rezervările, ocupările și facturile aparțin întotdeauna unui client. Consultați [Gestionarea clienților](/klantenbeheer). ### Creați o rezervare sau o ocupare [#maak-een-reservering-of-bezetting-aan] O rezervare este pentru o ședere cu dată de check-in și de check-out și o puteți crea și fără parcelă fixă. O ocupare leagă un client de o parcelă pentru o perioadă mai lungă, de exemplu un loc anual. Consultați [Rezervări](/reserveringen) și [Ocupări](/bezettingen). ### Creați prima factură [#maak-je-eerste-factuur] Deschideți profilul clientului și creați acolo o factură nouă. Adăugați rânduri, înregistrați factura și trimiteți-o. Consultați [Facturi](/facturen). ### Conectați plățile [#koppel-betalingen] Dacă doriți ca clienții să plătească online sau cu cardul la terminal, conectați Mollie prin Asistență > Setări, sub **Integrări**. Plățile în numerar, prin transfer și alte plăți manuale funcționează fără integrare. Consultați [Procesarea plăților](/betalingsverwerking) și [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie). Dacă folosiți contoare, bariere sau tag-uri NFC, le configurați după aceea. Consultați mai întâi [Parc](/park) și [Control acces](/toegangscontrole). ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Clienții, parcelele și produsele dumneavoastră sunt pregătite, astfel încât să puteți crea zilnic rezervări, ocupări și facturi. - Prima dumneavoastră factură rămâne ciornă la client. Abia după **Înregistrați** primește un număr definitiv, iar apoi o puteți trimite și o puteți încasa. - Dacă ați conectat Mollie, clienții pot plăti online sau cu cardul la terminal, iar plata apare automat pe factură. ## Orientarea în aplicație [#je-weg-vinden] Meniul principal se află în stânga. Sus schimbați organizația, dacă aveți mai multe. Elementele pe care le vedeți depind de drepturile dumneavoastră. | Meniu | Pentru ce | |------|----------| | **Panou** | Ecran de start cu sosirile și plecările de astăzi | | **Rezervări** | Șederile și calendarul de rezervări | | **Sarcini** | Distribuirea și urmărirea muncii | | **Control acces** | Puncte de acces și jurnal de acces | | **Clienți** | **Prezentare generală** și **Consum nefacturat** | | **Parc** | **Hartă**, **Terenuri**, **Contoare**, **Dulapuri de contoare** și **Vreme** | | **Comunicare** | **Apeluri telefonice**, **Notificări** și **Comentarii** | | **Administrare** | **Documente**, **Semnături**, **Facturi**, **Plăți**, **Tranzacții bancare** (cu dreptul de a le vizualiza), **Rapoarte de plată**, **Coadă de imprimare** și **Produse** | Sub titlul **Administrator** se află **Automatizări** (cu dreptul de a le vizualiza) și **Controlere**. În partea de jos, sub **Asistență**, găsiți notificările, **Inbox** și **Jurnal de audit** (cu drepturile corespunzătoare), **Setări** și **Mai multe resurse** cu documentația. Elementele pe care le vedeți depind de drepturile dumneavoastră. Căutați cu **Căutați** din antet sau cu **⌘K** (Mac) ori **Ctrl+K** (Windows). Astfel ajungeți direct la un client, o factură, o rezervare sau o parcelă. Consultați [Căutare](/zoeken). Contul dumneavoastră, sesiunile și cheile API le găsiți prin numele dumneavoastră din partea de jos a meniului. ## Probleme? [#problemen] Administratorul trebuie să vă invite mai întâi. Autentificați-vă cu contul cu care v-a invitat. Consultați [Autentificare](/inloggen). Vedeți doar elementele pentru care aveți drepturi. Cereți administratorului dreptul sau rolul corespunzător. Nu este disponibilă nicio parcelă sau clientul nu există încă. Creați mai întâi o parcelă și un client. O parcelă cu o ocupare în curs nu apare în lista de alegere. Folosiți **Căutați** din antet sau căutați în acest manual cu bara de căutare din partea de sus. ## Aveți nevoie de ajutor? [#hulp-nodig] - Dacă căutați ceva în acest manual, folosiți bara de căutare din partea de sus sau alegeți în Tillor **Mai multe resurse > Documentație**. - Tillor nu funcționează cum vă așteptați? Verificați mai întâi [starea sistemului](https://status.tillor.eu) pentru defecțiuni și întreținere planificată. - Nu aveți acces la o organizație sau doriți să modificați datele firmei de pe facturi? Scrieți la support@tillor.eu. - Doriți să recuperați date dintr-o copie de rezervă? Consultați [Date și copii de rezervă](/gegevens-backups). ## Termeni [#begrippen] - **Organizație**: contul dumneavoastră Tillor, de obicei firma dumneavoastră. Consultați [Termeni](/begrippen#organisatie). - **Parc**: locul fizic. Consultați [Termeni](/begrippen#park). - **Client**: o persoană sau o firmă în Tillor. Consultați [Termeni](/begrippen#klant). - **Parcelă**: un loc din parcul dumneavoastră. Consultați [Termeni](/begrippen#terrein). - **Ocupare** și **rezervare**: un client pe o parcelă pentru o perioadă mai lungă, sau o ședere cu dată de check-in și de check-out. Consultați [Termeni](/begrippen#bezetting). - **Înregistrare**: finalizarea unei facturi. Consultați [Termeni](/begrippen#boeken). ## Vezi și [#zie-ook] # Termeni (/ro-RO/begrippen) Tillor folosește câteva cuvinte mai des decât v-ați aștepta, iar unele seamănă între ele. Pe această pagină găsiți, pentru fiecare termen, ce înseamnă și unde puteți citi mai mult. Lista este în ordinea alfabetică a termenilor olandezi originali. Dacă doriți informații despre controlere în sine, cum ar fi ACL sau firmware, consultați [glosarul controlerelor](/controllers/lexicon). O **ocupare** este un client care stă mai mult timp pe o parcelă, de exemplu un client sezonier. O **rezervare** este o rezervare pentru o singură ședere. Prin **înregistrare**, Tillor înțelege întotdeauna finalizarea unei facturi, niciodată rezervarea unei șederi. ### Somație [#aanmaning] O reamintire către un client că o factură înregistrată nu a fost încă plătită. O trimiteți per factură, cu același link pentru plata online. Consultați [Trimiterea unei somații](/facturen/versturen#een-aanmaning-versturen). ### Automatizare [#automatisering] O regulă pe care Tillor o execută singur: când se întâmplă aceasta, fă aceea. De exemplu, crearea unei sarcini de urmărire când se încheie o ocupare. Pașii unei automatizări formează împreună un flux, desenul de pe canvas. Consultați [Automatizări](/automatiseringen). ### Plată [#betaling] O sumă pe care un client o plătește sau care este încă în curs, cu o metodă, un status și, de obicei, o factură. Le găsiți sub Administrare > Plăți. Consultați [Regăsirea plăților](/betalingsverwerking/betalingen-bekijken). ### Grup de plăți [#betalingsgroep] Un set de plăți sub un singur nume, pe care îl legați ulterior dintr-o dată de o factură înregistrată. De exemplu, toate plățile cu cardul de la terminal dintr-o zi. Consultați [Grupuri de plăți](/betalingsverwerking/groepen). ### Raport de plată [#betalingsrapport] Prezentarea tuturor plăților dintr-o singură zi calendaristică, destinată contabilității dumneavoastră. Raportul de astăzi este o ciornă și devine definitiv când ziua s-a încheiat. Consultați [Rapoarte de plată](/boekhouden/betalingsrapporten). ### Pagina de dovadă [#bewijspagina] Paginile de la finalul unui PDF semnat, cu titlul documentului, cine a semnat și când, plus două amprente digitale. Se numesc **Dovada semnării** și arată ulterior că documentul nu a fost modificat. Consultați [Dovadă și valabilitate](/handtekeningen/bewijs-en-geldigheid). ### Ocupare [#bezetting] Un client care se află pe o parcelă pentru o perioadă mai lungă. Cât timp ocuparea este în curs, Tillor facturează clientului consumul contoarelor de pe acea parcelă. O parcelă are cel mult un client în același timp. Consultați [Ocupări](/bezettingen). ### Înregistrare [#boeken] Finalizarea unei facturi ciornă. Factura primește un număr și apoi nu o mai puteți modifica liber. În Tillor, cuvântul nu are nicio legătură cu rezervarea. Consultați [Înregistrarea unei facturi](/facturen/boeken). ### Ciornă [#concept] O factură care nu a fost încă înregistrată. Puteți încă modifica rândurile, iar nimic nu a ajuns încă la client sau la contabilitate. Consultați [Statusurile unei facturi](/facturen/statussen). ### Conector [#connector] O cutiuță mică din rețeaua parcului dumneavoastră, care conectează Tillor cu dispozitivele de la fața locului, precum imprimantele și controlerele de acces. Tillor o livrează preconfigurată și o actualizează singur. Consultați [Conector](/connector). ### Controler [#controller] O cutiuță cu ecran tactil de pe parcul dumneavoastră, lângă un duș sau o ușă. Citește un tag NFC sau un cod QR, iar Tillor decide dacă oaspetele poate trece. Controlerele le gestionați sub **Controlere**. Consultați [Controlere](/controllers). ### Notă de credit [#creditnota] O factură cu sume negative, care anulează o factură anterioară. Aplicația o numește **notă de credit**. O creați cu **Stornați factura**. Consultați [Stornarea unei facturi](/facturen/corrigeren#een-factuur-omkeren). ### Câmp personalizat [#eigen-veld] Un câmp pe care organizația dumneavoastră îl adaugă singură unui client, unei parcele, unei ocupări, unui contor sau unei sarcini, peste câmpurile pe care le aduce Tillor. Le gestionați sub Setări > Câmpuri personalizate. Consultați [Câmpuri personalizate](/eigen-velden). ### Factură [#factuur] Ceea ce îi facturați unui client, cu rânduri pe produs. O factură nouă este întotdeauna o ciornă. O creați în profilul clientului și gestionați toate facturile sub Administrare > Facturi. Consultați [Facturi](/facturen). ### Eveniment [#gebeurtenis] Un rând din cronologia unui client, a unei facturi sau a altei înregistrări, care arată ce s-a întâmplat, cine a făcut-o și ce s-a schimbat. Consultați [Jurnal de activitate](/activiteitenlog). ### Utilizator [#gebruiker] Un cont cu acces la Tillor. În textul curent numim un alt utilizator coleg. Utilizatorii și drepturile lor le gestionați sub Setări > Utilizatori. Consultați [Organizație](/gebruikers/organisaties). ### Grup [#groep] Un set fix de colegi, de exemplu **Recepție**. Atribuiți sarcini unui grup, partajați vizualizări cu un grup și puteți acorda sau retrage drepturi unui grup. Consultați [Grupuri](/gebruikers/groepen). Un grup de plăți este altceva. ### Contul din registrul mare [#grootboek] Numărul de cont din contabilitatea dumneavoastră pe care se înregistrează un produs. Îl completați la produs și este trimis mai departe către contabilitate. Consultați [Numărul contului](/producten/product-aanmaken#grootboeknummer). ### Debit direct [#incasso] Tillor preia singur suma unei facturi din contul bancar al clientului. Acest lucru este posibil doar cu un mandat activ. Consultați [Încasarea unei facturi prin debit direct](/betalingsverwerking/incasso). ### Listă de opțiuni [#keuzelijst] O listă fixă de opțiuni din care un câmp personalizat de tipul **Alegere** sau **Alegere multiplă** își ia valorile. Creați lista o singură dată și o folosiți în mai multe câmpuri. Consultați [Liste de opțiuni](/eigen-velden/keuzelijsten). ### Kiosk [#kiosk] O tabletă Android care afișează aplicația Tillor și rămâne pe ea, astfel încât oaspeții să nu poată ajunge la setările dispozitivului. Consultați [Configurarea unui kiosk](/mobiele-app/kiosk-inrichten). ### Client [#klant] Înregistrarea din Tillor a unei persoane sau a unei firme: date, facturi, ocupări, metode de acces și multe altele. Cuvântul oaspete îl folosim doar în text obișnuit, pentru cineva care stă în parcul dumneavoastră. Consultați [Gestionarea clienților](/klantenbeheer). ### Mandat [#mandaat] Consimțământul unui client ca facturile să fie încasate din contul său bancar (un mandat SEPA). Clientul îl semnează chiar în Tillor. Consultați [Semnarea unui mandat SEPA](/betalingsverwerking/mandaat). ### Contor [#meter] Un aparat pentru apă, electricitate sau gaz. Un contor aparține unei parcele, nu unui client. Consumul merge la clientul care are în acel moment o ocupare pe parcelă. Consultați [Gestionarea contoarelor](/meterbeheer). ### Dulap de contoare [#meterkast] Un dulap în care se află contoare. Sub Parc > Dulapuri de contoare gestionați dulapurile de contoare și contoarele alocate acestora. Consultați [Parc](/park#meterkasten). ### Tag NFC [#nfc-tag] Un card, o brățară sau un breloc pe care un oaspete îl ține în fața unui controler, de exemplu pentru duș sau pentru un punct de acces. Un tag poate avea sold. Consultați [NFC](/nfc). ### Notificare [#notificatie] Un mesaj pe care Tillor îl trimite unui client sau unui coleg, prin e-mail, SMS, poștă, WhatsApp sau push. Sub Comunicare > Notificări vedeți dacă a ajuns. Consultați [Notificări](/notificaties). ### Cerere de semnare [#ondertekenverzoek] Cererea ca un PDF, precum un contract de închiriere, să fie semnat online de una sau mai multe persoane, pe rând. Le gestionați sub Administrare > Semnături. Consultați [Semnături](/handtekeningen). ### Consum nefacturat [#openstaand-verbruik] Consumul contoarelor care nu se află încă pe o factură. Îl vedeți per client sub Clienți > Consum nefacturat și îl facturați cu **Facturați consumul**. Consultați [Gestionarea contoarelor](/meterbeheer/verbruik-factureren). ### Comentariu [#opmerking] O notiță internă la un client, o factură, o rezervare sau o altă înregistrare. Comentariile nu sunt niciodată vizibile pentru client. Consultați [Comentarii](/notities). ### Organizație [#organisatie] Contul dumneavoastră Tillor, adică firma dumneavoastră cu utilizatorii, setările și datele ei. Parcul este locul fizic. Consultați [Organizație](/gebruikers/organisaties). ### Parc [#park] Locul fizic: campingul sau parcul dumneavoastră de recreere. Sub **Parc** găsiți harta, parcelele, contoarele și dulapurile de contoare. Consultați [Parc](/park). ### Peppol [#peppol] O rețea europeană prin care trimiteți facturile electronic, direct către sistemul contabil al destinatarului, fără PDF. Pentru facturile belgiene către firme cu număr de TVA este obligatoriu. Consultați [Peppol](/boekhouden/peppol). ### Produs [#product] Un tarif sau un serviciu pe care îl puneți pe un rând de factură, precum o noapte, taxa de staționare sau un kWh de curent. Un produs poate avea acțiuni pe care Tillor le execută la înregistrare sau la plată. Consultați [Produse](/producten). ### Acțiune de produs [#productactie] Ceva ce Tillor face automat când un rând de factură cu acest produs este înregistrat sau plătit, precum prelungirea unei ocupări sau încărcarea unui tag NFC. Consultați [Acțiuni de produs](/producten/productacties). ### Drept [#recht] Ce are voie să facă un utilizator în Tillor, de exemplu să editeze produse sau să reia facturi. Acordați drepturi per utilizator sau printr-un grup. O refuzare printr-un grup câștigă întotdeauna. Consultați [Editarea drepturilor](/gebruikers/organisaties#rechten-bewerken) și [Drepturile grupului](/gebruikers/groepen#groepsrechten). ### Rezervare [#reservering] O rezervare pentru o singură ședere pe o parcelă, cu sosire și plecare. O rezervare nu este același lucru cu o ocupare. Consultați [Rezervări](/reserveringen). ### Sarcină [#taak] O treabă pentru dumneavoastră sau pentru un coleg, cu, printre altele, un termen limită, subsarcini și clienți sau parcele asociate. Vizualizați sarcinile în vizualizări. Consultați [Sarcini](/taken). ### Tabletă [#tablet] Dispozitivul de la recepție pe care rulează aplicația Tillor, de exemplu pentru a-i da unui client un contract sau un mandat de semnat. Tabletele, kioskurile și telefoanele pe care cineva este autentificat le găsiți sub **Setări**. Consultați [Tablete și kioskuri](/mobiele-app/tablets-en-kiosken). ### Parcelă [#terrein] Un loc din parcul dumneavoastră pe care îl închiriați sau pe care planificați șederi, cu un nume și, eventual, contoare. De o parcelă legați contoare, iar clienții ajung pe ea printr-o ocupare sau o rezervare. Consultați [Terenuri](/terreinen). ### Tip de parcelă [#terreintype] O clasificare a parcelelor dumneavoastră, precum **Loc**, **Căsuță** sau **Loc pentru autorulote**. Folosiți tipul pentru a filtra lista, a colora harta și în automatizări. Consultați [Tipuri de parcelă](/terreinen#terreintypes). ### Metodă de acces [#toegangsmethode] Modul în care un client trece printr-un punct de acces: recunoașterea numărului de înmatriculare, un tag NFC sau un cod QR. Le gestionați la client, sub fila **Control acces**. Consultați [Control acces](/toegangscontrole). ### Punct de acces [#toegangspunt] O barieră, o poartă sau o ușă electronică unde se controlează accesul. Puteți deschide și închide un punct de acces din Tillor și puteți vedea în jurnal cine a trecut. Consultați [Control acces](/toegangscontrole). ### Declanșator [#trigger] Începutul unei automatizări: evenimentul, momentul sau mesajul care o pornește. Un declanșator poate avea un filtru, astfel încât automatizarea pornește doar dacă ceva este adevărat. Consultați [Declanșatoare](/automatiseringen/triggers). ### Lot de consum [#verbruiksbatch] O perioadă de consum al contoarelor pentru un client și un contor, cu un index de început și unul de sfârșit. Aplicația o numește **Perioadă de consum**, iar în acest manual apare și ca lot de consum. Consultați [Loturi de consum](/meterbeheer/consumptie-batches). ### Vizualizare [#weergave] O modalitate salvată de a privi sarcinile dumneavoastră, de exemplu **Sarcini deschise** sau **Mentenanță**. Fiecare vizualizare apare ca filă în partea de sus a paginii Sarcini. Consultați [Vizualizări](/taken/weergaven). ### Sigiliu [#zegel] Semnătura digitală a organizației dumneavoastră cu care Tillor încheie un PDF semnat. Dacă ulterior se schimbă ceva în fișier, un cititor de PDF vă avertizează. Îi aparține și o ștampilă de timp. Consultați [Sigiliu și ștampilă de timp](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel). ## Vezi și [#zie-ook] # Date și copii de rezervă (/ro-RO/gegevens-backups) Tillor creează automat copii de rezervă ale datelor organizației dumneavoastră. Nu trebuie să setați nimic pentru asta și nu le vedeți în Tillor. Dacă aveți nevoie de date din trecut sau ceva a mers prost, suportul Tillor restaurează pentru dumneavoastră o stare anterioară. Iată cum cereți acest lucru și cât de mult puteți merge înapoi. - Copiile de rezervă merg înapoi până la prima lună calendaristică încheiată, cu o arhivă pe lună. Detaliile sunt în tabelul de mai jos. - Restaurarea nu o faceți singur: se face întotdeauna prin suportul Tillor. - Nu puteți descărca sau vizualiza singur o copie de rezervă. Înainte de a începe: stabiliți de ce date aveți nevoie și de la ce moment sau din ce lună. ## Cât timp păstrează Tillor copiile de rezervă? [#hoe-lang-bewaart-tillor-back-ups] Tillor păstrează trei tipuri de copii de rezervă în paralel. Împreună vă oferă un punct de restaurare recent și un istoric mai lung. | Perioadă | Ce puteți regăsi | |---------|-------------------------| | **Ultimele 48 de ore** | O copie de rezervă la fiecare 4 ore, pentru restaurare la un moment recent | | **Ultimele 14 zile** | O copie de rezervă pe noapte | | **Fiecare lună calendaristică încheiată** | O arhivă lunară pe lună, fără ștergere automată | Luna calendaristică curentă are doar copiile de rezervă nocturne din ultimele 14 zile. Imediat ce o lună s-a încheiat, o copie de rezervă din acea lună rămâne păstrată ca arhivă lunară. Termenele sunt valabile pentru toate organizațiile. Dacă Tillor schimbă politica, vom modifica această pagină. ## Restaurarea unei copii de rezervă [#een-back-up-laten-terugzetten] Restaurarea nu o faceți singur în Tillor. Suportul Tillor o face împreună cu dumneavoastră, ca datele curente să nu fie suprascrise din greșeală. ### Adunați ce doriți să recuperați [#verzamel-wat-je-wilt-terughalen] Stabiliți de ce date aveți nevoie, precum facturi, clienți sau rezervări. Notați momentul sau perioada la care doriți să vă întoarceți, de exemplu „ieri în jur de 14:00" sau „martie 2026". ### Luați legătura cu suportul Tillor [#neem-contact-op-met-tillor-support] Scrieți la support@tillor.eu și menționați numele organizației, ce date doriți să recuperați și momentul sau perioada dorită. ### Discutați ce anume se va restaura [#overleg-wat-er-precies-terugkomt] Suportul Tillor caută copia de rezervă potrivită cererii dumneavoastră și discută cu dumneavoastră ce se va întâmpla înainte de începerea restaurării. Restaurarea poate aduce datele înapoi la o stare anterioară. Tot ce ați introdus după momentul ales poate dispărea astfel. Discutați întotdeauna mai întâi acest lucru cu suportul Tillor. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Suportul Tillor caută copia de rezervă potrivită și discută cu dumneavoastră ce se va restaura, înainte de începerea restaurării. - În timpul restaurării, organizația dumneavoastră este în modul de mentenanță și doar angajații Tillor au acces. Apoi totul este din nou disponibil. - Datele pe care le-ați introdus după momentul ales pot să fi dispărut. De aceea, discutați întotdeauna mai întâi. ## Probleme? [#problemen] Acest lucru nu este posibil în Tillor. Copiile de rezervă sunt disponibile doar pentru suportul Tillor. Rugați suportul să caute datele de care aveți nevoie. Pentru lunile anterioare, Tillor păstrează o copie de rezervă pe lună calendaristică. Puteți deci reveni la o lună, dar nu la o anumită zi sau oră din acea lună. Pentru ultimele 14 zile se poate pe zi, pentru ultimele 48 de ore la fiecare 4 ore. În timpul unei restaurări, organizația dumneavoastră este în modul de mentenanță și doar angajații Tillor au acces. Stabiliți cu suportul Tillor un moment care vă convine. Scrieți suportului Tillor cu numele datelor și momentul ștergerii. Verificați mai întâi în [jurnalul de activitate](/activiteitenlog) cine a modificat ce și când. ## Vezi și [#zie-ook] # Autentificarea în Tillor (/ro-RO/inloggen) Vă autentificați în Tillor cu un cont pe care îl aveți deja la Microsoft, Google sau Apple. Tillor nu are o parolă proprie: furnizorul respectiv se ocupă de parola dumneavoastră. După autentificare alegeți organizația și ajungeți pe panou. Dacă este prima dumneavoastră zi, continuați cu [Primii pași](/aan-de-slag). Înainte de a începe: - Aveți nevoie de un cont Microsoft, Google sau Apple. - Un administrator trebuie să vă fi invitat mai întâi ca utilizator cu aceeași adresă de e-mail. Dacă nu s-a întâmplat acest lucru, vedeți **Nu s-au găsit organizații**. ## Autentificare [#inloggen] ### Deschideți Tillor [#open-tillor] Mergeți în browser la aplicația web Tillor. Dacă sunteți deja autentificat, Tillor vă redirecționează imediat către organizația dumneavoastră. ### Alegeți metoda de autentificare [#kies-je-inlogmethode] Faceți clic pe **Autentificare cu Microsoft**, **Autentificare cu Google** sau **Autentificare cu Apple**. Metoda cu care v-ați autentificat ultima dată este marcată cu **Ultima utilizare**. ### Urmați pașii furnizorului [#volg-de-stappen-van-de-provider] Ajungeți la ecranul de autentificare Microsoft, Google sau Apple. La Microsoft și Google alegeți singur ce cont folosiți. Apoi vă întoarceți în Tillor. ### Alegeți organizația [#kies-je-organisatie] Dacă aveți acces la mai multe organizații, vedeți un ecran de alegere. Căutați organizația în listă și faceți clic pe **Deschideți**. Dacă aveți doar una, mergeți direct la panou. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Ajungeți pe panoul organizației dumneavoastră. Tillor își amintește ultima metodă de autentificare și o marchează data viitoare cu **Ultima utilizare**. - Vedeți doar elementele pentru care aveți drepturi. - Sesiunea dumneavoastră rămâne activă pe acest dispozitiv, până la 30 de zile fără utilizare sau până vă deconectați singur. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] O persoană are un singur cont Tillor. Acest cont îl puteți asocia mai multor metode de autentificare. Un administrator vă adaugă ca utilizator într-o organizație și vă acordă drepturi. Ce vedeți apoi depinde de aceste drepturi. ```mermaid flowchart LR A[Contul dumneavoastră Microsoft, Google sau
Apple] --> B[Contul dumneavoastră Tillor] B --> C[Una sau mai multe organizații] C --> D[Drepturile dumneavoastră
stabilesc ce vedeți] ``` - Rămâneți autentificat cât timp folosiți Tillor. După 30 de zile fără utilizare vă autentificați din nou. - Un link de verificare pentru adresa dumneavoastră de e-mail este valabil 15 minute. Puteți solicita un e-mail nou cel mult o dată la două minute. - Microsoft este întotdeauna activat ca metodă de autentificare. Google și Apple pot lipsi, în funcție de mediul dumneavoastră Tillor. - Ultima metodă de autentificare nu o puteți deconecta. ## Acordarea accesului unui coleg [#een-collega-toegang-geven] Un administrator cu drepturile potrivite invită colegii. ### Deschideți utilizatorii [#open-de-gebruikers] Mergeți la Asistență > Setări și alegeți **Utilizatori**. ### Invitați colegul [#nodig-de-collega-uit] Faceți clic pe **Invitați utilizator**, completați adresa de e-mail și faceți clic pe **Invitați**. Dacă există deja un cont Tillor cu acea adresă de e-mail, colegul este adăugat direct. Altfel, colegul primește o invitație prin e-mail și devine membru la prima autentificare. Apoi setați drepturile, consultați [Organizație](/gebruikers/organisaties). Colegul nu vede nimic util până când aceste drepturi nu sunt setate. ## Gestionarea propriului cont [#je-eigen-account-beheren] Faceți clic pe numele dumneavoastră din partea de jos a meniului și alegeți **Cont**. Acolo găsiți: - **E-mail**: dacă adresa dumneavoastră de e-mail este **Verificat** sau **Neverificat**. Dacă scrie **Neverificat**, vedeți butonul **Verifică adresa de e-mail**, consultați [Verificarea adresei de e-mail](#je-e-mailadres-verifiëren). - **Platforme asociate**: asociați Microsoft, Google sau Apple aceluiași cont cu **Conectați**, sau eliminați o asociere cu **Deconectați**. Ultima metodă de autentificare nu o puteți deconecta. - **Sesiuni active**: vedeți pe ce dispozitive sunteți autentificat. Cu **Deconectare** încheiați o sesiune, cu **Deconectați toate celelalte dispozitive** toate celelalte. - Numărul dumneavoastră de telefon și limba contului. Rămâneți autentificat cât timp folosiți Tillor. După 30 de zile fără utilizare vă autentificați din nou. Pentru a vă deconecta, alegeți **Deconectare** în meniul de sub numele dumneavoastră. ## Verificarea adresei de e-mail [#je-e-mailadres-verifiëren] Tillor preia adresa dumneavoastră de e-mail de la furnizorul cu care v-ați autentificat prima dată. Google și Apple transmit atunci că adresa este a dumneavoastră. Microsoft de obicei nu face acest lucru, iar atunci adresa dumneavoastră apare pe pagina **Cont** ca **Neverificat**. Cât timp adresa dumneavoastră nu este verificată, Tillor nu asociază la autentificare o a doua metodă de autentificare contului dumneavoastră. Dacă, de exemplu, vă autentificați prima dată cu Google, iar contul a fost creat cu Microsoft, vedeți mesajul că adresa aparține deja unui cont care nu este încă verificat. Verificați adresa o singură dată, apoi funcționează. ### Solicitați e-mailul de verificare [#vraag-de-verificatiemail-aan] Dacă sunteți autentificat, faceți clic pe pagina **Cont** pe **Verifică adresa de e-mail**. Dacă nu sunteți autentificat și ați primit mesajul pe pagina de autentificare, completați acolo adresa de e-mail și faceți clic pe **Trimite e-mailul de verificare**. Acea pagină dă întotdeauna aceeași confirmare, chiar dacă nu există niciun cont cu acea adresă. ### Deschideți e-mailul [#open-de-e-mail] Primiți un e-mail cu subiectul **Verifică-ți adresa de e-mail pentru Tillor**. Faceți clic pe **Verifică adresa de e-mail**. Linkul este valabil 15 minute; dacă a expirat, solicitați pur și simplu unul nou. ### Autentificați-vă [#log-in] După clic, reveniți pe pagina de autentificare sau pe pagina contului dumneavoastră. Autentificați-vă cu metoda dorită. Din acest moment, Tillor asociază contului dumneavoastră o nouă metodă de autentificare cu aceeași adresă de e-mail. Puteți solicita un nou e-mail de verificare cel mult o dată la două minute. Dacă nu doriți să așteptați e-mailul, ca utilizator autentificat puteți asocia imediat și o a doua metodă sub **Cont > Platforme asociate**. ## Chei API pentru integrări [#api-sleutels-voor-koppelingen] Pentru integrări tehnice gestionați cheile API pe pagina **Cont**. Deschideți **Dezvoltatori** în meniul profilului și faceți clic pe **Mergeți la cheile API**, sau mergeți la **Cont** > **Chei API**. Consultați [Dezvoltatori](/ontwikkelaars) pentru documentația de integrare. ## Probleme? [#problemen] Contul dumneavoastră există, dar nu este încă asociat unei organizații. Rugați un administrator al organizației să vă invite cu aceeași adresă de e-mail ca cea a contului dumneavoastră Microsoft, Google sau Apple. Există deja un cont Tillor cu această adresă, creat cu altă metodă de autentificare, iar adresa nu este încă verificată. Sub mesaj completați adresa de e-mail și faceți clic pe **Trimite e-mailul de verificare**, sau autentificați-vă cu metoda pe care ați folosit-o înainte și faceți clic pe pagina **Cont** pe **Verifică adresa de e-mail**. Consultați [Verificarea adresei de e-mail](#je-e-mailadres-verifiëren). Un link de verificare funcționează 15 minute. Solicitați unul nou pe pagina de autentificare sau pe pagina **Cont** și folosiți cel mai recent e-mail. Acest cont este deja legat de alt utilizator sau adresa de e-mail nu corespunde contului dumneavoastră actual. Folosiți aceeași adresă de e-mail sau autentificați-vă cu contul deja asociat și deconectați-l mai întâi acolo. Autentificarea a durat prea mult sau pagina a rămas deschisă prea mult timp. Faceți din nou clic pe metoda de autentificare și parcurgeți pașii mai repede. Ce vedeți depinde de drepturile dumneavoastră. Rugați un administrator să vă modifice drepturile, consultați [Organizație](/gebruikers/organisaties). Încercați din nou. Dacă nu reușiți nici acum, scrieți la support@tillor.eu și transmiteți mesajul. ## Vezi și [#zie-ook] # Vraag het Tillie (/ro-RO/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. - 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. ## Een vraag stellen [#een-vraag-stellen] ### 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. ### 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. ### 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. ### 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. ## 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. ### 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**. ### 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. - 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. ## 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] Tillie is nog niet voor iedereen beschikbaar. Staat de knop niet rechtsonder, gebruik dan de zoekfunctie bovenaan. 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. 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. Tillie neemt even geen vragen aan. Gebruik de zoekfunctie bovenaan en probeer het later opnieuw. Herlaad de pagina en stel je vraag opnieuw. Blokkeert een extensie in je browser scripts of cookies, zet ze dan uit voor deze site. 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**. 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. Je bevestigde niet binnen 10 minuten. Vraag Tillie de wijziging opnieuw voor te stellen. Open de bronnen onder het antwoord en controleer de stap op die pagina. Geef het antwoord een duim omlaag, zodat we het kunnen verbeteren. ## Zie ook [#zie-ook] # Noutăți (/ro-RO/wat-is-nieuw) Tillor primește o actualizare aproape în fiecare zi. Pe această pagină găsiți modificările pe care le observați ca administrator. Omitem îmbunătățirile mici și remedierile de erori. ## Noiembrie 2026 [#november-2026] ### Sarcini [#taken] - Filtrați sarcinile după **Text**: afișați doar sarcinile al căror nume sau descriere conține sau, dimpotrivă, nu conține un text și adăugați câte texte doriți (de exemplu **Nu conține** `Verzekering vervallen:`). Consultați [Filtrarea după text](/taken/filteren#filteren-op-tekst). - Filtrele și setările vizualizării încorporate **Toate** pot fi acum salvate pentru întreaga organizație, cu dreptul **Gestionarea etichetelor și a vizualizărilor partajate**. Consultați [Salvarea sau renunțarea la modificări](/taken/weergaven#wijzigingen-opslaan-of-verwerpen). ### Căutare [#zoeken] - Fereastra de căutare afișează rezultatele pe categorii, cu categoria celui mai bun rezultat deasupra și cele mai bune trei rezultate din fiecare categorie. Cu butonul **Tot** de la începutul câmpului de căutare sau cu **⌥1** până la **⌥9** (**Alt** pe Windows) căutați într-o singură categorie, chiar înainte să tastați. Jos găsiți comenzile rapide și categoriile fără rezultate. Consultați [Căutare](/zoeken). ### Manual [#handleiding] - Acum Tillie se poate uita și în contul tău: dă-i acces de citire la organizația ta și întreabă despre clienții, facturile sau contoarele tale. Propune o modificare, care se face doar după ce o confirmi. Vezi [Lasă-o pe Tillie să se uite în cont](/vraag-het-tillie#tillie-in-je-account-laten-kijken). - Alegi acum tema luminoasă sau întunecată o singură dată: manualul urmează tema aleasă în Tillor și invers. - Nou: [Întreab-o pe Tillie](/vraag-het-tillie). Pune o întrebare cu propriile cuvinte în dreapta jos, iar Tillie răspunde din manual, cu paginile pe care le-a folosit. - Manualul există acum și în alte limbi: alegeți limba din dreapta sus. Se deschide automat în limba pe care o folosiți în Tillor. O pagină care nu este încă tradusă afișează textul în olandeză. ### Chat pe site [#website-chat] - Un vizitator poate trimite acum prin chat 10 mesaje pe minut și 200 pe zi, iar toți vizitatorii din aceeași rețea împreună 30 pe minut. Peste această limită, vizitatorul este rugat să aștepte puțin. Astfel, un script nu-ți poate inunda inboxul și răspunsurile lui Tillie. Vezi [Probleme?](/inbox/website-chat#problemen). ### Contoare (ICY) [#meters-icy] - Tillor citește acum ICY prin noul API v2. Sub Setări > Integrări > ICY completați datele de autentificare pentru API v2 și alegeți numărul parcului dumneavoastră din listă; fără aceste date, contoarele ICY nu mai sunt actualizate. - Un contor ICY afișează ce **Modul** se află pe locul respectiv (Campère sau PRM) și, dacă ICY îl cunoaște, **Numărul de serie al modulului**. Dacă acest număr de serie se schimbă la ICY, apare în **Activitate** a contorului. - Cardul **Controlere ICY** din Parc > Contoare arată, pentru fiecare controler, când l-a văzut ICY ultima dată, câte contoare sunt conectate la el. Alarmele pe care ICY le raportează pe un controler apar acum și aici, iar pentru ele primiți aceeași notificare push ca pentru o alarmă de contor. Un controler cu o alarmă sau unul inactiv de mai bine de o oră apare primul. Un controler poartă numele dulapului dumneavoastră de contoare (de exemplu **MK6**) în loc de numărul din ICY. Consultați [Controlere ICY](/meterbeheer/alarmen-en-status#icy-controllers). - Un contor ICY afișează acum și **Controler** și **Timp de deconectare**. Un alt timp de deconectare al modulului apare în **Activitate** a contorului. - Lista din Parc > Contoare are o coloană **Modul** (Campère sau PRM), iar fișierul Excel de la **Exportați toate contoarele** are pe foaia ICY coloana `module`. - Sub **Amperaj** apar doar valorile până la maximul setat la ICY pentru modulul de pe acel loc. Înainte, Tillor oferea pe fiecare contor întreaga listă a parcului. - Alarmele de la ICY primesc un nume fix în limba dumneavoastră, precum **Supracurent** sau **Întrerupere de curent**, iar **Avertismente** arată acum de câte ori a fost deja folosită limita de comutare. ### Dezvoltatori [#ontwikkelaars] - **Nu este compatibil cu versiunile anterioare:** alarmele se numesc de acum în API și în evenimente `integration-alarm`, deoarece pot fi acum și pe un controler ICY. Evenimentele `meter-alarm:created` și `meter-alarm:resolved` au fost înlocuite cu [`integration-alarm:created`](/ontwikkelaars/events#integration-alarm-created) și [`integration-alarm:resolved`](/ontwikkelaars/events#integration-alarm-resolved), iar căile REST `/meter-alarms` cu `/integration-alarms`. Numele vechi nu mai există. Webhook-urile și automatizările existente au fost convertite automat la noile evenimente; adaptați în propriul cod numele evenimentului și calea. Câmpul `meterId` al unei alarme poate fi gol; atunci `icyControllerId` este completat. - Un client OAuth poate fi acum limitat la persoanele din organizația dumneavoastră și, mai departe, la grupuri și permisiuni: bifați **Doar persoanele din (organizația dumneavoastră) se pot autentifica** în fereastra clientului, la Cont > Clienți OAuth. Destinat autentificării unice într-un serviciu extern. Consultați [Clienți OAuth](/ontwikkelaars/oauth-clients). - Fiecare endpoint din [referința API](/api-referentie) arată acum la **Acces** cine îl poate apela și de ce permisiune are nevoie un membru. O cheie API cu scopuri are nevoie și de această permisiune printre scopurile sale. [Indexul de evenimente](/ontwikkelaars/events) arată același lucru pentru fiecare eveniment. ### Chei API [#api-sleutels] - O cheie API poate fi acum limitată la drepturile de care are nevoie o integrare: activați **Limitează la permisiunile selectate** în fereastra cheii, sub Cont > Chei API. O cheie limitată nu poate face niciodată mai mult decât dumneavoastră. Consultați [Limitarea drepturilor](/ontwikkelaars/http#rechten-beperken). ### Câmpuri personalizate [#eigen-velden] - Un câmp de legătură către contoare se poate limita la contoarele parcelei ocupării, iar orice câmp de legătură către o înregistrare listabilă își poate filtra opțiunile cu TypeScript propriu. La salvare, Tillor refuză o înregistrare în afara acestei limitări. Listele scurte (sub 50 de înregistrări) sunt afișate imediat în lista de alegere, fără a tasta mai întâi 2 caractere. Consultați [Filtrarea opțiunilor](/eigen-velden/veldtypes#opties-filteren). - Același filtru poate da unei opțiuni și o etichetă proprie și un titlu în lista de alegere, returnând un text sau `{ label, group }` în loc de `true`. Consultați [Etichete proprii](/eigen-velden/veldtypes#eigen-labels). ### Manual [#handleiding-1] - Nou în manual: [Termeni](/begrippen), un glosar cu toți termenii din Tillor, și [Din practică](/praktijk), patru exemple detaliate care urmează o metodă de lucru completă prin toate modulele, precum atragerea unui client sezonier sau facturarea consumului. - Fiecare modul începe acum cu ce este, ce aveți nevoie pentru el și ce se întâmplă după aceea, cu un bloc **Bine de știut** și o listă **Probleme?** pe sarcină. Noi sunt și [Invitarea utilizatorilor și acordarea drepturilor](/gebruikers/gebruikers-en-rechten), o prezentare a tuturor [tipurilor de notificări](/communicatie/notificatietypes) și pagini separate pe sarcină pentru [contoare](/meterbeheer), [controlere](/controllers) și [imprimante](/printer). ### Semnături [#handtekeningen] - Clienții, persoanele de contact și părțile externe pot semna acum un document și pe tableta de la recepție. Faceți clic la rândul lor pe **Semnează pe tabletă**, cu cod sau fără cod dacă ați verificat singur identitatea; tableta afișează numele lor cu litere mari, inclusiv la un mandat SEPA. Consultați [Pe tableta de la recepție](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie). - La **Trimite**, editorul verifică totul dintr-o dată: un semnatar fără câmp de semnătură sau un client ori o persoană de contact fără adresă de e-mail și număr de mobil este indicat imediat. Consultați [Nu pot trimite](/handtekeningen/handtekening-vragen#problemen). ### Tranzacții bancare [#banktransacties] - Faceți clic pe pictograma (i) de lângă o tranzacție bancară pentru a-i deschide panoul de detalii. Din meniul de acțiuni creați o sarcină despre ea sau copiați un link care deschide direct panoul. Consultați [Vizualizarea tranzacțiilor bancare](/boekhouden/betalingsrapporten/betaalmethodes/ponto#banktransacties-bekijken). ### Produse și facturi [#producten-en-facturen] - TVA-ul transferat este acum o opțiune în **% TVA**, alături de cote: pentru servicii UE și contractant asociat, precum și livrare intracomunitară, export și scutit. Factura primește mențiunea legală, la înregistrare se cere un număr de TVA acolo unde este cazul, iar rândul ajunge în Admisol în grila corectă. Pentru Odoo completați, pentru fiecare regim, numele TVA-ului din Odoo în [setările de export](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo#btw-regimes); un preț programat poate converti și un produs într-un regim. Consultați [TVA transferat și alte regimuri fără TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw). - Introduceți sumele de dinainte de Tillor, precum garanțiile vechi, ca sold inițial în contul unui client: manual sau cu un import pentru toți clienții deodată. Acestea contează în sold și în monitorizare, dar nu sunt o factură și nu ajung în contabilitate. Consultați [Solduri inițiale de dinainte de Tillor](/producten/product-aanmaken#beginsaldi-van-voor-tillor). - Un pachet de produse este acum cod: fiecare pas are un produs, o cantitate și o **Formulă** opțională în TypeScript care, la salvarea facturii, stabilește dacă pasul apare pe ea, cu ce cantitate, sau exact ce rânduri (descriere proprie, preț, metodă de acces). Formula citește clientul, ocuparea, parcela și rândul principal, inclusiv câmpurile personalizate, plus listele de contoare și metode de acces. Alegerile fixe pentru contor, tag NFC și câine au dispărut; ce făceau apare ca formulă-exemplu în manual. Consultați [Formulă per pas](/producten/bundel-velden#formule-per-stap). - Monitorizați soldul unui client pe un cont din registrul mare, de exemplu pentru garanții. Tillor afișează soldul pe factură și refuză o factură care îl aduce sub zero. Cu un drept separat înregistrați totuși, cu o motivare în cronologie. Consultați [Monitorizarea soldului clientului](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). - Pe fila **Facturare** a unui client apare noul tabel **Conturi**: soldul pe fiecare cont din registrul mare pe care s-a înregistrat ceva, cu dedesubt facturile înregistrate și contul curent. Dacă aveți conturi monitorizate, vedeți implicit doar pe acestea; cu un filtru le vedeți pe toate. Consultați [Monitorizarea soldului clientului](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). ### Facturi și plăți [#facturen-en-betalingen] - Cu **Link pentru plată parțială** din meniul unei facturi înregistrate creați un link de plată pentru o parte din suma restantă. Consultați [Crearea unui link pentru o plată parțială](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). - Un mandat SEPA semnat este sigilat, astfel încât un cititor PDF arată orice modificare ulterioară. Consultați [Mandat SEPA](/betalingsverwerking/mandaat). ### Utilizatori și drepturi [#gebruikers-en-rechten] - Un grup poate permite sau refuza drepturi pentru toți membrii săi; o refuzare câștigă întotdeauna. În **Editați permisiunile** vedeți pentru fiecare drept dacă provine direct sau printr-un grup. Consultați [Drepturile grupului](/gebruikers/groepen#groepsrechten). ### Parc și tehnică [#park-en-techniek] - Un controler poate cunoaște mai multe rețele Wi-Fi, într-o ordine pe care o stabiliți singur. Consultați [Setările controlerului](/controllers/settings). - La un contor, **Consum și tendințe** arată consumul pe oră pentru o singură zi, cu un nou selector de perioadă. Consultați [Gestionarea contoarelor](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen). ### Sarcini [#taken-1] - Imprimați o sarcină pe A4 sau pe o imprimantă de bonuri din meniul sarcinii; tipăritura arată și elementele asociate și blocajele. În același meniu se află **Eliminați**, cu excepția sarcinilor pe care doar o automatizare le poate finaliza. Consultați [Detaliile sarcinii](/taken/taakdetails#het-menu-van-de-taak). - Adăugați subsarcini în timp ce creați o sarcină. Consultați [Crearea unei sarcini](/taken/taakdetails#een-taak-aanmaken). - O vizualizare poate ascunde sarcinile finalizate după o zi, o săptămână sau o lună. Consultați [Ascunderea sarcinilor finalizate](/taken/indelingen#voltooide-taken-verbergen). ## Octombrie 2026 [#oktober-2026] ### Parcele [#terreinen] - **Prețul calculat** al unei parcele urmează acum o formulă pe care o scrieți singur pentru fiecare organizație sub Setări > Tarif parcelă, cu aceleași variabile `{terrain.…}` ca în automatizări. Încercați formula imediat pe o parcelă, iar fiecare parte denumită primește o coloană în exportul parcelelor. Rezultatul este păstrat la parcelă și urmează orice modificare a parcelei sau a formulei. Consultați [Formula de tarif](/terreinen#tariefformule). ### Semnături [#handtekeningen-1] - Lăsați un PDF, precum un contract de închiriere, să fie semnat online pe rând de clienți, persoane de contact, colegi și părți externe. PDF-ul semnat cu pagina de dovadă ajunge la documentele clientului. Consultați [Semnături](/handtekeningen). - Un semnatar își poate tasta semnătura sau parafa în loc să o deseneze. Consultați [Cum semnează cineva](/handtekeningen/ondertekenen). - În editor alegeți la **Câmpuri pentru** pentru cine plasați câmpurile și puneți un câmp plasat, cu **Semnatar**, pe numele altcuiva. Câmpurile le plasați atingând sau trăgând. Consultați [Plasați câmpurile](/handtekeningen/handtekening-vragen). ### Autentificare [#inloggen] - Dacă adresa dumneavoastră de e-mail este încă **Neverificat**, o verificați cu un singur clic de pe pagina **Cont** sau de pe pagina de autentificare. Abia după aceea Tillor asociază contului dumneavoastră o a doua metodă de autentificare. Consultați [Verificarea adresei de e-mail](/inloggen#je-e-mailadres-verifiëren). ### Automatizări [#automatiseringen] - Cu pasul **Rulează cod** scrieți o bucată de TypeScript pe variabilele fluxului, de exemplu pentru a stabili ce subsarcini primește o sarcină. Rezultatul îl citiți în pașii următori ca `{result}`. Consultați [Rulează cod](/automatiseringen/logica#code-uitvoeren). - Un flux poate mai întâi să **Sincronizați tranzacțiile bancare** și apoi să trimită o reamintire de plată, astfel încât o factură plătită chiar acum să nu primească o reamintire. Salvați acea automatizare din rețeaua biroului, iar Tillor reține IP-ul pentru conexiunea bancară. Consultați [Sincronizați tranzacțiile bancare](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren). - Dezactivați somațiile automate pentru un client sau pentru o singură factură. Un flux de reamintire omite clienții care au deja acest lucru activat. Consultați [Dezactivează mementourile automate pentru client](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant). - La **Creează sarcină** puteți seta ca doar fluxul să finalizeze sarcina. Cu **Șterge sarcina** eliminați ulterior acea sarcină. Consultați [Sarcini](/automatiseringen/acties/taken). - La o acțiune de sarcină puteți activa **Cere confirmare**. Colegul confirmă mai întâi alegerea, iar apoi fluxul continuă. - Construiți singur automatizări pe un canvas: alegeți un declanșator, adăugați pași, condiții și timpi de așteptare și vedeți pentru fiecare execuție ce s-a întâmplat. Consultați [Automatizări](/automatiseringen). - O automatizare poate avea mai multe declanșatoare. Tillor blochează buclele în care o automatizare se pornește mereu pe ea însăși. - Așteptarea poate dura acum până la un moment fix, un număr de ore sau minute, sau până când organizația dumneavoastră se închide. - Porniți o automatizare la o dată dintr-o înregistrare, cu un declanșator programat sau din propriul sistem printr-un [webhook de intrare](/ontwikkelaars/automatiseringen). - Cu pasul **Cere o decizie** creați singur butoanele pe sarcină, cu culoare și pictogramă proprii, eventual cu o notiță sau o confirmare obligatorie. Fiecare buton este o ieșire a pasului. Consultați [Cere o decizie](/automatiseringen/logica#vraag-om-een-beslissing). - Declanșatorul **Este aleasă o acțiune a sarcinii** pornește o automatizare când cineva alege un buton asociat pe o sarcină. La un webhook de intrare, cu **Ignoră repetările** preveniți ca același apel să pornească fluxul de două ori. Consultați [Declanșatoare](/automatiseringen/triggers). - **Așteaptă un eveniment** are o ieșire **Șters** pentru cazul în care înregistrarea fluxului dispare. Consultați [Logică](/automatiseringen/logica#wachten-op-een-gebeurtenis). - În editor testați cu o înregistrare reală, puneți **Chenare** în jurul pașilor și restaurați o versiune anterioară prin **Istoric**. Consultați [Primii pași](/automatiseringen/aan-de-slag#de-editor). ### Sarcini [#taken-2] - În lista de sarcini vedeți toate înregistrările asociate și filtrați după tip cu **Legat de**. Consultați [Filtrare](/taken/filteren). - E-mailurile despre sarcini afișează o previzualizare a sarcinii. Sarcinile le găsiți și prin [Căutare](/zoeken). - Înainte ca o sarcină privată să devină vizibilă pentru întreaga organizație, Tillor întreabă dacă doriți să o faceți publică. Consultați [Sarcini private](/taken/prive-taken). - Sarcini private, o vizualizare calendar și un cronometru care continuă să ruleze în timp ce lucrați mai departe. Consultați [Sarcini](/taken). - Partajați o vizualizare ca pagină doar în citire sau ca link de calendar. Consultați [Partajarea sarcinilor](/taken/delen). - Statusurile de așteptare au fost reunite într-un singur status **În așteptarea răspunsului**. - Atribuiți o sarcină unui grup și partajați o vizualizare cu grupuri de colegi. Consultați [Cine vede o vizualizare](/taken/weergaven#wie-ziet-een-weergave). - O sarcină poate avea butoane de alegere, eventual cu o notiță sau o confirmare obligatorie. Consultați [Sarcini cu butoane de alegere](/taken/taakdetails#taken-met-keuzeknoppen). - Lipiți un fișier în fereastra sarcinii pentru a-l adăuga ca atașament. Câmpurile personalizate ale sarcinilor apar și ele în acea fereastră. ### Inbox [#inbox] - E-mailul de reamintire din chatul site-ului deschide acum conversația și pe alt dispozitiv sau în alt browser. Consultați [Reamintire prin e-mail](/inbox/website-chat-instellingen#herinnering-per-e-mail). ### Notificări [#meldingen] - Alegeți pentru fiecare notificare dacă Tillor vă contactează prin e-mail sau push. Setați acest lucru sub **Cont** la **Notificări**, sau pentru un coleg prin **Setări de notificări** la membrii organizației. Consultați [Utilizatori](/gebruikers). ### Tablete și kioskuri [#tablets-en-kiosken] - Fiecare tabletă sau kiosk are o pagină proprie de dispozitiv cu acțiuni la distanță, diagnostic, istoric și setări. Consultați [Tablete și kioskuri](/mobiele-app/tablets-en-kiosken). - Blocare kiosk, mod de noapte și notificări per dispozitiv pentru tabletele Android. ### Facturi și plăți [#facturen-en-betalingen-1] - Pe un rând de factură cu o perioadă alegeți parcela pe hartă. La înregistrare, Tillor creează rezervarea și face check-in oaspetelui, în funcție de produs. Consultați [Facturi](/facturen/aanmaken-en-bewerken#periode-en-terrein-kiezen). - Rapoarte de plată ciornă pentru ziua curentă. Consultați [Rapoarte de plată](/boekhouden/betalingsrapporten). - Dacă Mollie reține o rezervă de sold dintr-o plată, Tillor o înregistrează ca *Rezervă de sold* la furnizorul Mollie în loc de contul de așteptare, iar la eliberare dispare de acolo. Consultați [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#balansreserve). - Clienții primesc o reamintire să-și semneze mandatul SEPA înainte să expire. ### Clienți și fișiere [#klanten-en-bestanden] - Atașamentele, documentele și e-mailurile Outlook le vedeți într-un singur vizualizator de fișiere, fără descărcare. Videoclipurile pot fi redate; încărcările pot avea până la 250 MB. - Prezentarea clienților afișează șederile active și cele întârziate. Facturarea automată se oprește temporar la un consum de apă neobișnuit de mare. - Pe o parcelă vedeți istoricul ocupărilor, cu un link către client. ### Câmpuri personalizate [#eigen-velden-1] - Adăugați singur câmpuri la clienți, parcele, ocupări, contoare, sarcini, produse, documente, rezervări și metode de acces, sub Setări > Câmpuri personalizate. Le plasați între câmpurile standard, le faceți să apară sub o condiție și stabiliți cine le vede sau le editează. Consultați [Câmpuri personalizate](/eigen-velden). ### Produse [#producten] - Programați un preț nou de la o dată cu **Prețuri programate**; Tillor îl aplică în acea zi și vă trimite un e-mail. **Calculator TVA** convertește un preț sau îl ajustează cu un procent. Consultați [Programarea unei modificări de preț](/producten/prijzen-plannen). ### Clienți [#klanten] - În partea de sus a unui client se află cardul cu datele principale, cu comentarii fixate. Zilele de naștere ale clienților și partenerilor sunt indicate. Consultați [Gestionarea clienților](/klantenbeheer). - O adresă o completați cu **Stradă**, **Nr.** și **Ap.**, cu sugestii de adrese pe măsură ce tastați. Consultați [Gestionarea clienților](/klantenbeheer#adres-invullen). ### Control acces [#toegangscontrole] - La un pass QR vedeți în ce wallet se află și, cu **Sincronizează permisul Wallet**, îl pregătiți din nou. Consultați [Control acces](/toegangscontrole). ### Integrări [#integraties] - Conectați Partoo pentru a trimite automat orele de deschidere, sezoanele și excepțiile către locația dumneavoastră. Consultați [Partoo](/integraties/partoo). ## Septembrie 2026 [#september-2026] ### Plăți [#betalingen] - Mandatele SEPA le semnați chiar în Tillor, la distanță sau pe tableta de la recepție. Consultați [Mandat SEPA](/betalingsverwerking/mandaat). - O nouă pagină de plată cu alegere proprie a metodei de plată, cod QR și redirecționare către aplicația Bancontact. Tillor vă avertizează dacă o metodă de plată are o defecțiune. ### Control acces [#toegangscontrole-1] - Metodă de acces nouă: cod PIN. Un cod PIN poate fi convertit automat într-un număr de înmatriculare. Consultați [Control acces](/toegangscontrole#toegangsmethoden-beheren-via-het-klantprofiel). ### Sarcini [#taken-3] - Vizualizări salvate cu un constructor de filtre, partajare cu colegii și un flux de calendar pentru fiecare vizualizare. Consultați [Vizualizări](/taken/weergaven). - Dependențe între sarcini, prioritatea **Urgentă** și etichete pe care le creați direct. - Asociați o sarcină mai multor clienți sau parcelelor, contoarelor, facturilor și rezervărilor. ### Parc și comunicare [#park-en-communicatie] - Colorați parcelele pe hartă după tip și exportați harta ca PDF A4. Consultați [Hartă](/kaart). - Pentru telefonia Voys: rutare per client și mesagerie vocală automată. Consultați [Telefonie Voys](/communicatie/providers/voys). - Exportați prezentarea facturilor unui client în Excel. # Căutarea în Tillor (/ro-RO/zoeken) Cu funcția de căutare găsești dintr-o dată un client, o factură, o ocupare, o rezervare, un apel telefonic, o parcelă, un contor, o sarcină sau un raport de plată, de pe orice pagină. Nu trebuie deci să mergi mai întâi la secțiunea potrivită. Rezultatul deschide direct pagina corectă. - La **Toate rezultatele**, Tillor preia cel mult zece rezultate pe categorie și le afișează pe cele mai bune trei. Alege o categorie pentru a vedea până la o sută. - La clienți, Tillor găsește și rezultate cu o mică greșeală de scriere, astfel încât „Jansen" returnează și „Janssen". - Notițele de la apelurile telefonice sunt criptate și nu sunt căutate. Caută după numărul de telefon. - Etichetele NFC și numerele de înmatriculare nu au o categorie proprie. Le găsești la **Clienți**. ## Caută și deschide un rezultat [#zoeken-en-een-resultaat-openen] ### Deschide fereastra de căutare [#open-het-zoekvenster] Fă clic pe **Căutați** în antet (pe un ecran îngust, pe lupă) sau apasă **⌘K** (Mac) ori **Ctrl+K** (Windows). Cu aceeași scurtătură închizi din nou fereastra. ### Scrie termenul de căutare [#typ-je-zoekterm] Rezultatele apar de îndată ce te oprești o clipă din scris. Sunt grupate pe categorii, iar categoria cu cel mai bun rezultat este deasupra: primul rând este deci mereu cel mai bun rezultat. O potrivire bună în titlu contează mai mult decât una în descriere. În fiecare categorie vezi cele mai bune trei rezultate, iar cu **Arată încă …** deschizi toată categoria. Jos apare în ce categorii nu s-a găsit nimic. ### Limitează la o singură categorie (opțional) [#beperk-tot-één-categorie-optioneel] Dacă vrei să cauți doar într-un singur tip de date, alege-l cu butonul **Tot** de la începutul câmpului de căutare, de exemplu **Clienți**. Poți face asta înainte sau după ce tastezi; câmpul de căutare arată apoi **Caută în Clienți…**. Poți da clic și pe numele unei categorii din rezultate. Cu tastatura: - **Shift+Tab** deschide lista de categorii. - **⌥1** până la **⌥9** (**Alt+1** până la **Alt+9** pe Windows) alege direct o categorie, în ordinea din acea listă. Cifra stă și lângă numele fiecărei categorii din rezultate. - **Tab** parcurge categoriile care au rezultate. Înapoi la tot: alege **Tot** din listă sau apasă **Backspace** într-un câmp de căutare gol. ### Deschide rezultatul [#open-het-resultaat] Folosește tastele săgeată pentru a alege și apasă **Enter**. Cu **Ctrl+Enter** (**⌘+Enter** pe Mac) rezultatul se deschide într-o filă nouă. Poți și să faci clic cu mouse-ul. **Escape** închide fereastra. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Rezultatul ales deschide clientul, factura sau altă pagină în aceeași filă. Cu **Ctrl+Enter** (**⌘+Enter** pe Mac) se deschide într-o filă nouă. - Datele tale nu se schimbă: căutarea doar citește. - La un rezultat se vede după ce a fost găsit, de exemplu **Telefon:** sau **Factură:** cu valoarea care se potrivește. ## Ce caută Tillor [#wat-tillor-doorzoekt] | Categorie | După ce poți căuta | |-----------|-----------------------| | **Clienți** | Nume, număr de client, e-mail, telefon, adresă și localitate, cod de TVA, observații, persoane de contact (nume, e-mail, telefon) și metode de acces, cum ar fi un card NFC sau un număr de înmatriculare | | **Facturi** | Număr de factură (cu sau fără prefix, an și separatori), suma totală, ID-ul din linkul facturii și notițele (publice și interne) | | **Ocupări** | Numele parcelei, prenumele și numele clientului și ID-ul ocupării | | **Rezervări** | Număr de rezervare (de exemplu `RES/2026/0001`, cu sau fără prefix și an, sau compact `20260001`), notiță, numele clientului și ID-ul din link | | **Apeluri telefonice** | Număr de intrare și de ieșire, ID-ul apelului și referință externă | | **Parcele** | Nume, descriere, ID și numărul contorului de gaz al parcelei | | **Contoare** | Nume, număr de serie și ID-ul contorului | | **Sarcini** | Titlu, descriere și ID. Un rezultat arată și clientul sau parcela asociată | | **Rapoarte de plată** | Numărul raportului | Nu există o categorie separată pentru etichetele NFC. Cardurile NFC și alte valori de acces aparțin de **Clienți** și apar acolo de îndată ce se potrivesc cu termenul tău de căutare. ## Câte rezultate vezi? [#hoeveel-resultaten-zie-je] Dacă într-o categorie există zece sau mai multe rezultate, lângă numele acelei categorii apare **10+**. În prezentarea generală vezi cele mai bune trei rezultate pe categorie. Alege categoria sau dă clic pe **Arată încă …** pentru a vedea până la o sută de rezultate. La rezervări și facturi, toleranța la greșeli de scriere funcționează mai ales la numere și notițe. ## Sfaturi de căutare [#zoektips] - **Număr de înmatriculare, NFC sau cod QR**: caută după valoarea care figurează la client. Găsești clientul la **Clienți**. - **Număr de factură sau de rezervare**: scrie numărul așa cum apare pe document sau o parte din el. Pentru `RES/2026/0042` funcționează și `2026/0042` și `20260042`. - **Sumă**: o factură o găsești și după suma totală, de exemplu `120,50`. - **Cine unde se află**: caută la **Ocupări** după numele parcelei sau al clientului. - **Nume parțiale**: la clienți, de obicei este suficientă o parte din nume. La rezervări ajută un cuvânt din notiță. ## Probleme? [#problemen] Verifică ortografia și încearcă o parte mai scurtă din termen. Dacă ai ales o categorie, Tillor caută doar în ea. Dacă există rezultate într-o altă categorie, fereastra îți spune asta. Alege **Tot** cu butonul de la începutul câmpului de căutare sau dă clic pe **Eliminați filtrul**. A apărut o problemă în timpul căutării. Fă clic pe **Reîncercați**. Dacă problema persistă, consultă [starea sistemului](https://status.tillor.eu). Caută după valoarea exactă, așa cum figurează la client. Găsești clientul la **Clienți**, nu într-o categorie separată. Scrie numărul așa cum apare pe document sau o parte din el: pentru `RES/2026/0042` funcționează și `2026/0042` și `20260042`. Altfel, caută după numele clientului. Notițele de la apelurile telefonice sunt stocate criptat și de aceea nu sunt căutate. Caută după numărul de telefon. Unele browsere sau extensii folosesc ele însele Ctrl+K sau ⌘K. Fă atunci clic pe **Căutați** în antet. ## Vezi și [#zie-ook] # Jurnal de activitate (/ro-RO/activiteitenlog) În jurnalul de activitate vezi ce s-a schimbat în Tillor, când și de către cine. Îl deschizi la un client, o factură, o sarcină sau o altă înregistrare, iar central prin **Jurnal de audit**, dacă ai drepturile pentru asta. Este o evidență doar în citire, pe care o folosești pentru a verifica sau a dovedi ceva. - O intrare nu poate fi editată sau ștearsă - La un export sunt incluse implicit ultimele 30 de zile și cel mult un an - Deschiderea repetată a aceluiași document în decurs de zece minute este menționată o singură dată - Orele sunt afișate în fusul tău orar - Apar și acțiunile unei automatizări, ale unei chei API sau ale sistemului, cu tipul de actor alături ## Vezi jurnalul de activitate [#activiteitenlog-bekijken] În aplicație se numește de obicei **Evenimente** sau **Activitate**, în funcție de locul în care te afli. Cine are dreptul *Vezi jurnalul de audit* poate deschide în plus o prezentare centrală prin *Jurnal de audit* în bara laterală (deasupra Setărilor), cu filtre după utilizator, tip de eveniment și dată. | Unde | Navigare | Eticheta în aplicație | |------|----------|-----------------| | Client (toată activitatea asociată) | *Clienți > client > Evenimente* | Evenimente | | Factură | *Administrare > Facturi > factură* | Evenimente | | Rezervare | *Clienți > client > Rezervări > rezervare* | Activitate | | Parcelă | *Parc > Terenuri > parcelă* | Evenimente | | Contor | *Parc > Contoare > contor* | Activitate | | Produs | *Administrare > Produse > produs* | Evenimente | | Sarcină | *Sarcini > sarcină* sau *Clienți > client > Sarcini > sarcină* | Activitate | | Etichetă NFC | *Controlere > Etichete NFC > etichetă* | Activitate | | Tabletă, chioșc sau telefon | *Setări > Tablete și chioșcuri > dispozitiv* | Istoric | | Organizație (central) | *Jurnal de audit* (deasupra Setărilor, dreptul *Vezi jurnalul de audit*) | Jurnal de audit | | Raport de plată | *Administrare > Rapoarte de plată > raport* | Jurnal de evenimente | Pentru fiecare activitate vezi în cronologie: - **Titlu** - tipul evenimentului (de exemplu „Factură înregistrată", „Client actualizat") - **Utilizator** - colegul care a efectuat acțiunea (sau Tillor la acțiunile automate) - **Moment** - data și timpul relativ - **Descriere** - detalii suplimentare; uneori cu legături către facturi sau alte înregistrări asociate - **Înainte / după** (uneori) - la crearea, modificarea sau ștergerea datelor de client, contact, factură, plată, mandat de plată, grup de plată, document, metodă de acces, punct de acces, controler, parcelă, contor, index de contor, produs, ocupare, sarcină sau comentariu, plus scanarea, atribuirea sau desfacerea unui document de identitate și modificările la setări, drepturi de membru, facturare sau NFC: ce câmpuri au fost modificate. Codurile PIN ale punctelor de acces și datele personale ale unui document de identitate nu sunt păstrate în jurnal - **Atașamente** (uneori) - fișiere descărcabile, de exemplu la integrări eșuate - **Autentificare / deconectare** - când un coleg se autentifică sau se deconectează, vizibil în prezentarea centrală a jurnalului de audit - **Aplicații OAuth și consimțământ** - crearea, modificarea, ștergerea sau rotirea secretului aplicațiilor OAuth, plus consimțământul acordat, refuzat sau retras; vizibil în prezentarea centrală a jurnalului de audit. Secretele clientului nu sunt păstrate în jurnal - **Administrare și securitate** - modificări ale profilului organizației (nume, date juridice, TVA, IBAN, logo, mod mentenanță), invitații și membri noi, chei API personale (creare, modificare, reînnoire, ștergere), sesiuni încheiate, webhook-uri, automatizări, grupuri de colegi, tipuri de parcele, tablouri de contoare, grupuri de controlere, integrări instalate sau eliminate și acceptarea acordului de prelucrare a datelor; vizibil în prezentarea centrală a jurnalului de audit. Cheile, secretele webhook și setările integrărilor nu sunt păstrate; la o integrare vezi doar ce setări au fost modificate - **Accesarea datelor personale** - cine a deschis sau a descărcat un document, a vizualizat sau a descărcat imaginile ori fișierele unui document de identitate sau a deschis PDF-ul unei facturi ori l-a trimis la tabletă. Deschiderea repetată în decurs de zece minute este menționată o singură dată; fiecare descărcare a unui document de identitate este menționată separat ## Activități pe înregistrare [#activiteiten-per-record] Pe paginile de detalii vezi o cronologie cu activitatea pentru acea înregistrare. Pe fila **Evenimente** de la un client se află toate activitățile legate de acel client (facturi, plăți, ocupări etc.). Pentru **rezervări**, aceasta include, printre altele, crearea, check-in-ul și check-out-ul, anulările și stornările aferente și actualizarea datelor rezervării. Pentru **grupurile de plată** vezi și ce plăți au fost adăugate într-un grup sau scoase din el, iar pentru **controlere** ce cereri de adoptare au fost aprobate sau respinse. Pentru **rapoartele de plată**, aceasta include, printre altele, crearea raportului, finalizarea unui raport ciornă și trimiterea către contabilitate. Pentru **cererile de semnare** vezi fiecare pas: creată și modificată, trimisă, link trimis (din nou), memento, pagina de semnare deschisă, cod trimis sau introdus greșit, semnată, refuzată, readusă la ciornă, anulată, expirată și finalizată. Vezi [Dovadă și valabilitate](/handtekeningen/bewijs-en-geldigheid). Pentru **notificările externe** vezi când un sistem conectat a actualizat sau a șters o notificare înregistrată de el. Jurnalul de activitate este doar în citire. Intrările nu pot fi editate sau șterse. ## Cine a făcut-o? [#wie-heeft-het-gedaan] Fiecare rând arată, pe lângă utilizator, și **ce fel de actor** a efectuat acțiunea: un utilizator autentificat, o cheie API, o conexiune OAuth, o automatizare, conectorul Tillor sau sistemul însuși. La o cheie API sau o conexiune OAuth, ID-ul acelei chei sau conexiuni apare în detalii, astfel încât, în cazul unei chei scurse, vezi exact ce s-a făcut cu ea. Dacă scrie **Necunoscut**, Tillor nu a putut stabili actorul; asta este intenționat altceva decât „Sistem". ## Evenimente de securitate [#beveiligingsgebeurtenissen] Autentificările eșuate, cheile API și token-urile OAuth refuzate, accesul refuzat (drepturi lipsă), limitele de cereri depășite și deschiderea organizației tale de către un administrator Tillor apar și ele în jurnalul de activitate, cu adresa IP și browserul. Membrii cu dreptul **Alerte de securitate** primesc în fiecare oră o notificare dacă au fost modificate webhook-uri, chei API sau automatizări sau dacă accesul a fost refuzat în mod repetat. Accesul la cont pe care i-l dai lui [Tillie](/vraag-het-tillie#tillie-in-je-account-laten-kijken) sau îl retragi și fiecare modificare pe care o confirmi prin Tillie apar tot aici. ## Exportă pentru un audit [#exporteren-voor-een-audit] Cu **Exportați** din jurnalul de activitate descarci toate rândurile perioadei alese (implicit ultimele 30 de zile, cel mult un an) ca ZIP cu fișierul de date (CSV sau JSON Lines), un `manifest.json` cu numărul de rânduri, perioada, cine a exportat și suma de control SHA-256 a fișierului de date, și un fișier `CHECKSUMS.sha256` pe care îl poți verifica cu `sha256sum -c`. Exportul însuși este și el înregistrat în jurnal, cu aceeași sumă de control. Sunt înregistrate și deschiderea jurnalului de activitate complet și exporturile în masă ale datelor clienților (lista de clienți, jurnalul de acces, parcele, contoare). Toate orele sunt stocate în **UTC** pe servere cu sincronizare a timpului prin NTP și sunt afișate în fusul tău orar; exportul conține ore ISO 8601 în UTC. ## La ce folosești jurnalul? [#waarvoor-gebruik-je-de-log] - **Control** - a verifica ce coleg a înregistrat o factură sau a modificat un client - **Depanare** - a afla când a apărut o eroare - **Audituri** - a păstra o evidență completă pentru controale interne sau externe ## Vezi și [#zie-ook] # Primii pași (/ro-RO/automatiseringen/aan-de-slag) Pe această pagină îți construiești prima automatizare și înveți să cunoști editorul, ecranul în care desenezi fluxuri. Ai nevoie de dreptul **Gestionare automatizări** sau de **Toate permisiunile**. Vezi [Prezentarea generală](/automatiseringen) pentru context. ## Prezentarea generală [#het-overzicht] Mergi la **Admin > Automatizări**. Vezi o listă cu un rând pentru fiecare automatizare: - numele și o etichetă precum **2 probleme** dacă mai este ceva în neregulă cu fluxul (vezi [Probleme și activare](/automatiseringen/problemen)) - descrierea - declanșatorul ales, numărul de pași și cine a creat automatizarea (**de**) - un șir de bare cu ultimele rulări, cu alături momentul ultimei rulări sau **Nu a rulat încă**. O bară roșie este o rulare eșuată - un comutator pentru a porni sau opri automatizarea și un meniu cu trei puncte Deasupra listei filtrezi cu **Toate**, **Activate** și **În pauză**. Dacă o automatizare are probleme, apare și un filtru **Probleme**. Cu **Caută automatizări** cauți după nume sau descriere. Fă clic pe nume pentru a deschide editorul. Cu comutatorul pornești sau oprești o automatizare. Nu o poți porni cât timp există probleme. Meniul **Acțiuni pentru automatizare** are două opțiuni: | Opțiune | Ce face | |---|---| | **Duplică** | Creează o copie cu numele *[nume] (copie)*. Copia este în pauză | | **Șterge** | Șterge automatizarea și istoricul rulărilor. Tillor cere mai întâi confirmare | Rulările care așteaptă în acel moment într-o întârziere se opresc dacă ștergi automatizarea. ## Creează o automatizare nouă [#een-nieuwe-automatisering-maken] Fă clic pe **Automatizare nouă**. Se deschide o galerie cu șase puncte de pornire. Fiecare pas poate fi ajustat ulterior. | Punct de pornire | Ce face | |---|---| | **Pornește de la zero** | Un flux gol, doar cu un declanșator | | **Verifică parcela după plecare** | Creează o sarcină de verificare pentru parcelă când se încheie o ocupare, cu prioritate ridicată și atribuită celui care a oprit ocuparea | | **Urmărește facturile neplătite** | Așteaptă până după data scadentă, trimite un memento de plată și, o săptămână mai târziu, creează o sarcină de a-l suna pe client dacă factura este încă deschisă | | **Trimite rezervările către alt sistem** | Pentru fiecare rezervare nouă trimite un payload propriu la endpoint-ul tău webhook și creează o sarcină dacă livrarea eșuează | | **Verifică un contor care nu mai numără** | Creează o sarcină pentru recepție când un contor rămâne blocat deși parcela a fost folosită, cu subsarcini pentru verificarea la fața locului | | **Apelează Tillor API** | Adaugă un comentariu la fiecare sarcină nouă prin Tillor API | De îndată ce alegi, Tillor creează automatizarea și deschide editorul. Automatizarea este în pauză până o activezi. ## Editorul [#de-editor] Editorul umple tot ecranul și are trei părți: în stânga lista de pași, la mijloc canvasul și în dreapta panoul. Numele automatizării se află deasupra, în firul de navigare, și îl poți modifica direct acolo. Treci cu mouse-ul peste marcajele ℹ pentru o scurtă explicație pentru fiecare parte. **Lista de pași (stânga).** Caută un pas cu **Caută pași**. Deasupra se află grupul **Instrumente** cu **Comentariu** și **Chenar** (vezi [Comentarii și chenare](#opmerkingen-en-kaders)). Dedesubt se află pașii în șase grupuri, cu **Documente** între ele: - **Logică**: declanșatorul **Când se întâmplă asta** și condiții, așteptare, căutare și parcurgere, cum ar fi **Dacă / altfel**, **Ramificare**, **Întârziere**, **Deschis acum?**, **Caută o înregistrare**, **Pentru fiecare** și **Cere o decizie**. Vezi [Condiții, ramificări și întârzieri](/automatiseringen/logica) - **Sarcini**: creează, caută și actualizează sarcini - **Documente**: caută și actualizează documente - **Oaspeți și mesaje**: mesaje către oaspeți și colegi, comentarii, inbox, clienți și rezervări - **Facturi și plăți**: facturi, linkuri de plată, mandate și consum - **Acces și dispozitive**: mijloace de acces, bariere, curent, etichete NFC și tablete - **Integrări**: **Trimite webhook** și **Cerere API** Ce face fiecare acțiune găsești la [Acțiuni](/automatiseringen/acties). Dedesubt se află **Solicită un pas**, pentru cazul în care îți lipsește un pas. **Canvas (la mijloc).** Aici vezi fluxul. Deasupra se află declanșatorul, sub el pașii, cu linii între ei. În stânga jos mărești și micșorezi. **Panou (dreapta).** Deasupra se află comutatorul **Activ**, la probleme un buton precum **1 problemă**, un buton **Aranjează** care așază pașii frumos unul sub altul (comentariile rămân unde sunt) și un buton **Ascunde panoul**. Dacă ascunzi panoul, **Afișează panoul** îl arată din nou. Dedesubt alegi o filă: | Filă | Ce faci acolo | |---|---| | **Configurează** | Ajustezi pasul selectat. Dacă nu selectezi nimic, poți completa o **Descriere** pentru automatizare | | **Rulare de test** | Încerci fluxul, vezi [Testare și rulări](/automatiseringen/testen-en-uitvoeringen) | | **Rulări** | Te uiți înapoi la ce au făcut rulările reale | | **Istoric** | Vezi și restaurezi versiuni salvate anterior, vezi [Versiuni anterioare](#eerdere-versies) | Dacă ai făcut modificări, în partea de jos a panoului apare **Modificări nesalvate** cu butoanele **Anulează modificările** și **Salvează**. **Anulează modificările** readuce fluxul la ultima versiune salvată. Dacă panoul este ascuns, aceste butoane se află în dreapta sus pe canvas. Cât timp nu ai selectat niciun pas, sub descriere apare cine a creat automatizarea. Rulările eșuate sunt trimise prin e-mail acelei persoane, cel mult o dată pe oră pentru fiecare automatizare. Pe un telefon, panoul este mai întâi ascuns, ca canvasul să primească tot ecranul. Atinge un pas sau **Afișează panoul** pentru a-l deschide. ### Adaugă și conectează pași [#stappen-toevoegen-en-verbinden] Ai patru moduri de a adăuga un pas: - Fă clic pe un pas din lista din stânga. Apare în mijlocul canvasului - Trage un pas din listă pe canvas - Fă clic pe plusul de sub o ieșire care nu duce încă nicăieri (**Adaugă un pas după "[ieșire]"**) și alege un pas. Pasul nou este conectat imediat - Trage un pas pe o linie. Se așază atunci între cei doi pași (**Inserează un pas aici**) Pentru a conecta pașii între ei, tragi de la ieșirea de sub un pas către alt pas. Se aplică următoarele: - Fiecare ieșire duce la un singur pas. Dacă conectezi din nou o ieșire, linia nouă o înlocuiește pe cea veche - O linie care ar forma un cerc este refuzată. Dacă totuși există o buclă, nu poți activa automatizarea. O rulare se oprește de îndată ce ar repeta un pas - Un pas fără linie de intrare nu este niciodată executat. Tillor raportează asta ca problemă (**Neconectat, așa că acest pas nu rulează niciodată.**) - Un declanșator îl poți ajusta, duplica și adăuga în plus din lista din stânga. Ultimul declanșator nu poate fi șters. Un declanșator nu are ce căuta pe o linie: pornește o rulare proprie Dă unui pas un nume propriu în câmpul **Numele pasului**. Asta ajută când fluxul devine mai mare. Cu butoanele **Duplică pasul** și **Șterge pasul** din partea de sus a panoului copiezi sau ștergi pasul selectat. ### Comentarii și chenare [#opmerkingen-en-kaders] Cu un comentariu explici pe canvas ce face o parte din flux, de exemplu de ce există o condiție. Un **Chenar** este o linie punctată cu un nume pe care o pui în jurul unui grup de pași. - Fă clic în grupul **Instrumente** pe **Comentariu** sau **Chenar** și scrie textul - Trage comentariul sau chenarul peste pașii pe care îi explică. Selectează-le pentru a le mări sau a le micșora cu colțurile - Șterge un comentariu cu **Șterge comentariul** sau un chenar cu **Șterge chenarul**, sau selectează-le și apasă Delete - Comentariile și chenarele nu sunt niciodată executate și nu contează pentru probleme. Poți pune împreună cel mult 50. Sunt păstrate cu **Salvează**, la fel ca pașii, iar Ctrl/Cmd + Z anulează o modificare ### Versiuni anterioare [#eerdere-versies] De fiecare dată când salvezi o modificare, Tillor păstrează versiunea anterioară. Pe fila **Istoric** vezi versiunile cu ce s-a schimbat, de exemplu **1 pas adăugat** sau **Aranjare sau conexiuni modificate**, și de către cine sau ce a venit modificarea (de exemplu **Prin API**). Cu **Restabilește** pui o versiune pe canvas. Asta contează ca modificare nesalvată: salvează pentru a păstra versiunea sau anulează. ### Scurtături de la tastatură [#sneltoetsen] | Tastă | Ce face | |---|---| | Ctrl/Cmd + S | Salvează | | Ctrl/Cmd + Z | Anulează | | Ctrl/Cmd + Shift + Z sau Ctrl/Cmd + Y | Refă | | Ctrl/Cmd + C, Ctrl/Cmd + V | Copiază și lipește pașii selectați | | Ctrl/Cmd + D | Duplică pașii selectați | | Ctrl/Cmd + A | Selectează tot | | Delete sau Backspace | Șterge pașii sau liniile selectate | | Esc | Anulează selecția | ## Salvează și activează [#opslaan-en-inschakelen] Tillor nu salvează automat. Fă clic pe **Salvează** (sau apasă Ctrl/Cmd + S) pentru a-ți păstra modificările. Butonul este activ de îndată ce ceva a fost modificat și numele nu este gol. Dacă automatizarea este pornită, poți salva doar dacă nu mai există probleme. Un flux care rulează trebuie să rămână mereu valid. Rezolvă problemele sau pune mai întâi automatizarea în pauză. Cu comutatorul **Activ** pornești automatizarea. Asta salvează imediat și fluxul. Comutatorul nu funcționează cât timp există probleme, cu explicația **Rezolvă mai întâi problemele deschise**. Apoi automatizarea pornește la fiecare eveniment potrivit. Poate dura o jumătate de minut până când o modificare se aplică peste tot. Dacă modifici mai târziu un flux activat, modificările se aplică doar rulărilor noi. Rulările care sunt deja în curs sau așteaptă într-o întârziere se termină cu fluxul așa cum era când au pornit. ## Prima ta automatizare: o sarcină după plecare [#je-eerste-automatisering-een-taak-na-vertrek] Acest exemplu creează o sarcină când se încheie o ocupare. 1. Fă clic pe **Automatizare nouă** și alege **Verifică parcela după plecare** 2. Fă clic pe declanșator. La **Eveniment** scrie `occupation:ended` 3. Fă clic pe pasul **Creează sarcină**. Ajustează **Titlu**, **Descriere** și **Prioritate** sau alege la **Adaugă la panou** un panou și o **Coloană** 4. Deschide fila **Rulare de test** și fă clic pe **Rulează testul**. Vezi ce pași ar parcurge fluxul 5. Fă clic pe **Salvează** și pornește **Activ** 6. Încheie o ocupare și vezi pe fila **Rulări** ce s-a întâmplat ## Solicită un pas sau un eveniment [#een-stap-of-gebeurtenis-aanvragen] Îți lipsește un declanșator, o condiție sau o acțiune? Fă clic pe **Solicită un pas** sub lista de pași. În lista de evenimente a declanșatorului se află și un link **Lipsește un eveniment? Solicită-l**. 1. Alege la **De ce ai nevoie?** una dintre **Un declanșator sau un eveniment**, **O condiție sau un filtru**, **O acțiune** sau **Altceva** 2. Descrie la **Ce ar trebui să facă?** ce vrei să automatizezi. Scrie cel puțin 10 caractere, cel mult 1000 3. Fă clic pe **Trimite solicitarea** Solicitarea ta ajunge la echipa Tillor, împreună cu numele tău și numele organizației tale. Primești o notificare că solicitarea a fost trimisă. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - O automatizare nouă este în pauză. Nu se întâmplă nimic până nu pornești **Activ**. - După activare, automatizarea pornește la fiecare eveniment potrivit. Poate dura o jumătate de minut până când o modificare se aplică peste tot. - Fiecare pornire este o rulare. Le vezi pe fila **Rulări**, cu starea **Finalizat**, **În așteptare**, **Eșuat** sau **Anulat**. - Dacă o rulare eșuează, cel care a creat automatizarea primește un e-mail, cel mult unul pe oră pentru fiecare automatizare. - Dacă modifici un flux care rulează, modificările se aplică doar rulărilor noi. Ce este deja în curs sau așteaptă se termină cu fluxul vechi. - Sarcinile și comentariile create de automatizare apar în numele utilizatorului **Flux de lucru**. Vezi [Cine execută o automatizare?](/automatiseringen/workflow-gebruiker). ## Probleme? [#problemen] Tillor afișează **Rezolvă mai întâi problemele deschise**. Fă clic sus în panou pe butonul cu numărul de probleme și rezolvă-le. Vezi [Probleme și activare](/automatiseringen/problemen). Butonul **Salvează** este activ abia când ceva a fost modificat și numele nu este gol. Dacă automatizarea este pornită, poți salva doar fără probleme. Rezolvă-le sau pune mai întâi în pauză. Tillor raportează **Neconectat, așa că acest pas nu rulează niciodată.** Trage de la ieșirea unui pas anterior către acest pas. O linie care ar forma un cerc este refuzată. Un flux poate merge doar înainte. Meniul apare doar dacă ai dreptul **Vizualizare automatizări**. Pentru a construi și a modifica este nevoie de **Gestionare automatizări**. Cere unui administrator să îți ajusteze drepturile. Parcurge punctele de la [De ce nu pornește automatizarea mea?](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet). ## Pașii următori [#volgende-stappen] # Documente (/ro-RO/automatiseringen/acties/documenten) Cu aceste acțiuni lucrezi cu documentele unui client, de exemplu o dovadă de plată a asigurării. Tipul și data expirării unui document se găsesc în datele documentului. Într-un flux le citești sub forma `{document.userMetadata.documentType}` și `{document.userMetadata.insuranceExpiryDate}`. ## Găsește document [#document-zoeken] Caută cel mai nou document al unui client. Pasul are două ieșiri: **Găsită** și **Negăsită**. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului, de exemplu `{document.customerId}` sau `{customer.id}`. Obligatoriu | | **Tip** | De exemplu **Dovadă de plată a asigurării**. Lasă gol pentru orice tip | | **Omite documentele arhivate** | Activat implicit | | **Doar documentele care nu au expirat** | Data expirării trebuie să fie după momentul actual. Documentele fără dată de expirare nu sunt luate în calcul. Dezactivat implicit | Dacă se potrivesc mai multe documente, pasul îl alege pe cel mai nou. Prin **Găsită**, pașii următori pot folosi `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}` și `{foundDocument.userMetadata.insuranceExpiryDate}`. Așa poți verifica, de exemplu, la o asigurare expirată, dacă clientul are deja o dovadă de plată nouă și valabilă: caută cu **Tip** *Dovadă de plată a asigurării* și cu **Doar documentele care nu au expirat** activat, și continuă doar prin **Negăsită**. ## Actualizează document [#document-bijwerken] Modifică tipul unui document sau îl arhivează ori îl restaurează. Câmpurile goale rămân așa cum sunt. | Câmp | Ce completezi | |---|---| | **Document** | ID-ul documentului. Implicit `{document.id}`. Obligatoriu | | **Tip nou** | Lasă gol pentru a păstra tipul | | **Status** | **Activ** sau **Arhivat**. Lasă gol pentru a păstra starea | Un tip care cere o dată de expirare, cum este **Dovadă de plată a asigurării**, eșuează dacă documentul nu are dată de expirare. Acțiunea returnează `{updatedDocument.id}`. # Facturi și plăți (/ro-RO/automatiseringen/acties/facturen-en-betalingen) Acești pași se află în grupul **Facturi și plăți**. Cum funcționează ieșirile citești la [Ieșirile unei acțiuni](/automatiseringen/acties#uitgangen-van-een-actie). ## Trimite memento de plată [#betalingsherinnering-versturen] Trimite clientului mementoul de plată al unei facturi, exact ca butonul de memento de pe factură. | Câmp | Ce completezi | |---|---| | **Factură** | ID-ul intern al facturii. Implicit `{invoice.id}`. Obligatoriu | Ține cont că în câmp se așteaptă ID-ul intern al facturii (`{invoice.id}`) și nu numărul facturii (`{invoice.displayId}`). Pasul eșuează dacă: - factura nu este înregistrată - nu mai este nimic de plătit, deci factura este deja achitată - clientul nu are adresă de e-mail, număr de telefon și adresă poștală completă Rularea primește atunci starea **Eșuat** și restul fluxului nu se execută. Pune de aceea înaintea mementoului un **Dacă / altfel** care verifică dacă factura mai este deschisă, ca în șablonul **Urmărește facturile neplătite**. Pasul omite o factură și dacă aceasta a fost scoasă din memento-urile automate sau dacă la client este activat **Exclude din somațiile automate**. ## Sincronizează tranzacțiile bancare [#banktransacties-synchroniseren] Preia tranzacțiile bancare noi și așteaptă până se termină importul. Pune acest pas înainte de **Trimite memento de plată**, ca o factură tocmai achitată să nu primească memento. Dacă Ponto nu este conectat, pasul este omis. Salvează automatizarea din rețeaua biroului. Tillor reține atunci IP-ul de care are nevoie conexiunea bancară. Fără acel IP, sincronizarea nu poate porni. ## Dezactivează mementourile automate pentru client [#automatische-herinneringen-uitschakelen-voor-klant] Activează **Exclude din somațiile automate** la setările de facturare ale clientului. Fluxurile de memento omit apoi toate facturile lui. O somație manuală rămâne posibilă. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului. Obligatoriu | ## Dezactivează mementourile automate pentru factură [#automatische-herinneringen-uitschakelen-voor-factuur] Scoate o singură factură din fluxurile de memento pentru restanțe și din memento-urile automate. Colegii pot în continuare să trimită manual un memento. | Câmp | Ce completezi | |---|---| | **Factură** | ID-ul facturii. Obligatoriu | ## Trimite factura [#factuur-versturen] Trimite o factură clientului, în același mod ca butonul de trimitere de pe factură. | Câmp | Ce completezi | |---|---| | **Factură** | ID-ul facturii. Implicit `{invoice.id}`. Obligatoriu | Pasul eșuează dacă factura nu este înregistrată sau dacă clientul nu are adresă de e-mail, număr de telefon și adresă poștală completă. ## Înregistrează factura [#factuur-boeken] Înregistrează o factură ciornă, astfel încât să primească numărul de factură. | Câmp | Ce completezi | |---|---| | **Factură** | ID-ul facturii. Implicit `{invoice.id}`. Obligatoriu | Dacă factura este deja înregistrată, nu se întâmplă nimic și fluxul continuă prin **Omis**. După înregistrare, acțiunea returnează `{bookedInvoice.displayId}`, numărul facturii. Îl poți folosi într-un mesaj sau într-o sarcină. Combină pasul cu **Trimite factura** pentru a înregistra și a trimite o factură ciornă dintr-o dată. ## Tipărește factura [#factuur-afdrukken] Tipărește o factură sau o afișează pe tableta de la recepție. | Câmp | Ce completezi | |---|---| | **Factură** | ID-ul facturii. Implicit `{invoice.id}`. Obligatoriu | | **Unde** | **Imprimantă A4** (implicit), **Imprimantă de bonuri** sau **Tabletă** | Imprimantele le configurezi la [Setări de tipărire](/printer/afdrukinstellingen). O factură pe care o tipărești a doua oară cu acest pas este pur și simplu tipărită din nou. ## Creează link de plată [#betaallink-aanmaken] Creează un link de plată online pentru suma care mai este de plătit pe o factură. | Câmp | Ce completezi | |---|---| | **Factură** | ID-ul facturii. Implicit `{invoice.id}`. Obligatoriu | | **Metodă de plată** | **Lasă clientul să aleagă** (implicit), **Bancontact**, **iDEAL**, **Card de credit** sau **Payconiq** | Linkul există doar pentru o factură înregistrată din care mai este ceva de plătit. Dacă factura nu este înregistrată sau este deja achitată, fluxul continuă prin **Omis**. Apoi acțiunea returnează `{paymentLink.url}`. Pune-l într-un text, de exemplu într-un mesaj prin [Trimite mesaj unui oaspete](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen). ## Solicită mandat SEPA [#sepa-mandaat-aanvragen] Trimite unui client prin e-mail o cerere de semnare a unui mandat SEPA sau un memento pentru o cerere încă deschisă. Vezi [Mandat](/betalingsverwerking/mandaat) pentru mandatul în sine. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului. Implicit `{customer.id}`. Obligatoriu | | **Trimite** | **O cerere nouă** (implicit) sau **Un memento** | O cerere nouă este omisă dacă există deja una deschisă. Un memento este omis dacă nu există nicio cerere deschisă sau dacă cererea a expirat. În ambele cazuri, fluxul continuă prin **Omis**. ## Încasează prin debit direct [#innen-via-domiciliëring] Încasează ce mai este de plătit pe o factură folosind mandatul SEPA activ al clientului. | Câmp | Ce completezi | |---|---| | **Factură** | ID-ul facturii. Implicit `{invoice.id}`. Obligatoriu | | **După zile** | Câte zile așteaptă Tillor înainte de încasare. La 0 se încasează imediat. Maximul este 7 zile, un număr mai mare devine 7. Implicit 0 | Pasul încasează întreaga sumă rămasă. Dacă factura nu este înregistrată sau este deja achitată, sau dacă clientul nu are mandat activ, nu se întâmplă nimic și fluxul continuă prin **Omis**. Dacă clientul are mai mult de un mandat activ, pasul îl folosește pe cel mai nou. ## Facturează consumul [#verbruik-factureren] Facturează consumul de contor rămas nefacturat al unui client, înregistrează factura și o trimite. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului. Implicit `{occupation.customerId}`. Obligatoriu | | **Trimite prin e-mail** | Activat implicit | | **Trimite prin SMS** | Dezactivat implicit | Dacă nu există nimic de facturat, nu se creează nicio factură și fluxul continuă prin **Omis**. Altfel, acțiunea returnează `{consumptionInvoice.id}`. Vezi [Gestionarea contoarelor](/meterbeheer) pentru modul în care este urmărit consumul. ## Ciornă de factură de prelungire [#conceptfactuur-voor-verlenging] Creează o factură ciornă care prelungește o ocupare, gata de verificat. Factura nu este încă înregistrată. Este același tip de factură pe care îl obții cu **Prelungiți ocuparea (factură)** pe profilul clientului. | Câmp | Ce completezi | |---|---| | **Ocupare** | ID-ul ocupării. Implicit `{occupation.id}`. Obligatoriu | | **Adaugă consumul deschis** | Pune consumul de contor rămas al clientului pe aceeași factură. Dezactivat implicit | Acțiunea returnează `{extendInvoice.id}`. Dacă vrei să înregistrezi și să trimiți factura imediat, folosește apoi **Înregistrează factura** și **Trimite factura** cu `{extendInvoice.id}` ca factură. # Oaspeți și mesaje (/ro-RO/automatiseringen/acties/gasten-en-berichten) Acești pași se află în grupul **Oaspeți și mesaje**. Cum funcționează ieșirile citești la [Ieșirile unei acțiuni](/automatiseringen/acties#uitgangen-van-een-actie). ## Trimite mesaj unui oaspete [#gast-een-bericht-sturen] Trimite textul tău unui client prin e-mail, SMS sau WhatsApp. Folosește-l pentru mesaje care nu au un șablon fix în Tillor, cum ar fi un mesaj de bun venit în ziua sosirii. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului, de exemplu `{reservation.customerId}`. Obligatoriu | | **Subiect** | Doar pentru e-mail. Dacă rămâne gol, se folosește numele organizației tale | | **Mesaj** | Textul, fără formatare. Variabilele sunt completate. Obligatoriu | | **Trimite prin e-mail** | Activat implicit | | **Trimite prin SMS** | Dezactivat implicit | | **Trimite prin WhatsApp** | Dezactivat implicit | Ține cont de următoarele: - Clienții care nu acceptă comunicări nu primesc nimic. Fluxul continuă atunci prin **Omis** - În afara ferestrei de 24 de ore din WhatsApp, Tillor trimite textul tău ca șablon aprobat. În interiorul ferestrei, se trimite ca mesaj obișnuit - Dacă clientul nu există, pasul eșuează ## Notifică colegii [#collegas-verwittigen] Trimite colegilor o notificare push, un e-mail sau ambele. | Câmp | Ce completezi | |---|---| | **Colegi** | Alege unul sau mai mulți colegi | | **Notifică și persoana care a cauzat evenimentul** | Notifică și colegul care a cauzat evenimentul. Dacă evenimentul a fost cauzat de sistem, nu se adaugă nimeni | | **Titlu** | Titlul notificării. Obligatoriu | | **Text** | Conținutul notificării | | **Trimite ca notificare push** | Activat implicit | | **Trimite prin e-mail** | Dezactivat implicit | Utilizatorul **Flux de lucru** nu primește niciodată el însuși o notificare. Dacă nu există colegi de notificat, pasul nu face nimic și fluxul continuă normal. ## Adaugă un comentariu [#opmerking-toevoegen] Postează un [comentariu](/notities) în numele utilizatorului **Flux de lucru**. | Câmp | Ce completezi | |---|---| | **Comentariu** | Textul comentariului. Obligatoriu | | **La** | **Înregistrările evenimentului** (implicit) sau **O sarcină** | | **Sarcină** | Doar la **O sarcină**: ID-ul sarcinii, de exemplu `{createdTask.id}`. Obligatoriu | Ține cont de următoarele: - Menționează un coleg cu `@{triggeredBy.name}({triggeredBy.id})`. Colegul primește atunci o notificare, ca la un comentariu scris de tine. Funcționează doar dacă evenimentul a fost cauzat de un coleg - La **Înregistrările evenimentului**, comentariul ajunge la client, factură, rezervare, plată, parcelă, contor și sarcina la care se referă evenimentul. Dacă evenimentul nu are niciuna dintre aceste înregistrări, pasul eșuează - Acțiunea returnează `{createdComment.id}` ## Răspunde în inbox [#antwoorden-in-de-inbox] Trimite un răspuns într-o conversație din inbox, pe același canal pe care a scris oaspetele. | Câmp | Ce completezi | |---|---| | **Conversație** | ID-ul conversației. Implicit `{threadId}`. Obligatoriu | | **Răspuns** | Textul, fără formatare. Variabilele sunt completate. Dacă depășește 4096 de caractere, este tăiat. Obligatoriu | | **Păstrează asistentul AI activ** | Dezactivat implicit | Ține cont de următoarele: - `{threadId}` există la evenimentele despre mesajele din inbox, cum ar fi `inbox:message-created` - Evenimentul se aplică fiecărui mesaj nou, inclusiv propriului tău răspuns. Verifică de aceea mai întâi dacă mesajul a venit de la oaspete, altfel răspunsul tău pornește din nou fluxul. Pune înaintea acestui pas un [Caută o înregistrare](/automatiseringen/logica#record-opzoeken) pe **Mesaj din inbox** cu `{messageId}` și un **Dacă / altfel** care verifică dacă `foundInboxMessage.direction` este egal cu `INBOUND` - Implicit, răspunsul tău oprește [asistentul AI](/inbox/inbox-ai-assistant) în acea conversație, la fel ca atunci când răspunde un coleg. Cu **Păstrează asistentul AI activ**, asistentul continuă să vorbească. Dacă conversația este arhivată, pasul eșuează ## Etichetează sau arhivează conversația [#gesprek-taggen-of-archiveren] Adaugă etichete unei conversații din inbox, o arhivează sau face ambele. | Câmp | Ce completezi | |---|---| | **Conversație** | ID-ul conversației. Implicit `{threadId}`. Obligatoriu | | **Adaugă etichete** | Alege una sau mai multe etichete. Se adaugă la cele existente, care rămân | | **Arhivează conversația** | Dezactivat implicit | ## Actualizează clientul [#klant-bijwerken] Modifică starea unui client sau adaugă o notă. Celelalte date ale clientului rămân neschimbate. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului, de exemplu `{invoice.customerId}`. Obligatoriu | | **Status** | **Lasă neschimbat** (implicit), **Standard**, **Preferat**, **VIP**, **Avertisment** sau **Blocat** | | **Adaugă la note** | Text care se adaugă pe un rând nou sub notele existente. Dacă rămâne gol, nu se adaugă nimic | ## Check-in, check-out sau anulare [#inchecken-uitchecken-of-annuleren] Trece o rezervare în starea ei următoare. | Câmp | Ce completezi | |---|---| | **Rezervare** | ID-ul rezervării. Implicit `{reservation.id}`. Obligatoriu | | **Acțiune** | **Check-in** (implicit), **Check-out** sau **Anulare** | Rezervarea trebuie să fie în starea potrivită. **Check-in** și **Anulare** funcționează la o rezervare cu starea **Rezervat**, **Check-out** la o rezervare cu starea **Check-in efectuat**. Dacă se află în altă stare, nu se întâmplă nimic și fluxul continuă prin **Omis**. # Prezentare generală (/ro-RO/automatiseringen/acties) Acțiunile sunt pașii care fac efectiv ceva. Le găsești în lista de pași, în grupurile **Sarcini**, **Documente**, **Oaspeți și mesaje**, **Facturi și plăți**, **Acces și dispozitive** și **Integrări**. Pașii din grupul **Logică** conduc fluxul însuși. Aceștia se află la [Condiții, ramificări și întârzieri](/automatiseringen/logica). Toate acțiunile sunt executate de utilizatorul [**Flux de lucru**](/automatiseringen/workflow-gebruiker) al organizației tale. | Grup | Acțiune | Ce face | |---|---|---| | Sarcini | [Creează sarcină](/automatiseringen/acties/taken#taak-aanmaken) | Creează o sarcină, eventual cu subsarcini, pe un panou și legată de client, parcelă sau factură | | Sarcini | [Setează starea](/automatiseringen/acties/taken#taakstatus-zetten) | Modifică starea unei sarcini existente | | Sarcini | [Caută sarcină](/automatiseringen/acties/taken#taak-zoeken) | Caută o sarcină după titlu și continuă prin **Găsită** sau **Negăsită** | | Sarcini | [Setează prioritatea sarcinii](/automatiseringen/acties/taken#taakprioriteit-zetten) | Mărește, scade sau alege prioritatea unei sarcini existente | | Sarcini | [Actualizează sarcina](/automatiseringen/acties/taken#taak-bijwerken) | Redenumește o sarcină, adaugă persoane sau etichete ori mută termenul limită | | Sarcini | [Șterge sarcina](/automatiseringen/acties/taken#taak-verwijderen) | Șterge o sarcină, de exemplu sarcina creată de acest flux | | Documente | [Găsește document](/automatiseringen/acties/documenten#document-zoeken) | Caută cel mai nou document al unui client și continuă prin **Găsită** sau **Negăsită** | | Documente | [Actualizează document](/automatiseringen/acties/documenten#document-bijwerken) | Modifică tipul unui document sau îl arhivează ori îl restaurează | | Oaspeți și mesaje | [Trimite mesaj unui oaspete](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen) | Trimite un text propriu unui client prin e-mail, SMS sau WhatsApp | | Oaspeți și mesaje | [Notifică colegii](/automatiseringen/acties/gasten-en-berichten#collegas-verwittigen) | Trimite colegilor o notificare push sau un e-mail | | Oaspeți și mesaje | [Adaugă un comentariu](/automatiseringen/acties/gasten-en-berichten#opmerking-toevoegen) | Postează un comentariu la înregistrările evenimentului sau la o sarcină | | Oaspeți și mesaje | [Răspunde în inbox](/automatiseringen/acties/gasten-en-berichten#antwoorden-in-de-inbox) | Trimite un răspuns într-o conversație din inbox | | Oaspeți și mesaje | [Etichetează sau arhivează conversația](/automatiseringen/acties/gasten-en-berichten#gesprek-taggen-of-archiveren) | Adaugă etichete unei conversații din inbox sau o arhivează | | Oaspeți și mesaje | [Actualizează clientul](/automatiseringen/acties/gasten-en-berichten#klant-bijwerken) | Modifică starea unui client sau adaugă o notă | | Oaspeți și mesaje | [Check-in, check-out sau anulare](/automatiseringen/acties/gasten-en-berichten#inchecken-uitchecken-of-annuleren) | Trece o rezervare în starea ei următoare | | Facturi și plăți | [Trimite memento de plată](/automatiseringen/acties/facturen-en-betalingen#betalingsherinnering-versturen) | Trimite clientului mementoul de plată al unei facturi | | Facturi și plăți | [Sincronizează tranzacțiile bancare](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren) | Preia tranzacțiile bancare noi înainte ca fluxul să continue | | Facturi și plăți | [Dezactivează mementourile automate pentru client](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant) | Omite toate facturile unui client din somațiile automate | | Facturi și plăți | [Dezactivează mementourile automate pentru factură](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-factuur) | Scoate o singură factură din fluxurile de memento automate | | Facturi și plăți | [Trimite factura](/automatiseringen/acties/facturen-en-betalingen#factuur-versturen) | Trimite o factură clientului | | Facturi și plăți | [Înregistrează factura](/automatiseringen/acties/facturen-en-betalingen#factuur-boeken) | Înregistrează o factură ciornă | | Facturi și plăți | [Tipărește factura](/automatiseringen/acties/facturen-en-betalingen#factuur-afdrukken) | Tipărește o factură sau o afișează pe o tabletă | | Facturi și plăți | [Creează link de plată](/automatiseringen/acties/facturen-en-betalingen#betaallink-aanmaken) | Creează un link de plată online pentru ce mai este de plătit | | Facturi și plăți | [Solicită mandat SEPA](/automatiseringen/acties/facturen-en-betalingen#sepa-mandaat-aanvragen) | Cere unui client să semneze un mandat sau trimite un memento | | Facturi și plăți | [Încasează prin debit direct](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring) | Încasează ce mai este de plătit cu mandatul activ al clientului | | Facturi și plăți | [Facturează consumul](/automatiseringen/acties/facturen-en-betalingen#verbruik-factureren) | Facturează consumul de contor rămas nefacturat al unui client | | Facturi și plăți | [Ciornă de factură de prelungire](/automatiseringen/acties/facturen-en-betalingen#conceptfactuur-voor-verlenging) | Creează o factură ciornă care prelungește o ocupare | | Acces și dispozitive | [Creează metodă de acces](/automatiseringen/acties/toegang-en-toestellen#toegangsmiddel-aanmaken) | Oferă unui client acces prin cod QR, număr de înmatriculare, cod PIN sau NFC | | Acces și dispozitive | [Actualizează accesul](/automatiseringen/acties/toegang-en-toestellen#toegang-bijwerken) | Blochează, deblochează sau prelungește mijloace de acces | | Acces și dispozitive | [Trimite sau tipărește codul QR](/automatiseringen/acties/toegang-en-toestellen#qr-code-versturen-of-afdrukken) | Trimite clientului un cod de acces QR sau îl tipărește | | Acces și dispozitive | [Deschide sau închide bariera](/automatiseringen/acties/toegang-en-toestellen#slagboom-openen-of-sluiten) | Deschide sau închide o barieră sau o poartă | | Acces și dispozitive | [Comută curentul](/automatiseringen/acties/toegang-en-toestellen#stroom-schakelen) | Pornește sau oprește curentul unui contor inteligent | | Acces și dispozitive | [Actualizează etichetele NFC](/automatiseringen/acties/toegang-en-toestellen#nfc-tags-bijwerken) | Blochează, deblochează sau reîncarcă etichetele NFC ale unui client | | Acces și dispozitive | [Controlează tableta sau chioșcul](/automatiseringen/acties/toegang-en-toestellen#tablet-of-kiosk-bedienen) | Trezește o tabletă sau un chioșc, îl pune în repaus sau îl reîncarcă | | Acces și dispozitive | [Setează prezentarea](/automatiseringen/acties/toegang-en-toestellen#diavoorstelling-instellen) | Pune fotografii pe tablete și chioșcuri, dintr-o listă sau dintr-o cerere anterioară | | Integrări | [Trimite webhook](/automatiseringen/acties/integraties#webhook-versturen) | Livrează un mesaj propriu la unul dintre endpoint-urile tale webhook | | Integrări | [Cerere API](/automatiseringen/acties/integraties#api-verzoek) | Apelează Tillor API sau un alt site | În toate câmpurile de text poți folosi [variabile](/automatiseringen/variabelen), cum ar fi `{invoice.displayId}`. În dreapta sus a fiecărui câmp se află un buton **Variabilă** pentru a insera una. Câmpurile în care se cere un client, o factură sau o altă înregistrare așteaptă ID-ul intern al acelei înregistrări, cum ar fi `{invoice.id}`. Un număr de factură sau un nume nu funcționează deci. ## Ieșirile unei acțiuni [#uitgangen-van-een-actie] Sub un pas se află una sau mai multe ieșiri. Conectezi fiecare ieșire la un pas următor. Dacă lași o ieșire neconectată, rularea se încheie acolo. | Ieșire | La ce acțiuni | Când | |---|---|---| | **Următor** | Majoritatea acțiunilor | Pasul a reușit | | **Gata** și **Omis** | Acțiuni care uneori nu au nimic de făcut | **Gata** dacă pasul și-a făcut treaba. **Omis** dacă nu era nimic de făcut, de exemplu pentru că factura era deja înregistrată. Nu este o eroare | | **Găsită** și **Negăsită** | **Caută sarcină** | Dacă sarcina există | | **Găsită** și **Negăsită** | **Găsește document** | Dacă clientul are un astfel de document | | **Reușit** și **Eșuat** | **Trimite webhook** și **Cerere API** | Dacă cealaltă parte a acceptat mesajul | **Gata** și **Omis** apar la **Trimite mesaj unui oaspete**, **Check-in, check-out sau anulare**, **Înregistrează factura**, **Creează link de plată**, **Solicită mandat SEPA**, **Încasează prin debit direct** și **Facturează consumul**. La fiecare dintre ele, sub acțiune scrie când un pas este omis. ### Continuă când acest pas eșuează [#doorgaan-als-deze-stap-mislukt] Dacă o acțiune eșuează, rularea se oprește în mod normal cu starea **Eșuat**. Dacă vrei să decizi tu ce se întâmplă atunci, activează la finalul setărilor pasului **Continuă când acest pas eșuează**. Se poate la orice acțiune, în afară de **Trimite webhook** și **Cerere API**, care au deja propria ieșire **Eșuat**. Pasul primește atunci o ieșire suplimentară **Eroare**. Dacă acțiunea eșuează, fluxul continuă prin **Eroare** în loc să se oprească. Pașii următori pot folosi aceste variabile: | Variabilă | Conținut | |---|---| | `{error.message}` | Mesajul de eroare. Poate fi în engleză | | `{error.step}` | Numele pasului care a eșuat, așa cum l-ai completat la **Numele pasului** | Câteva lucruri de știut: - Dacă acțiunea a reușit sau a fost omisă, nu se schimbă nimic și **Eroare** nu este folosită - Dacă lași **Eroare** neconectată, rularea se încheie acolo fără alți pași. Rularea primește atunci starea **Finalizat**, dar pasul însuși apare pe fila **Rulări** cu mesajul său de eroare - Un al doilea pas eșuat în același flux înlocuiește `{error.message}` și `{error.step}` ale primului Un exemplu: lasă **Trimite mesaj unui oaspete** să continue dacă eșuează și creează prin **Eroare** o sarcină cu `{error.message}` în descriere. Astfel un coleg preia singur conversația cu oaspetele. ## Când un pas eșuează [#als-een-stap-mislukt] Există trei moduri în care decurge un eșec. - **O ieșire Eșuat.** Se întâmplă la **Trimite webhook** și **Cerere API** când cealaltă parte returnează o eroare. Fluxul continuă prin ieșirea **Eșuat**. Conecteaz-o la un pas următor, cum ar fi o sarcină pentru un coleg. Dacă lași ieșirea neconectată, rularea se încheie pur și simplu acolo - **O ieșire Eroare.** Dacă activezi la o altă acțiune **Continuă când acest pas eșuează**, pasul primește o ieșire **Eroare** și poți folosi motivul cu `{error.message}`. Vezi [Continuă când acest pas eșuează](#doorgaan-als-deze-stap-mislukt) - **Pasul oprește rularea.** Dacă lipsește o valoare după completarea variabilelor, o factură nu poate fi trimisă, un endpoint nu mai există sau JSON-ul este invalid, rularea primește starea **Eșuat**. Pașii următori nu se execută și Tillor nu reîncearcă pasul. Asta se întâmplă doar dacă nu ai activat **Continuă când acest pas eșuează** Mesajul de eroare se află la pas, pe fila **Rulări**. Aceste mesaje pot fi în engleză. Vrei ca un eșec să nu rămână niciodată neobservat? Conectează ieșirea **Eșuat** a unei **Cerere API** sau **Trimite webhook**, sau ieșirea **Eroare** a altei acțiuni, la un pas [Creează sarcină](/automatiseringen/acties/taken#taak-aanmaken). Astfel un coleg poate prelua problema. ## Grupuri [#groepen] # Integrări (/ro-RO/automatiseringen/acties/integraties) Acești pași se află în grupul **Integrări**. O livrare eșuată continuă prin **Eșuat**. Pentru celelalte acțiuni citești [Când un pas eșuează](/automatiseringen/acties#als-een-stap-mislukt). ## Trimite webhook [#webhook-versturen] Livrează un mesaj propriu la unul dintre endpoint-urile webhook ale organizației tale. E util pentru a anunța un alt sistem, de exemplu sistemul de casă sau site-ul tău. | Câmp | Ce completezi | |---|---| | **Endpoint** | Alege unul dintre endpoint-urile tale webhook. Le recunoști după adresă. Obligatoriu | | **Numele evenimentului** | Numele care însoțește mesajul, pentru ca destinatarul să îl poată recunoaște, de exemplu `automation.invoice_unpaid`. Obligatoriu | | **Payload** | Conținutul mesajului, ca JSON. Variabilele sunt completate înainte ca mesajul să fie trimis. Obligatoriu | Endpoint-urile le creezi și le gestionezi din meniul de profil, la **Dezvoltatori**. Endpoint-ul trebuie să existe și să fie activat. Dacă nu este, pasul eșuează și execuția se oprește. Mesajul este semnat cu cheia proprie a endpoint-ului, exact ca celelalte webhook-uri pe care le primește endpoint-ul. Tillor încearcă din nou de câteva ori dacă serverul tău nu răspunde corect. Endpoint-ul nu trebuie să urmeze numele evenimentului tău: mesajul ajunge oricum. Pasul are două ieșiri: | Ieșire | Când | |---|---| | **Reușit** | Serverul tău a răspuns cu o stare de succes | | **Eșuat** | Livrarea a eșuat după toate încercările. Mesajul mai este apoi reîncercat în fundal, ca un webhook obișnuit | Șablonul **Trimite rezervările către alt sistem** folosește **Eșuat** pentru a crea o sarcină, astfel încât cineva să se ocupe de ea. Un payload arată, de exemplu, așa: ```json { "reservation": "{reservation.displayId}", "checkIn": "{reservation.checkIn}", "adults": {reservation.numberOfAdults}, "customer": { "firstName": "{reservation.customer.firstName}", "email": "{reservation.customer.email}" } } ``` Pune textul între ghilimele și numerele fără. Datele se transmit în JSON ca dată și oră internaționale, de exemplu `2026-10-05T08:00:00.000Z`. Citește [Variabile și șabloane](/automatiseringen/variabelen#hoe-waarden-worden-ingevuld) pentru detalii. Partea tehnică, cum ar fi structura mesajului, se află la [Dezvoltatori > Automatizări](/ontwikkelaars/automatiseringen). ## Cerere API [#api-verzoek] Apelează API-ul Tillor al propriei organizații sau o altă adresă de pe internet. Cu el poți face aproape tot ce poate face Tillor și poți căuta date pentru a face apoi ceva cu ele. La **Trimite către** alegi între **Tillor API** și **URL personalizat**. La **Metodă** alegi **GET** (interogare), **POST** (creare), **PUT** sau **PATCH** (modificare) ori **DELETE** (ștergere). ### Tillor API [#tillor-api] | Câmp | Ce completezi | |---|---| | **Cale** | Partea din adresă de după API-ul organizației tale, de exemplu `/tasks` sau `/tasks/{task.id}`. Trebuie să înceapă cu `/`. Obligatoriu | | **Corp** | Datele pe care le trimiți, ca JSON. Lasă gol dacă nu trimiți nimic | Deasupra câmpului se află **Alege un endpoint API**. Fă clic pe el și caută în listă, de exemplu *tasks*. Când alegi un endpoint, Tillor completează metoda și calea. Dacă **Corp** este încă gol, primești și un exemplu a ceea ce așteaptă endpoint-ul. Înlocuiește numele dintre acolade din cale cu variabile din pașii anteriori. Dacă există parametri de interogare, îi vezi sub câmp. Apelul se face ca utilizatorul **Flux de lucru** și nu poate ieși niciodată din organizația ta. O automatizare nu poate gestiona automatizări, așa că apelurile care afectează automatizările sau rulările lor sunt refuzate. ### URL personalizat [#eigen-url] | Câmp | Ce completezi | |---|---| | **URL** | Adresa. Trebuie să înceapă cu `https://`. Obligatoriu | | **Anteturi** | Date suplimentare pentru destinatar, de exemplu o cheie. Fă clic pe **Adaugă antet** și completează **Nume** și **Valoare** | | **Corp** | Datele pe care le trimiți, ca JSON. Lasă gol dacă nu trimiți nimic | Se aplică aceste reguli: - Adresele fără `https://` sunt refuzate - Adresele private și interne sunt refuzate, chiar dacă un nume obișnuit trimite la ele - Redirecționările nu sunt urmate. Dacă serverul răspunde cu o redirecționare, se consideră **Eșuat** - Anteturile sunt stocate criptat. Poți deci pune în ele o cheie sau un token - La **GET** și **DELETE** nu se trimite corp ### Ieșiri și răspuns [#uitgangen-en-antwoord] Cererea are două ieșiri: **Reușit** (serverul a răspuns cu o stare de succes) și **Eșuat** (serverul a răspuns cu o stare de eroare). Dacă Tillor nu ajunge deloc la server, de exemplu din cauza unui timeout după 15 secunde sau a unei adrese refuzate, execuția se oprește cu starea **Eșuat**. Pentru pașii următori există trei variabile: | Variabilă | Conținut | |---|---| | `{response.status}` | Codul de stare, de exemplu 200 | | `{response.body}` | Răspunsul ca text, scurtat la primele 4000 de caractere | | `{response.data}` | Răspunsul ca date, astfel încât să poți extrage câmpuri din el cu `{response.data.items.0.id}` | Cum le folosești se explică la [Folosirea unui răspuns API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). Un exemplu complet cu o căutare se află la [Verificare caravană de închiriat](/automatiseringen/voorbeeld-nalopen). # Sarcini (/ro-RO/automatiseringen/acties/taken) Cu acești pași, o automatizare creează și actualizează sarcini, astfel încât un coleg să se ocupe de ceva. Ei se află în grupul **Sarcini**. Cum funcționează ieșirile citești la [Ieșirile unei acțiuni](/automatiseringen/acties#uitgangen-van-een-actie). ## Cum se leagă toate [#hoe-hangt-dit-samen] O sarcină creată de o automatizare este o sarcină obișnuită: o găsești pe pagina de sarcini, în vizualizările în care se potrivește și la clientul sau înregistrarea de care este legată. ```mermaid flowchart LR A["Pasul Creează sarcină"] --> T["Sarcină pe pagina de sarcini
pe numele Flux de lucru"] T --> V["Vizualizările o afișează
dacă se potrivește sau e în listă"] T --> C["Un coleg se ocupă de ea"] C -- "Starea sau atribuirea se schimbă" --> E["O altă automatizare poate porni de aici"] D["Pasul Cere o decizie"] --> T2["Sarcină cu butoane de alegere"] T2 -- "Un coleg alege un buton" --> F["Automatizarea continuă prin acea opțiune"] ``` Mai multe despre ce văd și ce fac colegii găsești la [Sarcini](/taken) și [Sarcini cu butoane de alegere](/taken/taakdetails#taken-met-keuzeknoppen). ## Creează sarcină [#taak-aanmaken] Creează o sarcină în sistemul de sarcini. Sarcina apare pe numele **Flux de lucru**. | Câmp | Ce completezi | |---|---| | **Titlu** | Numele sarcinii. Obligatoriu | | **Descriere** | O explicație pentru sarcină | | **Atribuie către** | Alege unul sau mai mulți colegi. Fă clic pe un nume pentru a-l activa sau dezactiva | | **Atribuie grupurilor** | Alege unul sau mai multe [grupuri](/gebruikers/groepen). Sarcina se aplică atunci tuturor celor care fac parte din grup în acel moment | | **Etichete** | Alege una sau mai multe [etichete](/taken/labels) | | **Atribuie și persoanei care a cauzat evenimentul** | Atribuie sarcina și colegului care a cauzat evenimentul, de exemplu cel care a încheiat ocuparea. Dacă evenimentul a fost cauzat de sistem, nu se adaugă nimeni | | **Prioritate** | **Scăzută**, **Medie**, **Ridicată** sau **Urgentă**. Implicit **Medie** | | **Adaugă la panou** | Alege un panou pe care va apărea sarcina sau lasă gol | | **Coloană** | Alege o coloană a panoului de mai sus. Lista afișează coloanele ca *[panou] · [coloană]* | | **Subtaskuri** | Un subtask pe rând sau exact o variabilă cu o listă, cum ar fi `{result}` din [Rulează cod](/automatiseringen/logica#code-uitvoeren) | | **Termen după** | Câte minute, ore, zile sau săptămâni după executarea pasului expiră termenul. La 0 sarcina nu primește termen. Implicit 1 zi | | **Leagă de înregistrări** | Leagă sarcina de înregistrările de mai jos și de clientul, parcela, factura, rezervarea sau contorul lor. Implicit activat | | **Leagă de** | Apare când **Leagă de înregistrări** este activat. Alege la ce înregistrări apare sarcina. Inițial este bifat tot ce cunoaște pasul: înregistrările declanșatorului și ce a găsit un pas de căutare anterior | | **Doar fluxul o poate finaliza** | Colegii nu pot finaliza sau șterge sarcina. Mai departe, adaugă un pas **Șterge sarcina** sau **Setează starea** pentru a o finaliza | Ține cont de următoarele: - Dacă nu alegi pe nimeni la **Atribuie către** sau **Atribuie grupurilor** și lași dezactivat **Atribuie și persoanei care a cauzat evenimentul**, sarcina nu are niciun coleg atribuit. **Flux de lucru** nu este niciodată atribuit el însuși - Subtaskurile au același titlu pe care îl completezi, niciun coleg atribuit și niciun termen. Rândurile goale sunt omise. Poți folosi variabile în rânduri - La **Leagă de** este vorba despre clienți, parcele, facturi, rezervări și contoare. La o ocupare care se încheie, sarcina este deci legată implicit de parcelă, de client și de rezervare. Dacă scoți o înregistrare din listă, sarcina rămâne în afara ei. Înregistrările care se adaugă mai târziu fluxului nu sunt adăugate automat de Tillor după ce ai modificat tu lista. Dacă alegi din nou tot, pasul urmează iar toate înregistrările disponibile - Dacă o sarcină se află doar pe un panou personal, o văd numai cei implicați. Vezi [Sarcini private](/taken/prive-taken) Pentru pașii următori, acțiunea returnează `{createdTask.id}` și `{createdTask.name}`. Cu ele poți seta apoi, de exemplu, starea. Dacă nu vrei o a doua sarcină atunci când există deja una deschisă pentru aceeași parcelă sau același client, pune mai întâi un pas [Caută sarcină](#taak-zoeken) și creează sarcina doar prin **Negăsită**. [Exemplul Verificare caravană de închiriat](/automatiseringen/voorbeeld-nalopen) face asta. Dacă activezi **Doar fluxul o poate finaliza**, sarcina afișează **Finalizată de automatizarea sa**. Colegii nu o pot finaliza sau șterge. ## Șterge sarcina [#taak-verwijderen] Șterge o sarcină, de exemplu sarcina creată de acest flux, de îndată ce nu mai este necesară. | Câmp | Ce completezi | |---|---| | **Sarcină** | ID-ul sarcinii. Implicit `{createdTask.id}`. Obligatoriu | O sarcină care a dispărut deja este omisă. Fluxul continuă atunci normal. ## Setează starea [#taakstatus-zetten] Modifică starea unei sarcini existente, de exemplu pentru a o finaliza. | Câmp | Ce completezi | |---|---| | **Sarcină** | ID-ul sarcinii. Implicit `{task.id}`. Obligatoriu | | **Stare** | **În așteptare**, **În curs**, **În așteptarea răspunsului** sau **Finalizat**. Implicit **Finalizat** | `{task.id}` funcționează dacă automatizarea pornește la un eveniment al unei sarcini, cum ar fi `task:created`. După un pas **Creează sarcină** folosești `{createdTask.id}`. Acțiunea returnează `{updatedTask.id}` și `{updatedTask.status}`. ## Caută sarcină [#taak-zoeken] Caută o sarcină existentă după titlu. Pasul are două ieșiri: **Găsită** și **Negăsită**. Astfel poți actualiza o sarcină dacă există deja și, altfel, poți crea una nouă. | Câmp | Ce completezi | |---|---| | **Titlu** | Titlul pe care trebuie să îl aibă exact sarcina, de exemplu `Nalopen {occupation.terrain.name}`. Variabilele sunt completate mai întâi. Obligatoriu | | **Legată de înregistrările evenimentului** | Doar sarcinile legate de cel puțin una dintre aceleași înregistrări, cum ar fi parcela sau clientul. Implicit activat | | **Doar sarcini nefinalizate** | Omite sarcinile finalizate. Implicit activat | | **Omite subsarcinile** | Caută doar sarcini principale. Implicit activat | Dacă se potrivesc mai multe sarcini, pasul o alege pe cea mai nouă. Dacă **Legată de înregistrările evenimentului** este activat, dar evenimentul nu are client, parcelă, factură, rezervare sau contor, fluxul merge prin **Negăsită**. Prin **Găsită**, pașii următori pot folosi `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}` și `{foundTask.status}`. ## Setează prioritatea sarcinii [#taakprioriteit-zetten] Modifică prioritatea unei sarcini existente. | Câmp | Ce completezi | |---|---| | **Sarcină** | ID-ul sarcinii. Implicit `{foundTask.id}`. Obligatoriu | | **Modificare** | **Cu un nivel mai sus** (implicit), **Cu un nivel mai jos** sau **La o prioritate fixă** | | **Prioritate** | Doar la **La o prioritate fixă**: **Scăzută**, **Medie**, **Ridicată** sau **Urgentă** | | **Crește până la** | Doar la **Cu un nivel mai sus**: cea mai mare prioritate pe care o poate da pasul. Implicit **Ridicată**. O sarcină care se află deja la acest nivel sau mai sus rămâne neschimbată | Ordinea este **Scăzută**, **Medie**, **Ridicată**, **Urgentă**. Un nivel mai jos se oprește la **Scăzută**. Dacă nu se schimbă nimic, pasul reușește pur și simplu, fără a modifica sarcina. Acțiunea returnează `{updatedTask.id}` și `{updatedTask.priority}`. ## Actualizează sarcina [#taak-bijwerken] Modifică o sarcină existentă. Câmpurile pe care le lași goale rămân cum sunt. | Câmp | Ce completezi | |---|---| | **Sarcină** | ID-ul sarcinii. Implicit `{foundTask.id}`. Obligatoriu | | **Titlu nou** | Noul nume al sarcinii. Gol lasă titlul neschimbat | | **Responsabili** | Alege unul sau mai mulți colegi | | **Grupuri** | Alege unul sau mai multe [grupuri](/gebruikers/groepen) | | **Atribuie și persoanei care a cauzat evenimentul** | Adaugă și colegul care a cauzat evenimentul. Dacă evenimentul a fost cauzat de sistem, nu se adaugă nimeni | | **Responsabili** | **Adaugă la cei actuali** (implicit) sau **Înlocuiește-i pe cei actuali** | | **Adaugă etichete** | Alege una sau mai multe [etichete](/taken/labels). Se adaugă, iar etichetele existente rămân | | **Termen după** | Setează termenul la acest număr de minute, ore, zile sau săptămâni după executarea pasului. La 0 termenul rămâne cum este | Ține cont de următoarele: - Dacă alegi **Înlocuiește-i pe cei actuali** și nu indici pe nimeni, sarcina nu mai are apoi pe nimeni atribuit - Dacă sarcina nu mai există, pasul eșuează - Acțiunea returnează `{updatedTask.id}` # Acces și dispozitive (/ro-RO/automatiseringen/acties/toegang-en-toestellen) Aceste acțiuni privesc parcul în sine: cine are voie să intre, ce contoare au curent și ce fac tabletele. Vezi [Controlul accesului](/toegangscontrole) pentru context despre metodele de acces. Cum funcționează ieșirile citești la [Ieșirile unei acțiuni](/automatiseringen/acties#uitgangen-van-een-actie). ## Creează metodă de acces [#toegangsmiddel-aanmaken] Oferă unui client acces prin cod QR, număr de înmatriculare, cod PIN sau NFC. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului, de exemplu `{reservation.customerId}`. Obligatoriu | | **Tip** | **Cod QR** (implicit), **Număr de înmatriculare**, **Cod PIN** sau **NFC** | | **Valoare** | Numărul de înmatriculare sau numărul NFC. Lasă gol pentru un cod QR sau un cod PIN, pentru că Tillor le creează singur | | **Valabil de la** | O variabilă de dată, de exemplu `{reservation.checkIn}`. Gol înseamnă fără limită | | **Valabil până la** | O variabilă de dată, de exemplu `{reservation.checkOut}`. Gol înseamnă fără limită | La **Număr de înmatriculare** și **NFC**, **Valoare** este obligatorie. Acțiunea returnează `{createdAccessMethod.id}` și `{createdAccessMethod.value}`. Valoarea este codul QR sau codul PIN. Cu ID-ul poți trimite apoi codul prin **Trimite sau tipărește codul QR**. ## Actualizează accesul [#toegang-bijwerken] Blochează, deblochează sau prelungește o metodă de acces ori toate metodele de acces ale unui client. | Câmp | Ce completezi | |---|---| | **Care** | **O metodă de acces** (implicit) sau **Toate ale unui client** | | **Metodă de acces** | Doar la **O metodă de acces**: ID-ul, de exemplu `{createdAccessMethod.id}`. Obligatoriu | | **Client** | Doar la **Toate ale unui client**: ID-ul clientului, de exemplu `{occupation.customerId}`. Obligatoriu | | **Stare** | **Lasă neschimbat** (implicit), **Activ**, **Blocare ușoară**, **Blocat** sau **Inactiv** | | **Valabil până la** | O variabilă de dată. Gol păstrează data de sfârșit actuală | Ține cont de următoarele: - Dacă lași **Stare** pe **Lasă neschimbat** și **Valabil până la** gol, pasul nu face nimic - La **Toate ale unui client**, metodele de acces setate pe **Nu prelungi automat** își păstrează data de sfârșit, ca atunci când un client plătește o factură. Starea lor se schimbă totuși. La **O metodă de acces**, pasul modifică data de sfârșit chiar dacă acea metodă de acces este setată pe **Nu prelungi automat** ## Trimite sau tipărește codul QR [#qr-code-versturen-of-afdrukken] Trimite clientului un cod de acces QR, îl tipărește sau ambele. | Câmp | Ce completezi | |---|---| | **Metodă de acces** | ID-ul metodei de acces. Implicit `{createdAccessMethod.id}`. Obligatoriu | | **Trimite prin e-mail** | Implicit activat | | **Trimite prin SMS** | Implicit dezactivat | | **Trimite prin WhatsApp** | Implicit dezactivat | | **Imprimare** | **Nu tipări** (implicit), **Imprimantă de etichete** sau **Imprimantă de bonuri** | Dacă dezactivezi toate cele trei canale și alegi **Nu tipări**, pasul nu face nimic. ## Deschide sau închide bariera [#slagboom-openen-of-sluiten] Deschide sau închide o barieră sau o poartă. | Câmp | Ce completezi | |---|---| | **Punct de acces** | Alege unul dintre punctele tale de acces. Obligatoriu | | **Acțiune** | **Deschide** (implicit) sau **Închide** | ## Comută curentul [#stroom-schakelen] Pornește sau oprește curentul unui contor inteligent. De exemplu, pentru a opri curentul când se încheie o ocupare. | Câmp | Ce completezi | |---|---| | **Ce contoare** | **Toate contoarele comutabile ale unei parcele** (implicit) sau **Un contor** | | **Parcelă** | Doar la **Toate contoarele comutabile ale unei parcele**: ID-ul parcelei. Implicit `{occupation.terrainId}`. Obligatoriu | | **Contor** | Doar la **Un contor**: alege contorul. Obligatoriu | | **Curent** | **Activat** sau **Dezactivat**. Implicit **Dezactivat** | Ține cont de următoarele: - La **Toate contoarele comutabile ale unei parcele**, pasul comută doar contoarele care pot comuta. Dacă parcela nu are niciunul, nu se întâmplă nimic - Dacă comutarea unui contor nu reușește, pasul eșuează. La **Un contor** se întâmplă la fel și dacă contorul nu poate comuta. Contoarele care fuseseră deja comutate rămân comutate ## Actualizează etichetele NFC [#nfc-tags-bijwerken] Actualizează toate [etichetele NFC](/nfc/nfc-tags) ale unui client. | Câmp | Ce completezi | |---|---| | **Client** | ID-ul clientului, de exemplu `{occupation.customerId}`. Acțiunea se aplică fiecărei etichete NFC a acestui client. Obligatoriu | | **Acțiune** | **Blochează** (implicit), **Deblochează**, **Reîncarcă** sau **Trimite mesaj de sold scăzut** | | **Sumă** | Doar la **Reîncarcă**: suma în euro, per etichetă. Trebuie să fie mai mare decât 0. Obligatoriu | Dacă clientul are două etichete și completezi 20, fiecare etichetă primește 20 de euro în plus. Fără etichete, pasul nu face nimic. Dacă suma nu este un număr mai mare decât 0, pasul eșuează. ## Controlează tableta sau chioșcul [#tablet-of-kiosk-bedienen] Trimite o comandă către o [tabletă sau un chioșc](/mobiele-app/tablets-en-kiosken). | Câmp | Ce completezi | |---|---| | **Dispozitiv** | Alege dispozitivul. Obligatoriu | | **Comandă** | **Trezește** (implicit), **Adoarme**, **Reîncarcă**, **Identifică** sau **Redă sunet de test** | ## Setează prezentarea [#diavoorstelling-instellen] Setează prezentarea de fotografii pe fiecare tabletă și chioșc sau pe un singur dispozitiv. Restul setărilor dispozitivului rămân neschimbate. Dacă aceeași prezentare este deja setată, dispozitivul respectiv este omis. Un declanșator orar, apoi o [Cerere API](/automatiseringen/acties/integraties#api-verzoek) către un flux de activități și apoi acest pas: așa înlocuiești o sincronizare separată. Leagă pasul de ieșirea **Reușit** a cererii. | Câmp | Ce completezi | |---|---| | **Dispozitive** | **Fiecare tabletă și chioșc** (implicit) sau **Un singur dispozitiv** | | **Dispozitiv** | Doar la **Un singur dispozitiv**. Obligatoriu | | **Mod** | **Economizor** (implicit, după o perioadă fără atingere) sau **Fundal** | | **Secunde pe fotografie** | Cât timp rămâne afișată o fotografie. Implicit 10. De la 3 la 600 | | **Așteptare înainte de start** | Doar la **Economizor**: secunde fără atingere. Implicit 15 | | **Încadrare** | **Umple** sau **Încadrează** | | **Fotografii** | **Dintr-o cerere anterioară** (implicit) sau **Adrese** | | **Adrese de imagine** | Doar la **Adrese**: o adresă https pe rând. Obligatoriu | | **Listă** | Calea listei JSON, fără acolade. După o cerere API este `response.data`. Obligatoriu | | **Câmpul imaginii** | Numele câmpului cu adresa https, de exemplu `signage_image`. Obligatoriu | | **Câmpul id** | Face ca aceeași fotografie să păstreze același id, astfel încât o listă nemodificată să nu trimită un mesaj nou către dispozitiv | | **Câmpul stării** și **Stare** | Doar rândurile la care acel câmp are această valoare, de exemplu `CONFIRMED` | | **Sari dacă e completat** | Rândurile la care acest câmp are o valoare sunt eliminate, de exemplu `deleted_at` | | **Câmpul datei** și **Câmpul datei de sfârșit** | Un rând rămâne cât timp acel moment nu a trecut. Dacă data de sfârșit este goală, contează data | | **Câmp de sortare** | Sortează lista crescător, de exemplu după `date` | | **Număr maxim de fotografii** | Implicit 5, cel mult 20 | O adresă care nu începe cu `https://` nu este luată în calcul. Dacă lista nu este un array JSON, pasul eșuează și prezentarea actuală rămâne setată. # Prezentare generală (/ro-RO/automatiseringen) Cu automatizările, Tillor face ceva fără ca vreun coleg să trebuiască să se gândească la asta. Stabilești o regulă: *când se întâmplă asta, fă aceasta*. Câteva exemple: - Se încheie o ocupare la o rulotă fixă, iar Tillor creează o sarcină de verificare cu subtaskuri și o atribuie colegului care a oprit ocuparea - O factură a depășit scadența, iar Tillor trimite un memento de plată și, o săptămână mai târziu, creează o sarcină pentru a suna clientul dacă factura este încă deschisă - Intră o rezervare nouă, iar Tillor trimite datele către propriul tău sistem - În fiecare luni la 08:00, Tillor creează o sarcină pentru controlul săptămânal - Intră o rezervare nouă, iar Tillor creează un cod QR pentru oaspete și îl trimite prin e-mail O automatizare o construiești singur pe o pânză de desen, fără cod. Alegi un moment de start, adaugi pași și îi legi cu linii. ## În cuvinte simple [#in-gewone-woorden] O automatizare are trei tipuri de elemente. Detaliile tehnice trebuie să le cunoști abia când ai nevoie de ele. - **Momentul de start (declanșatorul)** este „când". Se întâmplă ceva în Tillor, cum ar fi încheierea unei ocupări, sau este o anumită oră ori o anumită dată. Vezi [Declanșatori](/automatiseringen/triggers) - **Logica** este „dacă". Aici fluxul se uită la date și alege un drum sau așteaptă să se întâmple ceva. Un exemplu: *factura nu este încă plătită după o săptămână?* Vezi [Condiții, comutatoare și întârzieri](/automatiseringen/logica) - **Acțiunile** sunt „atunci fă". Crearea unei sarcini, trimiterea unui mesaj, înregistrarea unei facturi. Vezi [Acțiuni](/automatiseringen/acties) În plus, **variabilele** sunt datele momentului însuși, cum ar fi numele parcelei sau al clientului. Le pui între acolade într-un text, iar Tillor completează valoarea reală. Vezi [Variabile și șabloane](/automatiseringen/variabelen). ## Cine o poate folosi [#wie-kan-het-gebruiken] Automatizările lucrează cu drepturi depline în organizația ta. Vizualizarea cere permisiunea **Vizualizare automatizări**, iar construirea și modificarea **Gestionare automatizări**. Administratorii cu **Toate permisiunile** le au pe amândouă. Vezi [Cine poate folosi automatizările?](/automatiseringen/veelgestelde-vragen#wie-kan-automatiseringen-gebruiken). Găsești pagina în meniul lateral, la Admin > Automatizări. ## Cum se leagă toate [#hoe-hangt-dit-samen] Fiecare automatizare este alcătuită din pași pe care îi legi într-un flux. O automatizare colaborează cu sarcinile: creează sarcini, așteaptă un coleg care alege un buton sau pornește de îndată ce se schimbă o sarcină. Vezi [Sarcini](/taken#hoe-hangt-dit-samen). De fiecare dată când o automatizare pornește, numim asta o rulare. O rulare începe la momentul de start și urmează liniile în jos. | Element | Ce face | |---|---| | **Când se întâmplă asta** (declanșator) | Momentul de start. Un eveniment din Tillor, un webhook, o acțiune aleasă a unei sarcini, o factură cu scadența depășită, o dată cum este sosirea unui oaspete, o oră fixă sau un program propriu. Un flux poate avea mai mulți declanșatori. Fiecare declanșator pornește o rulare proprie | | **Doar când** | Un filtru pe declanșator. Automatizarea pornește doar dacă datele se potrivesc, de exemplu doar pentru rulote fixe | | **Dacă / altfel** | Împarte fluxul în **Da** și **Nu** pe baza uneia sau mai multor condiții | | **Ramificare** | Împarte fluxul în mai multe ramuri, în funcție de valoarea unui câmp | | **Întârziere** și alți pași de așteptare | Fac fluxul să aștepte, o perioadă, o dată, programul de lucru, o condiție, un eveniment sau o decizie a unui coleg | | **Deschis acum?**, **Caută o înregistrare**, **Pentru fiecare** | Verifică dacă ești deschis, preiau o înregistrare sau execută pașii următori pentru fiecare element dintr-o listă | | **Acțiuni** | Fac cu adevărat ceva: sarcini, mesaje către oaspeți și colegi, facturi, plăți și mandate, acces, contoare și dispozitive, webhook-uri și cereri API | Pașii cu mai multe ieșiri, cum ar fi **Da** și **Nu**, **Gata** și **Omis** sau **Reușit** și **Eșuat**, îți permit să alegi o continuare diferită pentru fiecare rezultat. La fiecare acțiune poți activa și o ieșire **Eroare**, astfel încât fluxul să continue dacă pasul eșuează. ```mermaid flowchart TD A["Când se întâmplă asta
Factura a depășit scadența"] --> B["Trimite memento de plată"] B --> C["Întârziere
7 zile"] C --> D{"Dacă / altfel
încă neplătită?"} D -- Da --> E["Creează sarcină
sună clientul"] D -- Nu --> F["Sfârșit"] ``` ## Variabile [#variabelen] Câmpurile de text dintr-un pas acceptă variabile între acolade, cum ar fi `{occupation.terrain.name}`. Tillor completează acolo numele parcelei care aparține evenimentului. Așa creezi mesaje și sarcini care diferă de la caz la caz. Citește mai multe la [Variabile și șabloane](/automatiseringen/variabelen). ## Pornire rapidă [#snel-aan-de-slag] 1. Mergi la **Admin > Automatizări** și fă clic pe **Automatizare nouă** 2. Alege un șablon sau **Pornește de la zero** 3. Setează declanșatorul și pașii și fă clic pe **Salvare** 4. Încearcă fluxul în fila **Rulare de test**. Atunci nu se trimite și nu se creează nimic în realitate 5. Activează **Activ** când ești mulțumit Noua automatizare este în pauză până o activezi tu. O explicație pas cu pas se află la [Primii pași](/automatiseringen/aan-de-slag). - O automatizare nouă este în pauză până o activezi tu - O automatizare are cel mult 100 de pași. Comentariile și cadrele de pe pânză se numără separat, cel mult 50 - O **Ramificare** are cel mult 8 ramuri, iar **Cere o decizie** cel mult 8 opțiuni - Programele și datele sunt verificate în fiecare minut. Un eveniment pornește imediat - Modificările pot dura o jumătate de minut până se aplică peste tot - O rulare eșuată este trimisă prin e-mail celui care a creat automatizarea, cel mult o dată pe oră - În fila **Rulări** se află ultimele 20 de rulări - Un flux nu se poate porni pe sine sau pe alt flux prin ceea ce creează el însuși O automatizare activată trimite memento-uri reale și creează sarcini reale. Folosește fila **Rulare de test** și verifică primele rulări în fila **Rulări** înainte de a fi sigur că totul este în ordine. ## Componente [#onderdelen] ## Termeni [#begrippen] - **Automatizare**: o regulă de tipul „când se întâmplă asta, fă aceasta", construită ca flux - **Flux**: pânza unei singure automatizări, cu pași și linii - **Declanșator**: momentul de start al unui flux - **Rulare**: o singură dată în care o automatizare pornește și parcurge fluxul - **Acțiune**: un pas care face cu adevărat ceva, cum ar fi crearea unei sarcini - **Variabilă**: o dată a momentului, între acolade într-un text - **Rulare de test**: o probă în care nu se trimite și nu se creează nimic în realitate - **Flux de lucru**: utilizatorul pe numele căruia lucrează o automatizare Mai mulți termeni găsești în [lista de termeni](/begrippen). # Condiții, ramificări și întârzieri (/ro-RO/automatiseringen/logica) Cu pașii din grupul **Logică** stabilești încotro merge un flux și când: „dacă” și „așteaptă puțin”. Un exemplu: *dacă factura este încă deschisă după o săptămână, creează o sarcină*. Ei conduc acțiunile de după ei. Doar [Cere o decizie](#vraag-om-een-beslissing) creează ceva, o sarcină. | Pas | Ce face | Ieșiri | |---|---|---| | [Dacă / altfel](#als--anders) | Împarte după condiții | **Da**, **Nu** | | [Ramificare](#schakel) | Alege o ramură după valoarea unui câmp | Una per ramură și **Implicit** | | [Întârziere](#vertraging) | Așteaptă un timp fix sau până la o dată | **Următorul** | | [Deschis acum?](#nu-open) | Verifică dacă ești deschis acum | **Deschis**, **Închis** | | [Așteaptă până la deschidere](#wachten-tot-open) | Așteaptă până la următoarea oră de deschidere | **Următorul** | | [Așteaptă până la închidere](#wachten-tot-gesloten) | Așteaptă până la următoarea oră de închidere | **Următorul** | | [Cel mult o dată pe perioadă](#hoogstens-één-keer-per-periode) | Oprește repetările | **Continuă**, **Deja rulat** | | [Caută o înregistrare](#record-opzoeken) | Preia o înregistrare după ID | **Găsită**, **Negăsită** | | [Pentru fiecare](#voor-elk) | Execută pașii de după el pentru fiecare element dintr-o listă | **Pentru fiecare**, **Gata** | | [Așteaptă până când](#wachten-tot) | Așteaptă până când condițiile sunt îndeplinite | **Îndeplinită**, **Expirat** | | [Așteaptă un eveniment](#wachten-op-een-gebeurtenis) | Așteaptă până se întâmplă ceva în Tillor | **Primit**, **Expirat**, uneori **Șters** | | [Cere o decizie](#vraag-om-een-beslissing) | Lasă un coleg să aleagă între opțiunile tale | Una per opțiune și **Expirat** | ## Dacă / altfel [#als--anders] Împarte fluxul în două căi pe baza datelor. Este același principiu ca filtrul de la **Doar când** al declanșatorului, dar acum în mijlocul fluxului. Pasul are două ieșiri: **Da** (condițiile sunt îndeplinite) și **Nu** (nu sunt îndeplinite). 1. Adaugă un pas **Dacă / altfel** 2. La **Condiții**, dă clic pe **Adaugă condiție** 3. Alege câmpul cu butonul **Variabilă** sau scrie tu însuți calea, de exemplu `invoice.paymentStatus` 4. Alege comparația (**este**, **nu este**, **conține**, **este mai mare decât**, **este mai mic decât**, **este unul dintre**, **este gol** sau **nu este gol**) și completează valoarea 5. Conectează ieșirea **Da** și, dacă vrei, **Nu** la un pas următor Un pas **Dacă / altfel** are nevoie de cel puțin o condiție. Altfel, Tillor afișează **Adaugă o condiție.** Când ai mai multe condiții, alegi între **Toate trebuie să se potrivească** și **Este suficientă una**. Comparațiile funcționează așa cum este descris la [Doar când](/automatiseringen/triggers#alleen-wanneer). Nu trebuie să conectezi ambele ieșiri. Dacă o ieșire nu duce nicăieri, rularea se termină acolo. Un flux care face ceva doar la **Da** este deci perfect în regulă. Poți folosi și câmpuri din pașii anteriori. După o [Cerere API](/automatiseringen/acties/integraties#api-verzoek) poți, de exemplu, să te uiți la `response.status` sau la `response.data.paymentStatus`. ## Ramificare [#schakel] Alege **Ramificare** când ai nevoie de mai mult de două căi. Pasul se uită la valoarea unui singur câmp și alege ramura potrivită. 1. La **Câmp**, alege câmpul la care vrei să te uiți, de exemplu `occupation.occupationType` 2. La **Ramuri**, dă clic pe **Adaugă ramură**. Completează **Ramură** (numele care apare pe ieșire) și **Egal cu** (valoarea pe care trebuie să o aibă câmpul) 3. Repetă pentru fiecare ramură 4. Conectează fiecare ieșire la un pas următor Fiecare ramură primește o ieșire proprie sub pas. În plus, există mereu o ieșire **Implicit**. Aceasta se folosește când nicio ramură nu se potrivește. - Câmpul trebuie să corespundă exact cu valoarea, inclusiv majusculele - Dacă se potrivește mai mult de o ramură, câștigă prima din listă - O ramură fără valoare la **Egal cu** nu contează - Poți seta cel mult 8 ramuri, plus **Implicit** - Dacă câmpul este gol sau nu există, fluxul merge pe **Implicit** Valorile câmpurilor de alegere sunt în notația Tillor. O ocupare de tip rulotă de închiriat are, de exemplu, valoarea `RENTAL_CARAVAN`, iar o factură plătită `PAID`. Lista de la **Câmp** arată câmpurile evenimentului și ale pașilor anteriori. Câmpurile din răspunsul unei cereri API apar în listă abia când Tillor cunoaște un exemplu al acelui răspuns. Vezi [Folosirea unui răspuns API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). ## Întârziere [#vertraging] Cu **Întârziere** faci fluxul să aștepte înainte să continue. Folosești asta pentru lucruri ca *mai verifică o dată peste o săptămână*. La **Așteaptă** alegi una dintre două variante. ### Un timp fix [#een-vaste-tijd] Alege **Pentru un timp fix** și completează la **Durată** un număr și o unitate: **secunde**, **minute**, **ore**, **zile** sau **săptămâni**. Secundele nu sunt exacte. Fluxul poate continua cu câteva secunde mai târziu. O întârziere de 0 nu face nimic, de aceea Tillor afișează **O întârziere de 0 nu face nimic.** ### Până la o dată [#tot-een-datum] Alege **Până la o dată** când timpul de așteptare depinde de o dată din date, precum data scadenței unei facturi sau data de sfârșit a unei rezervări. | Câmp | Ce completezi | |---|---| | **Dată** | Un câmp cu o dată, de exemplu `invoice.dueDate`. Lista arată doar câmpurile care sunt o dată | | **Față de acea dată** | **Înainte** sau **După** | | **Decalaj** | Cât timp înainte sau după acea dată, în minute, ore, zile sau săptămâni. La 0 fluxul continuă exact la acea dată | Exemple: - **Dată** `invoice.dueDate`, **După**, **Decalaj** 1 zi: fluxul continuă o zi după data scadenței - **Dată** `reservation.checkIn`, **Înainte**, **Decalaj** 2 zile: fluxul continuă cu două zile înainte de sosire Dacă acel moment este deja în trecut sau data este goală, fluxul continuă imediat. ### Ce se întâmplă în timpul așteptării [#wat-er-tijdens-het-wachten-gebeurt] - Rularea primește starea **În așteptare**. În fila **Rulări** scrie când continuă (**Continuă …**). Timpii lungi de așteptare, precum săptămânile, nu sunt o problemă - După întârziere, Tillor citește din nou datele, astfel încât pașii de după să vadă situația actuală. Vezi mai jos - Dacă pui automatizarea pe pauză în timpul așteptării, rularea se oprește imediat ce trece timpul de așteptare. Nu mai continuă și primește starea **Anulată**. Dacă activezi automatizarea înainte să treacă timpul de așteptare, rularea continuă normal - Dacă ștergi automatizarea, rulările în așteptare se opresc - Dacă modifici fluxul în timp ce o rulare așteaptă, acea rulare se termină cu fluxul așa cum era când a pornit ### Datele sunt citite din nou [#gegevens-worden-opnieuw-gelezen] O rulare își amintește datele din momentul evenimentului, dar citește din nou înregistrările aferente înainte să continue. Acestea sunt înregistrarea evenimentului (de exemplu factura) și înregistrările la care aceasta face referire (de exemplu clientul). Un exemplu: o automatizare trimite un memento pentru o factură, așteaptă 7 zile și apoi verifică cu **Dacă / altfel** dacă `invoice.paymentStatus` nu este `PAID`. Dacă factura a fost plătită în acea săptămână, condiția vede factura plătită și fluxul merge pe **Nu**. Există două excepții: - Dacă înregistrarea nu mai există, de exemplu pentru că o ocupare a fost ștearsă, rularea păstrează copia din momentul evenimentului - Datele pe care le-a produs un pas anterior, precum răspunsul unei cereri API, nu sunt preluate din nou. Dacă vrei astfel de date reîmprospătate după o întârziere, fă o nouă cerere API O [rulare de test](/automatiseringen/testen-en-uitvoeringen) sare peste întârzieri și lucrează cu datele de exemplu pe care le completezi tu. Ce se întâmplă după o întârziere reală vezi abia într-o rulare reală. ## Deschis acum? [#nu-open] Verifică dacă organizația ta este deschisă în acest moment și împarte fluxul în **Deschis** și **Închis**. Nu ai nimic de setat. Tillor folosește orele de la **Setări > Program de funcționare**, cu perioade de sezon, sărbători și excepții. Vezi [Setările organizației](/gebruikers/organisaties#openingsuren). Folosește-l, de exemplu, ca să trimiți un alt text în afara programului sau să creezi o sarcină. Dacă preferi să aștepți până când ești din nou deschis, folosește [Așteaptă până la deschidere](#wachten-tot-open). Dacă vrei să aștepți până închizi, folosește [Așteaptă până la închidere](#wachten-tot-gesloten). ## Așteaptă până la deschidere [#wachten-tot-open] Pune fluxul pe pauză până la următoarea oră de deschidere și apoi continuă. Organizația ta este deja deschisă? Atunci fluxul continuă imediat. Nu ai nimic de setat. - Ora de deschidere vine din **Setări > Program de funcționare**, în fusul orar al organizației tale - Dacă luna următoare nu există nicio oră de deschidere, fluxul continuă imediat în loc să rămână în așteptare - În timpul așteptării, rularea primește starea **În așteptare**. Ce se întâmplă atunci găsești la [Întârziere](#wat-er-tijdens-het-wachten-gebeurt) ## Așteaptă până la închidere [#wachten-tot-gesloten] Pune fluxul pe pauză până la următoarea oră de închidere și apoi continuă. Organizația ta este deja închisă? Atunci fluxul continuă imediat. Nu ai nimic de setat. - Ora de închidere vine din **Setări > Program de funcționare**, în fusul orar al organizației tale - Blocurile care se leagă între ele, precum 9:00–12:00 și 12:00–17:00, contează ca o singură bucată. Fluxul așteaptă până la sfârșitul acelei bucăți - În timpul așteptării, rularea primește starea **În așteptare**. Ce se întâmplă atunci găsești la [Întârziere](#wat-er-tijdens-het-wachten-gebeurt) ## Cel mult o dată pe perioadă [#hoogstens-één-keer-per-periode] Lasă fluxul să treacă doar dacă nu a trecut deja prin acest pas pentru aceeași înregistrare în cadrul perioadei. Așa nu trimiți unui client același memento în fiecare zi. | Câmp | Ce completezi | |---|---| | **Perioadă** | Cât timp contează rulările anterioare, în minute, ore, zile sau săptămâni. Implicit 1 zi | | **Numără per** | După ce numeri. Gol înseamnă per înregistrare cu care a pornit fluxul, precum factura sau rezervarea. Completează o variabilă, de exemplu `{customer.id}`, ca să numeri per client sau per parcelă | Pasul are două ieșiri: **Continuă** dacă fluxul nu a trecut pe acolo în perioadă și **Deja rulat** dacă a trecut. Conectează **Deja rulat** la un alt pas sau lasă-l gol, astfel încât rularea să se termine acolo. Ține cont de următoarele: - Contează doar rulările aceleiași automatizări și doar dacă au trecut prin acest pas pe **Continuă** - Dacă nu conectezi **Șters** la nimic, Tillor oprește fluxurile în așteptare ale acelei înregistrări și șterge sarcinile pe care le-a creat fluxul și pe care doar fluxul le putea finaliza. Dacă conectezi ieșirea, fluxul continuă acolo - Dacă fluxul pornește fără înregistrare, de exemplu la **În fiecare zi la o oră**, completează tu o variabilă la **Numără per**. Fără această valoare fiecare rulare este nouă și pasul nu oprește nimic - Rularea care este în curs nu se numără pe ea însăși Un exemplu: **Perioadă** 7 zile și **Numără per** `{invoice.customerId}` lasă să treacă cel mult un memento pe săptămână per client, chiar dacă acel client are mai multe facturi scadente. ## Caută o înregistrare [#record-opzoeken] Încarcă o înregistrare pe baza ID-ului ei, astfel încât pașii de după să îi poată folosi câmpurile. Este util când evenimentul oferă doar un ID, precum mesajul dintr-o conversație din inbox. | Câmp | Ce completezi | |---|---| | **Tip de înregistrare** | **Client**, **Rezervare**, **Ocupare**, **Factură**, **Plată**, **Parcelă**, **Sarcină**, **Document**, **Metodă de acces**, **Etichetă NFC**, **Contor**, **Conversație din inbox** sau **Mesaj din inbox**. Implicit **Mesaj din inbox** | | **ID** | ID-ul înregistrării, de exemplu `{messageId}`. Obligatoriu | Pasul are două ieșiri: **Găsită** și **Negăsită**. Dacă înregistrarea nu există sau ID-ul este gol, fluxul merge pe **Negăsită**. După **Găsită**, câmpurile înregistrării se află în variabile care încep cu `found` urmat de tip: `{foundCustomer.firstName}`, `{foundInvoice.displayId}`, `{foundReservation.checkIn}`, `{foundTerrain.name}`, `{foundInboxMessage.direction}`. Celelalte tipuri se numesc `foundOccupation`, `foundPayment`, `foundTask`, `foundAccessMethod`, `foundNfcTag`, `foundMeter` și `foundInboxThread`. Sunt incluse și înregistrările la care face referire, cu un nivel în adâncime, precum `{foundReservation.customer.firstName}`. Totul se află în lista din spatele butonului **Variabilă**. O a doua căutare de același tip o înlocuiește pe prima. Atenție la **Sarcină**: folosește același nume `foundTask` ca [Caută o sarcină](/automatiseringen/acties/taken#taak-zoeken), iar ultima dintre cele două câștigă. Același lucru este valabil pentru **Document** și `foundDocument` de la [Caută un document](/automatiseringen/acties/documenten#document-zoeken). ## Mapează variabile [#variabelen-mappen] Copiază valori în nume noi de variabile, astfel încât pașii următori să poată folosi o singură formă - util când un flux pornește prin **Webhook de intrare** (`{body.…}`) și prin **Factură restantă** (`{invoice.…}`). | Câmp | Ce completezi | |---|---| | **Mapări** | Rânduri cu **Variabilă țintă** (de ex. `invoice`) și **Sursă** (de ex. `{foundInvoice}` sau `{body.invoiceId}`) | Pasul are o singură ieșire: **Următorul**. Dacă sursa este exact o variabilă între acolade, de exemplu `{foundInvoice}`, Tillor copiază întreaga înregistrare (obiect). Altfel, Tillor completează sursa ca text, precum `Factură {foundInvoice.displayId}` în `meta.label`. Test obișnuit cu webhook: **Webhook de intrare** → **Caută o înregistrare** (Factură, ID `{body.invoiceId}`) → **Mapează variabile** (`invoice` ← `{foundInvoice}`) → aceleași condiții și aprobare ca la declanșatorul de tip program. ## Rulează cod [#code-uitvoeren] Execută o bucată de TypeScript pe variabilele fluxului și păstrează ce returnează ca variabilă nouă. Pentru logică pe care nu o poți exprima în câmpuri și condiții: ce subsarcini trebuie să apară, calculul unei sume sau al unei date, remodelarea corpului unui webhook. | Câmp | Ce completezi | |---|---| | **Cod** | TypeScript. Variabilele le scrii ca în texte, cu acolade: `{customer.firstName}` este citită ca valoare, nu completată ca text. Încheie cu `return`. Obligatoriu | | **Variabilă de ieșire** | Numele sub care pașii următori citesc rezultatul, precum `result` (atunci `{result}`) sau `result.names`. Implicit `result` | Pasul are o singură ieșire: **Următorul**. Iată cum funcționează: - Codul vede doar variabilele pe care le menționează. O variabilă pe care fluxul nu o are este `null`; o dată vine ca text (`2026-07-01T10:00:00.000Z`) - Formatările și decalajele de dată (`{bedrag|currency}`, `{datum + 1 day}`) nu funcționează aici: calculează-le în cod - Returnează o listă, un text, un număr sau un obiect. Un obiect îl citești apoi câmp cu câmp: `{result.total}` - Codul nu poate prelua sau trimite nimic: fără internet, fără bază de date. Doar calculează. Un calcul prea lung (mai mult de 50 ms) se întrerupe - Dacă codul aruncă o eroare, rularea se oprește cu acea eroare și numărul rândului. O vezi în fila **Rulări** - În dreapta codului vezi imediat ce returnează pe exemplu; la testare rulează și el Un exemplu: după plecare vrei subsarcini care depind de parcelă. Pune un pas **Rulează cod** cu: ```ts const tasks = ["Plaats vegen", "Sanitair"]; if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren"); return tasks; ``` Apoi, la **Creează sarcină**, completează câmpul **Subtaskuri** doar cu `{result}`: fiecare text din listă devine o subsarcină. ## Pentru fiecare [#voor-elk] Execută pașii de după **Pentru fiecare** o dată pentru fiecare element dintr-o listă, de exemplu pentru fiecare factură deschisă a unui client. Fluxul în sine continuă pe **Gata**. | Câmp | Ce completezi | |---|---| | **Listă** | **Metodele de acces ale unui client**, **Etichetele NFC ale unui client**, **Facturile deschise ale unui client**, **Rezervările confirmate ale unui client**, **Ocupările unui client**, **Documentele unui client** (doar cele active) sau **Contoarele unei parcele**. Implicit **Metodele de acces ale unui client** | | **Al** | Clientul sau parcela a cărei listă o vrei, de exemplu `{customer.id}` sau `{occupation.terrainId}`. Obligatoriu | Pasul are două ieșiri cu sens propriu: - **Pentru fiecare** duce la pașii pe care vrei să îi faci per element - **Gata** este calea prin care continuă fluxul însuși Iată cum funcționează: - Fiecare element primește o rulare proprie, care parcurge pașii de după **Pentru fiecare** până la capătul acelei ramuri. Le vezi în fila **Rulări**, care le arată doar pe ultimele 20 - Elementul se află în variabila `item`, de exemplu `{item.id}`. Variabilele evenimentului și ale pașilor anteriori rămân disponibile - Fluxul nu așteaptă ca elementele să se termine. Imediat după ce acestea au pornit, continuă pe **Gata**. Rezultatul unui element nu îl poți deci folosi în pașii de după **Gata** - Se procesează cel mult 100 de elemente, cele mai vechi primele. Dacă în listă sunt mai multe, restul nu se procesează - Dacă lista este goală sau câmpul **Al** este gol, nu pornește nimic și fluxul continuă imediat pe **Gata** - **Facturile deschise ale unui client** sunt facturi înregistrate din care mai este ceva de plătit. **Rezervările confirmate ale unui client** sunt rezervări cu starea **Rezervată** Un exemplu: o factură devine scadentă și vrei să creezi un link de plată pentru fiecare factură deschisă a acelui client. Alege **Facturile deschise ale unui client**, completează `{invoice.customerId}` la **Al** și pune după **Pentru fiecare** un pas **Creează link de plată** cu `{item.id}` ca factură. ## Așteaptă până când [#wachten-tot] Verifică condițiile din nou și din nou până sunt îndeplinite sau se oprește după un timp. Folosește-l când nu știi când se întâmplă ceva, dar știi ce aștepți, de exemplu până când o factură este plătită. | Câmp | Ce completezi | |---|---| | **Până când** | Una sau mai multe condiții, în același mod ca la [Dacă / altfel](#als--anders) | | **Verifică la fiecare** | Cât de des se uită Tillor din nou, în minute, ore, zile sau săptămâni. Cel puțin 5 minute. Implicit 1 oră | | **Nu mai aștepta după** | Cât așteaptă pasul cel mult. Implicit 7 zile | Pasul are două ieșiri: **Îndeplinită** (condițiile sunt îndeplinite) și **Expirat** (timpul de așteptare a trecut fără ca ele să fie îndeplinite). Ține cont de următoarele: - Prima verificare are loc imediat. Dacă condițiile sunt deja îndeplinite, fluxul continuă direct pe **Îndeplinită**. Dacă nu ai completat nicio condiție, este îndeplinită întotdeauna - La fiecare verificare, Tillor citește din nou înregistrările evenimentului, ca la o [întârziere](#gegevens-worden-opnieuw-gelezen). O condiție precum `invoice.paymentStatus` este `PAID` vede deci plata imediat ce există - Un interval sub 5 minute devine 5 minute - În timpul așteptării, rularea primește starea **În așteptare**. Pentru pauză și modificarea fluxului este valabil același lucru ca la [Întârziere](#wat-er-tijdens-het-wachten-gebeurt) ## Așteaptă un eveniment [#wachten-op-een-gebeurtenis] Pune fluxul pe pauză până se întâmplă ceva în Tillor, de exemplu până când factura este plătită. | Câmp | Ce completezi | |---|---| | **Eveniment** | Ce aștepți. Aceeași listă ca la [declanșator](/automatiseringen/triggers#als-er-iets-gebeurt). Obligatoriu | | **Doar pentru aceeași înregistrare** | Continuă doar dacă evenimentul privește înregistrarea care a pornit fluxul. Implicit activat | | **Nu mai aștepta după** | Cât așteaptă pasul cel mult. Implicit 7 zile | Pasul are două ieșiri: **Primit** (evenimentul a venit) și **Expirat** (timpul de așteptare a trecut fără eveniment). Dacă **Doar pentru aceeași înregistrare** este activat, apare o a treia ieșire, **Șters**. O folosești când înregistrarea fluxului a fost ștearsă în timp ce fluxul aștepta. Ține cont de următoarele: - Cu **Doar pentru aceeași înregistrare** activat, contează, de exemplu, doar plata facturii cu care a pornit fluxul. Dacă îl dezactivezi, orice eveniment de acel tip lasă fluxul să continue - Dacă nu conectezi **Șters** la nimic, Tillor oprește fluxurile în așteptare ale acelei înregistrări și șterge sarcinile pe care le-a creat fluxul și pe care doar fluxul le putea finaliza. Dacă conectezi ieșirea, fluxul continuă acolo - Dacă fluxul pornește fără înregistrare, de exemplu la **În fiecare zi la o oră**, contează orice eveniment de acel tip - Un eveniment pe care îl provoacă chiar un pas al unei automatizări contează și el. Fluxurile în așteptare continuă deci și pe baza muncii făcute de **Flux de lucru** - După **Primit**, datele evenimentului pe care l-ai așteptat se află în variabile, fără colegul care l-a provocat. Dacă aștepți `invoice:paid`, `{invoice.paymentStatus}` dă apoi noua stare - În timpul așteptării, rularea primește starea **În așteptare**. Pentru pauză și modificarea fluxului este valabil același lucru ca la [Întârziere](#wat-er-tijdens-het-wachten-gebeurt) ## Cere o decizie [#vraag-om-een-beslissing] Creează o sarcină cu butoane pe care le stabilești tu și așteaptă până când cineva alege un buton. Așa introduci un moment în care un om se uită peste, de exemplu înainte ca fluxul să blocheze un client sau să înregistreze o factură. Fiecare opțiune este un buton pe sarcină și o ieșire a pasului. | Câmp | Ce completezi | |---|---| | **Titlul sarcinii** | Titlul sarcinii. Obligatoriu | | **Descriere** | Spune-i colegului ce trebuie decis | | **Opțiuni** | Butoanele de pe sarcină. Vezi mai jos. Cel puțin una | | **Atribuie către** | Alege unul sau mai mulți colegi | | **Atribuie grupurilor** | Alege unul sau mai multe grupuri | | **Leagă de** | Înregistrările la care apare sarcina, precum clientul sau factura. Completat în prealabil cu înregistrările cunoscute la acest pas | | **Nu mai aștepta după** | Cât așteaptă pasul cel mult. Implicit 3 zile | ### Setarea opțiunilor [#opties-instellen] 1. La **Opțiuni**, dă clic pe **Adaugă opțiune** și completează numele, de exemplu **Aprobă**. Acest nume apare pe buton și pe ieșire 2. Dă clic pe căsuța colorată din stânga numelui (**Pictogramă și culoare**) ca să alegi o culoare și o pictogramă. O pictogramă nu este obligatorie 3. Activează **Cere o notă** dacă la această alegere colegul trebuie să completeze un motiv 4. Activează **Cere confirmare** dacă colegul trebuie mai întâi să confirme. Completezi atunci un **Titlu confirmare** și un **Mesaj de confirmare** și alegi la **Severitate** dintre **Info**, **Avertisment** sau **Destructiv**. În aceste texte poți folosi variabile 5. Repetă pentru fiecare opțiune. Poți crea cel mult 8 opțiuni Dacă lista este încă goală, butonul **Aprobă / Respinge** pregătește imediat două opțiuni: un **Aprobă** verde și un **Respinge** roșu. Fiecare opțiune are nevoie de un nume, altfel Tillor afișează **Fiecare opțiune are nevoie de un nume.** Fără opțiuni, Tillor afișează **Adaugă cel puțin o opțiune.** ### Ieșiri [#uitgangen] Pasul are câte o ieșire per opțiune, cu numele și culoarea acelei opțiuni, plus mereu **Expirat**. | Ieșire | Când | |---|---| | Numele unei opțiuni | Cineva a ales acel buton pe sarcină | | **Expirat** | Timpul de așteptare a trecut fără alegere sau sarcina a fost ștearsă | Ține cont de următoarele: - Butoanele apar pe cardul sarcinii, în lista de sarcini și în sarcina însăși. O astfel de sarcină nu are bifă: nu o poți finaliza pur și simplu, ci doar alege un buton. După alegere, sarcina are starea **Finalizată** și se arată ce opțiune a fost aleasă. Vezi [Sarcini cu butoane de alegere](/taken/taakdetails#taken-met-keuzeknoppen) - Poate alege cel căruia i-a fost atribuită sarcina, inclusiv printr-un grup, precum și administratorii. Dacă nu atribui pe nimeni, poate alege oricine vede sarcina - Sarcina primește prioritatea **Ridicată**. Apare pe numele **Flux de lucru** - Dacă sarcina este ștearsă înainte să aleagă cineva, fluxul continuă pe **Expirat**. După **Expirat** din cauza timpului de așteptare, sarcina rămâne - Pașii următori pot folosi `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}` și `{approval.decidedBy.name}`. `{approval.label}` este numele opțiunii alese, iar `{approval.note}` nota pe care a completat-o colegul - În timpul așteptării, rularea primește starea **În așteptare**. Pentru pauză și modificarea fluxului este valabil același lucru ca la [Întârziere](#wat-er-tijdens-het-wachten-gebeurt) O [rulare de test](/automatiseringen/testen-en-uitvoeringen) nu poate ști dacă ești deschis, ce decide un coleg și dacă o înregistrare există. La **Ce se întâmplă la acești pași?** alegi deci tu ieșirea pentru **Deschis acum?**, **Cel mult o dată pe perioadă**, **Caută o înregistrare**, **Pentru fiecare**, **Așteaptă până când**, **Așteaptă un eveniment** și **Cere o decizie**. La **Pentru fiecare**, testul merge pe ieșirea pe care o alegi, **Pentru fiecare** sau **Gata**, nu pe amândouă. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - O ieșire pe care nu o conectezi face ca rularea să se termine acolo. - La un pas de așteptare, rularea primește starea În așteptare și continuă mai târziu. O automatizare pusă pe pauză oprește rulările în așteptare imediat ce trece timpul de așteptare. - După un timp de așteptare, Tillor citește din nou datele, astfel încât pașii să vadă situația actuală. ## Probleme? [#problemen] Un pas **Dacă / altfel** are nevoie de cel puțin o condiție. Dă clic pe **Adaugă condiție**. Completează la **Durată** un număr mai mare decât 0. O **Ramificare** compară valoarea exact, inclusiv majusculele. Valorile de alegere sunt în notația Tillor, precum `RENTAL_CARAVAN`. Dacă câmpul este gol, fluxul merge tot pe **Implicit**. Un pas **Cere o decizie** are nevoie de cel puțin o opțiune cu un nume. La **Opțiuni**, dă clic pe **Adaugă opțiune**. Fluxul așteaptă un timp, o condiție, un eveniment sau o decizie. În fila **Rulări** scrie când continuă sau expiră. La **Așteaptă până când** asta se întâmplă implicit după 7 zile, la **Cere o decizie** după 3 zile. Dacă sarcina este ștearsă înainte să aleagă cineva, fluxul continuă pe **Expirat**. Vezi [Sarcini cu butoane de alegere](/taken/taakdetails#taken-met-keuzeknoppen). # Probleme și activare (/ro-RO/automatiseringen/problemen) Tillor îți verifică fluxul în permanență în timp ce îl construiești. Cât timp există probleme deschise, nu poți activa automatizarea. Așa se evită ca un flux care nu poate funcționa să încerce să trimită mementouri sau sarcini reale. ## Unde vezi problemele [#waar-zie-je-de-problemen] - Pe fiecare pas cu o problemă apare un mic număr de avertizare - În panoul din dreapta, problemele pasului selectat sunt într-un bloc portocaliu deasupra setărilor - Sus în panou se află un buton cu totalul, de exemplu **3 probleme**. Dă clic pe el pentru listă și dă clic pe un mesaj ca să sari la pas - În lista automatizărilor, lângă nume apare o etichetă precum **3 probleme**, precum și un filtru **Probleme** ## De ce nu pot activa [#waarom-kan-ik-niet-inschakelen] Comutatorul **Activ** nu funcționează cât timp există probleme, cu textul **Rezolvă mai întâi problemele deschise**. În listă nu poți porni nici comutatorul automatizării. Dacă automatizarea este deja pornită, nu poți salva modificări care au probleme. Un flux care rulează trebuie să rămână valid. Rezolvă problemele sau pune mai întâi automatizarea pe pauză. ## Ce înseamnă mesajele [#wat-de-meldingen-betekenen] | Mesaj | Ce se întâmplă | Ce faci | |---|---|---| | **Adaugă un declanșator pentru a începe.** | Fluxul nu are declanșator | Un flux are mereu nevoie de cel puțin un declanșator. Trage **Când se întâmplă asta** din lista din stânga pe canvas | | **Acest eveniment nu mai există. Alege altul.** | Evenimentul declanșatorului nu mai există | La **Eveniment**, alege altul | | **Neconectat, așa că acest pas nu rulează niciodată.** | Nicio linie nu duce la pas | Conectează pasul la o ieșire a altui pas sau șterge-l | | **Acest pas face parte dintr-o buclă. Un flux poate merge doar înainte.** | O linie se întoarce la un pas anterior | Șterge linia care se întoarce. Un flux nu poate merge în cerc | | **[Câmp] este obligatoriu.** | Un câmp obligatoriu este gol, precum **Titlu** la o sarcină | Completează câmpul. Câmpurile obligatorii au o steluță | | **[Câmp]: [variabilă] nu este disponibilă la acest pas.** | Folosești o variabilă care nu există la acest pas | Alege o variabilă din lista din spatele butonului **Variabilă**. Verifică și dacă pasul care produce variabila se află mai devreme în flux | | **[Câmp] nu este un JSON valid.** | **Payload** sau **Corp** nu este corect ca JSON | Verifică acoladele, virgulele și ghilimelele. Variabilele sunt permise | | **Adaugă cel puțin o opțiune.** | Un pas **Cere o decizie** nu are opțiuni | La **Opțiuni**, dă clic pe **Adaugă opțiune** | | **Fiecare opțiune are nevoie de un nume.** | O opțiune de la **Cere o decizie** nu are nume | Completează numele sau șterge opțiunea | | **Adaugă o condiție.** | Un pas **Dacă / altfel** nu are condiții | Dă clic pe **Adaugă condiție** | | **O condiție nu are un câmp valid.** | Câmpul unei condiții este gol sau necunoscut | Alege sau scrie un câmp care se află în lista din spatele **Variabilă** | | **Introdu o valoare pentru [variabilă].** | O condiție are o comparație, dar încă nu are valoare | Completează valoarea sau alege o comparație precum **este gol**, care nu are nevoie de una | | **[Câmp]: [variabilă] nu este un format cunoscut.** | După `\|` folosești un format care nu există | Folosește `currency`, `number`, `date`, `datetime`, `time`, `upper` sau `lower`. Vezi [Formatarea unei valori](/automatiseringen/variabelen#een-waarde-opmaken) | | **[Câmp]: [variabilă] nu este o unitate.** | Scrii un decalaj de dată cu o unitate care nu există | Folosește `minutes`, `hours`, `days`, `weeks` sau `months` | | **[Câmp]: câmpul personalizat [variabilă] nu există.** | Folosești un câmp personalizat care nu (mai) există | Alege un câmp existent din lista din spatele **Variabilă** | | **[Câmp]: [variabilă] are un format sau o deplasare de dată, care funcționează doar în texte.** | Folosești un format în câmpul de cod de la **Rulează cod** | Calculează în cod | | **[Câmp]: [variabilă] nu este un nume de variabilă.** | Numele unui rezultat conține caractere nepermise | Folosește litere, cifre și puncte, precum `result` sau `result.names` | | **O întârziere de 0 nu face nimic.** | Întârzierea este setată la 0 | Completează o durată mai mare decât 0 | | **Calea trebuie să înceapă cu / și să rămână în API-ul organizației tale.** | **Calea** unei cereri API nu este permisă | Fă ca ea să înceapă cu un singur `/` și nu pune `..` sau `\` în ea | | **URL-ul trebuie să înceapă cu https://.** | **URL-ul** unei cereri API nu este sigur | Folosește o adresă care începe cu `https://` | | **Expresia cron nu este validă. Folosiți cinci câmpuri, de exemplu 0 8 * * 1.** | Expresia cron nu este corectă | Vezi [După o expresie cron](/automatiseringen/triggers#volgens-een-cron-expressie) | ## Ce nu poate Tillor verifica dinainte [#wat-tillor-niet-vooraf-kan-controleren] Unele erori ies la iveală abia când fluxul rulează cu adevărat. - Un URL format din variabile poate fi verificat abia după ce este completat - La evenimentele ale căror date nu sunt descrise, Tillor nu verifică variabilele - Dacă o înregistrare există, dacă o factură poate fi trimisă sau dacă un alt server este accesibil se vede abia în timpul unei rulări Un flux fără mesaje nu este deci neapărat un flux care reușește mereu. Testează-l cu [Testare și rulări](/automatiseringen/testen-en-uitvoeringen) și verifică primele rulări reale. Dacă se schimbă un eveniment sau un câmp pe care se sprijină fluxul tău, vezi asta ca mesaj la pasul respectiv. Modifică pasul înainte să activezi din nou automatizarea. # Testare și rulări (/ro-RO/automatiseringen/testen-en-uitvoeringen) În editor lucrezi cu două file ca să verifici dacă un flux face ce vrei: **Rulare de test** pentru o încercare și **Rulări** pentru ce s-a întâmplat cu adevărat. Le deschizi în dreapta, în panou. A patra filă, **Istoric**, arată versiunile anterioare ale fluxului, vezi [Versiuni anterioare](/automatiseringen/aan-de-slag#eerdere-versies). ## O rulare de test [#een-testuitvoering] Alege fila **Rulare de test**. Un test parcurge fluxul cu date de exemplu și arată ce pași ar face. O rulare de test nu trimite nimic, nu creează nimic și nu modifică nimic. Întârzierile sunt sărite, astfel încât vezi imediat rezultatul final. Acțiunile arată doar ce ar face, cu textul **Nu se execută într-un test.** ### Date de exemplu [#voorbeeldgegevens] Sus se află **Testează cu o înregistrare reală**. Pentru fiecare înregistrare a declanșatorului, precum **Ocupare**, alege o înregistrare prin **Alege o înregistrare** (caută după nume sau număr). Tillor încarcă înregistrarea așa cum este acum, cu înregistrările la care face referire, în datele de exemplu. Testul tot nu trimite, nu creează și nu modifică nimic. Sub **Date de exemplu ale evenimentului** se află datele cu care lucrează testul, în format JSON. Dacă automatizarea a pornit deja o dată pe bune, testul începe cu datele ultimei rulări reale. Altfel, Tillor completează un exemplu care are forma evenimentului: un text devine *example*, un număr 1 și o dată momentul curent. Modifică valorile ca să încerci alte cazuri, de exemplu un alt tip de parcelă sau o factură cu o altă stare. Dacă textul nu este un JSON valid, apare **Datele de exemplu nu sunt un JSON valid.** și nu poți porni testul. Dacă fluxul conține o **Cerere API**, apare și un câmp **Exemplu de răspuns API**. Lipește acolo răspunsul pe care îl aștepți de la cerere. Cu el, testul poate parcurge pașii de după cerere, iar Tillor indică câmpurile răspunsului ca variabile. Vezi [Folosirea unui răspuns API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). ### Ce se întâmplă la acești pași [#wat-gebeurt-er-bij-deze-stappen] La unii pași, rezultatul depinde de lumea exterioară: **Trimite webhook**, **Cerere API**, acțiuni cu o ieșire **Omis** sau **Eroare** și logică precum **Deschis acum?**, **Caută o înregistrare**, **Așteaptă un eveniment** și **Cere o decizie**. La **Ce se întâmplă la acești pași?** alegi, per pas, pe ce ieșire continuă testul. Așa testezi și calea de urmat când ceva merge prost. ### Rezultatul [#het-resultaat] Dă clic pe **Rulează testul**. Vezi pașii în ordine, cu, per pas: - valorile completate, de exemplu titlul unei sarcini așa cum ar fi creat - la o condiție, per rând, ce s-a comparat și dacă s-a potrivit. Verde înseamnă reușit, roșu nu, cu valoarea care era de fapt acolo (*era …*) - pe ce ieșire a continuat fluxul (**Continuă pe: Da**) - la o întârziere, până când s-ar fi așteptat După rulare, butonul se numește **Rulează din nou**. Testul redă pașii unul câte unul (**Pasul 2 din 5…**). Cu **Arată tot** sari peste această redare. Pe canvas se colorează drumul pe care l-a luat testul, iar pașii care nu au venit la rând sunt estompați. Dă clic pe numele unui pas din rezultat ca să sari la acel pas. Jos scrie **Finalizat după 5 pași.** Dacă filtrul de la **Doar când** nu se potrivește cu datele tale de exemplu, vezi **Filtrul declanșatorului nu se potrivește cu aceste date, așa că fluxul nu ar porni.** Verifică atunci care condiție este roșie. Cu **Golește** scoți rezultatul de pe canvas. ### Ce nu arată un test [#wat-een-test-niet-laat-zien] - Dacă o factură poate fi trimisă cu adevărat, dacă un endpoint este accesibil sau dacă o cale API există - Cum arată înregistrările după o întârziere. Testul lucrează cu datele tale de exemplu și nu citește nimic din nou - Erori care apar abia cu date reale, precum un câmp gol De aceea, verifică întotdeauna primele rulări reale în fila **Rulări**. ## Rulări reale [#echte-uitvoeringen] În fila **Rulări** se află ultimele 20 de rulări reale ale acestei automatizări, cea mai nouă sus. Lista se reîmprospătează singură cam la fiecare 15 secunde. Cât timp nu a pornit încă nimic, scrie **Nicio rulare încă. Activează automatizarea și așteaptă evenimentul ei.** Fiecare rulare arată ora de pornire, numărul de pași sau (la așteptare) când continuă, și o stare. | Stare | Ce înseamnă | |---|---| | **În curs** | Rularea este în desfășurare chiar acum | | **În așteptare** | Rularea este într-o [întârziere](/automatiseringen/logica#vertraging), așteaptă un eveniment sau o aprobare și continuă mai târziu | | **Finalizată** | Fluxul a fost parcurs până la capăt | | **Eșuată** | Un pas nu a putut fi executat. Mesajul apare alături ca **Eșuat: …** | | **Anulată** | Rularea s-a oprit pentru că automatizarea a fost pusă pe pauză sau ștearsă în timp ce rularea aștepta | Dă clic pe o rulare ca s-o deschizi. Vezi atunci: - toți pașii care s-au făcut, cu ora și ce a făcut pasul - valorile completate, de exemplu titlul pe care l-a primit cu adevărat sarcina - la o condiție, ce rânduri s-au potrivit - la un pas eșuat, mesajul de eroare, care poate fi în engleză Pe canvas se colorează drumul pe care l-a luat această rulare. Pașii care nu au venit la rând sunt estompați. Dă clic pe numele unui pas ca să sari la acel pas. Sub pași se află un buton precum **3 seturi de date**. Acesta arată datele cu care a pornit rularea și ce a produs fiecare acțiune, precum ID-ul sarcinii create sau răspunsul unei cereri API. Așa poți verifica ce valori a avut o variabilă. Jos într-o rulare deschisă se află și o **Urmă** (Trace): un cod de litere și cifre. Dacă ceva nu este în regulă la o rulare, transmite acel cod către suport. Așa găsim exact această rulare. Evenimentele care nu au trecut de filtrul de la **Doar când**, sau pentru care automatizarea a rulat deja o dată la **Rulează o singură dată per înregistrare**, nu pornesc nicio rulare și nu apar deci în listă. În lista automatizărilor, la fiecare automatizare apare ora ultimei rulări, alături de o bară mică per rulare recentă. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - După o rulare de test nu s-a schimbat nimic în Tillor. Abia când pornești **Activ**, automatizarea rulează cu adevărat. - Rulările reale rămân în fila **Rulări**. Aceasta le arată pe ultimele 20. - O rulare eșuată duce la un e-mail către cel care a creat automatizarea, cel mult unul pe oră. ## Probleme? [#problemen] Tillor afișează **Datele de exemplu nu sunt un JSON valid.** și nu lasă testul să pornească. Verifică acoladele, virgulele și ghilimelele. Cu aceste date de exemplu, fluxul nu ar porni. Vezi care condiție este roșie și modifică datele sau condiția. Tillor afișează **Nicio rulare încă. Activează automatizarea și așteaptă evenimentul ei.** Evenimentele care nu au trecut de filtru nu apar acolo. Vezi [Întrebări frecvente](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet). Un test nu trimite nimic și nu citește înregistrările din nou. Dacă o factură poate fi trimisă sau o adresă este accesibilă se vede abia în realitate. Deschide rularea pentru mesajul de eroare și datele per pas. Ai nevoie de ajutor de la suport? Transmite codul **Urmă** al rulării. ## O rulare care nu vrea să pornească [#een-uitvoering-die-niet-wil-starten] Vezi [Întrebări frecvente](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet) pentru o listă de verificare. # Declanșatoare (/ro-RO/automatiseringen/triggers) Declanșatorul este momentul de pornire al unei automatizări: „când”. Se află în partea de sus a fiecărui flux, sub numele **Când se întâmplă asta**. Un exemplu: *pornește când se încheie o ocupare*. El stabilește și ce date pot folosi pașii de după el. Un flux poate avea mai multe declanșatoare. Fiecare declanșator pornește o rulare proprie, cu filtrul lui. Adaugi unul din lista din stânga. Ultimul declanșator nu poate fi șters. ## Unde pornește automatizarea [#waar-start-de-automatisering-op] La **Pornește de la** alegi unul dintre cele șapte momente de pornire. | Alegere | Pornește când | |---|---| | **Când se întâmplă ceva** | Are loc un eveniment în Tillor, de exemplu o ocupare care se încheie sau o factură care se plătește | | **Factură restantă** | O factură înregistrată este încă deschisă după data scadentă | | **Webhook de intrare** | Un alt sistem trimite un mesaj la adresa proprie a automatizării | | **Este aleasă o acțiune a sarcinii** | Cineva alege, la o sarcină, un buton de alegere legat de această automatizare | | **Se atinge o dată** | Se atinge o dată a unei înregistrări, eventual cu un timp înainte sau după. De exemplu o zi înainte de sosirea unei rezervări | | **În fiecare zi la o oră** | Este ora aleasă, în fiecare zi | | **După o expresie cron** | Vine rândul programului pe care îl indici | Alegi deci mai întâi tipul de moment de pornire, apoi detaliile. Dacă alegi alt moment de pornire, filtrele de la **Doar când** sunt golite. Ele fuseseră scrise pentru alegerea anterioară și nu se mai potrivesc. ## Când se întâmplă ceva [#als-er-iets-gebeurt] La **Eveniment** alegi ce trebuie să pornească automatizarea. Dă clic pe câmp și scrie pentru a căuta, de exemplu *occupation* sau *invoice*. Evenimentele apar în notația Tillor, ca `occupation:ended`: mai întâi despre ce este vorba, apoi ce s-a întâmplat. Acestea sunt evenimentele de care ai nevoie cel mai des: | Eveniment | Pornește când | |---|---| | `occupation:ended` | Se încheie o ocupare | | `reservation:created` | Se creează o rezervare | | `reservation:updated` | O rezervare este modificată | | `customer:created` | Se creează un client | | `customer:updated` | Un client este modificat | | `invoice:created` | Se creează o factură | | `invoice:updated` | O factură este modificată | | `invoice:paid` | O factură este plătită | | `payment:created` | Intră o plată | | `task:created` | Se creează o sarcină | | `task:status-changed` | Se schimbă starea unei sarcini | | `task:assigned` | O sarcină este atribuită cuiva | | `task:action-chosen` | Cineva alege un buton de alegere la o sarcină | | `integration-alarm:created` | Un contor dă o alarmă | | `comment:created` | Se postează un comentariu | | `document:created` | Se adaugă un document | | `signatureRequest:updated` | O cerere de semnare este actualizată | | `signatureRequest:completed` | Toți semnatarii unei cereri de semnare au semnat | | `mandate-agreement:signed` | Un client a semnat un mandat SEPA | | `mandate-agreement:activated` | Un mandat SEPA a devenit activ | | `mandate-agreement:expired` | O cerere de mandat SEPA a expirat fără semnătură | | `mandate-agreement:failed` | Activarea unui mandat SEPA a fost refuzată sau a eșuat | | `productPriceChange:applied` | Intră în vigoare un [preț de produs programat](/producten/prijzen-plannen) | Este aceeași listă ca cea a [webhook-urilor](/ontwikkelaars/events). Poți deci folosi orice eveniment pentru care Tillor poate trimite un webhook. Câteva evenimente extrem de frecvente, precum starea fizică a barierelor, scrisul în inbox, jurnalele controllerelor și prezența vehiculelor, nu apar în listă. Sub câmpul **Eveniment** se află linkul **Lipsește un eveniment? Solicită-l**. Vezi [Solicitarea unui pas sau a unui eveniment](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen). ### Ce date primești [#welke-gegevens-krijg-je-mee] La majoritatea evenimentelor există o înregistrare, de exemplu o ocupare, o factură sau o sarcină. Această înregistrare, plus înregistrările la care face referire, sunt apoi disponibile ca variabile în pași. La `occupation:ended` poți folosi, de exemplu: - `{occupation.terrain.name}` pentru numele terenului - `{occupation.customer.firstName}` pentru prenumele clientului - `{occupation.reservation.displayId}` pentru numărul rezervării. Nu orice ocupare are o rezervare: atunci rămâne gol În plus există mereu `{triggeredBy.name}` și `{triggeredBy.id}`: colegul care a provocat evenimentul. Dacă evenimentul a fost provocat de sistem, de exemplu de o sincronizare bancară, aceste câmpuri sunt goale. Sub setările declanșatorului se află **Datele pe care le oferă acest eveniment**. Acolo vezi exact ce variabile poți folosi. La un eveniment ale cărui date nu sunt descrise, Tillor spune că nu e nimic de ales. Variabilele pe care le scrii tu funcționează în continuare. Vezi [Variabile și șabloane](/automatiseringen/variabelen). ## Este aleasă o acțiune a sarcinii [#er-wordt-een-taakactie-gekozen] Unele sarcini au butoane de alegere în loc de bifă, de exemplu din [Cere o decizie](/automatiseringen/logica#vraag-om-een-beslissing). Un buton poate fi legat de o automatizare. Cu acest declanșator, automatizarea pornește imediat ce cineva alege acel buton. Vezi și [Sarcini cu butoane de alegere](/taken/taakdetails#taken-met-keuzeknoppen). Legarea unui buton de o automatizare nu se face în editorul de fluxuri. Dacă ai nevoie de asta, cere-i administratorului Tillor sau suportului. Pașii primesc datele sarcinii, de exemplu `{task.name}` și `{task.id}`, plus `{action.label}` (numele butonului ales) și `{note}` (nota completată de coleg, dacă butonul a cerut-o). Sub **Datele pe care le oferă acest eveniment** vezi lista completă. ## Factură restantă [#factuur-is-vervallen] Acest declanșator pornește pentru fiecare factură care: - este înregistrată (ciornele și facturile anulate nu se iau în calcul) - nu este notă de credit - mai are o sumă deschisă - are o dată scadentă dinainte de azi Pentru fiecare astfel de factură pornește o rulare proprie. Datele facturii și ale clientului sunt disponibile ca `{invoice.…}`, de exemplu `{invoice.displayId}`, `{invoice.amountOutstanding}` și `{invoice.customer.firstName}`. Dacă dezactivezi **Rulează o singură dată per înregistrare**, automatizarea pornește pentru aceeași factură cel mult o dată pe zi cât timp aceasta este restantă. Dacă îl lași activat, pornește exact o dată pentru fiecare factură. De obicei asta este ce vrei pentru un memento. La **De reamintit** alegi cât timp trebuie să fie deschisă factura, aceeași regulă ca în lista de facturi. Activează **Omite clienții excluși de la somații automate** pentru a sări peste clienții care au setat asta în setările lor de facturare. O factură scoasă ea însăși din reamintirile automate nu pornește nici ea fluxul. ## Webhook de intrare [#inkomende-webhook] Un webhook este un mesaj pe care un alt sistem îl trimite la o adresă. Cu acest declanșator, acel sistem pornește automatizarea, de exemplu site-ul tău, un formular sau o platformă de rezervări. Fiecare automatizare primește o adresă proprie, secretă. 1. La **Pornește de la** alege **Webhook de intrare** 2. Salvează automatizarea. La **Adresă** apare URL-ul 3. Dă clic pe **Copiază** și setează adresa în celălalt sistem 4. Activează automatizarea Celălalt sistem trimite un `POST` cu JSON la acea adresă. Conținutul este apoi disponibil ca `{body.…}`, de exemplu `{body.email}` sau `{body.reservering.nummer}`, iar parametrii din URL ca `{query.…}`. Cu **Doar când** poți filtra și după aceste câmpuri. Mai departe, funcționează așa: - Adresa este secretul. Cine o cunoaște poate porni automatizarea. Împarte-o deci doar cu sistemul care are nevoie de ea - Dacă adresa a ajuns pe mâini greșite, dă clic pe **Adresă nouă** și salvează. Adresa veche nu mai funcționează din acel moment - O automatizare dezactivată sau o adresă greșită dă eroarea `404` - Conținutul poate avea cel mult 100 KB - Fiecare apel pornește o rulare pentru fiecare declanșator webhook din flux. Adresa aparține primului declanșator webhook. **Adresă nouă** la acel declanșator o înlocuiește - Nu este legată nicio înregistrare, deci **Rulează o singură dată per înregistrare** nu are efect ### Ignoră repetările [#herhalingen-negeren] Dacă celălalt sistem trimite uneori același apel de două ori, cu **Ignoră repetările** eviți ca fluxul să pornească de două ori. Tillor ține minte o cheie a apelului. Dacă aceeași cheie vine din nou, nu pornește nimic. | Alegere | Ce este cheia | |---|---| | **Fiecare apel pornește fluxul** | Nu există cheie. Implicit | | **Dintr-un antet** | Valoarea unui antet pe care îl alegi la **Numele antetului**, de exemplu `Idempotency-Key` | | **Din corpul JSON** | Valoarea unui câmp din JSON, pe care îl alegi la **Câmp**, precum `id` sau `data.eventId` | | **Același corp JSON** | Întregul conținut. Un apel cu exact același conținut se socotește repetare | La **Ține minte cheia timp de** alegi cât timp este valabilă cheia, în ore, zile sau săptămâni. După acest timp, aceeași cheie pornește din nou fluxul. La 0, cheia este valabilă până ștergi automatizarea. Un apel fără antetul ales sau fără câmpul ales este refuzat. ## Se atinge o dată [#een-datum-is-bereikt] Acest declanșator pornește la o dată a unei înregistrări. La **Dată** alegi orice câmp de dată al unei înregistrări pe care Tillor o trimite și la evenimente, scris ca înregistrare și câmp. Câteva exemple: | Dată | Înregistrare | |---|---| | `reservation.checkIn` | Data sosirii unei rezervări | | `reservation.checkOut` | Data plecării unei rezervări | | `invoice.dueDate` | Data scadentă a unei facturi | | `task.dueDate` | Termenul limită al unei sarcini | | `occupation.paidUntil` | Până când este plătită o ocupare | | `accessMethod.periodTo` | Sfârșitul valabilității unui cod QR, a unui număr de înmatriculare sau a altei metode de acces | | `nfcTag.activatedUntil` | Până când este activat un tag NFC | | `mandateAgreement.expiresAt` | Când expiră o cerere de semnare a unui mandat SEPA | | `customer.birthday` | Data nașterii unui client | | `contact.birthday` | Data nașterii unei persoane de contact | Implicit, declanșatorul pornește o singură dată, chiar la acea dată. Activează **Repetă în fiecare an** pentru ca să conteze doar ziua și luna: atunci fluxul pornește din nou în fiecare an, ca la ziua de naștere de la `contact.birthday`. Un 29 februarie cade în alți ani pe 28 februarie. Poți alege și datele salvate la o înregistrare ca câmpuri suplimentare. `document.userMetadata.insuranceExpiryDate` este data scadentă a unui document, precum dovada plății asigurării. O astfel de dată fără oră se socotește ca miezul nopții (UTC, ora standard internațională). Cu **Doar când** limitezi apoi declanșatorul la un tip, de exemplu `document.userMetadata.documentType` este `INSURANCE_PAYMENT_PROOF`, și la documentele active cu `document.status` este `ACTIVE`. Cu **Cât timp** și **Înainte sau după** muți momentul. *1 zi* și **Înainte** la `reservation.checkIn` pornește fluxul cu o zi înainte de sosire. La 0 pornește chiar la dată. O dată fără oră se socotește ca miezul nopții. Cu **Ora** alegi când, în acea zi, pornește fluxul. **Ora din dată** folosește momentul din câmp, precum ora sosirii unei rezervări. **Oră fixă din zi** pornește în ziua datei la ora și minutul pe care le alegi, în fusul orar al organizației tale. Astfel `contact.birthday` cu **Repetă în fiecare an** pornește în fiecare an la 09:00, de ziua de naștere. **Cât timp** se numără atunci de la acea oră: *1 zi* și **Înainte** pornește cu o zi înainte la 09:00, chiar dacă în acea noapte se schimbă ora. Pentru fiecare înregistrare pornește o rulare proprie, cu datele acelei înregistrări ca variabile, de exemplu `{reservation.displayId}` și `{reservation.customer.firstName}`. Cu **Doar când** îl limitezi, de exemplu doar rezervările cu starea înregistrată. Mai departe, funcționează așa: - Pentru fiecare înregistrare și fiecare moment, fluxul pornește o singură dată. Dacă data se mută mai târziu, de exemplu pentru că un oaspete sosește mai târziu, fluxul pornește din nou la noul moment - Dacă momentul era deja trecut când ai salvat sau activat automatizarea, nu mai pornește pentru el - Momentele ratate, de exemplu în timpul unei mentenanțe, sunt recuperate de Tillor până la o oră mai târziu ## În fiecare zi la o oră [#elke-dag-op-een-uur] La **Oră** alegi o oră (de la 0 la 23) și la **Minut** un minut de la 0 la 59. Ora este ora din fusul orar al organizației tale. Pașii primesc `{now}`: momentul în care a pornit rularea. ## După o expresie cron [#volgens-een-cron-expressie] Alege un ritm, precum în fiecare zi, în fiecare luni la 08:00 sau în lunile impare (a 1-a, a 3-a și a 5-a). La **Personalizat** setezi intervalul, zilele săptămânii și ora, până la minut. La **Expresie cron** scrii tu programul. O expresie cron este o scriere scurtă pentru o oră care se repetă. Are cinci părți, separate printr-un spațiu: **minut**, **oră**, **ziua lunii**, **luna** și **ziua săptămânii**. | Expresie | Semnificație | |---|---| | `0 8 * * 1` | În fiecare luni la 08:00 | | `7 8 * * 1` | În fiecare luni la 08:07 | | `30 7 * * 1-5` | În fiecare zi lucrătoare la 07:30 | | `0 9 1 * *` | În prima zi a fiecărei luni la 09:00 | | `0 8 * * 1#1,1#3,1#5` | În fiecare luni impară (a 1-a, a 3-a și a 5-a din lună) la 08:00 | | `0 8 * * 1L` | Ultima luni din lună la 08:00 | | `0 8 * * 1 W2:2026-10-05` | La fiecare două săptămâni, lunea la 08:00, începând cu săptămâna de 5 octombrie 2026 | | `*/15 * * * *` | În fiecare sfert de oră | | `* * * * *` | În fiecare minut | În fiecare parte poți folosi un număr, o listă cu virgule (`8,17`), un interval (`1-5`), un pas (`*/15`) sau o stea (`*`, orice valoare). Ziua săptămânii 0 și 7 sunt amândouă duminică. `1#2` este a doua luni, `1L` ultima. Un al șaselea câmp `W2:2026-10-05` se repetă la fiecare două săptămâni, numărate de la acea săptămână. Nume precum *MON* sau *JAN* nu funcționează. Dacă completezi atât o zi a lunii, cât și o zi a săptămânii, automatizarea pornește la una dintre ele. Dacă expresia nu este validă, Tillor anunță asta la declanșator. Orele sunt în fusul orar al organizației tale. ## La ce oră pornește exact un program [#hoe-laat-start-een-schema-precies] Tillor verifică în fiecare minut ce programe sunt la rând. O automatizare care trebuie să pornească la 08:07 pornește în acel minut. Asta se aplică la **Factură restantă**, **Se atinge o dată**, **În fiecare zi la o oră** și **După o expresie cron**. Pe minut, un program pornește cel mult o dată. O verificare care rulează abia în minutul următor nu mai recuperează minutul anterior. Evenimentele pornesc imediat, fără această întârziere. ## Doar când [#alleen-wanneer] Cu **Doar când** pornești automatizarea numai dacă datele se potrivesc. Astfel pornești, de exemplu, doar pentru rulote fixe sau doar pentru facturi peste o sumă. Lasă gol pentru a porni la fiecare eveniment de acest tip. 1. Dă clic pe **Adaugă condiție** 2. Alege câmpul cu butonul **Variabilă** (sau scrie calea, de exemplu `invoice.status`) 3. Alege cum compari 4. Completează valoarea. La câmpurile cu alegere fixă, precum o stare, un tip de teren sau un coleg, alegi dintr-o listă Poți folosi următoarele comparații: | Alegere | Se potrivește când | |---|---| | **este** | Câmpul este egal cu valoarea | | **nu este** | Câmpul nu este egal cu valoarea | | **conține** | Valoarea apare undeva în câmp | | **este mai mare decât** | Câmpul este mai mare decât valoarea (la numere și date) | | **este mai mic decât** | Câmpul este mai mic decât valoarea (la numere și date) | | **este unul dintre** | Câmpul este egal cu una dintre valorile alese | | **este gol** | Câmpul este gol | | **nu este gol** | Câmpul nu este gol | Majusculele nu contează. Numerele se compară ca numere, deci 10 este mai mare decât 9. Dacă ai mai mult de o condiție, alegi cum lucrează împreună: **Toate trebuie să se potrivească** sau **Este suficientă una**. Evenimentele oprite de filtru nu pornesc nicio rulare și nu lasă deci nicio urmă în fila **Rulări**. Dacă vrei să vezi dacă filtrul tău este corect, folosește testarea: acolo vezi, pentru fiecare condiție, dacă s-a potrivit. ## Rulează o singură dată per înregistrare [#eén-keer-per-record-uitvoeren] Cu **Rulează o singură dată per înregistrare**, automatizarea pornește cel mult o dată per factură, rezervare sau altă înregistrare, oricât de des se produce evenimentul pentru ea. Este util mai ales la evenimente care revin des, precum `invoice:updated`: o factură este modificată de zeci de ori, dar tu vrei să trimiți un singur memento. Tillor ține minte, pentru fiecare înregistrare, că automatizarea a pornit deja. Această memorie dispare dacă ștergi automatizarea. Funcționează doar la evenimentele care au o înregistrare, la **Factură restantă** și la **Se atinge o dată**. La **Se atinge o dată** înseamnă: chiar dacă data se mută mai târziu, fluxul nu pornește din nou. La un program precum **În fiecare zi la o oră** nu are efect. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - De fiecare dată când apare momentul de pornire și filtrul se potrivește, pornește o rulare cu datele acelui moment ca variabile. - Un eveniment pornește imediat. O dată, o oră sau un program pornește în minutul în care îi vine rândul. - Dacă filtrul nu se potrivește, nu pornește nimic și nu rămâne nicio urmă în fila **Rulări**. ## Probleme? [#problemen] Verifică dacă automatizarea este activată, dacă ai ales **Evenimentul** potrivit și dacă filtrul de la **Doar când** nu este prea strict. Testează cu datele unui caz real în fila **Rulare de test**. Mai multe în [Întrebări frecvente](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet). Folosește cinci câmpuri separate printr-un spațiu, de exemplu `0 8 * * 1`. Nume precum *MON* nu funcționează. Automatizarea este dezactivată sau adresa nu este corectă. Activează automatizarea și copiază adresa din nou. La alt moment de pornire, filtrele de la **Doar când** sunt golite, pentru că fuseseră scrise pentru momentul de pornire anterior. Adaugă-le din nou. **Rulează o singură dată per înregistrare** este activat. Atunci pornește cel mult o dată per factură, rezervare sau altă înregistrare. ## Citește mai departe [#meer-lezen] # Variabile și șabloane (/ro-RO/automatiseringen/variabelen) Cu variabilele faci texte care diferă de la caz la caz. Scrii o variabilă între acolade, iar Tillor completează valoarea reală imediat ce automatizarea rulează. Un exemplu de titlu de sarcină: ```text Controleer {occupation.terrain.name} ``` Dacă ocuparea se încheie pe terenul 12, sarcina se numește *Controleer 12*. ## Inserarea unei variabile [#een-variabele-invoegen] Deasupra fiecărui câmp de text în care funcționează variabilele se află butonul **Variabilă**. Dă clic pe el și vezi o listă cu toate datele disponibile, grupate pe înregistrări. Scrie pentru a căuta (**Caută variabile**) și dă clic pe un rând. Tillor pune variabila la locul cursorului. Poți și să scrii pur și simplu variabila singur. Sub câmp, o casetă gri arată cum arată textul cu date de exemplu, astfel încât vezi imediat dacă este corect. Variabilele funcționează în câmpuri de text precum titluri, descrieri, subsarcini, mesaje, ID-ul unui client, al unei facturi sau al altei înregistrări, calea sau URL-ul unei cereri API, corpul, payload-ul unui webhook, numele evenimentului webhook și valorile antetelor. La ultimele două lipsește butonul **Variabilă**, dar o variabilă pe care o scrii tu este totuși completată. Tillor nu verifică aceste două câmpuri pentru erori și nu arată un exemplu pentru ele. În câmpurile în care alegi o dată cu care compari, scrii variabila fără acolade. Asta se aplică la **Doar când**, **Dacă / altfel** și **Până când** la **Așteaptă până când** (de exemplu `invoice.status`), la **Câmp** al unui pas **Ramificare** și la **Dată** al unui pas **Întârziere**. ## Ce variabile există [#welke-variabelen-zijn-er] | Variabilă | Disponibilă | Conținut | |---|---|---| | `{occupation.…}`, `{invoice.…}`, `{task.…}`, `{reservation.…}` și altele | După un eveniment | Câmpurile înregistrării despre care este evenimentul. Numele înregistrării este și începutul variabilei | | `{occupation.terrain.name}` | După un eveniment | Câmpuri ale înregistrărilor la care face referire înregistrarea, precum clientul sau terenul. Funcționează la un singur nivel de adâncime | | `{triggeredBy.name}`, `{triggeredBy.id}` | Mereu | Colegul care a provocat evenimentul. Gol dacă a făcut-o sistemul | | `{invoice.…}` | La **Factură restantă** | Câmpurile facturii restante și ale clientului | | `{reservation.…}`, `{task.…}` și altele | La **Se atinge o dată** | Câmpurile înregistrării a cărei dată s-a atins, plus înregistrările la care face referire | | `{now}`, `{today}` | Mereu | Momentul în care rulează pasul și miezul nopții acelei zile în fusul orar al organizației. Împreună cu o deplasare (mai jos), `{today + 1 day}` dă ziua de mâine | | `{threadId}`, `{messageId}` | La evenimentele despre mesaje din inbox, precum `inbox:message-created` | ID-ul conversației și al mesajului | | Câmpurile evenimentului | După **Așteaptă un eveniment**, prin **Primit** | Datele evenimentului așteptat. Ele înlocuiesc datele acelorași înregistrări de la începutul fluxului | | `{createdTask.id}`, `{createdTask.name}` | După **Creează sarcină** | Sarcina tocmai creată | | `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}`, `{foundTask.status}` | După **Caută sarcină**, prin **Găsită** | Sarcina pe care a găsit-o pasul | | `{updatedTask.id}`, `{updatedTask.status}` | După **Setează starea** | Sarcina a cărei stare a fost schimbată | | `{updatedTask.id}`, `{updatedTask.priority}` | După **Setează prioritatea sarcinii** | Sarcina a cărei prioritate a fost schimbată | | `{updatedTask.id}` | După **Actualizează sarcina** | Sarcina care a fost modificată | | `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}`, `{foundDocument.userMetadata.insuranceExpiryDate}` | După **Găsește document**, prin **Găsită** | Documentul pe care l-a găsit pasul | | `{updatedDocument.id}` | După **Actualizează document** | Documentul care a fost modificat | | `{response.status}`, `{response.body}`, `{response.data.…}` | După **Cerere API** | Răspunsul cererii | | `{foundCustomer.…}`, `{foundInvoice.…}`, `{foundReservation.…}` și altele | După **Caută o înregistrare**, prin **Găsită** | Câmpurile înregistrării găsite de pas, plus înregistrările la care face referire. Numele este `found` plus tipul înregistrării: `foundCustomer`, `foundReservation`, `foundOccupation`, `foundInvoice`, `foundPayment`, `foundTerrain`, `foundTask`, `foundDocument`, `foundAccessMethod`, `foundNfcTag`, `foundMeter`, `foundInboxThread` sau `foundInboxMessage` | | `{body.…}`, `{query.…}`, `{receivedAt}` | După **Webhook de intrare** | Corpul JSON, parametrii de interogare și momentul primirii apelului webhook | | Orice nume de destinație din **Mapează variabile** | După **Mapează variabile** | Ce completezi ca destinație în acel pas, de exemplu `{invoice.displayId}` după `invoice` ← `{foundInvoice}` | | `{item.…}` | În pașii de după **Pentru fiecare** | Câmpurile elementului pentru care rulează acum pasul, precum `{item.id}` | | `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}`, `{approval.decidedBy.name}` | După **Cere o decizie**, printr-o opțiune | Sarcina, opțiunea aleasă, numele opțiunii, nota și colegul care a ales | | `{task.…}`, `{action.label}`, `{note}` | La **Este aleasă o acțiune a sarcinii** | Sarcina, butonul ales și nota completată la el | | `{createdComment.id}` | După **Adaugă un comentariu** | Comentariul tocmai postat | | `{bookedInvoice.displayId}` | După **Înregistrează factura**, prin **Gata** | Numărul facturii înregistrate | | `{paymentLink.url}` | După **Creează link de plată**, prin **Gata** | Linkul cu care clientul poate plăti online | | `{consumptionInvoice.id}` | După **Facturează consumul**, prin **Gata** | Factura pentru consumul contorului | | `{extendInvoice.id}` | După **Ciornă de factură de prelungire** | Ciorna de factură care prelungește ocuparea | | `{createdAccessMethod.id}`, `{createdAccessMethod.value}` | După **Creează metodă de acces** | Noua metodă de acces și valoarea ei, precum codul unui cod QR sau al unui cod PIN | | `{error.message}`, `{error.step}` | După o acțiune cu **Continuă când acest pas eșuează**, prin **Eroare** | Mesajul de eroare și numele pasului care a eșuat | Ce câmpuri are exact o înregistrare vezi în lista din spatele butonului **Variabilă**. La declanșator se află și prezentarea **Datele pe care le oferă acest eveniment**. ### Doar ce vine mai devreme în flux [#alleen-wat-eerder-in-de-flow-komt] Un pas poate folosi doar variabile din declanșatorul care ajunge la el și din pașii aflați mai devreme pe același drum. Dacă mai multe declanșatoare ajung la același pas, sunt disponibile doar variabilele pe care le oferă fiecare dintre aceste declanșatoare. Un câmp dintr-un pas anterior se ia în calcul dacă fiecare dintre aceste declanșatoare trece și prin acel pas. Dacă folosești o variabilă care nu există în acel punct, Tillor anunță **[Câmp]: [variabilă] nu este disponibilă la acest pas.** Un flux cu un astfel de mesaj nu poate fi activat. Unele înregistrări păstrează date suplimentare într-un singur câmp, precum datele documentului în `userMetadata`. Fiecare cheie de sub el este o variabilă: `{document.userMetadata.documentType}`, `{document.userMetadata.insuranceExpiryDate}` sau altă cheie. Cheile cunoscute, precum tipul și data scadentă a unui document, apar și ele în listă și le poți compara ca dată. O dată fără oră, precum `2026-10-07`, apare într-un mesaj ca `07-10-2026`. Variabilele de la **Pentru fiecare** (`{item.…}`) există doar în pașii de după ieșirea **Pentru fiecare**, nu după **Gata**. Nici variabilele unei ieșiri pe care nu ai luat-o nu există: `{paymentLink.url}` există doar dacă pasul a trecut prin **Gata**, iar `{foundTask.id}` doar după **Găsită**. La evenimentele ale căror date nu sunt descrise, Tillor nu poate verifica ce variabile există. Atunci nu primești acel mesaj. Verifică deci aceste fluxuri cu extra atenție printr-o rulare de test. ### O valoare nouă o înlocuiește pe cea veche [#een-nieuwe-waarde-vervangt-de-oude] O a doua **Cerere API** în același flux înlocuiește `response` din prima. Același lucru se aplică la `createdTask` după o a doua **Creează sarcină**, la `foundTask` după un al doilea **Caută sarcină** sau **Caută o înregistrare** pe **Sarcină**, și la `error` după un al doilea pas eșuat. Folosește deci datele dintr-un răspuns în pasul care urmează imediat după el. ## Cum se completează valorile [#hoe-waarden-worden-ingevuld] Tillor adaptează notația la tipul câmpului. **În text obișnuit** (titluri, descrieri, subsarcini): - Datele sunt în fusul orar al organizației tale, de exemplu `05-10-2026`. Dacă momentul nu cade exact la miezul nopții, apare și o oră, precum `05-10-2026 14:30` - Un câmp gol dă un text gol - O variabilă pe care Tillor nu o cunoaște rămâne așa cum ai scris-o, de exemplu `{occupation.terain.name}`. O greșeală de scriere se observă astfel imediat în sarcină sau în mesaj - Dacă o înregistrare legată lipsește, variabila rămâne goală. O ocupare fără rezervare nu dă deci nimic pentru `{occupation.reservation.displayId}`, iar un eveniment provocat de sistem nu dă nimic pentru `{triggeredBy.name}`. Dacă în acest caz vrei alt text, pune înainte un **Dacă / altfel** cu **este gol** **În JSON** (**Payload** al unui webhook și **Corpul** unei cereri API): - Textul este completat în siguranță. Ghilimelele, rândurile noi și alte caractere speciale din valoare nu pot strica JSON-ul - Numerele și valorile da/nu vin fără ghilimele, deci nu pune ghilimele în jurul lor. Textul îl pui între ghilimele - Datele merg ca dată și oră internațională, precum `2026-10-05T08:00:00.000Z`, astfel încât sistemul primitor să le poată citi corect ```json { "reservation": "{reservation.displayId}", "adults": {reservation.numberOfAdults} } ``` Dacă JSON-ul nu este valid după completare, de exemplu pentru că un număr este gol, rularea se oprește cu un mesaj de eroare. **Într-o cale sau un URL** (la o cerere API): - Valorile sunt convertite astfel încât să încapă într-o adresă. Un nume cu spațiu nu dă deci o adresă stricată - Și aici datele merg ca dată și oră internațională - Ce scrii tu singur rămâne așa cum scrii. Dacă vrei un spațiu într-un termen de căutare, scrie singur `%20` ## Deplasarea unei date [#een-datum-verschuiven] După o variabilă de dată poate urma o deplasare: `{reservation.checkOut + 1 day}`, `{today - 2 weeks}`, `{invoice.dueDate + 3 hours|date}`. Unitățile sunt `minutes`, `hours`, `days`, `weeks` și `months` (merge și singularul). Zilele și săptămânile au lungimi fixe, astfel încât o valabilitate rămâne la fel de lungă și peste trecerea la ora de vară și de iarnă; lunile urmează calendarul, deci 31 ianuarie plus o lună este 28 sau 29 februarie. La o valoare care nu este o dată, deplasarea nu face nimic, iar o unitate care nu există este o eroare la pas. Câmpurile de dată precum **Valabil până la** acceptă aceeași scriere. ## Formatarea unei valori [#een-waarde-opmaken] Pune după variabilă un `|` și un format, de exemplu `{invoice.amountOutstanding|currency}`. Fără format, o sumă apare simplă, precum `1295.3`. Cu `|currency` devine `€ 1.295,30`. | Format | Exemplu | Rezultat | |--------|-----------|-----------| | `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` (număr fix de zecimale) | | `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` | - Numerele și sumele apar mereu în notația belgiană: punct pentru mii și virgulă pentru zecimale - Datele și orele sunt în fusul orar al organizației tale - Dacă formatul nu poate citi valoarea, de exemplu `|currency` pe text, valoarea apare pur și simplu fără format - Un format pe care Tillor nu îl cunoaște rămâne așa cum l-ai scris, iar editorul arată un mesaj despre el - În JSON și într-un URL, valoarea formatată este completată ca text. Pune deci ghilimele în jurul ei în JSON ## Folosirea unui răspuns API [#een-api-antwoord-gebruiken] După o [Cerere API](/automatiseringen/acties/integraties#api-verzoek) poți folosi câmpuri din răspuns cu `{response.data.…}`. Răspunsul la o căutare de sarcini arată, de exemplu, așa: ```json { "items": [ { "id": "task_1", "priority": "LOW" } ] } ``` Atunci `{response.data.items.0.id}` dă ID-ul primei sarcini (prima dintr-o listă are numărul 0), iar `{response.data.items.0.priority}` prioritatea ei. Tillor poate oferi câmpurile unui răspuns ca variabilă abia când știe cum arată răspunsul. Asta se poate în două feluri: - Lasă automatizarea să ruleze o dată cu adevărat. Tillor folosește atunci răspunsul ultimei rulări - Lipește un exemplu în fila **Rulare de test**, în câmpul **Exemplu de răspuns API**. Acest câmp apare imediat ce fluxul conține o **Cerere API**. Sub el se află **Câmpuri din acest răspuns**. Dă clic pe un câmp pentru a-l copia, inclusiv acoladele Apoi câmpurile apar în lista din spatele butonului **Variabilă** și în lista de la **Câmp** al unui pas **Ramificare**. Dacă scrii tu singur o cale sub `response.data`, aceasta este mereu acceptată, chiar și fără exemplu. În plus: - `{response.body}` conține primele 4000 de caractere ale răspunsului. Dacă răspunsul este mai lung, restul este tăiat - `{response.data}` este gol dacă răspunsul nu este JSON sau dacă răspunsul este foarte mare (peste 100.000 de caractere) - La o căutare fără rezultat, `{response.data.items.0.id}` nu există. Un pas **Ramificare** pe un astfel de câmp merge atunci prin **Implicit** În fila **Rulare de test** completezi și datele de exemplu ale evenimentului. Astfel vezi, în rularea de test, ce valori ar completa Tillor. Vezi [Testare și rulări](/automatiseringen/testen-en-uitvoeringen). ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Imediat ce automatizarea rulează, Tillor înlocuiește fiecare variabilă cu valoarea reală. O variabilă pe care Tillor nu o cunoaște rămâne așa cum ai scris-o. - Dacă o dată este goală, locul rămâne gol. Dacă atunci vrei alt text, pune înainte un **Dacă / altfel** cu **este gol**. ## Probleme? [#problemen] O variabilă pe care Tillor nu o cunoaște rămâne literal. De obicei este o greșeală de scriere. Alege variabila prin butonul **Variabilă**. Folosești o dată care nu există încă în acest punct al fluxului, de exemplu de la un pas care vine mai târziu sau de la o ieșire pe care nu ai luat-o. Pune mai devreme în flux pasul care produce acea dată. Cât timp mesajul este prezent, nu poți activa automatizarea. Un număr gol face JSON-ul invalid. Textul îl pui între ghilimele, numerele nu. Verifică câmpurile cu o rulare de test. Tillor nu cunoaște încă forma răspunsului. Lasă automatizarea să ruleze o dată cu adevărat sau lipește un exemplu la **Exemplu de răspuns API** în fila **Rulare de test**. # Întrebări frecvente (/ro-RO/automatiseringen/veelgestelde-vragen) ## Cine poate folosi automatizările? [#wie-kan-automatiseringen-gebruiken] Cine are **Vizualizare automatizări** vede automatizările și rulările lor. Cine are **Gestionare automatizări** le poate și crea, modifica, activa și șterge. Administratorii cu **Toate permisiunile** pot face orice. Aceste permisiuni le acorzi membrilor organizației tale. Fii atent cu **Gestionare automatizări**: o automatizare lucrează cu toate permisiunile organizației tale. Cine are voie să construiască fluxuri poate deci face orice printr-un flux. Acordă-l doar persoanelor în care ai încredere. Cine nu are niciuna dintre cele două permisiuni nu vede elementul de meniu **Admin > Automatizări**. ## De ce nu pornește automatizarea mea? [#waarom-start-mijn-automatisering-niet] Parcurge aceste puncte. 1. **Este pornită?** O automatizare al cărei comutator este oprit (filtrul **În pauză**) nu pornește. Dacă are probleme, nu ai putut-o activa. Vezi [Probleme și activare](/automatiseringen/problemen) 2. **Este evenimentul potrivit?** O rezervare nouă este `reservation:created`, o modificare este `reservation:updated`. Verifică și dacă evenimentul chiar apare la acțiunea pe care o faci 3. **Te oprește filtrul?** Evenimentele care nu trec de filtrul de la **Doar când** nu lasă nicio rulare. Folosește fila **Rulare de test** cu datele unui caz real ca să vezi ce condiție nu se potrivește. Fii atent la valorile câmpurilor cu alegere fixă: o stare de factură este, de exemplu, `BOOKED` 4. **Este activat Rulează o singură dată per înregistrare?** Atunci automatizarea nu pornește din nou pentru o factură sau o rezervare pentru care a rulat deja. Vezi [Rulează o singură dată per înregistrare](/automatiseringen/triggers#eén-keer-per-record-uitvoeren) 5. **Este un program?** Atunci pornește în minutul în care îi vine rândul. O oră fixă și un program folosesc fusul orar al organizației tale 6. **Tocmai ai activat-o sau modificat-o?** Poate dura o jumătate de minut până ce totul ia act 7. **Vin multe evenimente deodată?** Atunci rulările sunt procesate una câte una și poate dura puțin până ajunge rândul la a ta Dacă automatizarea pornește, dar apoi ceva nu merge bine, uită-te în fila **Rulări** ca să vezi ce s-a întâmplat și unde s-a blocat rularea. ## De ce pornește programul meu prea târziu? [#waarom-start-mijn-schema-te-laat] Programele sunt verificate în fiecare minut. O automatizare care pornește la o dată, la o oră sau după un program începe în acel minut. Un eveniment pornește imediat. ## Poate o automatizare să se pornească singură mereu? [#kan-een-automatisering-zichzelf-blijven-starten] În cadrul unui singur flux, nu. Dacă legi o ieșire astfel încât fluxul ar sări înapoi la un pas anterior, Tillor refuză acea linie. Un flux cu o astfel de buclă nu poate fi activat. Dacă o rulare ajunge totuși la un pas pe care l-a făcut deja, se oprește, în loc să repete pasul. Nici prin evenimente. Ce face un pas se întâmplă ca utilizatorul **Flux de lucru**, iar evenimentele provocate de **Flux de lucru** nu pornesc automatizări. O automatizare care pornește la `task:created` și face **Creează sarcină** nu pornește deci din nou la sarcina pe care a creat-o chiar ea. Asta se aplică și între automatizări: una nu o poate porni pe cealaltă. Dacă într-un timp scurt intră multe evenimente, de exemplu dintr-o trimitere mare, fiecare eveniment pornește o rulare. Tillor le procesează câteva deodată. Nu se pierde nimic, dar poate dura puțin. ## Ce limite există? [#welke-grenzen-gelden-er] | Ce | Limită | |---|---| | Pași într-o automatizare | 100 | | Ramuri într-un pas **Ramificare** | 8, pe lângă **Implicit** | | Conexiuni dintr-o ieșire | 1 pas. Dacă conectezi din nou, linia nouă o înlocuiește pe cea veche | | Lungimea numelui | 120 de caractere | | Lungimea descrierii | 500 de caractere | | Comentarii și cadre pe canvas | 50 la un loc | | Opțiuni la **Cere o decizie** | 8 | | Timp de așteptare al unei cereri API | 15 secunde | | Răspunsul din `{response.body}` | Primele 4000 de caractere | | Răspunsul din `{response.data}` | Până la 100.000 de caractere, mai mare rămâne gol | | Întârziere în secunde | Nu este exactă, poate veni câteva secunde mai târziu | | Programe | Verificare în fiecare minut | | Elemente într-un **Pentru fiecare** | 100 per dată | | Verificare la **Așteaptă până când** | Cel mult la fiecare 5 minute | | Conținutul unui webhook de intrare | 100 KB | | Rulări în fila **Rulări** | Ultimele 20 | ## Pot porni mai multe automatizări la același eveniment? [#kunnen-er-meerdere-automatiseringen-op-dezelfde-gebeurtenis-starten] Da. Fiecare automatizare activată al cărei declanșator și filtru se potrivesc pornește propria rulare. Nu te baza pe o ordine fixă. ## Pot face două lucruri deodată după o ieșire? [#kan-ik-na-één-uitgang-twee-dingen-tegelijk-laten-doen] Nu, o ieșire duce la un singur pas. Pune acțiunile una după alta sau creează o a doua automatizare cu același declanșator. ## Ce se întâmplă cu rulările în curs dacă schimb ceva? [#wat-gebeurt-er-met-lopende-uitvoeringen-als-ik-iets-verander] | Ce faci | Ce se întâmplă cu rulările | |---|---| | Modifici fluxul și salvezi | Rulările noi folosesc fluxul nou. Rulările deja în curs sau în așteptare se termină cu fluxul așa cum era | | Pui automatizarea în pauză | Rulările care așteaptă într-o întârziere se opresc imediat ce trece timpul de așteptare și primesc starea **Anulat**. Ce este deja în desfășurare în acel moment se termină. Dacă o pornești din nou înainte să treacă timpul de așteptare, rularea continuă normal | | Ștergi automatizarea | Rulările și istoricul sunt șterse. Rulările în așteptare se opresc | ## Ce se întâmplă dacă un pas eșuează? [#wat-gebeurt-er-als-een-stap-mislukt] Rularea se oprește cu starea **Eșuat**, iar pașii de după nu se mai execută. Cine a creat automatizarea primește un e-mail despre rularea eșuată, cel mult unul pe oră pentru fiecare automatizare. Tillor nu încearcă din nou pasul. La **Trimite webhook** și **Cerere API** poți prinde un eșec cu ieșirea **Eșuat**. La alte acțiuni activezi **Continuă când acest pas eșuează**: pasul primește atunci o ieșire **Eroare**, iar fluxul continuă de acolo. Vezi [Când un pas eșuează](/automatiseringen/acties#als-een-stap-mislukt). ## Se trimite ceva cu adevărat în timpul unui test? [#wordt-er-echt-iets-verstuurd-tijdens-een-test] Nu. O rulare de test nu trimite nimic, nu creează nimic și nu modifică nimic. Vezi [Testare și rulări](/automatiseringen/testen-en-uitvoeringen). ## Sunt datele mele stocate în siguranță? [#zijn-mijn-gegevens-veilig-opgeslagen] Fluxurile tale și istoricul rulărilor, inclusiv antetele cu chei sau token-uri, sunt stocate criptat. Pentru adresele de pe internet este permis doar `https`, iar adresele interne sunt refuzate. ## Îmi lipsește un eveniment, o condiție sau o acțiune [#ik-mis-een-gebeurtenis-voorwaarde-of-actie] Folosește **Solicită un pas** în editor. Vezi [Solicitarea unui pas sau a unui eveniment](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen). ## Pot gestiona automatizările și din propriul meu sistem? [#kan-ik-automatiseringen-ook-vanuit-mijn-eigen-systeem-beheren] Da, dacă integrarea ta are toate permisiunile. Vezi [Pentru dezvoltatori](/ontwikkelaars/automatiseringen). Începe cu un declanșator și o acțiune, lasă-le să ruleze câteva zile și verifică rulările. Abia apoi extinde cu condiții și întârzieri. # Exemplu: verificarea rulotei de închiriat (/ro-RO/automatiseringen/voorbeeld-nalopen) Acest exemplu construiește un flux cu un filtru, **Caută sarcină**, **Setează prioritatea sarcinii**, un **Dacă / altfel** și o sarcină cu subsarcini. Nu ai nevoie de nicio cerere API pentru el. În mediile demo ale Tillor, acest flux se află deja pregătit, ca exemplu în pauză, sub numele **Nalopen huurcaravan**. Îl poți privi acolo în timp ce construiești. ## Ce face fluxul [#wat-de-flow-doet] Un oaspete pleacă dintr-o rulotă fixă. Rulota trebuie verificată pentru următorul oaspete. - Dacă nu există încă o sarcină de verificare deschisă pentru acel teren, fluxul creează una, cu cinci subsarcini și un termen limită după 7 zile. Sarcina merge și la colegul care a oprit ocuparea - Dacă există deja o sarcină de verificare deschisă, de exemplu pentru că rulota s-a eliberat de două ori la scurt timp, fluxul nu creează a doua sarcină. În schimb, prioritatea sarcinii existente crește cu un nivel ```mermaid flowchart TD A["Bezetting gestopt
alleen stacaravans"] --> F{"Open nalooptaak?"} F -- Gevonden --> P["Prioriteit een stap hoger
tot Hoog"] F -- Niet gevonden --> B{"Door een collega gestopt?"} B -- Ja --> C["Nalooptaak maken
met naam van de collega"] B -- Nee --> D["Nalooptaak maken"] ``` Cei doi pași de sarcină de jos sunt aproape identici. Doar descrierea diferă: dacă sistemul a încheiat ocuparea, nu există niciun coleg de menționat. ## Ce îți trebuie [#wat-je-nodig-hebt] - Ai permisiunea **Gestionare automatizări** sau **Toate permisiunile** - În organizația ta există un tip de teren pentru rulote fixe, în acest exemplu **Stacaravan** - Opțional: un panou și o coloană pentru sarcinile de verificare ## Construirea fluxului [#de-flow-bouwen] ### 1. Creează un flux gol [#1-een-lege-flow-maken] 1. Mergi la **Admin > Automatizări** și dă clic pe **Automatizare nouă** 2. Alege **Pornește de la zero** 3. În firul de navigare de sus, completează numele **Nalopen huurcaravan** 4. Dă clic pe canvas, lângă pași, și completează în panou, la **Descriere**, la ce folosește fluxul ### 2. Setează declanșatorul [#2-de-trigger-instellen] 1. Dă clic pe declanșator. Lasă **Pornește de la** pe **Când se întâmplă ceva** 2. La **Eveniment** alege `occupation:ended`. Scrie *occupation* pentru a căuta 3. La **Numele pasului** dă pasului numele *Bezetting gestopt* Acum fluxul pornește la fiecare ocupare care se încheie. Tu îl vrei doar pentru rulote fixe: 1. La **Doar când** dă clic pe **Adaugă condiție** 2. Dă clic pe **Variabilă** și alege `occupation.terrain.terrainTypeId` 3. Lasă comparația pe **este** 4. La valoare alege tipul de teren **Stacaravan** ### 3. Caută o sarcină de verificare deschisă [#3-een-open-nalooptaak-zoeken] 1. Adaugă un pas **Caută sarcină**, conectează declanșatorul la el și dă-i numele *Open nalooptaak?* 2. La **Titlu** completează `Nalopen {occupation.terrain.name}` 3. Lasă activate **Legată de înregistrările evenimentului**, **Doar sarcini nefinalizate** și **Omite subsarcinile** Pasul caută acum o sarcină principală care nu este încă finalizată, care se numește exact *Nalopen* urmat de numele terenului și care este legată de același teren, același client sau aceeași rezervare. Apoi fluxul continuă pe **Găsită** sau **Negăsită**. ### 4. Ridică prioritatea [#4-de-prioriteit-verhogen] 1. Adaugă un pas **Setează prioritatea sarcinii**, dă-i numele *Prioriteit verhogen* și conectează la el ieșirea **Găsită** 2. Lasă **Sarcină** pe `{foundTask.id}` 3. Lasă **Modificare** pe **Cu un nivel mai sus** și **Crește până la** pe **Ridicată** ### 5. Verifică cine a oprit ocuparea [#5-nagaan-wie-de-bezetting-stopzette] 1. Adaugă un pas **Dacă / altfel**, conectează la el ieșirea **Negăsită** a pasului *Open nalooptaak?* și dă-i numele *Door een collega gestopt?* 2. Dă clic pe **Adaugă condiție** și alege la **Variabilă** `triggeredBy.id` 3. Alege comparația **nu este gol** `{triggeredBy.id}` este gol dacă sistemul a încheiat ocuparea, de exemplu o sarcină programată. Atunci fluxul merge pe **Nu**. ### 6. Creează sarcina [#6-de-taak-aanmaken] Adaugă un pas **Creează sarcină**, dă-i numele *Nalooptaak maken* și conectează la el ieșirea **Da**. Completează câmpurile astfel: | Câmp | Valoare | |---|---| | **Titlu** | `Nalopen {occupation.terrain.name}` | | **Descriere** | `Automatisch gegenereerd.`, un rând gol și `Bezetting stopgezet door @{triggeredBy.name}({triggeredBy.id})` | | **Prioritate** | **Scăzută** | | **Termen după** | 7 zile | | **Atribuie și persoanei care a cauzat evenimentul** | Activat | | **Leagă de înregistrări** | Activat | | **Subtaskuri** | Cinci rânduri: *Kuisen*, *Inboedel*, *Internet + TV*, *Kader QR code*, *Controleren op werkjes* | Cu `@{triggeredBy.name}({triggeredBy.id})` colegul este menționat în descriere. Dacă vrei ca sarcina să ajungă pe un panou, alege un panou la **Adaugă la panou** și o coloană la **Coloană**. Cine trebuie să primească mereu sarcina alegi la **Atribuie către**. Lasă titlul identic cu cel din *Open nalooptaak?*. Altfel, pasul de căutare nu va mai găsi sarcina data viitoare. ### 7. Sarcina pentru sistem [#7-de-taak-voor-het-systeem] 1. Dă clic pe pasul *Nalooptaak maken* și apoi pe **Duplică pasul** 2. Dă copiei numele *Nalooptaak maken (systeem)* și conectează la ea ieșirea **Nu** 3. Setează **Descriere** doar la `Automatisch gegenereerd.` ### 8. Testează și activează [#8-testen-en-inschakelen] 1. Verifică să nu existe sus în panou un buton cu probleme (precum **1 problemă**) 2. Deschide fila **Rulare de test** și dă clic pe **Rulează testul**. Vezi ce drum ia fluxul și ce titlu și descriere ar primi sarcina. Nu se creează nimic 3. Activează comutatorul **Activ** ## De ce doi pași în loc de unul [#waarom-twee-stappen-in-plaats-van-één] Poți folosi pașii **Caută sarcină** și **Setează prioritatea sarcinii** și separat. Dacă vrei, de exemplu, să nu faci nimic când sarcina există deja, nu conecta pur și simplu nimic la **Găsită**. Dacă vrei să dai sarcinii existente un comentariu sau altă stare, pune un alt pas după **Găsită**, precum **Setează starea** cu `{foundTask.id}`. ## Ce se întâmplă în practică [#wat-er-in-de-praktijk-gebeurt] | Situație | Ce face fluxul | |---|---| | Nicio sarcină de verificare deschisă pentru acest teren | Creează o sarcină nouă cu cinci subsarcini | | Sarcină deschisă cu prioritatea **Scăzută** | O setează pe **Medie** | | Sarcină deschisă cu prioritatea **Medie** | O setează pe **Ridicată** | | Sarcină deschisă cu prioritatea **Ridicată** sau **Urgentă** | Lasă prioritatea așa cum este | | Ocupare pe alt tip de teren | Nu pornește | Sarcina apare pe numele [**Flux de lucru**](/automatiseringen/workflow-gebruiker) și este legată de terenul și clientul ocupării, și de rezervare dacă există. Nu orice ocupare are o rezervare. Colegul care a oprit ocuparea apare ca persoană atribuită sarcinii. # Cine execută o automatizare? (/ro-RO/automatiseringen/workflow-gebruiker) O automatizare nu lucrează sub numele dumneavoastră. Toți pașii sunt executați de un utilizator fix al organizației dumneavoastră, numit **Flux de lucru**. ## Ce observați [#wat-je-ervan-merkt] - O sarcină creată de o automatizare apare pe numele **Flux de lucru** - Un comentariu adăugat de o automatizare printr-o [cerere API](/automatiseringen/acties/integraties#api-verzoek) apare tot pe numele **Flux de lucru** - În editor, în panoul din dreapta, cât timp nu ați selectat niciun pas, apare mementoul că pașii se execută ca utilizatorul **Flux de lucru** al organizației dumneavoastră, niciodată ca dumneavoastră Astfel este mereu clar ce a făcut un coleg și ce a făcut o automatizare. Numele dumneavoastră nu apare lângă ceva ce nu ați făcut chiar dumneavoastră. ## Ce este **Flux de lucru** [#wat-workflow-is] - Un utilizator de sistem, nu un coleg. Nu vă puteți autentifica cu el și nu are căsuță de e-mail - Există unul singur pe organizație. Există doar în organizația dumneavoastră și nu poate face nimic în altă parte - Are toate drepturile în organizația dumneavoastră, ca un administrator. Acesta este și motivul pentru care doar administratorii pot crea și modifica automatizări - Nu este membru al organizației, așa cum este un coleg Deoarece **Flux de lucru** are voie să facă orice, o automatizare poate face tot ce permite API-ul Tillor. O **Cerere API** poate, de exemplu, să modifice sau să șteargă date. Păstrați de aceea fluxurile mici și testați-le bine. ## Ce nu are voie să facă **Flux de lucru** [#wat-workflow-niet-mag] O automatizare nu poate crea, modifica, activa sau șterge automatizări și nu le poate vedea execuțiile. O cerere API în acest scop este refuzată. Astfel, un flux nu se poate modifica pe sine sau alt flux. ## Eveniment cauzat de **Flux de lucru** [#gebeurtenis-veroorzaakt-door-workflow] Ce face **Flux de lucru** cauzează evenimente obișnuite, de exemplu o sarcină nouă. În cronologie și în webhook-uri apare atunci **Flux de lucru** drept autor. Astfel de evenimente nu pornesc automatizări: un flux nu se poate porni pe sine sau alt flux. O execuție care așteaptă cu **Așteaptă un eveniment** își continuă totuși drumul: aceasta nu poate porni un flux nou, deci nici o buclă. Mai multe despre aceasta găsiți la [Întrebări frecvente](/automatiseringen/veelgestelde-vragen#kan-een-automatisering-zichzelf-blijven-starten). ## Cui atribuiți [#wie-wijs-je-toe] **Flux de lucru** nu este niciodată atribuit el însuși unei sarcini și nu primește niciodată o notificare de la **Notifică colegii**. Dacă doriți ca un coleg să preia sarcina, alegeți la **Atribuie către** un coleg sau bifați **Atribuie și persoanei care a cauzat evenimentul**. # Înregistrarea unei plăți (/ro-RO/betalingsverwerking/betaling-registreren) O plată se înregistrează pe o factură înregistrată contabil, cu un sold deschis. Ecranul de plată este același pentru toate metodele. Diferă doar câmpurile de sub **Metodă de plată**. ### Deschideți factura [#open-de-factuur] Mergeți la Administrare > Facturi sau deschideți factura din Clienți > client > Facturare. Factura trebuie să fie înregistrată contabil și să aibă un sold deschis. ### Faceți clic pe Efectuați o plată [#klik-op-maak-betaling] Se deschide ecranul **Plată nouă pentru** factură. Sus vedeți totalul facturii și suma rămasă de plată. ### Alegeți metoda de plată [#kies-de-betaalmethode] La **Metodă de plată** alegeți cum intră plata. Opțiunile pe care le vedeți depind de factură și de ce a configurat organizația dumneavoastră. - **Terminal** trimite cererea către un terminal de plată cu cardul. Consultați [Terminal](/betalingsverwerking/terminal). - **Numerar**, **Transfer bancar** și, eventual, **Altele** înregistrează bani care au intrat în afara Tillor. Consultați [Numerar și transfer bancar](/betalingsverwerking/contant). - **Transfer intern** mută soldul către o altă factură a aceluiași client. Consultați [Transfer intern](/betalingsverwerking/interne-overboeking). - **Mandat SEPA** încasează suma cu un mandat activ al clientului. Consultați [Încasarea unei facturi](/betalingsverwerking/incasso). ### Introduceți suma [#vul-het-bedrag-in] **Sumă** este implicit suma rămasă de plată. Cu butoanele 25%, 50%, 75% și 100% completați rapid o parte sau tastați dumneavoastră o sumă. Suma nu poate depăși suma rămasă de plată. ### Efectuați plata [#voer-de-betaling-uit] Faceți clic pe **Efectuează plata**. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Suma rămasă de plată și starea plății facturii se actualizează. Plata apare pe factură la **Plăți** și în Administrare > Plăți. Cum le regăsiți, aflați la [Regăsirea plăților](/betalingsverwerking/betalingen-bekijken). Preferă clientul să plătească singur? Trimiteți atunci factura cu **Trimiteți notificare**. Consultați [Plata online](/betalingsverwerking/online). ## Probleme? [#problemen] Butonul apare doar pe o factură înregistrată contabil, cu un sold deschis. O factură în ciornă o înregistrați mai întâi. O factură plătită integral nu mai are buton. Clientul nu are un mandat activ a cărui sumă maximă să fie suficient de mare pentru această sumă. La o notă de credit, metoda nu apare în listă. Consultați [Încasarea unei facturi](/betalingsverwerking/incasso). Terminal apare în listă doar dacă Mollie este conectat și organizația dumneavoastră poate primi plăți cu cardul. Consultați [Terminal](/betalingsverwerking/terminal). # Regăsirea plăților (/ro-RO/betalingsverwerking/betalingen-bekijken) Vedeți plățile în trei locuri: pe factura însăși, în prezentarea generală a tuturor plăților și în ecranul de detalii al unei plăți. ## Vizualizarea plăților unei facturi [#betalingen-van-een-factuur-bekijken] Deschideți factura și derulați până la **Plăți**. Vedeți doar plățile legate de această factură. ## Căutarea în toate plățile [#alle-betalingen-doorzoeken] Mergeți la Administrare > Plăți. Filtrați după dată, metodă de plată, stare sau client, ori căutați după numele clientului sau numărul facturii. Prin meniul de acțiuni (trei puncte) de la o plată puteți, în funcție de plată: | Acțiune | Ce face | |---|---| | **Detalii** | Deschide ecranul de detalii | | **PDF plată** | Creează o dovadă de plată | | **Sincronizați** | Preia starea actuală de la Mollie. Doar la plățile Mollie care există deja la Mollie | | **Omite întârzierea** | Trimite acum la bancă o încasare programată. Consultați [Încasarea unei facturi](/betalingsverwerking/incasso) | | **Dezasociați de factură** | Elimină plata de pe factură | | **Anulați** | Anulează o plată care nu este încă finalizată | | **Eliminați** | Șterge plata | ## Citirea detaliilor unei plăți [#de-details-van-een-betaling-lezen] Faceți clic pe **Detalii** pentru ecranul **Detalii plată**. Vedeți acolo suma, starea, metoda, factura și o cronologie. - **Data scadenței** apare la o încasare SEPA în curs. Starea arată atunci Așteptat cu acea dată. - **Trimite după** apare la o încasare pe care Tillor nu a trimis-o încă la bancă. - **Raport de plăți** arată raportul în care ajunge plata. Cât timp plata nu se află încă într-un raport, apare numărul raportului urmat de **(estimat)**. La o plată Mollie apare **La următoarea plată Mollie**, deoarece raportul se cunoaște abia la plată. Mai multe despre rapoarte găsiți la [Rapoarte de plăți](/boekhouden/betalingsrapporten). ## Etichete de stare [#statuslabels] | Stare | Semnificație | |---|---| | În curs | Plata este încă în desfășurare | | Autorizat | Aprobată, dar nefinalizată încă | | Plătit | Finalizată | | Eșuat | Nu a reușit | | Anulat | Întreruptă înainte să fie gata | | Expirat | Sesiunea de plată a expirat | | Rambursat și Rambursat parțial | Suma a fost returnată integral sau parțial | | Stornat | Banca sau emitentul cardului a retras suma | ## Urmărirea sumelor deschise [#openstaande-bedragen-opvolgen] Mergeți la Administrare > Facturi. Cardul **Facturi cu sold deschis** arată facturile înregistrate contabil care nu sunt încă plătite integral. În tabele filtrați după starea plății **Deschis** și sortați după data scadenței. ### Trimiterea unui memento [#een-aanmaning-versturen] Un memento se trimite pe factură, nu în masă. ### Deschideți factura [#open-de-factuur] Alegeți o factură care este încă deschisă. ### Trimiteți mementoul [#verstuur-de-aanmaning] Faceți clic pe **Trimiteți notificare** și alegeți **Trimiteți memento**. Confirmați trimiterea. Clientul primește un memento cu un link pentru plata online. Consultați [Plata online](/betalingsverwerking/online). ## Probleme? [#problemen] Folosiți **Sincronizați** din meniul de acțiuni al plății. Tillor preia atunci datele actuale. Ajută mai ales dacă o notificare de la Mollie a fost ratată. Acțiunea apare doar la plățile Mollie care au deja o tranzacție la Mollie. La o încasare pe care Tillor nu a trimis-o încă, nu există nimic de preluat. # Înregistrarea plăților în numerar și prin transfer bancar (/ro-RO/betalingsverwerking/contant) Cu **Numerar**, **Transfer bancar** și, eventual, **Altele** consemnați că un client a plătit în afara Tillor. Tillor nu trimite atunci nimic. Actualizează soldul deschis al facturii. - **Numerar**: clientul plătește cash la recepție. - **Transfer bancar**: ați primit un transfer bancar care nu a fost asociat automat facturii. - **Altele**: pentru alte plăți cu o descriere proprie, cum ar fi un cec sau un schimb. Metoda apare doar dacă organizația dumneavoastră a activat-o. ## Înregistrarea unei plăți [#een-betaling-registreren] ### Deschideți ecranul de plată [#open-het-betaalscherm] Deschideți o factură înregistrată contabil, cu sold deschis, și faceți clic pe **Efectuați o plată**. ### Alegeți metoda [#kies-de-methode] La **Metodă de plată** alegeți **Numerar** sau **Transfer bancar**. ### Introduceți suma [#vul-het-bedrag-in] Tastați o sumă sau folosiți butoanele 25%, 50%, 75% și 100%. ### Verificați data primirii [#controleer-de-datum-van-ontvangst] **Data primirii** este implicit astăzi. Modificați-o dacă banii au intrat într-o altă zi. ### Adăugați eventual un comentariu [#voeg-eventueel-een-opmerking-toe] La **Notă** puteți introduce un număr de referință sau o notiță. La **Altele** o descriere este obligatorie. ### Efectuați plata [#voer-de-betaling-uit] Faceți clic pe **Efectuează plata**. Data stabilește în ce raport de plăți ajunge plata. Dacă înregistrați astăzi o plată de ieri, setați data la ieri, astfel încât să fie completat raportul corect. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Plata apare imediat pe factură și în Administrare > Plăți. Consultați [Regăsirea plăților](/betalingsverwerking/betalingen-bekijken). La **Transfer bancar** puteți face ca clientul să primească și un e-mail cu sfatul de a folosi comunicarea structurată la transferurile următoare. Bifa **Trimiteți memento de comunicare structurată** se află în ecranul de plată. Bifa este gri dacă clientul nu are adresă de e-mail. ## Setări pentru plățile manuale [#instellingen-voor-handmatige-betalingen] La Asistență > Setări > Plăți găsiți aceste setări: | Setare | Ce face | |---|---| | **Afișați metoda de plată „Altele”** | Adaugă metoda **Altele** în ecranul de plată | | **Maxim numerar** | Cea mai mare sumă în numerar pe plată, implicit 2999 euro | | **Implicit: memento transfer bancar manual** | Bifează implicit memento-ul | | **Maxim numerar** | Cea mai mare sumă pe care o puteți înregistra ca plată în numerar, în euro întregi (implicit 2999) | ## Probleme? [#problemen] O plată în numerar nu poate depăși **Maxim numerar** de la Asistență > Setări > Plăți (implicit 2999 euro). Înregistrați suma în mai multe părți sau alegeți altă metodă. Metoda este dezactivată. Activați **Afișați metoda de plată „Altele”** la Asistență > Setări > Plăți. Plățile manuale nu sunt disponibile pentru fiecare factură. Ecranul vă anunță atunci. ## Vezi și [#zie-ook] # Grupuri de plăți (/ro-RO/betalingsverwerking/groepen) Un grup de plăți adună mai multe plăți primite sub un singur nume, astfel încât să le puteți asocia dintr-o dată unei facturi înregistrate contabil. Este util dacă doriți să reconciliați abia la sfârșitul zilei sau al unei activități. Exemple: - **Închiderea unei ture de casă**: toate plățile cu cardul din zi se află într-un grup. Îl asociați facturii cu încasările zilei. - **Facturarea unei activități**: participanții plătesc online în avans. La înregistrarea contabilă asociați întregul grup facturii. - **O rezervare cu avans și sold**: avansul și plata finală se află împreună într-un grup și sunt atribuite dintr-o dată. ## Regulile [#de-regels] - Un grup are starea Deschis (încă neasociat) sau Atribuit (deja asociat unei facturi). - Un grup nu are un client propriu. Clientul rezultă din factura căreia îi asociați grupul. - Plățile dintr-un grup le mutați doar împreună. O plată separată dintr-un grup nu poate fi atribuită altei facturi. - Puteți asocia un grup doar unei facturi înregistrate contabil. Facturile în ciornă se pot încă modifica sau dispărea. ## Asocierea unui grup la o factură [#een-groep-aan-een-factuur-koppelen] ### Deschideți grupurile de plăți [#open-de-betalingsgroepen] Mergeți la Administrare > Plăți și uitați-vă sub **Grupuri de plăți**. Lista arată implicit doar grupurile deschise. Modificați filtrul **Stare** pentru a vedea și grupurile atribuite. ### Alegeți Atribuiți [#kies-koppelen] Deschideți meniul de acțiuni (trei puncte) de la un grup deschis și alegeți **Atribuiți**. ### Alegeți factura [#kies-de-factuur] Selectați factura înregistrată contabil de care trebuie să se lege întregul grup. ### Confirmați [#bevestig] Faceți clic pe **Atribuiți** în fereastră. Toate plățile din grup merg dintr-o dată la acea factură, iar grupul primește starea Atribuit. Puteți face asta și de pe factură. Alegeți acolo **Atribuiți plata** în meniul de acțiuni, mergeți la fila **Grupuri de plăți** și faceți clic pe **Atribuiți grupul**. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Un grup atribuit apare pe PDF-ul facturii ca un rând cu totalul grupului. Plățile separate le deschideți în prezentarea plăților facturii. Grupul însuși îl regăsiți în detaliile fiecărei plăți care face parte din el. Dacă grupul conține o plată Mollie care există deja la Mollie, lângă **Atribuiți** apare și **Sincronizați**. Această acțiune preia dintr-o dată datele actuale ale tuturor plăților potrivite din grup. Ajută dacă aveți îndoieli privind starea sau dacă o notificare a fost ratată. Un grup gol îl puteți șterge cu **Șterge**. ## Cum ajung plățile într-un grup? [#hoe-komen-betalingen-in-een-groep] Sistemul dumneavoastră de casă sau de activități poate transmite un nume de grup la crearea unei plăți Mollie. Tillor creează atunci singur un grup sau folosește un grup deschis existent și pune plata în el. Câmpurile pentru aceasta se află la [Metadate Mollie](/ontwikkelaars/mollie-metadata#ingestie-hints-voor-betalingsgroepen). ## Probleme? [#problemen] Factura este încă o ciornă. Înregistrați-o mai întâi contabil, deoarece doar facturile înregistrate contabil pot primi un grup. Nu se poate pentru o plată care se află încă într-un grup. Lucrați la nivelul grupului. ## Vezi și [#zie-ook] # Încasarea unei facturi cu un mandat (/ro-RO/betalingsverwerking/incasso) Dacă un client are un mandat activ, Tillor poate încasa o factură din contul său bancar. Alegeți dumneavoastră cum: asociați mandatul facturii, astfel încât încasarea să pornească singură după înregistrarea contabilă, sau porniți încasarea manual cu **Efectuați o plată**. Un mandat îl solicitați prin [Semnarea unui mandat SEPA](/betalingsverwerking/mandaat). O notă de credit nu poate fi încasată. ## Încasarea automată a unei facturi [#een-factuur-automatisch-laten-innen] ### Deschideți factura [#open-de-factuur] Mergeți la Administrare > Facturi și deschideți o factură în ciornă sau înregistrată contabil a clientului. ### Alegeți mandatul [#kies-het-mandaat] La **Mandat de debit direct** alegeți mandatul clientului. În listă apar doar mandatele active. Alegeți **Fără mandat** pentru a elimina din nou asocierea. Câmpul spune ce se întâmplă: Tillor creează imediat o plată deschisă, iar banca este solicitată la două zile după înregistrarea contabilă. Până atunci puteți anula plata. ### Înregistrați factura contabil [#boek-de-factuur] După înregistrarea contabilă, la factură apare **Încasarea este programată pentru** cu data. În acea zi Tillor trimite încasarea la bancă. Dacă factura era deja înregistrată contabil când ați asociat mandatul, se aplică același termen de două zile din acel moment. Dacă Tillor a trimis deja încasarea la bancă, nu mai puteți modifica mandatul de pe factură. ### Suma maximă a unui mandat [#het-maximumbedrag-van-een-mandaat] Fiecare mandat are o sumă maximă. O vedeți în lista de mandate ca **max.** cu o sumă. Dacă o factură este mai mare: - mandatul apare gri în listă, cu mesajul că maximul este mai mic decât suma facturii; - factura afișează mesajul că suma facturii depășește maximul mandatului; - Tillor nu poate înregistra contabil o factură cu un astfel de mandat asociat. Alegeți atunci un mandat cu un maxim mai mare sau lăsați clientul să plătească în alt mod. ## Pornirea manuală a unei încasări [#een-incasso-handmatig-starten] ### Deschideți ecranul de plată [#open-het-betaalscherm] Deschideți factura înregistrată contabil și faceți clic pe **Efectuați o plată**. ### Alegeți Mandat SEPA [#kies-sepa-mandaat] La **Metodă de plată** alegeți **Mandat SEPA**. Dacă este gri, clientul nu are un mandat activ care să acopere suma. ### Alegeți mandatul și întârzierea [#kies-het-mandaat-en-de-vertraging] Selectați **Mandat**. Tillor alege singur primul mandat activ care acoperă suma. La **Întârziere (zile)** introduceți între 0 și 7 zile. Cu 0, încasarea merge imediat la bancă, cu un număr mai mare Tillor așteaptă atâtea zile. ### Efectuați plata [#voer-de-betaling-uit] Faceți clic pe **Efectuează plata**. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Plata apare la factură și în Administrare > Plăți. - Cât timp încasarea așteaptă, în detalii apare **Trimite după** cu data. Alegeți **Omite întârzierea** în meniul de acțiuni pentru a o trimite acum la bancă sau **Anulați** pentru a o opri. - După trimitere, plata are starea În curs cu **Data scadenței**. O încasare SEPA durează câteva zile. Apoi devine Plătit sau Eșuat dacă banca refuză încasarea. - O încasare în curs se numără deja în contabilitate ca plată în desfășurare. Dacă eșuează sau o anulați, dispare din nou din ciornă. Consultați [Rapoarte de plăți](/boekhouden/betalingsrapporten). - Clientul vede pe pagina de plată **Se încasează prin debitare directă** cu suma și data, fără butoane de plată. Astfel nimeni nu plătește de două ori. PDF-ul facturii și e-mailul facturii menționează suma și data încasării. Mica primă plată prin care un client și-a confirmat mandatul este dedusă de Tillor din factura următoare. ## Încasarea automată a facturilor de utilități [#nutsfacturen-automatisch-innen] Facturile de consum pentru apă, electricitate și gaz pot fi încasate automat cu mandatul clientului. - Dacă la semnare clientul bifează **Folosește acest mandat și pentru plata automată a facturilor de utilități (apă, curent, gaz)**, Tillor setează acest mandat imediat ce devine activ. Bifa este implicit activată. - Puteți alege mandatul și singur la Clienți > client > Facturare, în cardul **Setări de facturare**, la **Mandat**. - În lista de mandate, mandatul pentru utilități este marcat cu **Utilități**. O factură de consum nouă primește apoi singură acest mandat ca **Mandat de debit direct**. ## Probleme? [#problemen] Clientul nu are un mandat cu starea Activ al cărui maxim să fie suficient de mare. Verificați cardul **Mandate** la Clienți > client > Facturare. Mandatul asociat are un maxim mai mic decât suma facturii. Alegeți alt mandat sau eliminați mandatul de pe factură. Tillor a trimis deja încasarea la bancă. Urmăriți plata în Administrare > Plăți. Deschideți plata pentru motiv. Factura este din nou deschisă. Alegeți **Efectuați o plată** pentru o nouă încasare sau altă metodă, ori trimiteți clientului un link de plată cu **Trimiteți notificare**. Cât timp plata de la Administrare > Plăți afișează încă **Trimite după**, o puteți anula. Dacă a fost deja trimisă, nu se mai poate. Puteți totuși revoca mandatul pentru facturile următoare, consultați [Revocarea unui mandat](/betalingsverwerking/mandaat-beheren). Și automatizările pot încasa: pasul [Încasează prin debit direct](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring). ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/betalingsverwerking) O plată în Tillor este de obicei legată de o factură înregistrată contabil. Clientul poate plăti singur online, dumneavoastră puteți înregistra o plată la recepție sau Tillor încasează automat suma printr-un mandat SEPA. Pe această pagină vedeți ce metodă folosiți pentru ce. - O plată este legată de o factură înregistrată contabil. Pe o ciornă nu se poate plăti. - O plată în numerar poate fi implicit de cel mult 2999 euro. Modificați aceasta cu **Maxim numerar** la Asistență > Setări > Plăți. - Peste 2500 de euro, pagina de plată avertizează clientul că banca sau cardul poate refuza plata online. Clientul primește atunci IBAN-ul și comunicarea structurată pentru a face un transfer. - O încasare cu mandat merge la bancă la două zile după înregistrarea contabilă. La **Efectuați o plată** alegeți dumneavoastră o întârziere de 0 până la 7 zile. Până la plecarea încasării o puteți anula. - Dacă o factură depășește maximul mandatului, nu puteți încasa. Dacă acel mandat se află pe factură, nici factura nu o puteți înregistra contabil. - Linkul de semnare al unui mandat este valabil 14 zile. Tillor reamintește clientului după 7 zile, cu 2 zile înainte de expirare și în ultima zi. - Un transfer intern este posibil doar între două facturi înregistrate contabil ale aceluiași client. - Tillor nu poate rambursa bani unui client. O rambursare o rezolvați în afara Tillor, de exemplu cu un transfer bancar. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Fiecare metodă se încheie în același loc: o plată pe factură. Apoi continuă spre raportul de plăți și contabilitatea dumneavoastră. ```mermaid flowchart LR F[Factură înregistrată] --> M{Metodă de plată} M -- Online --> P[Plată] M -- Terminal --> P M -- Numerar sau transfer --> P M -- Încasare SEPA --> P M -- Transfer intern --> P P -- Stare și sold --> F P -- Pe zi --> R[Raport de plăți] R --> B[Contabilitate] ``` O încasare rămâne mai întâi În curs. Factura apare atunci deja ca plătită (în curs). Dacă încasarea eșuează, factura este din nou deschisă. Rapoartele de plăți și legătura cu software-ul de contabilitate se află la [Contabilitate](/boekhouden). ## Ce metodă alegeți? [#welke-methode-kies-je] | Metodă | Când | Cum plătește clientul | Ce înregistrează Tillor | |---|---|---|---| | [Plata online](/betalingsverwerking/online) | Clientul plătește singur, de acasă sau din mers | Prin linkul din e-mailul sau SMS-ul facturii, cu iDEAL, Bancontact, card de credit sau altă metodă | Plata imediat ce partenerul de plată o confirmă, chiar dacă clientul nu mai face nimic | | [Terminal](/betalingsverwerking/terminal) | Clientul se află la recepție | Cu cardul sau telefonul pe un terminal de plată Mollie | Plata imediat ce terminalul o finalizează | | [Numerar și transfer bancar](/betalingsverwerking/contant) | Bani primiți în afara Tillor | Cash la recepție sau un transfer bancar | Plata pe care o înregistrați dumneavoastră, cu data primirii | | [Mandat SEPA](/betalingsverwerking/incasso) | Facturi recurente sau mari, consum | Nu plătește. Tillor încasează suma din contul bancar | O plată în curs până când banca confirmă încasarea | | [Transfer intern](/betalingsverwerking/interne-overboeking) | Mutarea soldului între două facturi ale aceluiași client | Nu plătește. Nu intră bani | Două plăți legate, una pozitivă și una negativă | Plățile online, plățile cu cardul și încasările trec prin Mollie. Plățile în numerar și transferurile le înregistrați dumneavoastră. } description="Ecranul de plată pe o factură înregistrată contabil" /> } description="Pe factură, în prezentarea generală și în detalii" /> } description="Pagina de plată pe care o vede clientul" /> } description="Plăți cu cardul la recepție" /> } description="Înregistrarea plăților în afara Tillor" /> } description="Mutarea soldului între facturi" /> } description="La distanță sau la recepție" /> } description="Încasare automată cu un mandat" /> } description="Gruparea plăților și asocierea lor dintr-o dată" /> } description="Exemple detaliate din practică" /> ## Termeni [#begrippen] - **Plată**: o sumă primită sau în curs, cu o metodă, o stare și, de obicei, o factură. - **Mandat**: acordul unui client de a încasa facturi din contul său bancar. Consultați [Mandat SEPA](/betalingsverwerking/mandaat). - **Grup de plăți**: un set de plăți pe care îl atribuiți ulterior dintr-o dată unei facturi. Consultați [Grupuri de plăți](/betalingsverwerking/groepen). - **Raport de plăți**: prezentarea zilnică a plăților primite pentru contabilitate. Consultați [Rapoarte de plăți](/boekhouden/betalingsrapporten). - **Transfer intern**: mutarea soldului între două facturi ale aceluiași client, fără să intre bani. - **Încasare**: Tillor ia suma din contul bancar al clientului, cu mandatul său. - **Client**: clientul căruia îi aparține factura. Consultați [Client](/begrippen#klant). # Crearea unui transfer intern (/ro-RO/betalingsverwerking/interne-overboeking) Cu **Transfer intern** mutați o sumă de la o factură înregistrată contabil la o altă factură înregistrată contabil a aceluiași client. Nu intră bani. Tillor creează o plată pozitivă pe factura pe care o închideți și o plată negativă legată pe factura de destinație. Aceasta nu este o plată în numerar, cu cardul sau prin transfer bancar. Acele metode apar separat în ecranul de plată. ## Înregistrarea unui transfer intern [#een-interne-overboeking-registreren] ### Deschideți ecranul de plată [#open-het-betaalscherm] Deschideți factura înregistrată contabil cu sold deschis și faceți clic pe **Efectuați o plată**. ### Alegeți Transfer intern [#kies-interne-overboeking] La **Metodă de plată** alegeți **Transfer intern**. ### Alegeți factura de destinație [#kies-de-doelfactuur] La **Factura destinație** selectați factura înregistrată contabil către care merge suma. Lista arată doar facturi înregistrate contabil ale aceluiași client. ### Introduceți suma [#vul-het-bedrag-in] Tastați o sumă sau folosiți butoanele 25%, 50%, 75% și 100%. ### Efectuați plata [#voer-de-betaling-uit] Completați eventual **Data primirii** și faceți clic pe **Efectuează plata**. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Tillor creează două plăți legate, **Transfer intern de la** și **Transfer intern către**, fiecare cu numărul facturii celeilalte facturi. - Soldul deschis al ambelor facturi se actualizează. - Dacă ștergeți una dintre cele două plăți, Tillor o șterge și pe cealaltă. ## Transferul intern și contabilitatea [#interne-overboeking-en-boekhouding] - Un transfer intern apare pe raportul de plăți din ziua în care îl înregistrați. Dacă îl înregistrați astăzi, apare imediat pe [raportul în ciornă](/boekhouden/betalingsrapporten#concept-en-definitief) de astăzi. - Ajunge în exportul contabil, împreună cu plățile Mollie. - Plățile în numerar, transferurile bancare și conturile bancare nu ajung în exportul contabil. ## După stornarea unei facturi cu Prelungiți ocuparea [#na-het-omkeren-van-een-factuur-met-bezetting-verlengen] Cu **Stornați factura** transformați o factură într-o notă de credit. Un transfer intern între acele două facturi este doar o compensare în contabilitate. Nu prelungește și nu scurtează încă o dată ocuparea. Ce înseamnă aceasta pentru **Plătit până la**: - Pe factura inițială, **Plătit până la** nu se schimbă. - Pe nota de credit, **Plătit până la** se întoarce doar dacă factura inițială fusese deja plătită cu o plată reală, cum ar fi numerar, transfer bancar sau Mollie. Dacă fusese compensată doar printr-un transfer intern, **Plătit până la** rămâne la fel. - **Facturat până la** a fost deja ajustat la înregistrarea contabilă. ## Probleme? [#problemen] Apar doar facturi înregistrate contabil ale aceluiași client. Înregistrați mai întâi o factură în ciornă și nu alegeți aceeași factură pe care creați plata. ## Vezi și [#zie-ook] # Revocarea sau retrimiterea unui mandat (/ro-RO/betalingsverwerking/mandaat-beheren) Toate acțiunile pentru un mandat se află în meniul (trei puncte) de la rândul din cardul **Mandate**. Găsiți acel card la Clienți > client > Facturare. Acțiunile pe care le vedeți depind de stare. | Stare | Acțiuni în meniu | |---|---| | Așteaptă semnătura | **Afișează pe iPad**, **Trimite memento**, **Retrimite linkul de semnare**, **Anulează cererea** | | Link expirat | **Retrimite linkul de semnare**, **Anulează cererea** | | Activarea a eșuat | **Anulează cererea** | | Activ | **Deschide mandatul semnat**, **Revocă mandatul** | | Revocat | **Deschide mandatul semnat** | **Afișează pe iPad** apare doar dacă aplicația Tillor este online pe un dispozitiv al organizației dumneavoastră. ## Retrimiterea unei cereri deschise [#een-openstaande-aanvraag-opnieuw-versturen] ### Deschideți meniul de la cerere [#open-het-menu-bij-de-aanvraag] Căutați cererea cu starea Așteaptă semnătura sau Link expirat. ### Alegeți acțiunea [#kies-de-actie] - **Trimite memento** trimite din nou un e-mail clientului, cu un link nou. Data de încheiere nu se schimbă. - **Retrimite linkul de semnare** trimite prin e-mail un link nou, valabil din nou 14 zile. Un link trimis anterior nu mai funcționează după niciuna dintre acțiuni. Tillor afișează **Memento trimis** sau **Linkul de semnare a fost retrimis**. Clientul primește un e-mail. Cum funcționează mementourile automate găsiți la [Semnarea unui mandat SEPA](/betalingsverwerking/mandaat#herinneringen-voor-het-tekenen). ## Anularea unei cereri [#een-aanvraag-annuleren] Alegeți **Anulează cererea** dacă clientul nu mai trebuie să semneze. Cererea primește starea Anulat. Dacă se află pe tabletă, dispare de acolo. Apoi puteți porni o cerere nouă. ## Revocarea unui mandat activ [#een-actief-mandaat-intrekken] Revocați un mandat dacă clientul nu mai poate fi debitat, de exemplu în caz de mutare, de contract reziliat sau la cererea clientului. Pentru plata automată este necesar apoi un mandat nou, cu o nouă semnătură a clientului. ### Alegeți Revocă mandatul [#kies-mandaat-intrekken] Deschideți meniul de la mandatul activ și alegeți **Revocă mandatul**. ### Confirmați [#bevestig] În ecranul **Revoci acest mandat?** faceți clic pe **Revocă**. Tillor afișează **Mandat revocat**. Ce se întâmplă apoi: - Nu se mai încasează facturi prin acest mandat. Încasările pe care Tillor nu le trimisese încă la bancă sunt anulate. - Starea mandatului devine Revocat. - Documentul semnat este păstrat ca dovadă, dar este mutat în arhivă. La documentele clientului îl găsiți sub **Arhivate**, astfel încât lista să arate doar mandatele care încă sunt valabile. - Clientul primește un e-mail că mandatul a fost revocat, cu o copie a documentului semnat. Mandatele configurate în afara Tillor afișează în meniu doar **Revocă mandatul**. ## Probleme? [#problemen] Acțiunea apare doar la un mandat cu starea Activ. O cerere care nu este încă semnată o anulați cu **Anulează cererea**. Revocarea anulează doar încasările pe care Tillor nu le trimisese încă la bancă. O încasare care este deja în drum o urmăriți la Administrare > Plăți. Alegeți mandatul la **Mandat de debit direct** pe factură. Consultați [Încasarea unei facturi](/betalingsverwerking/incasso). ## Vezi și [#zie-ook] # Semnarea unui mandat SEPA (/ro-RO/betalingsverwerking/mandaat) Cu un mandat SEPA, un client își dă acordul ca facturile să fie încasate automat din contul său bancar. Clientul semnează mandatul chiar în Tillor. Tillor păstrează documentul semnat la client, iar apoi puteți încasa facturi. Aceasta se află la [Încasarea unei facturi](/betalingsverwerking/incasso). Înainte de a începe: - Mandatele trebuie să fie activate pentru organizația dumneavoastră. Dacă nu sunt, butonul **Creați mandat** vă anunță că trebuie să contactați administratorul. - Clientul are nevoie de o adresă de e-mail. - Un client poate avea o singură cerere deschisă în același timp. ## Solicitarea unui mandat [#een-mandaat-aanvragen] ### Deschideți clientul [#open-de-klant] Mergeți la Clienți > client > Facturare. Jos se află cardul **Mandate** cu toate mandatele și cererile clientului. ### Faceți clic pe Creați mandat [#klik-op-mandaat-aanmaken] Se deschide un meniu cu una sau două opțiuni. Alegeți cum semnează clientul. Alegeți **Trimite invitația de mandat**. Clientul primește un e-mail cu un link către pagina de semnare, iar Tillor afișează **Mandatul a fost trimis spre semnare la** adresa de e-mail a clientului. Linkul este valabil 14 zile, inclusiv ultima zi. Clientul nu trebuie să introducă un IBAN. El alege singur cum confirmă mandatul. Alegeți **Semnare pe iPad-ul de la recepție**. Mandatul apare pe tableta de la recepție, iar Tillor afișează **Mandatul este pe iPad, clientul poate semna**. Această opțiune apare în meniu doar dacă aplicația Tillor este online pe un dispozitiv al organizației dumneavoastră. Consultați [Tablete și kioske](/mobiele-app/tablets-en-kiosken). Clientul semnează cu degetul pe tabletă. Documentul semnat consemnează că a fost semnat la recepție și ce coleg a folosit tableta. Cererea a fost deja trimisă și doriți totuși să o afișați pe tabletă? Deschideți meniul de la cerere și alegeți **Afișează pe iPad**. ## Ce face clientul? [#wat-doet-de-klant] Clientul parcurge mai multe ecrane. Pe tabletă sunt aceleași ecrane, cu câteva diferențe indicate mai jos. ### Vizualizarea mandatului [#het-mandaat-bekijken] Pagina **Semnează mandatul SEPA pentru** organizația dumneavoastră arată cine este creditorul, pentru cine încasează și ce fel de plată este. Clientul atinge **Semnează mandatul**. ### Acceptarea textului [#de-tekst-accepteren] Clientul citește rezumatul sau, prin **Citește textul complet al mandatului**, întregul text și bifează că este de acord. Dedesubt se află o a doua bifă pentru a folosi mandatul și la facturile de utilități (apă, electricitate, gaz). Această bifă este implicit activată. Consultați [Încasarea unei facturi](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen). ### Semnarea [#tekenen] Clientul semnează cu degetul sau cu mouse-ul. ### Alegerea confirmării [#de-bevestiging-kiezen] Sub **Cum vrei să autorizezi?** clientul alege între două moduri de confirmare. - **O mică primă plată** cu propria bancă sau propriul card, de exemplu prin iDEAL, Bancontact, card de credit sau Apple Pay. Suma este între 0 și 1 euro, în funcție de metodă. Banca confirmă astfel că este contul clientului, iar clientul nu trebuie să copieze un IBAN. Tillor deduce suma din factura următoare. - **Cont bancar (SEPA)**: clientul își introduce IBAN-ul, confirmă că contul este al lui și introduce un cod din șase cifre. Codul vine prin SMS pe numărul de telefon al clientului sau prin e-mail dacă nu se cunoaște un număr. Pe tabletă, calea cu IBAN funcționează la fel: codul ajunge prin SMS pe telefonul clientului. Dacă clientul alege prima plată, tableta afișează un cod QR pe care clientul îl scanează cu telefonul pentru a plăti. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Mandatul apare în listă cu starea Semnat, se activează sau Așteaptă prima plată dacă clientul a ales mica plată. - Imediat ce mandatul este valid la partenerul de plată, starea devine Activ. Clientul primește prin e-mail o copie a mandatului semnat. - Tillor păstrează documentul semnat la documentele clientului. Îl deschideți din meniul de la mandat cu **Deschide mandatul semnat**. Documentul este sigilat și are o ștampilă de timp, astfel încât o modificare ulterioară să fie vizibilă într-un cititor PDF. Consultați [Sigiliu și ștampilă de timp](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel). - Dacă fereastra clientului a fost închisă înainte ca prima plată să fie gata, cererea rămâne deschisă. Clientul poate încerca din nou prin același link sau poate trece la IBAN. ## Stări [#statussen] | Stare | Semnificație | |---|---| | Așteaptă semnătura | Clientul nu a semnat încă | | Semnat, se activează | Semnat cu IBAN, Tillor creează mandatul | | Așteaptă prima plată | Semnat, mica plată trebuie încă să reușească | | Activ | Puteți folosi mandatul pentru încasare | | Activarea a eșuat | Partenerul de plată a refuzat mandatul. Tillor încearcă din nou mai târziu | | Link expirat | Clientul nu a semnat în 14 zile | | Anulat | Ați anulat cererea | | Revocat | Mandatul activ a fost revocat | Mandatele configurate în afara Tillor afișează stările În curs, Activ, Inactiv și Anulat. Doar un mandat activ poate fi folosit pentru încasare. ## Memento-uri pentru semnare [#herinneringen-voor-het-tekenen] Tillor trimite singur clientului memento-uri prin e-mail cât timp cererea rămâne deschisă: când mai sunt 7 zile, cu două zile înainte de expirare și în ultima zi. Fiecare memento conține un link de semnare proaspăt. Doriți să îl îndemnați dumneavoastră pe client? Alegeți în meniul de la cerere **Trimite memento**. Data de încheiere rămâne atunci aceeași. Dacă linkul a expirat sau doriți să acordați din nou 14 zile, alegeți **Retrimite linkul de semnare**. Mai multe despre aceste acțiuni găsiți la [Revocarea sau retrimiterea unui mandat](/betalingsverwerking/mandaat-beheren). Doriți ca o automatizare să reacționeze când o cerere expiră? Pentru aceasta există declanșatorul **Cerere de mandat expirată**, consultați [Automatizări](/automatiseringen). ## Probleme? [#problemen] Treceți cu mouse-ul peste buton pentru motiv. De obicei clientul nu are adresă de e-mail sau mandatele nu sunt activate pentru organizația dumneavoastră. Adăugați o adresă de e-mail clientului sau rugați administratorul să activeze mandatele. Pe client poate fi deschisă o singură cerere în același timp. Retrimiteți cererea existentă sau anulați-o, apoi creați una nouă. Opțiunea apare doar dacă aplicația Tillor a avut recent contact cu Tillor pe un dispozitiv al organizației dumneavoastră. Deschideți aplicația pe tabletă, așteptați puțin și încercați din nou. Codul merge la numărul de telefon din profilul clientului. Verificați că este corect. Dacă clientul nu are număr, codul vine prin e-mail. Clientul poate cere un cod nou. Clientul vede **Acest link de semnare a expirat**. Alegeți la cerere **Retrimite linkul de semnare**. Partenerul de plată a refuzat mandatul. Tillor încearcă din nou automat mai târziu. Dacă nu reușește în mod constant, anulați cererea cu **Anulează cererea** și rugați clientul să semneze din nou, eventual cu altă confirmare. ## Vezi și [#zie-ook] # Plata online a unui client (/ro-RO/betalingsverwerking/online) Plata online se face prin pagina de plată personală a unei facturi. Clientul deschide pagina, alege o metodă de plată și finalizează plata la banca sau la emitentul cardului său. Tillor colaborează pentru aceasta cu [Mollie](https://www.mollie.com), deci Mollie trebuie să fie conectat. Nu există un buton separat pentru trimiterea linkului de plată. Partajați pagina cu o notificare sau cu URL-ul personal al facturii. Înainte de a începe: - Factura este înregistrată contabil și are o sumă deschisă. Altfel clientul nu are nimic de plătit. - Mollie este conectat. Fără metode de la Mollie, clientul vede doar un buton de plată, consultați [Probleme?](#problemen). - Clientul are o adresă de e-mail sau un număr de telefon, ori partajați linkul dumneavoastră. ## Trimiterea linkului de plată clientului [#de-betaallink-naar-de-klant-sturen] ### Înregistrați factura contabil [#boek-de-factuur] Plata online este posibilă doar pe o factură înregistrată contabil, cu sold deschis. ### Trimiteți o notificare [#verstuur-een-notificatie] Faceți clic pe **Trimiteți notificare** și alegeți un canal, cum ar fi e-mail sau SMS. Clientul primește un mesaj cu butonul **Vizualizați și plătiți online**. Preferați să partajați dumneavoastră? Deschideți meniul de acțiuni (trei puncte) de pe factură și alegeți **URL personal**. Tillor copiază linkul în clipboard. Un memento cu același link îl trimiteți cu **Trimiteți memento**, consultați [Regăsirea plăților](/betalingsverwerking/betalingen-bekijken#een-aanmaning-versturen). Clientul vrea să plătească doar o parte? Creați atunci un [link pentru o plată parțială](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). ## Ce vede clientul? [#wat-ziet-de-klant] Clientul deschide pagina **Factura ta de la** organizația dumneavoastră. Acolo se află suma de plătit, o prezentare a rândurilor facturii și un buton pentru a vedea factura. De la acel ecran clientul continuă în trei pași. ### Plătește [#betaal] Clientul atinge **Plătește** cu suma. Dacă există un buton Apple Pay, clientul poate plăti direct cu el. ### Alegeți o metodă [#kies-een-methode] Sub **Cum dorești să plătești?** apar metodele disponibile, cum ar fi iDEAL, Bancontact și card de credit. Ordinea vine de la Mollie și se adaptează la limba clientului. Se aplică aceste reguli: - Metoda pe care clientul a folosit-o data trecută pe acel dispozitiv apare cu **Folosit ultima dată**. - Pentru clienții francofoni, Pay By Bank apare primul cu **Adesea cea mai bună opțiune**. - Dacă o metodă are o problemă la Mollie, apare un avertisment, de exemplu că metoda este parțial indisponibilă sau în mentenanță. Clientul poate totuși încerca metoda, dar mesajul spune că ar putea să nu reușească. Textul problemei vine de la Mollie. ### Finalizați plata [#rond-de-betaling-af] Ce se întâmplă apoi depinde de metodă și de dispozitiv. Consultați mai jos. ### Finalizarea pe computer sau pe telefon [#afronden-op-computer-of-telefoon] La iDEAL și Bancontact, Tillor afișează un cod QR sub **Scanează pentru a plăti**. Clientul deschide aplicația băncii pe telefon și scanează codul. Pagina merge mai departe singură imediat ce plata a intrat. Dacă clientul preferă să plătească pe computer, poate face acest lucru cu **Plătește în browser**. La Bancontact, Tillor afișează butonul **Deschide aplicația Bancontact**. Clientul finalizează plata în aplicație și apoi revine la pagină. Prin **Plătește în browser**, clientul poate plăti și pe telefon în browser. La alte metode, cum ar fi cardul de credit, Tillor redirecționează clientul către pagina de plată a partenerului de plată și apoi îl aduce înapoi. Dacă redirecționarea nu se face singură, apare un link pentru a continua. ### Dacă nu reușește [#als-het-niet-lukt] - **Alege altă metodă** readuce clientul la listă. - **Ia-o de la capăt** pornește o plată nouă cu aceeași metodă. Util dacă clientul a anulat în aplicația băncii sau nu s-a întâmplat nimic. - La o plată eșuată, anulată sau expirată, pagina anunță rezultatul, iar clientul poate alege altă metodă. ## Ce mai poate afișa pagina [#wat-de-pagina-nog-meer-kan-tonen] | Situație | Ce vede clientul | |---|---| | Factura este plătită | **Plătită integral** cu suma primită și o confirmare prin e-mail | | Banca a pornit un transfer | **Confirmăm plata ta**. La Pay By Bank durează de obicei câteva secunde și cel mult câteva zile lucrătoare | | O încasare SEPA este programată | **Se încasează prin debitare directă** cu suma și data. Clientul nu trebuie să facă nimic. Opțiunile de plată nu apar, astfel încât nimeni să nu plătească de două ori | | Suma este mai mare de 2.500 de euro | Un avertisment că banca sau cardul poate refuza plata online din cauza limitelor, cu IBAN-ul și comunicarea structurată pentru a face un transfer | | Plata online nu este posibilă pentru această factură | **Plătește prin transfer bancar** cu datele bancare | ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Linkul personal nu are dată de expirare. Clientul îl poate deci deschide și mai târziu. Imediat ce Mollie confirmă plata, aceasta apare pe factură și în Administrare > Plăți. Factura trece la Plătit dacă întreaga sumă a intrat. Nu trebuie să înregistrați nimic dumneavoastră. Consultați [Regăsirea plăților](/betalingsverwerking/betalingen-bekijken) pentru stări. ## Probleme? [#problemen] Mollie nu transmite atunci nicio metodă. Clientul vede doar butonul de plată și merge cu el direct la pagina de plată Mollie. Dacă rămâne așa, verificați conexiunea cu Mollie. Deschideți plata prin Administrare > Plăți și folosiți **Sincronizați**. La Pay By Bank, confirmarea poate dura câteva zile lucrătoare. Mollie anunță că metoda are probleme. Clientul poate alege altă metodă sau poate încerca mai târziu. Integrați un sistem propriu cu plățile Mollie? Consultați [Metadate Mollie](/ontwikkelaars/mollie-metadata). ## Vezi și [#zie-ook] # Plata cu un terminal de plată (/ro-RO/betalingsverwerking/terminal) Cu metoda de plată **Terminal** trimiteți suma rămasă de plată a unei facturi către un terminal de plată de la recepție. Clientul plătește cu cardul sau cu telefonul, iar Tillor înregistrează plata imediat ce terminalul o finalizează. Tillor este partener tehnologic [Mollie](https://www.mollie.com) exclusiv pentru plata cu cardul. Tillor furnizează terminalele Mollie și configurează împreună cu dumneavoastră Mollie Connect, dispozitivul și legătura cu factura. Întrebările despre plata cu cardul la recepție ajung, așadar, la Tillor. Tillor nu conectează terminale Worldline, CCV sau alte terminale de plată. Dacă aveți deja un astfel de terminal, primiți de la noi un dispozitiv Mollie. Astfel, plata online, plata cu cardul și [raportul de plăți](/boekhouden/betalingsrapporten) rămân un singur lanț. ## Pornirea unei plăți cu cardul [#een-pinbetaling-starten] ### Deschideți ecranul de plată [#open-het-betaalscherm] Deschideți o factură înregistrată contabil, cu sold de plată, și faceți clic pe **Efectuați o plată**. ### Alegeți Terminal [#kies-terminal] La **Metodă de plată** alegeți opțiunea **Terminal**. ### Alegeți terminalul [#kies-de-terminal] Selectați terminalul de la recepție. Tillor afișează doar terminalele disponibile în acel moment. Dacă aveți unul singur, acesta este deja selectat. ### Introduceți suma [#vul-het-bedrag-in] Tastați o sumă sau folosiți butoanele 25%, 50%, 75% și 100%. O sumă parțială este utilă la un avans sau atunci când clientul plătește o parte în numerar și o parte cu cardul. ### Trimiteți plata [#stuur-de-betaling] Faceți clic pe **Efectuează plata**. Apare ecranul **Se procesează plata** în timp ce Tillor trimite cererea către terminal. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Ecranul urmărește plata în direct. Clientul plătește la terminal, iar ecranul trece de la **Plată în curs** la **Plată reușită**. Se închide singur după câteva secunde, iar soldul rămas de plată al facturii este actualizat. Cât timp terminalul așteaptă, puteți bifa două opțiuni: - **Imprimați A4 când este plătit** pune PDF-ul facturii în coada imprimantei A4 imediat ce plata reușește. Opțiunea este gri dacă niciun conector nu este online. - **Trimiteți e-mail după plată** trimite factura clientului prin e-mail imediat ce plata reușește. Opțiunea este gri dacă clientul nu are adresă de e-mail. Dacă plata eșuează sau expiră, primiți mesajul **Plată eșuată** sau **Plată expirată**. Faceți clic pe **Retrimiteți la terminal** pentru a încerca din nou. ## Setarea terminalului implicit [#de-standaardterminal-instellen] Tillor activează dispozitivul de plată cu contul dumneavoastră Mollie. După conectarea Mollie, Tillor alege singur terminalul dacă există exact un terminal activ. Pe un altul îl alegeți la Setări > Integrări, la Mollie, în câmpul **Terminal implicit** (lângă **Profil principal**). Tillor propune apoi acel terminal la o plată cu cardul. ## Probleme? [#problemen] Metoda apare abia după ce Mollie este conectat și contul dumneavoastră are un terminal asociat. Verificați conectarea la Setări > Integrări. Tillor afișează doar terminalele online și active. Verificați dacă terminalul este pornit și conectat, apoi încercați din nou. După o nouă încercare, o plată veche cu statusul În curs poate rămâne în listă. Anulați-o la Administrare > Plăți cu **Anulare** în meniul de acțiuni, astfel încât factura să fie corectă. Trimiteți un e-mail la **support@tillor.eu**. ## Vezi și [#zie-ook] # Ocupări (/ro-RO/bezettingen) O ocupare stabilește că un client folosește o anumită parcelă (un loc de camping, un stâlp electric și altele asemenea). Cât timp ocuparea este activă, Tillor atribuie automat clientului consumul contoarelor de pe acea parcelă. Gestionați ocupările în profilul clientului. Începeți cu [Crearea unei ocupări](#een-bezetting-aanmaken). - O parcelă poate fi ocupată de un singur client la un moment dat. Parcelele cu o ocupare activă nu apar în lista de alegere. - **Plătit până la** acceptă doar astăzi sau o dată ulterioară. - Parcela unei ocupări nu poate fi modificată ulterior. Dacă un client se mută, încheiați ocuparea și creați una nouă. - Ștergerea unei ocupări nu poate fi anulată, dar consumul până la data de încheiere se păstrează și poate fi încă facturat. - La **Prelungiți ocuparea (factură)**, factura ciornă primește o dată scadentă la 14 zile după creare. - Doar câmpurile **Tip**, **Frecvența chiriei** și **Preț** sunt informative. Ele nu controlează automat înregistrarea contoarelor sau facturarea. ## Cum se leagă lucrurile? [#hoe-hangt-dit-samen] O ocupare leagă trei lucruri: clientul, parcela și contoarele de pe acea parcelă. Astfel Tillor știe pe numele cui se înregistrează consumul. ```mermaid flowchart LR K[Klant] --> B[Bezetting] B --> T[Terrein] T --> M[Meters op het terrein] M --> V[Verbruiksperiode van de klant] V --> F[Factuur] B -->|Bezetting verlengen| F ``` La creare, Tillor notează citirile inițiale ale contoarelor, iar la încheiere citirile finale. Consumul dintre ele aparține clientului. O ocupare nouă pe aceeași parcelă începe o perioadă nouă. ## Vizualizarea ocupărilor [#bezettingen-bekijken] Deschideți un profil de client prin Clienți > Prezentare generală și mergeți la cardul **Ocupări** din fila **Prezentare generală**. - Tabelul afișează pentru fiecare ocupare **Parcelă**, **Tip**, **Frecvența chiriei**, **Preț**, **Stare** și **Plătit până la**, cu o indicație relativă precum „peste 12 zile". - La **Plătit până la** apare o pictogramă de informare cu **Facturat până la** într-un tooltip, dacă acea dată este completată sau este egală cu **Plătit până la**. - Cu **Filtrați ocupările...** căutați după numele parcelei. - Acțiunile pentru fiecare ocupare (editare, prelungire, ștergere) se află în meniul cu trei puncte de la sfârșitul rândului. ## Crearea unei ocupări [#een-bezetting-aanmaken] Înainte de a începe: - Parcela trebuie să fie liberă. Dacă nu apare în listă, este deja ocupată. Consultați Probleme, mai jos. - Dacă parcela are contoare, aveți la îndemână citirile inițiale. Dacă nu completați nimic, Tillor preia ultima citire cunoscută. ### Deschideți profilul clientului [#open-het-klantprofiel] Mergeți la Clienți > Prezentare generală, deschideți clientul și mergeți la cardul **Ocupări**. ### Faceți clic pe Creați ocupare [#klik-op-bezetting-aanmaken] Găsiți butonul în bara de instrumente a tabelului. Se deschide un dialog. ### Completați datele [#vul-de-gegevens-in] Doar **Parcelă** este obligatorie. Restul este opțional. - **Parcelă**: alegeți prin **Selectați o parcelă**. În listă apar doar parcelele disponibile. Dacă nicio parcelă nu este disponibilă, vedeți **Nu s-au găsit parcele disponibile.** - **Plătit până la (opțional)**: până când a plătit clientul în avans. Alegeți astăzi sau mai târziu. - **Facturat până la (opțional)**: lăsați gol pentru a urma aceeași dată ca **Plătit până la**, sau alegeți o dată proprie. - **Tip**: **Cazare proprie** (implicit) sau **Rulotă de închiriat**. - **Frecvența chiriei (opțional)**: una dintre opțiunile setate de organizația dumneavoastră, fiecare cu o lună de început și un număr de luni (de exemplu început în ianuarie, 6 luni). Alegeți **Fără frecvență** dacă nu doriți să stabiliți una. - **Descriere (opțional)**: o explicație, de exemplu înțelegeri privind tariful. - **Preț**: ocuparea preia prețul parcelei. Cu **Înlocuiți prețul moștenit al parcelei** indicați un preț propriu. - **Citiri inițiale ale contoarelor (opțional)**: apare imediat ce parcela are contoare. Dacă nu are contoare, vedeți **Niciun contor asociat**. ### Confirmați [#bevestig] Faceți clic pe **Creați ocupare** pentru a salva. ### Completarea citirilor contoarelor [#meterstanden-invullen] Tastați singur citirea în fila **Manual**. Câmpul afișează ca exemplu ultima citire cunoscută. Dacă există citiri anterioare, puteți alege o citire existentă prin **Selectați**. Un contor care trimite singur citiri nu permite introducerea manuală. Alegeți o citire existentă prin **Selectați o citire de contor**. Dacă introduceți o citire mai mică decât ultima citire salvată, Tillor afișează un avertisment. Puteți totuși confirma valoarea mai mică sau modifica introducerea. ### Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Ocuparea este activă imediat și apare în tabelul din profilul clientului. - Tillor începe pentru fiecare contor de pe parcelă o perioadă de consum pentru acest client. Citirile noi ale contoarelor contează de acum ca consum al clientului. - Parcela nu mai este disponibilă pentru o altă ocupare. ## Editarea unei ocupări [#een-bezetting-bewerken] ### Deschideți meniul ocupării [#open-het-menu-van-de-bezetting] Faceți clic pe meniul cu trei puncte de lângă ocupare și alegeți **Editați**. ### Modificați câmpurile [#pas-de-velden-aan] Puteți modifica **Tip**, **Frecvența chiriei**, **Descriere**, **Plătit până la**, **Facturat până la** și **Preț**. **Parcelă** este doar pentru citire. Dacă organizația dumneavoastră are [câmpuri personalizate](/eigen-velden) pentru ocupări, acestea apar în partea de jos a dialogului. ### Salvați [#sla-op] Faceți clic pe **Salvați modificările**. Modificarea apare, cu o prezentare înainte/după, în fila **Evenimente** a clientului. ## Încheierea unei ocupări [#een-bezetting-beëindigen] Încheierea elimină legătura dintre client și parcelă. Parcela devine apoi din nou disponibilă. ### Alegeți Eliminați [#kies-verwijderen] Faceți clic pe meniul cu trei puncte de lângă ocupare și alegeți **Eliminați**. Se deschide fereastra **Ștergeți ocuparea**. ### Alegeți data și citirile finale ale contoarelor [#kies-de-datum-en-de-eindmeterstanden] Dacă parcela are contoare, puteți completa **Citiri finale ale contoarelor (opțional)**. Alegeți mai întâi la **Dată** ziua în care se încheie ocuparea (astăzi sau mai devreme). Apoi apare pentru fiecare contor un câmp pentru citirea finală. Un contor manual îl completați prin **Manual** sau îl alegeți prin **Selectați**. Un contor automat cere întotdeauna o citire existentă prin **Selectați o citire de contor**. ### Confirmați [#bevestig-1] Faceți clic pe **Ștergeți ocuparea**. Aceasta nu poate fi anulată. ### Ce se întâmplă apoi? [#wat-gebeurt-er-daarna-1] - Tillor închide perioadele de consum deschise ale clientului. Consumul până la data de încheiere se păstrează și poate fi încă facturat. - Parcela este din nou disponibilă pentru o ocupare nouă. - Ocuparea dispare din tabel. ## Facturare: prelungirea unei ocupări [#facturatie-bezetting-verlengen] Cu **Prelungiți ocuparea (factură)** creați o factură ciornă pentru următoarea perioadă a unei ocupări, de exemplu taxa anuală de loc. Puteți face acest lucru pentru o singură ocupare sau pentru toate ocupările clientului deodată. Înainte de a începe: trebuie să existe cel puțin un produs cu acțiunea **Prelungiți ocuparea** (adesea taxa de loc). Consultați [Produse](/producten). ### Porniți acțiunea [#start-de-actie] Deschideți meniul cu trei puncte de lângă ocupare și alegeți **Prelungiți ocuparea (factură)**. Faceți clic în bara de instrumente pe **Prelungiți toate**. Toate ocupările ajung pe o singură factură ciornă, cu un rând principal pentru fiecare ocupare. ### Alegeți dacă facturați și consumul [#kies-of-je-verbruik-meefactureert] Bifați **Facturați consumul restant pentru această parcelă** (la **Prelungiți toate**: **Facturați consumul restant (toate parcelele)**) dacă doriți să facturați și consumul restant pe aceeași factură ciornă. Dacă nu este nimic restant pe contoarele implicate, rămân doar rândurile pentru prelungirea ocupării. ### Creați factura ciornă [#maak-de-conceptfactuur] Faceți clic pe **Creați factură ciornă**. Tillor folosește primul produs cu acțiunea **Prelungiți ocuparea** (alfabetic după nume) și construiește rândurile pentru dumneavoastră. Apoi completați perioada pe factură și înregistrați contabil când sunteți gata. ### Ce se întâmplă apoi? [#wat-gebeurt-er-daarna-2] - O factură ciornă este pregătită la client, cu mesajul **Gata** și o descriere a ceea ce a fost creat. - Dacă înregistrați contabil factura, Tillor setează **Facturat până la** la momentul de sfârșit al rândului. - După plată, Tillor actualizează **Plătit până la**. **Facturat până la** avansează doar dacă era încă înaintea acelui moment de sfârșit. Dacă există deja o factură ciornă care prelungește această parcelă, Tillor afișează **Verificați înainte de a continua**. O a doua ciornă poate genera rânduri duble sau poate sări peste o perioadă. Deschideți ciorna existentă cu **Deschideți ciorna ...**, sau alegeți **Creați ciorna oricum**. ## Plătit până la, tip, frecvența chiriei și preț [#betaald-tot-type-huurfrequentie-en-prijs] | Câmp | Semnificație | |---|---| | **Plătit până la** | Până când a plătit clientul în avans. La creare sau editare alegeți astăzi sau mai târziu. | | **Facturat până la** | Până când s-a facturat. Dacă îl lăsați gol, afișarea urmează **Plătit până la**. | | **Tip** | Deosebește șederea proprie de închiriere. | | **Frecvența chiriei** | Stabilește ritmul chiriei pentru urmărire administrativă. | | **Preț** | Urmează implicit parcela, dar poate fi modificat pentru fiecare ocupare. | ## Scenarii frecvente [#veelvoorkomende-scenarios] ### Un oaspete nou face check-in [#een-nieuwe-gast-checkt-in] 1. Căutați clientul sau adăugați-l. 2. În profilul clientului, creați o ocupare pe parcelă. 3. Completați citirea inițială sau lăsați Tillor să preia ultima citire. 4. De acum, Tillor asociază acestui client consumul contoarelor de pe acea parcelă. ### Un oaspete pleacă [#een-gast-vertrekt] 1. La ocupare alegeți **Eliminați**. 2. Alegeți data plecării și completați citirile finale ale contoarelor. 3. Confirmați. Tillor închide perioadele de consum, iar parcela este din nou disponibilă. ### Un client se mută pe altă parcelă [#een-klant-verhuist-naar-een-ander-terrein] 1. Încheiați ocuparea curentă cu citirile finale ale contoarelor de pe parcela veche. 2. Creați o ocupare nouă pe parcela nouă, cu citirile inițiale ale contoarelor. 3. Tillor ține separat perioadele de consum pentru fiecare parcelă. ## Probleme? [#problemen] În listă apar doar parcelele fără ocupare activă. Dacă alt client are încă parcela, încheiați mai întâi acea ocupare. Dacă nimic nu este disponibil, vedeți **Nu s-au găsit parcele disponibile.** Dacă lipsesc toate parcelele și vedeți **A apărut o eroare la încărcarea parcelelor.**, reîncărcați pagina. Un alt utilizator a fost mai rapid și a ocupat parcela. Reîncărcați pagina clientului, alegeți o altă parcelă sau încheiați mai întâi ocuparea celuilalt client. Este intenționat. La creare sau editare, **Plătit până la** acceptă doar astăzi sau mai târziu. Alegeți mai întâi la **Dată** ziua în care se încheie ocuparea. Apoi apare un câmp pentru fiecare contor. Dacă parcela nu are contoare, nu există niciun câmp. Este un contor care trimite singur citiri. Alegeți o citire existentă prin **Selectați o citire de contor**. Dacă vedeți **Nicio citire de contor disponibilă**, contorul nu a trimis încă nicio citire. De obicei nu există niciun produs cu acțiunea **Prelungiți ocuparea**. Creați unul, consultați [Produse](/producten), și încercați din nou. Dacă prelungiți toate ocupările deodată, verificați și că aparțin aceluiași client. Există deja o ciornă pentru această parcelă sau parcela este facturată până la o dată care nu este încă plătită. Citiți mesajul. Cu **Creați ciorna oricum** continuați conștient, cu **Deschideți ciorna ...** verificați mai întâi ciorna existentă. Aceasta nu poate fi anulată. Creați o ocupare nouă pe aceeași parcelă. Consumul până la data de încheiere a ocupării vechi s-a păstrat. ## Noțiuni [#begrippen] - **Ocupare**: un client pe o parcelă pentru o perioadă. Consultați [ocupare](/begrippen#bezetting). - **Parcelă**: locul în sine, cu eventuale contoare. Consultați [parcelă](/begrippen#terrein). - **Plătit până la**: data până la care clientul a plătit în avans. - **Facturat până la**: data până la care s-a facturat deja. - **Perioadă de consum**: perioada în care consumul unui contor este atribuit unui singur client. Consultați [lot de consum](/begrippen#verbruiksbatch). - **Frecvența chiriei**: ritmul chiriei, de exemplu anual sau la jumătate de an. ## Vezi și [#zie-ook] # TVA și taxe (/ro-RO/boekhouden/belasting) Aici citiți cum ajunge TVA-ul pe facturile dumneavoastră și cum verifică Tillor codul de TVA al unui client. Verificarea se face prin VIES, serviciul european prin care puteți verifica un cod de TVA. ## Cotele de TVA [#btw-tarieven] Cotele de TVA se setează per produs. Mergeți la **Administrare > Produse** și deschideți un produs pentru a alege **% TVA** dintre cotele disponibile (implicit 0%, 6%, 9%, 12% și 21%). ## Taxare inversă și alte regimuri fără TVA [#btw-verlegd-en-andere-regimes-zonder-btw] Uneori nu aplicați TVA, dar nu este vorba de o simplă cotă de 0%: clientul trebuie să declare singur TVA-ul sau livrarea este scutită. În lista de alegere **% TVA** a unui produs apar de aceea, sub cote, cinci regimuri. Dacă alegeți unul, produsul rămâne la 0% și Tillor știe motivul. | Regim | Când | Casetă în declarația de TVA | |--------|---------|----------------------------| | **Taxare inversă (servicii UE)** | Un serviciu pentru un client plătitor de TVA din altă țară UE | 44 | | **Taxare inversă (cocontractant)** | Lucrări imobiliare pentru un client belgian plătitor de TVA care depune declarații periodice | 45 | | **Livrare intracomunitară** | Bunuri pe care le trimiteți unui client plătitor de TVA din altă țară UE | 46 | | **Export în afara UE** | Bunuri care părăsesc UE | 47 | | **Scutit de TVA** | O livrare scutită prin natura ei (articolul 44 din Codul TVA) | 00 | Un regim face patru lucruri pe care o simplă cotă de 0% nu le face: - **Pe factură**, la rând apare `0%*`, iar sub totaluri apare mențiunea legală a regimului, de exemplu *Taxare inversă: TVA-ul este datorat de beneficiar*. Dacă pe o factură sunt două regimuri, al doilea primește `**`. - **Înregistrarea contabilă reușește doar cu un cod de TVA** la cele două regimuri de taxare inversă și la o livrare intracomunitară. Completați codul în profilul clientului; apare atunci și pe factură. - **Către contabilitate** merge rândul cu codul regimului, astfel încât să ajungă în caseta potrivită a declarației de TVA. Consultați [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#btw-regimes). - **Prin Peppol**, rândul primește categoria de TVA a regimului. Tillor nu verifică dacă un client sau o livrare are dreptul la un regim. Dacă aveți dubii, întrebați contabilul dumneavoastră. ## Validarea codului de TVA [#btw-nummer-validatie] Când introduceți un cod de TVA în profilul clientului, Tillor îl verifică automat prin serviciul european VIES, imediat ce țara este completată. ### Cum funcționează [#hoe-het-werkt] 1. Deschideți **Clienți > client** (secțiunea **Datele clientului**) 2. Setați **țara** și introduceți codul de TVA (de exemplu `NL123456789B01` sau `BE0123456789`) 3. Tillor validează codul automat (după o scurtă pauză) 4. La un cod de TVA valid apare o bifă verde; faceți clic pe ea pentru datele companiei din VIES 5. Doriți să preluați numele și adresa? Faceți clic pe **Aplicați adresa companiei** în acea fereastră (numele companiei ajunge în câmpul prenume) 6. La un cod de TVA invalid apare o pictogramă roșie cu explicații Validarea TVA funcționează pentru toate țările UE. Pentru companiile din afara UE puteți introduce codul de TVA manual, fără validare. ### Țări acceptate [#ondersteunde-landen] Validarea acceptă toate statele membre UE, inclusiv Țările de Jos (NL), Belgia (BE), Germania (DE), Franța (FR) și toate celelalte țări UE. ### Codul de țară pe factura PDF [#landcode-op-de-factuur-pdf] Pe factura PDF, Tillor completează automat un cod de țară lipsă pentru țările în care aceasta este scrierea obișnuită: dacă la un client belgian introduceți `0123456789`, pe factură apare `BE0123456789`. Pentru Spania, Italia și Portugalia acest lucru nu se întâmplă, deoarece acolo codul fiscal național se scrie fără cod de țară (un NIF spaniol precum `B04876793` rămâne deci neschimbat). Dacă tastați singur codul de țară în câmp, acesta este întotdeauna preluat. ## Clienți belgieni și Peppol [#belgische-klanten-en-peppol] Pentru clienții belgieni cu cod de TVA, trebuie completat un **ID Peppol** în fila **Facturare** înainte de a putea înregistra contabil facturi. Aceasta este o obligație legală pentru facturarea B2B în Belgia. Consultați [documentația Peppol](/boekhouden/peppol) pentru mai multe informații. ## TVA pe facturi [#btw-op-facturen] Toate rândurile facturii afișează automat cota de TVA corectă, pe baza produsului asociat. Pe factură vedeți **Subtotal**, **TVA** și **Total**; pe factura PDF apare în plus o prezentare pe cote de TVA. Aveți permisiunea de a modifica setările organizației? Mergeți la **Setări > Facturare** și activați **Listă derulantă a cotei de TVA pe liniile facturii ciornă**. Pe **facturile ciornă** apare atunci o coloană pentru a alege cota pe rând (opțiunile urmează cotele configurate pentru organizația dumneavoastră). La selectarea unui produs, cota implicită din produs rămâne valoarea de pornire. În aceeași coloană alegeți și un [regim fără TVA](#btw-verlegd-en-andere-regimes-zonder-btw) pentru un singur rând. ## Probleme? [#problemen] Tillor nu a putut confirma codul prin VIES. Verificați țara și codul. Pentru o companie din afara UE puteți introduce codul și fără validare. Clientul nu are cod de TVA. Taxarea inversă și o livrare intracomunitară există doar pentru un client plătitor de TVA. Completați codul la Clienți > client, secțiunea **Datele clientului**, și înregistrați din nou. O factură Peppol poate purta un singur motiv pentru lipsa TVA-ului. Puneți rândurile fiecărui regim pe o factură separată. Puteți alege doar dintre cotele permise, implicit 0%, 6%, 9%, 12% și 21%. Coloana cu cote apare doar pe facturile ciornă și doar dacă **Listă derulantă a cotei de TVA pe liniile facturii ciornă** este activată. ## Vezi și [#zie-ook] # Metode de plată (/ro-RO/boekhouden/betalingsrapporten/betaalmethodes) Rapoartele de plăți conțin plăți din surse diferite. Doar **Mollie** și **transferurile interne** sunt trimise către contabilitate. | Metodă | Pe raportul Tillor | Către contabilitate | |---------|-------------------|------------------| | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | Da (prin decontarea Mollie) | Da | | [Conturi bancare](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | Da (în ziua plății) | Nu | | [Transfer intern](/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) | Da | Da | ```mermaid flowchart LR Mollie[Mollie] --> R[Tillor-rapport] Bank[Bankrekeningen] --> R Internal[Interne overboeking] --> R R --> BH[Boekhouding] Mollie --> BH Internal --> BH ``` ## Vezi și [#zie-ook] # Transferuri interne (/ro-RO/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) Cu **Transfer intern** mutați o sumă rămasă de plată de pe o factură pe o altă factură **înregistrată contabil** a **aceluiași client**. Tillor creează o plată pozitivă pe factura pe care o plătiți și o plată negativă asociată pe factura țintă. Consultați [Transfer intern - Înregistrare](/betalingsverwerking/interne-overboeking) pentru procesul de înregistrare pas cu pas, cu capturi de ecran. ## În rapoartele de plăți [#in-betalingsrapporten] - Transferurile interne apar pe raportul de plăți Tillor din ziua în care le înregistrați (Bruxelles). - Ele **sunt** incluse în exportul contabil: împreună cu plățile Mollie, și **nu** împreună cu conturile bancare sau cu alte metode manuale (numerar, transfer bancar, ...). - În exportul contabil, fiecare rând apare ca `Tillor - Interne overboeking - {factuurnummer}`, asociat facturii și clientului respectiv. ## Vezi și [#zie-ook] # Mollie (/ro-RO/boekhouden/betalingsrapporten/betaalmethodes/mollie) Plățile Mollie (iDEAL, card de credit, Bancontact, terminal etc.) sunt sincronizate în Tillor și asociate rapoartelor de plăți prin **decontarea Mollie**. ## Conectarea în Tillor [#koppelen-in-tillor] 1. Mergeți la **Setări > Integrări** și alegeți **Mollie** din listă. 2. Urmați pașii Mollie OAuth dacă conexiunea nu este încă activă. 3. Pe pagina de detalii alegeți, la **Profil site web**, un **Profil principal** (profilul de site web Mollie pentru plăți și sincronizare). Opțional alegeți un **Terminal implicit** (dispozitivul de plată pe care Tillor îl propune implicit la facturi). 4. Faceți clic pe **Salvați**. Fără profil principal, plățile Mollie nu funcționează în Tillor; un terminal este necesar doar pentru plățile cu cardul. ### Pictogramele de stare din listele de alegere [#statusiconen-in-de-keuzelijsten] În stânga numelui profilului și al terminalului apare o pictogramă colorată. Aceasta arată starea la Mollie, nu numele în sine. | Pictogramă | Profil site web | Terminal | |-------|----------------|----------| | Verde (bifă) | Verificat - potrivit pentru plăți live | Activ - gata pentru plăți cu cardul | | Portocaliu (ceas) | Încă neverificat la Mollie | În așteptare - încă inactiv | | Roșu (interzis) | Blocat | - | | Gri | - | Inactiv | Alegeți de preferință un profil **verificat**. Un terminal **activ** este opțional și necesar doar dacă doriți ca Tillor să propună plăți cu cardul. Fără profil principal, plățile și sincronizarea nu funcționează. ## Decontările Mollie [#mollie-settlements] Cât timp Mollie nu a plătit încă o plată, aceasta apare ca **avans** pe raportul ciornă deschis. Abia la finalizare decide decontarea pe ce raport se încadrează; consultați [Plățile Mollie pe ciornă](/boekhouden/betalingsrapporten#mollie-betalingen-op-het-concept). Pentru **ziua de raport D**, Tillor caută o decontare în această ordine: 1. Decontare **creată în ziua D** 2. Altfel, decontare **creată în ziua D+1** (de regulă: încasările din D sunt plătite dimineața următoare) ```mermaid flowchart TD D[Rapportdag D] --> E{Settlement aangemaakt op D?} E -- ja --> F[Koppel aan rapport D] E -- nee --> G{Settlement aangemaakt op D+1?} G -- ja --> F G -- nee --> H[Nog geen Mollie op dit rapport] F --> I[Eén settlement-id per rapport] ``` **Reguli stabilite:** - Fiecare id de decontare apare pe **cel mult un** raport de plăți. - Dacă un raport are deja o decontare, asocierea **rămâne**; Tillor nu o înlocuiește. - Dacă lipsesc atât D, cât și D+1 (de exemplu în weekend): raportul poate exista deja doar cu plăți manuale sau din conturi bancare; imediat ce Mollie publică, sincronizarea zilnică completează Mollie. ## Exemple [#voorbeelden] | Ziua de raport D | Decontare creată la Mollie | Rezultat | |--------------|----------------------------------|-----------| | Mar 20 mai | Mar 20 mai (`stl_aaa`) | `PAYR/2026/0140` (20 mai) primește `stl_aaa` | | Mar 20 mai | Mie 21 mai dimineața devreme (`stl_bbb`) | `PAYR/2026/0140` (20 mai) primește `stl_bbb` (regula D+1) | | Dum 18 mai | Lun 19 mai (`stl_ccc`) | `PAYR/2026/0138` (duminică) primește `stl_ccc`, **nu** raportul de luni | | Lun 19 mai | Lun 19 mai (`stl_ccc`) | Raportul de luni caută propria decontare (`stl_ddd` marți sau mai târziu), nu `stl_ccc` | | Sâm 17 mai | Nicio decontare sâm/dum/lun dimineața | Raportul din 17 mai: mai întâi manual/conturi bancare; Mollie urmează când există decontarea | | Mar 20 mai | Raportul exista deja fără decontare | La următoarea rulare, la 09:00: decontarea ajunge totuși pe 20 mai, plățile sunt asociate | **Concret (D+1):** încasările de **marți 20 mai** se află în decontarea `stl_6necch`, creată **miercuri 21 mai** la 06:08. Tillor asociază `stl_6necch` cu **`PAYR/2026/0140` (ziua de raport 20 mai)**, nu cu raportul din 21 mai. **Raport existent:** exista `PAYR/2026/0140` deja în Tillor fără decontare Mollie asociată și cu două rânduri manuale? După sincronizare, `stl_6necch` este totuși asociată; rândurile existente rămân; plățile Mollie din acea decontare se adaugă. **Deja asociat:** raportul din **15 mai** are deja `stl_old`. Tillor **nu** modifică acel id. Plățile Mollie individuale cu același id de decontare ajung totuși pe raportul care are deja acea decontare. ## Sincronizarea rapoartelor existente [#synchronisatie-op-bestaande-rapporten] După crearea rapoartelor lipsă, Tillor caută **doar rapoarte fără decontare Mollie asociată** într-o fereastră glisantă de **o lună calendaristică înainte de ieri** până la ieri. Rapoartele care au deja o decontare Mollie **nu** sunt preluate din nou prin lista de decontări Mollie. ```mermaid flowchart TD start[Synchronisatie
ma-za 09:00] --> scope[Rapportdag vanaf
maand vóór gisteren t/m gisteren] scope --> nullOnly[Alleen rapporten
zonder Mollie-afrekening] nullOnly --> U{Zoek settlement voor D of D+1} U -- gevonden --> V[Settlement vastleggen] U -- niet --> W[Geen Mollie-stap] V --> X[Ongekoppelde Mollie-betalingen
uit settlement koppelen] X --> Z[Betalingen met dezelfde
settlement-id op dat rapport] ``` Plățile care au deja un id de decontare de la Mollie, dar nu apar încă pe un raport, ajung pe raportul cu același id de decontare. ## Plățile Mollie în Tillor [#mollie-betalingen-in-tillor] Tillor preia plățile Mollie **la fiecare 15 minute** (pentru fiecare organizație cu conexiune Mollie activă). Webhook-urile de la Mollie funcționează în plus imediat: o plată devine pe loc **Plătit**, **Rambursat** sau **Stornat**, chiar dacă a apărut în afara Tillor (de exemplu la un terminal de plată). Dacă aveți dubii sau un webhook a fost ratat: **Sincronizați** în meniul de acțiuni al plății. O plată ajunge pe un raport dacă: - se află în **decontarea** asociată (lista de la Mollie), sau - plata are deja un id de decontare care aparține raportului. | Tip în raport | Semnificație | |-----------------|-----------| | Cunoscut | Plată asociată unei facturi din Tillor | | Necunoscut | Nicio asociere cu o factură în Tillor → cont de așteptare 499000, cu excepția cazului în care trimiteți datele contabile prin Mollie | Plățile din decontare care **nu** există în Tillor apar ca plată Mollie necunoscută pe raport. Pe un raport de plăți vedeți plățile Mollie asociate în tabelul **Plăți**: ## Metadate Mollie [#mollie-metadata] Aveți o casă de marcat sau un alt sistem care creează singur plăți Mollie? Puteți îndruma Tillor prin metadate pe acea plată: asociere cu o factură sau un [grup de plăți](/betalingsverwerking/groepen), ori direct către contabilitate. Câmpurile sunt descrise la [Metadate Mollie](/ontwikkelaars/mollie-metadata). ## Vezi și [#zie-ook] # Conturi bancare (/ro-RO/boekhouden/betalingsrapporten/betaalmethodes/ponto) Conexiunea bancară se leagă prin open banking de contul dumneavoastră bancar și preia automat tranzacțiile. ## Cum funcționează [#hoe-het-werkt] 1. **Tranzacții**: la fiecare 5 minute, Tillor preia tranzacțiile bancare de la banca dumneavoastră 2. **Comunicare structurată**: se citește +++123/4567/89002+++ sau numărul facturii (INV/2024/0001) 3. **Asociere**: Tillor caută o factură care se potrivește → se creează plata și se asociază 4. **Transfer manual dublu**: dacă pe aceeași factură există deja un transfer manual cu aceeași sumă, acesta este șters, astfel încât plata să nu fie numărată de două ori 5. În Tillor vedeți această plată ca **transfer bancar** ## Conectarea [#koppelen] Integrarea se numește **Conturi bancare** și se află la Setări > Integrări > Conturi bancare. Completați un **Client ID** și un **Secret client**; un administrator Tillor vă ajută la configurare și vă îndrumă la onboarding. ## Vizualizarea tranzacțiilor bancare [#banktransacties-bekijken] Tranzacțiile bancare importate se află la **Administrare > Tranzacții bancare**. Această pagină este vizibilă doar utilizatorilor cu permisiunea **Vizualizați tranzacțiile bancare**. Fără această permisiune nu vedeți pagina în meniu. În tabelul **Tranzacții**, coloana **Factură** se află între **Data valutei** și **Comunicare**: - Este tranzacția deja asociată unei facturi? Atunci vedeți numărul facturii ca link (de exemplu `INV/2026/0001`). - Încă nicio asociere? Deschideți meniul de acțiuni (trei puncte) de la sfârșitul rândului și alegeți **Atribuiți facturii**. Dacă este nevoie, Tillor creează mai întâi o plată și o asociază tranzacției. Pentru aceasta aveți nevoie de permisiunea **Atribuiți plata**; fără ea nu vedeți această acțiune în meniu. - Este tranzacția deja asociată unei facturi? Deschideți același meniu de acțiuni și alegeți **Dezasociați de factură** pentru a elimina asocierea (atât manuală, cât și potrivită automat). Faceți clic pe pictograma (i) de lângă IBAN pentru a deschide panoul de detalii al tranzacției: suma, data valutei, contrapartea și IBAN-ul, comunicarea, datele extrasului de cont (referința băncii, referința ordonatorului, numărul cardului, ...), factura, plata și raportul de plăți asociate, precum și referințele. Meniul de acțiuni se află și în partea de sus a acelui panou. În meniul de acțiuni mai alegeți: - **Creează sarcină** pentru a atașa o sarcină tranzacției, de exemplu pentru a procesa manual o plată. Sarcina afișează tranzacția ca element asociat; faceți clic pe ea pentru a deschide panoul de detalii. Consultați [Elemente asociate](/taken/taakdetails#gekoppelde-items). - **Copiați linkul** pentru un link care deschide pagina **Tranzacții bancare** cu panoul de detalii al acelei tranzacții, de exemplu pentru a-l lipi într-un comentariu sau într-un mesaj. Aceeași coloană **Factură** o vedeți pe un **raport de plăți** în tabelul **Tranzacții ale contului bancar**, atât timp cât aveți permisiunea de citire. ## Dezasocierea [#ontkoppelen] La **Administrare > Tranzacții bancare** (și pe un raport de plăți, în **Tranzacții ale contului bancar**) deschideți meniul de acțiuni pe un rând asociat și alegeți **Dezasociați de factură**. Aceasta funcționează atât pentru tranzacțiile asociate manual, cât și pentru cele potrivite automat. La **Administrare > Plăți**, **Dezasociați de factură** apare doar la plățile pe care le-ați asociat sau mutat dumneavoastră la o factură. Astfel evitați să ștergeți din greșeală, prin lista de plăți, o asociere automată corectă. ## Sincronizarea manuală [#handmatig-synchroniseren] La **Administrare > Tranzacții bancare** și pe un **raport de plăți** (tabelul **Tranzacții ale contului bancar**) apare butonul **Sincronizați contul bancar** dacă conexiunea bancară este instalată și aveți permisiunea **Sincronizați tranzacțiile bancare**. Cu el solicitați o sincronizare bancară proaspătă; Tillor importă apoi tranzacțiile noi și încearcă să le asocieze facturilor. Fără conexiune bancară sau fără această permisiune, butonul nu apare. Tillor importă tranzacțiile noi și automat, la fiecare 5 minute. Ambele permisiuni le setați la **Setări > Permisiunile utilizatorilor** (grupul **Tranzacții bancare**). ## În rapoartele de plăți [#in-betalingsrapporten] Transferurile bancare **apar** pe raportul de plăți Tillor din data plății (Bruxelles), împreună cu plățile manuale din acea zi. Ele **nu** sunt incluse în exportul contabil: doar Mollie și transferurile interne. Conexiunea bancară este destinată în principal asocierii automate cu facturile din Tillor. Clientul face transferul cu comunicare structurată → Tillor preia de la banca dumneavoastră → factura este potrivită → plată + factură plătită. ## Vezi și [#zie-ook] # Admisol (/ro-RO/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) Admisol este un program de contabilitate pe care Tillor îl acceptă pentru trimiterea rapoartelor de plăți. Rapoartele de plăți sunt convertite în XML Admisol și trimise automat sau manual către Admisol. ## Instalare [#installatie] 1. Mergeți la **Setări** (marcajul **1** din captura de ecran) și alegeți **Integrări**. 2. Căutați **Admisol** în lista de integrări (marcajul **2**) și deschideți pagina de detalii. 3. Pe pagina de detalii completați **ID companie** și **Cheie serviciu web** (date de la Admisol) și faceți clic pe **Instalați**. ## Trimiterea automată [#automatisch-versturen] Când un raport de plăți **se modifică pe fond** (de exemplu după asocierea plăților sau după **Recalculați raportul**): 1. Tillor verifică dacă Admisol este instalat pentru organizație 2. Raportul este convertit în XML Admisol 3. XML-ul este trimis către Admisol La **crearea zilnică** (09:00), Tillor parcurge zilele lipsă **de la cea mai veche la cea mai nouă**. Fiecare raport nou ajunge la Admisol abia după ce raportul anterior a primit un răspuns (acceptare sau respingere). Dacă trimiterea nu reușește, Tillor se oprește pentru acea organizație până la următoarea rulare. [Raportul ciornă](/boekhouden/betalingsrapporten#concept-en-definitief) al zilei curente ajunge deja la Admisol imediat ce conține o plată Mollie sau un transfer intern, iar apoi este retrimis doar când înregistrarea se schimbă. Plățile în numerar de pe ciornă nu duc la o trimitere. Plățile Mollie de pe o ciornă sunt contabilizate în contrapartidă pe furnizorul Mollie **fără referință de document**; Admisol le înregistrează ca **avans** („de primit încă"). Rambursările pe care Mollie nu le-a reținut încă apar ca o a doua linie de avans separată pe Mollie („de reținut încă"). La trimiterea definitivă, în locul lor vine plata efectivă cu costurile bancare, iar plățile care nu se aflau în decontare se mută ca avans pe următoarea ciornă. Cât timp raportul este ciornă, în Admisol referința documentului apare ca `PAYR/2026/0275 - Concept`; acest adaos dispare la trimiterea definitivă. Dacă raportul devine definitiv în următoarea zi lucrătoare, Tillor îl retrimite, acum cu decontarea Mollie, sub **același număr de document și aceeași dată contabilă**. Dacă o trimitere automată eșuează, primiți o notificare și apare un rând în cronologia evenimentelor raportului. ## Trimiterea manuală [#handmatig-versturen] 1. Mergeți la **Administrare > Rapoarte de plăți** 2. Deschideți raportul pe care doriți să îl trimiteți 3. Faceți clic pe **„Trimiteți către contabilitate"** ## Ce plăți sunt incluse? [#welke-betalingen-gaan-mee] Doar plățile cu: - **Mollie** ca furnizor, sau - **Transfer intern** ca metodă de plată Plățile din conturile bancare nu sunt trimise către contabilitate. ## Rambursare parțială (Mollie) [#gedeeltelijke-terugbetaling-mollie] Dacă o plată Mollie asociată a fost rambursată parțial sau integral, Tillor trimite **suma inițială a plății** pe raportul de plăți al **decontării Mollie în care a intrat plata**. **Rambursarea** apare ca rând negativ pe raportul **decontării în care Mollie scade rambursarea** (eticheta *Rambursare*). Acestea pot fi decontări ulterioare; mai multe rambursări primesc fiecare propriul rând pe raportul decontării lor. Astfel raportul corespunde cu ceea ce plătește efectiv Mollie. Prin înregistrarea rambursărilor doar în ziua acelei decontări, nu se mai adaugă niciun rând suplimentar pe contul de așteptare **499000** (*sold rămas*). ## Costuri bancare per factură Mollie [#bankkosten-per-mollie-factuur] Mollie își reține costurile la fiecare plată și le facturează o dată pe lună. Tillor înregistrează de aceea costurile reținute **pe perioadă de facturare**: fiecare rând poartă luna pentru care Mollie facturează costurile, de exemplu *Costuri bancare 01/2026*. O plată din primele zile ale lunii conține adesea încă costuri din luna precedentă; acestea apar atunci ca rând separat pe același raport. Toate rândurile din aceeași perioadă însumează suma facturii Mollie din acea lună. Rândurile lunii curente rămân deschise până când Mollie emite factura. ### Pe furnizorul Mollie [#op-de-leverancier-mollie] Costurile reținute nu sunt o a doua cheltuială: Mollie își plătește cu ele propria factură. De aceea Tillor le înregistrează pe **furnizorul Mollie**, fără referință de document. Cheltuiala și TVA-ul intră doar prin factura de achiziție Mollie. În fiecare lună, pe furnizorul Mollie, stingeți factura împotriva rândurilor *Costuri bancare* din acea perioadă; ele au împreună aceeași valoare. O corecție printr-o operațiune diversă nu este necesară. Mollie reține de obicei costurile unei plăți chiar în momentul în care plata intră, chiar dacă plata efectivă urmează mai târziu. Un raport ciornă înregistrează de aceea aceste costuri deja pe perioadă de facturare, iar avansul pe Mollie este suma după costuri. O plată cu cardul pe care Mollie o mai ține nu are încă costuri reținute: acestea apar abia pe raportul cu plata efectivă. Până atunci, luna nu este încă completă pe furnizorul Mollie. În Admisol **nu stingeți rânduri de pe un raport ciornă** (referința documentului se termină în *- Concept*). La trimiterea definitivă, Admisol înlocuiește rândurile raportului, iar stingerile de pe acele rânduri pot dispărea. Aceasta se poate întâmpla și când retrimiteți un raport definitiv, chiar dacă nu s-a schimbat nimic: verificați apoi stingerile de pe furnizorul Mollie. ## Rezervă de sold [#balansreserve] Mollie reține uneori o parte din plată ca **rezervă de sold**: bani pe care îi aveți de primit, dar pe care Mollie îi ține temporar. Deoarece nu este nici cost, nici rambursare, Tillor înregistrează această sumă pe **furnizorul Mollie** cu eticheta *Rezervă de sold*, la fel ca plata în sine. Astfel rămâne ca sold de primit deschis la Mollie, în loc să ajungă pe contul de așteptare. Dacă Mollie eliberează ulterior rezerva, pe raportul acelei decontări apare un rând *Rezervă de sold* de sens opus, care scade din nou soldul. Nu trebuie să faceți nimic; pe furnizorul Mollie, cele două rânduri se anulează reciproc. ## Facturi deja stinse în Admisol [#facturen-die-in-admisol-al-afgepunt-zijn] Admisol refuză un rând pe o factură sau o notă de credit pe care ați stins-o manual în Admisol împotriva altei înregistrări decât raportul de plăți. Tillor înregistrează atunci rândurile acelei facturi pe client **fără referință de document**, astfel încât raportul să meargă totuși mai departe. Sumele și clientul rămân aceleași; doar asocierea cu factura o stingeți din nou în Admisol. În cronologia evenimentelor raportului, în XML-ul trimis apare despre ce factură este vorba. ## Parametri contabili [#boekhoudparameters] După instalare, setați parametrii contabili la **Setări** în aplicația Admisol (același ecran ca ID companie și Cheie serviciu web). Acolo se află, printre altele, tipurile de documente pentru facturi și decontări, codul furnizorului Mollie, contul implicit din registrul general pentru rândurile facturii și departamentul implicit. Câmpurile lipsă primesc valorile implicite Tillor. Plățile Mollie necunoscute sunt înregistrate pe contul de așteptare **499000**. Pentru fiecare plată puteți transmite și departamentul și anul contabil prin [metadate Mollie](/ontwikkelaars/mollie-metadata#directe-boekhoudmetadata-tillorbookkeeping). ### Regimuri de TVA [#btw-regimes] Un rând de factură cu un [regim fără TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) ajunge la Admisol cu propriul **profil de adresă fiscală** și propriul **cod fiscal**. Împreună, acestea stabilesc în ce casetă a declarației de TVA intră rândul. Valorile implicite sunt cele ale unui dosar Admisol nou: | Regim | Profil de adresă fiscală | Cod fiscal | Casetă | |--------|------------------|----------|---------| | Taxare inversă (servicii UE) | `EU` | `vd21` | 44 | | Taxare inversă (cocontractant) | `MED` | `v21` | 45 | | Livrare intracomunitară | `EU` | `v21` | 46 | | Export în afara UE | `EXP` | `v21` | 47 | | Scutit de TVA | `NA` | `v0` | 00 | Dacă dosarul dumneavoastră folosește alte coduri, modificați-le la parametrii contabili: pentru fiecare regim există un câmp pentru profilul de adresă fiscală și unul pentru codul fiscal. Codurile dosarului dumneavoastră le găsiți în Admisol la **Instellingen > BTW-instellingen > Tax-relaties**. Fișa clientului din Admisol își păstrează propriul profil de adresă fiscală; doar rândul facturii îl primește de la regim. ## Vezi și [#zie-ook] # Exact Online (/ro-RO/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) Exact Online este programul de contabilitate folosit de multe parcuri olandeze și de birourile lor. Tillor asociază **clienții**, **facturile înregistrate contabil** și **rapoartele de plăți** cu Exact Online. Conexiunea este **disponibilă la cerere** - încă nu ca self-service în App Marketplace. Doriți să conectați Tillor la Exact Online? Solicitați activarea prin [demo](https://tillor.eu/demo) sau trimiteți un e-mail la **support@tillor.eu**. Configurăm conexiunea împreună cu contabilul dumneavoastră. ## Ce acoperă conexiunea [#wat-de-koppeling-dekt] Exportul vizat urmează același lanț ca [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) și [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo). Corespondența exactă a jurnalelor și a conturilor de venituri o stabilim la activare. - **Clienți** din Tillor către Exact Online - **Facturi înregistrate contabil** (rânduri și TVA) - **Rapoarte de plăți** - doar **Mollie** și **transferuri interne**, ca la celelalte exporturi contabile Plățile din conturile bancare apar pe raportul Tillor, dar nu sunt incluse în exportul contabil. Consultați [sisteme de contabilitate](/boekhouden/betalingsrapporten/boekhoudsystemen). ## Încă fără self-service [#nog-geen-zelfbediening] Nu găsiți încă Exact Online la **Setări > Integrări**. Alegerea administrației, corespondența cu registrul general și primul export se fac împreună cu suportul Tillor. Nu există un formular de instalare pe care să îl completați singur. Tillor exportă către un singur program de contabilitate pe organizație. Dacă folosiți deja Admisol sau Odoo, stabilim împreună care sistem rămâne activ. ## Solicitarea [#aanvragen] 1. Notați administrația dumneavoastră Exact Online (divizia) și dacă contabilul dumneavoastră urmărește și el. 2. Solicitați conexiunea prin [tillor.eu/demo](https://tillor.eu/demo) sau la **support@tillor.eu**. 3. Tillor planifică activarea și corespondența jurnalelor și a conturilor de venituri. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/boekhouden/betalingsrapporten/boekhoudsystemen) Tillor acceptă integrarea cu software-ul de contabilitate pentru trimiterea rapoartelor de plăți. Rapoartele de plăți sunt convertite în formatul programului dumneavoastră de contabilitate (în prezent Admisol) și trimise automat sau manual. [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) este disponibil la cerere. ## Sisteme acceptate [#ondersteunde-systemen] | Sistem | Stare | |---------|--------| | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | Acceptat | | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | Clienți și facturi înregistrate contabil | | [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) | La cerere | ## General [#algemeen] - **Automat**: la crearea sau la o actualizare semnificativă a unui raport de plăți, acesta este trimis către Admisol (doar dacă Admisol este instalat) - **Manual**: prin **Administrare > Rapoarte de plăți** → deschideți raportul → **Trimiteți către contabilitate** - **Ce plăți**: doar **Mollie** și **transferuri interne**. Conturile bancare apar pe raportul Tillor, dar nu sunt incluse în exportul contabil. ## Vezi și [#zie-ook] # Odoo (/ro-RO/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) Conexiunea Odoo din Tillor exportă **clienții** și **facturile înregistrate contabil** către Odoo. Rapoartele de plăți către Odoo vor urma într-o versiune viitoare; până atunci folosiți [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) dacă doriți să trimiteți automat rapoartele de plăți. ## Instalare [#installatie] 1. Mergeți la **Setări** și deschideți App Marketplace. 2. Căutați cardul **Odoo** și faceți clic pe **Instalați**. 3. Completați mai întâi la **Conexiune**: - **URL Odoo** - de exemplu `https://mijnbedrijf.odoo.com` sau doar `mijnbedrijf` (Tillor completează atunci URL-ul `.odoo.com`) - **Nume de utilizator** - utilizator cu acces la API - **Cheie API** - cheia API (Odoo: profilul de utilizator > chei API) 4. Faceți clic pe **Continuați la baza de date**. Tillor preia bazele de date disponibile (sau vă lasă să introduceți manual numele). 5. Alegeți baza de date la **Bază de date** și finalizați instalarea. La salvare, Tillor testează conexiunea. Dacă sunt instalate atât Admisol, cât și Odoo, Tillor folosește **Admisol** pentru export (prioritate fixă). Instalați Odoo doar dacă nu mai folosiți Admisol. ## Parametri contabili (aplicația Odoo) [#boekhoudparameters-odoo-app] După instalare, setați parametrii de export prin **Setări** în aplicația Odoo (pe lângă URL, baza de date, utilizator și cheia API). Tillor preia în timp real jurnalele de vânzări și conturile de venituri din Odoo; le alegeți printr-un câmp de căutare (cod și nume). | Câmp în aplicație | Implicit | Semnificație | |---|---|---| | **Cod jurnal de vânzări** | INV | Jurnalul de vânzări din Odoo cu acest cod | | **Cont de venituri implicit** | 700000 | Contul de venituri când rândul facturii nu are un număr propriu în registrul general | | **Înregistrați facturile automat** | oprit | După export, înregistrează imediat în Odoo | | **Atașați PDF-ul facturii** | pornit | PDF-ul facturii Tillor ca anexă la factura din Odoo | | **Atașați UBL Peppol** | pornit | UBL-ul Peppol ca anexă suplimentară (doar dacă Tillor are deja acest UBL) | Pentru fiecare rând de factură, Tillor caută mai întâi un cont Odoo cu același cod ca **numărul din registrul general** al rândului; în caz contrar, folosește contul de venituri implicit. Pentru TVA, Tillor caută în Odoo o TVA de vânzare cu același procent ca pe rând. ### Regimuri de TVA [#btw-regimes] Un rând de factură cu un [regim fără TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), cum ar fi taxarea inversă, are nevoie în Odoo de o TVA de vânzare proprie: un 0% obișnuit ajunge în rubrica greșită a declarației dumneavoastră. De aceea, în setările de export, introduceți pentru fiecare regim pe care îl folosiți **numele TVA-ului de vânzare din Odoo**, exact așa cum apare în Odoo la **Contabilitate > Configurare > Taxe** (într-un Odoo belgian, de exemplu `0% EU S` pentru servicii UE). Există cinci câmpuri: taxare inversă (servicii UE), taxare inversă (cocontractant), livrare intracomunitară, export în afara UE și scutit de TVA. Dacă câmpul unui regim este gol sau TVA-ul nu există în Odoo, exportul acelei facturi se oprește cu un mesaj de eroare. Completați numele și trimiteți din nou factura. ## PDF-ul facturii în Odoo [#factuur-pdf-in-odoo] Cu **Atașați PDF-ul facturii** (implicit activat), Tillor încarcă același PDF ca în Tillor. La un export nou, acest lucru se întâmplă **înainte** de înregistrarea în Odoo, astfel încât previzualizarea din dreapta facturii să poată fi asociată. Numele fișierului urmează numărul facturii Tillor (de ex. `INV_2026_0001.pdf`). Tillor setează acest PDF și ca anexă principală a facturii Odoo. La **Evenimente** ale facturii Tillor vedeți dacă exportul a reușit, inclusiv clientul, factura, PDF-ul și UBL-ul. - Dacă factura Odoo există deja (aceeași referință: numărul facturii Tillor), Tillor actualizează clientul, rândurile, datele și referința de plată. Dacă factura era deja înregistrată în Odoo, Tillor o readuce mai întâi la ciornă, modifică datele și o înregistrează din nou când **Înregistrați facturile automat** este activat sau când factura era deja înregistrată. - Apoi anexele PDF și UBL sunt înlocuite sau adăugate, dacă aceste opțiuni sunt activate. - Dacă încărcarea eșuează după crearea unei facturi-ciornă noi, factura Odoo respectivă este ștearsă, astfel încât următorul export să poată încerca din nou. ## UBL Peppol în Odoo [#peppol-ubl-in-odoo] Cu **Atașați UBL Peppol** (implicit activat), Tillor încarcă UBL-ul Peppol ca anexă suplimentară la factura Odoo. Numele fișierului urmează numărul facturii Tillor (de ex. `INV_2026_0001.xml`). - Tillor nu generează singur UBL: fișierul devine disponibil abia după o livrare Peppol reușită. - Dacă UBL-ul nu este încă gata în momentul exportului, Tillor omite anexa UBL; imediat ce UBL-ul sosește, este adăugat totuși la factura Odoo existentă. - Dacă încărcarea UBL eșuează, întregul export Odoo **nu** eșuează (spre deosebire de PDF). Doar o eroare de PDF după o factură nouă anulează ciorna din Odoo. ## Facturi [#facturen] - La **înregistrarea** sau **reînregistrarea** unei facturi, Tillor exportă automat factura către Odoo. - Manual: acțiunile facturii > export către contabilitate (același buton ca la Admisol). - Se exportă doar facturile cu starea **Înregistrată**. - Dacă există deja o factură Odoo cu același număr de factură Tillor, nu se creează o a doua factură. Tillor actualizează clientul, rândurile și datele pe acea factură (de exemplu după mutarea la alt client sau după reînregistrare) și înlocuiește anexele PDF/UBL când aceste opțiuni sunt activate. - Dacă PDF-ul facturii se modifică după o **plată** (sau altă sumă pe document), Tillor înlocuiește anexa PDF existentă în Odoo imediat ce noul PDF este gata. Nu apare o a doua factură Odoo și nu se înregistrează nicio plată în Odoo. ## Clienți [#klanten] Clienții sunt actualizați sau creați în Odoo cu numărul de client Tillor ca referință. Partenerii existenți cu același număr sunt actualizați. ## Rapoarte de plăți [#betalingsrapporten] Trimiterea automată și manuală a rapoartelor de plăți către Odoo **nu este încă disponibilă**. Procesul zilnic al raportului de plăți omite Odoo fără mesaj de eroare. ## Cerințe în Odoo [#vereisten-in-odoo] - Jurnal de vânzări cu codul setat (implicit `INV`) - Conturi din registrul general cu coduri care corespund rândurilor Tillor sau contului de venituri implicit - Opțional: cote de TVA de vânzare în Odoo cu aceleași procente ca în Tillor ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/boekhouden/betalingsrapporten) Un **raport de plăți** este o prezentare zilnică a plăților dintr-o singură zi calendaristică. Numerotare: `PAYR/YYYY/DDDD` (ziua din an, patru cifre; de ex. `PAYR/2026/0054`). **Conținut:** plăți cunoscute și necunoscute, plata efectuată de Mollie (dacă este cazul) și tranzacțiile bancare necorelate din conturile dumneavoastră bancare. O plată de la Mollie se numește în contabilitate settlement: suma pe care Mollie o virează în contul dumneavoastră bancar pentru o serie de plăți. Contabilul dumneavoastră lucrează cu aceste rapoarte. Dumneavoastră nu trebuie să le creați sau să le închideți. Vezi și [Cum se leagă toate acestea?](/boekhouden#hoe-hangt-dit-samen). ## Ciornă și definitiv [#concept-en-definitief] Un raport are o **stare**: | Stare | Semnificație | |--------|-----------| | **Ciornă** | Raportul **zilei curente**. Plățile de azi (transferuri interne, numerar, conturi bancare și Mollie) sunt deja asociate cu el, iar raportul merge deja către contabilitate. Plățile Mollie apar ca **avans**: bani pe care Mollie încă trebuie să îi vireze. Nu există încă un settlement Mollie, iar raportul nu este încă tipărit automat. | | **Definitiv** | Ziua este închisă. Tillor a asociat settlement-ul Mollie (dacă este cazul), a tipărit raportul și a trimis versiunea definitivă către contabilitate. | Raportul-ciornă de azi apare automat: la rularea de la 09:00 sau mai devreme, imediat ce înregistrați prima plată manuală sau plată în cont bancar din ziua respectivă. Nu trebuie să finalizați niciodată singuri o ciornă; Tillor o face la următoarea rulare zilnică, după ce ziua s-a încheiat. Recunoașteți o ciornă după **numărul de raport gri, subliniat cu puncte** și după insigna **Ciornă**, în listă (coloana și filtrul **Status**), pe pagina de detalii și oriunde se face trimitere la raport. PDF-ul unei ciorne poartă **(ciornă)** în titlu. Numărul raportului și data contabilă în contabilitate rămân aceleași când ciorna devine definitivă. ### Plăți Mollie în ciornă [#mollie-betalingen-op-het-concept] Fiecare plată Mollie achitată și încă nevirată de Mollie ajunge imediat pe raportul-ciornă deschis. În contabilitate, totalul apare ca **avans la furnizorul Mollie**: astfel vedeți în orice moment cât mai aveți de primit de la Mollie. O **debitare directă SEPA aflată în curs** se numără în același mod, chiar dacă încasarea pleacă spre Mollie abia peste câteva zile. Factura apare atunci în Tillor deja ca plătită (în curs de procesare) și tot așa apare în contabilitate. Dacă încasarea eșuează sau este anulată, plata dispare din nou din ciornă. Când ciorna devine definitivă, Tillor compară raportul cu settlement-ul Mollie: - Plățile care **sunt în settlement** rămân pe raport. Avansul este înlocuit de plata reală, cu costurile bancare. - Plățile care **nu sunt** în el (de exemplu card de credit cu plată ulterioară sau încasări după închiderea Mollie) trec la **următorul raport-ciornă** și rămân acolo ca avans. - Dacă o plată din settlement era deja pe o ciornă ulterioară, Tillor o aduce înapoi pe raportul settlement-ului. Se iau în considerare doar plățile recente: achitate în ultima lună și încă fără settlement la Mollie. **Rambursările** se numără imediat. O rambursare pe care Mollie nu a reținut-o încă dintr-o plată apare ca linie negativă pe ciorna deschisă. În contabilitate rămân două avansuri separate la Mollie: unul pentru plățile încă de primit și unul pentru rambursările încă de reținut; ele nu se compensează între ele. Acest lucru este valabil și atunci când plata inițială se află deja pe un raport definitiv mai vechi: Mollie reține atunci suma dintr-o plată ulterioară. Imediat ce un settlement compensează rambursarea, aceasta apare pe raportul acelui settlement și dispare din ciornă. O ciornă merge către contabilitate imediat ce conține ceva ce contabilitatea înregistrează (o plată Mollie sau un transfer intern). Apoi Tillor o retrimite doar dacă se modifică înregistrarea, de fiecare dată sub același număr de document. Modificările sunt grupate: trimiterea pleacă la aproximativ zece secunde după ultima modificare și cel târziu după un minut, astfel încât, de exemplu, atribuirea unei plăți unei facturi produce o singură trimitere. O ciornă cu doar plăți în numerar sau plăți în conturi bancare nu este deci trimisă, iar o plată suplimentară în numerar nu provoacă o nouă trimitere. ## Generare zilnică [#dagelijkse-generatie] În fiecare **zi lucrătoare la 09:00** (de luni până sâmbătă, fusul orar Europa/Bruxelles), Tillor procesează toate rapoartele de la **1 ianuarie până ieri** care lipsesc încă sau sunt încă **ciornă**, **de la cel mai vechi la cel mai nou**: ciornele sunt finalizate, zilele lipsă sunt create imediat ca raport definitiv. Pentru fiecare raport, Tillor așteaptă răspunsul Admisol (succes sau eroare) înainte ca următorul raport să fie procesat și trimis. Apoi Tillor deschide **raportul-ciornă de azi**. Pentru fiecare organizație cu conexiune Mollie activă urmează apoi o sincronizare **limitată**: rapoartele **fără** settlement Mollie de la **o lună calendaristică înainte de ieri** până ieri (vezi [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)). ```mermaid flowchart TD start[Start zi lucrătoare 09:00] --> create[Finalizează ciornele până ieri
creează zilele lipsă] create --> manual[Asociază plățile manuale și din conturi
bancare cu ziua raportului] manual --> rollover[Plăți Mollie nevirate
către ciorna următoare] rollover --> concept[Deschide raportul-ciornă de azi] concept --> mollieCheck{Mollie activ?} mollieCheck -- nu --> done[Gata] mollieCheck -- da --> sync[Actualizează rapoartele fără settlement
din ultima lună] sync --> done ``` ### Ce conține un raport? [#wat-zit-in-een-rapport] | Sursă | Când este asociată | |------|-------------------| | Plăți manuale | Ziua calendaristică a datei de creare (Bruxelles) | | Plăți în conturi bancare | Ziua calendaristică a datei plății (Bruxelles) | | Mollie | Settlement pentru ziua de raport D (vezi [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)) | Plățile în conturi bancare apar **pe** raportul Tillor pentru acea zi, dar **nu** merg în exportul contabil (doar Mollie și transferurile interne). ### Ieri fără settlement Mollie [#gisteren-zonder-mollie-settlement] Dacă raportul de **ieri** trebuie încă finalizat (sau încă creat) și Mollie nu are încă un settlement pentru ieri sau azi, Tillor **așteaptă** până în următoarea zi lucrătoare; raportul rămâne între timp **ciornă**. Zilele mai vechi fără settlement primesc totuși un raport (manual/conturi bancare); Mollie este asociat ulterior la sincronizare. Încasările de sâmbătă și duminică primesc adesea un settlement Mollie abia luni dimineața. Acesta aparține raportului de **duminică** (regula D+1), nu celui de luni. Vezi [exemplele de pe pagina Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden). ## Exemple [#voorbeelden] | Situație | Ce vedeți | |----------|-------------| | Zi lucrătoare, settlement în dimineața următoare | Raportul de **ieri** primește totuși Mollie (regula D+1) | | Transfer intern înregistrat azi | Apare imediat pe **raportul-ciornă de azi** și merge către contabilitate | | Plată Mollie primită azi | Apare imediat pe ciornă, în contabilitate ca avans la Mollie | | Plată Mollie care nu este în settlement-ul raportului | La finalizare trece la următoarea ciornă | | Raportul de ieri încă ciornă, fără settlement | Tillor **așteaptă** până când Mollie publică (următoarea zi lucrătoare la 09:00); raportul rămâne ciornă | | Raportul a existat fără Mollie | Rularea următoare de la 09:00 completează settlement-ul și plățile | | Raportul avea deja un id de settlement | Id-ul **rămâne**; doar plăți suplimentare mai pot fi asociate | Mai multe exemple cu date (weekend, settlement dublu): [Mollie > Exemple](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden). ## Deschiderea și navigarea unui raport de plăți [#betalingsrapport-openen-en-navigeren] 1. Mergeți la **Administrare > Rapoarte de plăți** (marcajul verde **1** din captura de ecran). 2. Deschideți un raport din listă. 3. Pe pagina de detalii, folosiți săgețile din bara de acțiuni din dreapta pentru a merge la raportul anterior sau următor. La trecerea cursorului peste o săgeată vedeți context suplimentar (numărul raportului, data și numărul de plăți) pentru raportul către care navigați. În dreapta paginii de detalii se află **Jurnalul de evenimente**. Acolo vedeți când a fost creat raportul, când a fost finalizat și dacă a fost trimis către contabilitate. ## Probleme? [#problemen] Mollie nu a publicat încă o plată pentru ieri. Tillor așteaptă atunci până în următoarea zi lucrătoare la 09:00. Raportul devine definitiv de la sine, nu trebuie să faceți nimic. O plată ajunge pe raportul zilei în care a fost primită. La numerar și transfer bancar, aceasta este **Data primirii** pe care ați completat-o. Modificați această dată la înregistrare, vezi [Numerar și transfer bancar](/betalingsverwerking/contant). Plata nu se afla în virarea raportului. Ea trece la următoarea ciornă și rămâne acolo ca avans până când Mollie o virează. Doar plățile Mollie și transferurile interne sunt trimise. Un raport cu doar plăți în numerar sau plăți în conturi bancare nu este trimis. O eroare la trimitere o găsiți în **Jurnalul de evenimente** al raportului. ## Vezi și [#zie-ook] ## Termeni [#begrippen] - **Raport de plăți**: prezentarea zilnică a plăților dintr-o singură zi calendaristică, cu numărul `PAYR/an/zi`. - **Ciornă**: raportul zilei curente. Se mai poate modifica. - **Definitiv**: ziua este închisă, iar raportul a fost trimis către contabilitate. - **Avans**: o plată Mollie pe care Mollie nu a virat-o încă. - **Settlement**: plata efectuată de Mollie către dumneavoastră. # Prezentare generală (/ro-RO/boekhouden) Aici transferați plățile și facturile din Tillor către software-ul dumneavoastră de contabilitate. Tillor grupează plățile pe zi într-un raport de plăți și trimite acel raport mai departe, astfel încât contabilul dumneavoastră să nu mai fie nevoit să retranscrie nimic. - Există un raport de plăți pe zi calendaristică. Raportul de azi există deja ca **Ciornă** și devine definitiv imediat ce ziua s-a încheiat. - Tillor procesează rapoartele în fiecare zi lucrătoare (de luni până sâmbătă) la 09:00, ora Belgiei. - Doar plățile Mollie și transferurile interne merg către contabilitate. Numerarul, transferurile bancare și conturile bancare apar pe raport, dar nu sunt trimise mai departe. - Plățile Mollie sunt actualizate la fiecare 15 minute, conturile bancare la fiecare 5 minute. - Mollie virează de obicei în ziua următoare. Weekendul primește adesea o plată abia luni dimineața. - Tillor grupează modificările aduse unei ciorne și o trimite la aproximativ zece secunde după ultima modificare, cel târziu după un minut. - Un client belgian cu număr de TVA are nevoie de un ID Peppol înainte de a putea înregistra o factură. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] ```mermaid flowchart LR F[Factură înregistrată] --> B[Plată] B --> R[Raportul de plăți al zilei] R -- Mollie și transferuri interne --> X[Software de contabilitate] R -- Conturi bancare și numerar --> O[Doar prezentare în Tillor] ``` - O plată este legată de o factură. Vezi [Facturi](/facturen). - Fiecare plată ajunge pe raportul zilei în care a fost primită. - O plată Mollie apare mai întâi ca avans pe raportul-ciornă. Imediat ce Mollie virează, acel avans devine plata reală. - Raportul merge către software-ul dumneavoastră de contabilitate. Care sisteme sunt posibile, citiți la [Sisteme de contabilitate](/boekhouden/betalingsrapporten/boekhoudsystemen). ## Ce face? [#wat-doet-het] - **Rapoarte de plăți**: prezentări zilnice cu numărul `PAYR/YYYY/DDDD`, unde DDDD este ziua din an - **Sisteme de contabilitate**: conexiune cu Admisol, Odoo pentru clienți și facturi (rapoartele de plăți către Odoo vor urma) și [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) la cerere - **Metode de plată**: Mollie, conturi bancare și transferuri interne **Exemplu:** încasările din **20 mai** sunt virate pe **21 mai** și apar pe raportul **`PAYR/2026/0140` (20 mai)**. Mai multe exemple: [exemple Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden). În aplicația web vedeți plățile și facturile ca mai jos. ## Vezi și [#zie-ook] ## Termeni [#begrippen] - **Raport de plăți**: prezentarea zilnică a plăților dintr-o singură zi calendaristică. - **Ciornă**: raportul zilei curente, care se mai poate modifica. - **Definitiv**: un raport închis, trimis către contabilitate. - **Plată (settlement)**: suma pe care Mollie o virează în contul dumneavoastră bancar pentru o serie de plăți. - **Avans la Mollie**: bani pe care Mollie încă trebuie să vi-i verse, așa cum apar în contabilitate. - **Registru general**: numărul de cont din contabilitatea dumneavoastră. Vezi [Produse](/producten). - **Peppol**: rețeaua europeană pentru trimiterea facturilor direct în sistemul destinatarului. Vezi [Peppol](/boekhouden/peppol). # Peppol (/ro-RO/boekhouden/peppol) Cu Peppol trimiteți o factură direct în sistemul de contabilitate al destinatarului, fără PDF. Peppol este rețeaua europeană pentru facturarea electronică. La Tillor se întâmplă automat: dacă un client are un ID Peppol, factura pleacă singură după înregistrare. ## Când folosiți Peppol? [#wanneer-gebruik-je-peppol] Peppol este obligatoriu pentru: - **Facturi B2B belgiene** - trimiterea facturilor către companii belgiene cu număr de TVA - **Achiziții publice** - facturarea către autorități publice în majoritatea țărilor UE Pentru clienții olandezi, Peppol este opțional, dar acceptat. Din 2026, Peppol este obligatoriu pentru toate facturile B2B din Belgia. Asigurați-vă că ID-urile Peppol ale clienților dumneavoastră belgieni sunt setate corect. ## Configurarea Peppol [#peppol-instellen] ### Peppol pentru organizația dumneavoastră [#peppol-voor-je-organisatie] Peppol folosește **numărul de TVA** și **adresa** organizației dumneavoastră. Verificați că aceste date sunt corecte în **Setări**. La prima trimitere prin Peppol, Tillor înregistrează automat organizația dumneavoastră ca expeditor în rețeaua Peppol. Contactați suportul Tillor dacă Peppol nu este încă disponibil pentru organizația dumneavoastră. ### Setarea ID-ului Peppol pentru un client [#peppol-id-instellen-voor-een-klant] Pentru fiecare client căruia doriți să îi facturați prin Peppol: 1. Mergeți la *Clienți > [client] > Facturare* 2. Deschideți **Setări de facturare** 3. Introduceți **ID Peppol** sau alegeți un destinatar prin pictograma de căutare 4. Faceți clic pe **Salvați** Aveți un client belgian cu număr de TVA? Atunci nu puteți înregistra o factură cât timp nu este setat un ID Peppol. ## Căutarea unui destinatar Peppol [#een-peppol-ontvanger-opzoeken] Nu cunoașteți ID-ul Peppol al unui client? Folosiți pictograma de căutare din stânga câmpului: 1. Mergeți la *Clienți > [client] > Facturare* 2. Faceți clic pe pictograma de căutare din stânga **ID Peppol** 3. Tillor caută automat pe baza numărului de TVA al clientului 4. Selectați destinatarul potrivit din rezultate Nu toate companiile sunt înregistrate în rețeaua Peppol. Dacă o companie nu este găsită, puteți trimite în continuare factura prin e-mail. ## Trimiterea facturilor prin Peppol [#facturen-via-peppol-versturen] Când un client are un ID Peppol setat, Tillor trimite automat factura prin Peppol după înregistrare: 1. Creați factura ca de obicei 2. Verificați că **ID Peppol** al clientului este setat corect 3. Verificați rândurile și sumele de pe factura-ciornă, apoi faceți clic pe **Înregistrați factura** 4. Tillor trimite factura automat prin rețeaua Peppol (de obicei în câteva minute după înregistrare) ### Verificarea stării trimiterii [#verzendstatus-controleren] Deschideți factura înregistrată și vedeți **Evenimente** în panoul din dreapta. Aici vedeți dacă factura a fost trimisă prin Peppol sau dacă trimiterea ori livrarea a eșuat. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Factura este trimisă automat imediat ce o înregistrați. Nu trebuie să trimiteți nimic. - O factură trimisă prin Peppol primește eticheta **Trimisă prin Peppol** în lista de pe profilul clientului. - O astfel de factură nu mai poate fi readusă la ciornă și nici mutată la alt client. Corectarea se face cu o factură de credit. Vezi [Corectarea unei facturi](/facturen/corrigeren). - Dacă trimiterea eșuează, vedeți acest lucru la **Evenimente** pe factură și apare o notificare la Comunicare > Notificări. Trimiteți atunci factura prin e-mail, vezi [Trimiterea unei facturi](/facturen/versturen). ## Probleme? [#problemen] Clientul este belgian și are un număr de TVA. Completați ID-ul Peppol la Clienți > client > Facturare, **Setări de facturare**. Dacă nu cunoașteți ID-ul, folosiți pictograma de căutare din stânga câmpului. Nu toate companiile sunt conectate la Peppol. Trimiteți atunci factura prin e-mail. Verificați dacă ID-ul Peppol al clientului este completat înainte de a înregistra. ## Vezi și [#zie-ook] # Trimiterea unei facturi sau a unui memento (/ro-RO/communicatie/e-mails) Cu **Trimiteți notificarea** trimiteți clientului o factură înregistrată. Cu **Trimiteți memento** reamintiți clientului o factură neachitată. Alegeți singuri prin e-mail, SMS, poștă sau WhatsApp, iar apoi urmăriți livrarea în [Notificări](/notificaties). Tillor nu trimite aceste mesaje de la sine la înregistrare. Dumneavoastră decideți când primește clientul ceva. Dacă doriți ca acest lucru să se întâmple automat, puteți folosi o [automatizare](/begrippen#automatisering). Înainte de a începe: - Factura trebuie să fie **înregistrată**. Pe o factură-ciornă butonul nu apare. - Clientul are cel puțin o adresă de e-mail, un număr de telefon sau o adresă poștală completă (stradă, cod poștal și localitate). Altfel nu vedeți **Trimiteți notificarea**. - Pentru un memento trebuie să mai existe o sumă neachitată. O factură achitată nu oferă opțiunea **Trimiteți memento**. - Pentru fiecare canal trebuie să fie cunoscută informația corespunzătoare. Altfel canalul apare dezactivat, cu mesajul **Nicio adresă de e-mail înregistrată**, **Niciun număr de telefon înregistrat** sau **Nicio adresă poștală înregistrată**. ## Trimiterea unei facturi [#een-factuur-versturen] ### Deschideți factura [#open-de-factuur] Mergeți la Administrare > Facturi și deschideți o factură înregistrată. ### Faceți clic pe Trimiteți notificarea [#klik-op-verstuur-notificatie] Se deschide fereastra **Trimiteți notificarea**. Alegeți canalele prin care clientul primește factura. ### Alegeți canalele și faceți clic pe Trimiteți [#kies-de-kanalen-en-klik-op-versturen] Tillor anunță **Notificare trimisă**. Dacă nu reușește, vedeți **Notificarea nu a fost trimisă**. Canalele funcționează astfel: | Canal | Ce primește clientul | |---|---| | **E-mail** | Este activat implicit. Factura este atașată ca PDF la mesaj, la adresa de e-mail din profilul clientului | | **SMS** | Un text scurt cu linkul personal către factură | | **Poștă** | Factura ca scrisoare la adresa poștală din profilul clientului. Este dezactivat implicit. Tillor afișează o sumă orientativă de poștă pentru fiecare scrisoare | | **WhatsApp** | Apare dacă ați conectat WhatsApp Business. Dacă fereastra de 24 de ore a clientului este închisă și nu aveți o metodă de plată la Meta, Tillor blochează trimiterea | ## Trimiterea unui memento [#een-aanmaning-versturen] ### Deschideți meniul de lângă Trimiteți notificarea [#open-het-menu-naast-verstuur-notificatie] Faceți clic pe săgeata de lângă buton și alegeți **Trimiteți memento**. ### Alegeți canalele [#kies-de-kanalen] La un memento, **SMS** este activat implicit dacă clientul are un număr de telefon. Dacă alegeți **Poștă**, clientul primește o scrisoare de memento cu factura ca anexă și un cod QR pe scrisoare. Vezi [Trimiterea unei facturi](/facturen/versturen). ### Confirmați [#bevestig] Faceți clic pe **Trimiteți**. Dacă ați ales și **Corespondență recomandată cu confirmare de primire**, apare **Trimiteți cu cost suplimentar**. Această opțiune există doar dacă poșta recomandată este acceptată în țara adresei poștale. Tillor transferă costurile suplimentare organizației dumneavoastră. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Mesajul apare în Comunicare > Notificări cu canalul, starea și un link către factură. Îl vedeți și la client. - E-mailul și SMS-ul pornesc cu În așteptare și devin Trimis imediat ce au fost livrate. Clientul poate citi mesajul și poate face clic pe link. Ambele le vedeți în fereastra de detalii. - La poștă, starea devine Trimis imediat ce serviciul poștal confirmă că scrisoarea este pe drum sau livrată. La poștă vedeți suma poștală de la momentul trimiterii, iar la poșta recomandată și suma suplimentară. - Dacă un mesaj rămâne blocat mai mult de 5 minute, Tillor încearcă din nou. După 2 zile fără trimitere devine Eșuat. - Dacă mesajul eșuează, factura rămâne așa cum era. Puteți oricând să trimiteți din nou. Doriți ca Tillor să reacționeze singur, de exemplu anunțând un coleg dacă un memento eșuează? Pentru asta puteți crea o [automatizare](/begrippen#automatisering). ## Probleme? [#problemen] Factura este încă o ciornă sau clientul nu are adresă de e-mail, număr de telefon și adresă poștală completă. Înregistrați factura sau completați una dintre aceste informații în profilul clientului. Factura este deja achitată sau încă neînregistrată. Un memento se poate trimite doar pentru o factură înregistrată pentru care mai există o sumă neachitată. Informația lipsește din profilul clientului. Adăugați adresa de e-mail, numărul de telefon sau adresa poștală și deschideți din nou fereastra. Deschideți Comunicare > Notificări și faceți clic pe canalul mesajului. În fereastra de detalii se află mesajul de eroare. De obicei adresa sau numărul nu este corect. Modificați-l în profilul clientului și trimiteți din nou. Trimiterea recomandată este posibilă doar către adrese poștale din țările în care Tillor o acceptă. Pentru alte adrese, poșta obișnuită rămâne posibilă. Verificați starea în Comunicare > Notificări. Dacă mesajul este pe **Returnat**, adresa nu există. Dacă este pe **Trimis**, rugați clientul să verifice folderul de spam. Vezi [Notificări](/notificaties#problemen). ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/communicatie) La Comunicare urmăriți tot ce se spune sau se trimite între parcul dumneavoastră și clienți: apeluri telefonice, mesaje trimise de Tillor și comentarii interne. Tot aici stabiliți ce mesaje ajung la un client și vedeți dacă au ajuns. Conversațiile pe care clienții le încep prin chat sau rețele sociale se află în [inbox](/inbox). - Un mesaj cu factura sau un memento nu pleacă niciodată de la sine la înregistrare. Îl porniți dumneavoastră sau o [automatizare](/begrippen#automatisering) - Dacă un mesaj rămâne blocat mai mult de 5 minute, Tillor încearcă din nou. După 2 zile fără trimitere, apare ca **Eșuat** - Un SMS cu datele organizației poate fi trimis doar în timpul unui apel în curs, din panoul din dreapta jos - Un mesaj nou în inbox apare ca un card în dreapta jos și dispare după aproximativ zece secunde - Apelurile telefonice ajung abia după ce Voys este instalat și planul de apelare indică spre Tillor ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Toată comunicarea cu un client se adună în profilul clientului. Ce pleacă și ce vine circulă prin canale diferite. ```mermaid flowchart LR K[Client] -->|sună| T[Apeluri telefonice] K -->|chat, WhatsApp, Messenger, Instagram| I[Inbox] P[Parc] -->|factură sau memento| N[Notificări] N -->|e-mail, SMS, poștă, WhatsApp| K P -->|comentariu intern| O[Comentarii] T --> KP[Profil client] I --> KP N --> KP ``` - **Apelurile** ajung prin furnizorul dumneavoastră de telefonie și sunt legate de client prin numărul de telefon. - **Mesajele de la clienți** prin chat sau rețele sociale ajung în inbox. - **Mesajele către clienți** le trimiteți dintr-o factură. Livrarea o urmăriți la Notificări. - **Comentariile** sunt interne. Clienții nu le văd. ## Componente [#onderdelen] ## Termeni [#begrippen] - **Furnizor de telefonie**: compania care vă oferă linia telefonică, de exemplu Voys. - **Notificare**: un mesaj pe care Tillor îl trimite unui client sau unui [utilizator](/begrippen#gebruiker). - **Canal**: calea pe care circulă un mesaj, cum ar fi e-mail, SMS, poștă sau WhatsApp. - **Inbox**: locul unde ajung mesajele clienților prin chat și rețele sociale. - **Comentariu**: o notă internă la un [client](/begrippen#klant), o factură sau o altă înregistrare. Mai mulți termeni găsiți în [lista de termeni](/begrippen). # Tipuri de notificări (/ro-RO/communicatie/notificatietypes) Această listă arată fiecare tip de mesaj pe care îl puteți întâlni în [prezentarea notificărilor](/notificaties) și când îl trimite Tillor. Tipul îl vedeți în coloana **Tip** și puteți filtra după el cu filtrul **Tip**. Denumirile corespund ecranului. Mesajele către clienți pleacă prin e-mail, SMS, poștă sau WhatsApp. Mesajele către colegi pleacă prin push, e-mail sau telefon, conform preferințelor colegului respectiv. Vezi [Notificări în aplicație](/notificaties#meldingen-in-de-app). Mesaje precum **Factură nouă** sau **Memento factură** nu sunt trimise automat de Tillor la înregistrarea unei facturi. Le porniți dumneavoastră cu **Trimiteți notificarea** sau **Trimiteți memento** pe factură. Vezi [Trimiterea unei facturi sau a unui memento](/communicatie/e-mails). ## Facturi și plăți [#facturen-en-betalingen] | Tip | Când este trimis | |---|---| | Factură nouă | Către client, când trimiteți o factură. Factura este atașată la mesaj | | Factură plătită | Către client, când o factură a fost achitată | | Memento factură | Către client, ca reamintire pentru o factură neachitată | | Memento transfer bancar manual | Către clientul care plătește prin transfer bancar, cu sfatul de a folosi comunicarea structurată | | Arhivă facturi | Către adresa de suport a organizației dumneavoastră, cu contabilul în copie, când o arhivă de facturi este gata | | Eșec la trimiterea facturii Peppol | Când o factură nu a putut fi trimisă prin Peppol | | Trimiterea facturii către software-ul de contabilitate a eșuat | Când trimiterea unei facturi către software-ul dumneavoastră de contabilitate eșuează | | Trimiterea facturii către software-ul de contabilitate restabilită | Când acea trimitere a reușit totuși după notificări anterioare | | Trimiterea raportului de plăți către software-ul de contabilitate a eșuat | Când trimiterea unui raport de plăți eșuează | | Facturi anulate reînregistrate | Când facturile anulate au fost reînregistrate automat în timpul nopții | | Plată bancară care nu stinge factura | Când o plată bancară a fost asociată cu o factură, dar factura rămâne apoi neachitată | | Consum mult peste normal, oprit la facturarea automată | Când un client nu a fost facturat automat deoarece consumul de electricitate sau apă este cu mult peste normal | | Preț de produs programat aplicat | Către organizația dumneavoastră, în ziua în care intră în vigoare un [preț programat](/producten/prijzen-plannen). Prețul vechi și cel nou sunt afișate alăturat | | Rambursare automată pornire mașină | Când o plată online pentru pornirea unei mașini a fost rambursată deoarece mașina nu a pornit | | Revizuire plăți NFC offline | Când plățile NFC offline nu au putut fi verificate după sincronizare | | Sold scăzut etichetă NFC | Către client, când soldul unei etichete NFC este scăzut | ## Mandate SEPA și semnare [#sepa-mandaten-en-ondertekenen] | Tip | Când este trimis | |---|---| | Cerere de semnare a mandatului SEPA | Către client, cu linkul pentru semnarea mandatului, inclusiv pentru mementourile dinainte ca linkul să expire | | Cod de verificare mandat SEPA | Către client, cu codul pe care îl introduce pe pagina de semnare, prin SMS sau e-mail | | Copie a mandatului SEPA semnat | Către client, imediat ce mandatul este activ | | Mandat SEPA revocat | Către client, cu documentul semnat atașat încă o dată | | Cerere de semnătură | Către un semnatar când îi vine rândul, prin e-mail sau prin SMS dacă nu există adresă de e-mail | | Cod de semnare | Către semnatar, cu codul pentru semnare, prin SMS sau e-mail | | Document semnat | Către toți semnatarii, cu PDF-ul semnat, imediat ce ultimul a semnat | | Semnătură refuzată | Către colegul care a trimis cererea, când un semnatar refuză | | Acceptare DPA | Confirmarea acceptării DPA, cu DPA semnat ca anexă | | Cod de verificare DPA | Prin SMS către responsabil, cu codul pentru acceptarea acordului de prelucrare a datelor | ## Contoare, controlere și acces [#meters-controllers-en-toegang] | Tip | Când este trimis | |---|---| | Alarmă de contor | Când un contor are o alarmă nouă | | Alarmă de contor rezolvată | Când o alarmă de contor a fost remediată | | Eliminare contor | Când contoarele au fost eliminate | | Contoare care necesită atenție | Prezentare a contoarelor ale căror măsurători lipsesc sau care au o alarmă de mult timp | | Controller indisponibil | Când un controller nu dă semne de viață timp de peste 5 minute | | Supraîncălzirea controlerului | Notificare urgentă când un controler se încălzește prea tare | | Conector offline | Când conectorul parcului dumneavoastră nu mai dă semne de viață | | Conector din nou online | Când conectorul este din nou accesibil | | Gateway HTTP al conectorului indisponibil | Când conectorul încă funcționează, dar camerele nu îl mai ating | | Cameră LPR offline | Când o cameră de numere de înmatriculare nu răspunde timp de peste 5 minute | | Punct de acces deschis prea mult timp | Când un punct de acces rămâne deschis mai mult decât este permis | | Rezumat ieșiri cu numere de înmatriculare expirate | Rezumat al vehiculelor cu o perioadă de acces expirată care au ieșit cât timp recepția era închisă | | Cod de acces QR | Către client, cu codul QR pentru acces | | Tabletă sau chioșc offline | Când o tabletă sau un chioșc nu dă semne de viață în afara perioadei sale de repaus | | Bateria tabletei sau a chioșcului aproape goală | Când o tabletă sau un chioșc este aproape descărcat și nu se încarcă | ## Sarcini, comentarii și inbox [#taken-opmerkingen-en-inbox] | Tip | Când este trimis | |---|---| | Sarcină atribuită | Către colegul căruia i-a fost atribuită o sarcină | | Sarcină neatribuită | Către colegul căruia i-a fost retrasă o sarcină | | Sarcină finalizată | Când o sarcină a fost finalizată | | Memento sarcină | Când a venit momentul reamintirii unei sarcini | | Termen sarcină | Când o sarcină ajunge la termen fără a fi finalizată | | Rezumat zilnic al vizualizării | Prin e-mail, rezumatul zilnic al unei vizualizări de sarcini pe care o urmăriți | | Răspuns la comentariu | Cineva a răspuns la un comentariu | | Mențiune în comentariu | Ați fost menționat într-un comentariu | | Comentariu rezolvat | Un comentariu a fost marcat ca rezolvat | | Răspuns la comentariu respins | Când un răspuns prin e-mail la un comentariu nu a fost postat deoarece adresa expeditorului nu este corectă | | Mesaj inbox | Când sosește un mesaj nou în inbox | | Predare urgentă AI | Când asistentul AI vă predă o conversație urgentă | | Urmărire chat site web | Către un vizitator al site-ului cu un răspuns necitit, cu un link pentru reluarea conversației | ## Automatizări și integrări [#automatiseringen-en-integraties] | Tip | Când este trimis | |---|---| | Mesaj de automatizare | Text pe care o automatizare îl trimite unui client | | Notificare de automatizare | Notificare pe care o automatizare o trimite unui coleg, prin push, e-mail sau ambele | | Rularea automatizării a eșuat | Către creatorul unei automatizări când o rulare s-a încheiat cu o eroare | | Livrarea webhook eșuează | Când livrările către webhook-ul dumneavoastră eșuează și Tillor continuă să încerce | | Livrarea webhook a eșuat definitiv | Când Tillor nu a putut livra un eveniment webhook după toate încercările | | Notificare externă | Mesaj pe care un sistem conectat l-a trimis el însuși, vezi [Notificări externe](/notificaties#externe-notificaties) | Un webhook este o conexiune prin care Tillor transmite automat un eveniment către un alt sistem. ## Cont și organizație [#account-en-organisatie] | Tip | Când este trimis | |---|---| | Bun venit utilizator | Mesaj de bun venit pentru un utilizator nou | | Verificarea e-mailului | Linkul pentru confirmarea unei adrese de e-mail | | Invitație organizație | Invitație pentru cineva fără cont Tillor de a deveni membru al organizației dumneavoastră | | Detalii organizație | SMS către un apelant cu un link către datele organizației dumneavoastră | | Trimitere formular de contact | Când cineva completează formularul de contact | | Memento program de sărbătoare | Reamintire de a completa programul de funcționare pentru o sărbătoare viitoare | | Document șters | Către utilizatorul care a șters un document | ## Notificări de la echipa Tillor [#meldingen-van-het-tillor-team] Aceste mesaje sunt destinate echipei Tillor și în mod normal nu le vedeți: **Incident de sistem**, **Alertă de securitate**, **Alertă Grafana** și **Defecțiune gateway LoRa**. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/communicatie/providers) Printr-un furnizor de telefonie precum Voys, Tillor vede cine sună și păstrează apelurile, înregistrările și transcrierile. Conectați furnizorul la Setări > Integrări. Twilio nu este un furnizor de telefonie: trimite mesajele SMS ale Tillor și a fost configurat chiar de Tillor. ## Furnizori disponibili [#beschikbare-providers] # Twilio (/ro-RO/communicatie/providers/twilio) Twilio trimite în numele Tillor mesajele SMS și, dacă este configurat, notificările WhatsApp. Nu este un furnizor de telefonie precum Voys și nu îl instalați singuri: Tillor l-a configurat pentru întreaga platformă. ## Diferența față de Voys [#verschil-met-voys] | | Voys | Twilio | |---|---|---| | Telefonie (apeluri, convorbiri) | Da | Nu | | Configurare în Tillor | **Setări > Integrări** | Nu - setare a platformei | | Vizibil pentru utilizatori | Apeluri, înregistrări, transcrieri | SMS-uri trimise și notificări WhatsApp | ## Ce face Twilio în Tillor? [#wat-doet-twilio-in-tillor] Imediat ce Twilio este configurat, Tillor îl folosește, printre altele, pentru: - **trimiterea notificărilor prin SMS** (de exemplu mementouri de plată, confirmări de rezervare și notificări de facturi) - **trimiterea detaliilor organizației prin SMS** din **Comunicare > Apeluri telefonice** (butonul SMS cu tooltip **Trimiteți detaliile organizației apelantului prin SMS**) - **livrarea notificărilor WhatsApp** atunci când WhatsApp prin Twilio este configurat pe platformă - **folosirea codurilor de verificare prin SMS** la semnarea acordului de prelucrare a datelor (DPA) SMS-urile trimise și notificările WhatsApp le urmăriți în **Comunicare > Notificări**: Configurarea Twilio nu o faceți singuri în Tillor. Cereți administratorului platformei sau suportului Tillor conexiunea potrivită pentru mediul dumneavoastră. ## Fără instalare în Integrări [#geen-installatie-in-integraties] Spre deosebire de Voys, Twilio **nu** se găsește la **Setări > Integrări**. Conexiunea este administrată de administratorul mediului Tillor. ## Vezi și [#zie-ook] # Telefonie Voys (/ro-RO/communicatie/providers/voys) Cu integrarea Voys, Tillor vede cine sună și afișează imediat datele clientului. Apelurile, înregistrările și transcrierile ajung apoi la [Apeluri telefonice](/communicatie/telefoongesprekken). Voys este un furnizor de telefonie pentru companii. Înainte de a începe: - Aveți nevoie de un cont Voys VoIP activ și de acces la setările planului de apel din Voys. - Aveți nevoie de dreptul **Gestionați integrările**. - Numărul de telefon al apelantului trebuie să fie trecut în profilul clientului sau la o persoană de contact, altfel Tillor nu asociază apelul cu un client. ## Configurarea Voys [#voys-instellen] 1. Mergeți la **Setări** (în bara laterală, sub **Asistență**) 2. Alegeți **Integrări** și deschideți **Voys** din listă 3. Pe pagina de detalii, completați datele dumneavoastră Voys (`username`, `password`, `client_uuid`, `token`) și faceți clic pe **Instalați** Aveți nevoie de un cont Voys VoIP activ. După instalare și configurare, Tillor asociază automat apelurile cu clienții când numărul de telefon corespunde unui client sau unui contact. ## Găsirea URL-urilor pentru Voys [#urls-voor-voys-terugvinden] Tillor și Voys comunică între ele prin adrese (URL-uri). La unii pași, Voys cere un răspuns de la Tillor, de exemplu dacă sunteți deschis. Răspunsul este **ACK** (da, continuă) sau **NAK** (nu, urmează celălalt traseu). Un webhook este o astfel de adresă pe care Voys o apelează în timpul unui apel. Pentru webhook-uri, căutarea numelui apelantului și codurile de acces folosiți URL-urile pe care Tillor le generează pentru dumneavoastră. 1. Mergeți la **Setări > Integrări** și deschideți **Voys** 2. După instalare, pe pagina de detalii, la **Setări**, se află blocul **URL-uri de configurat** - copiați de acolo URL-ul potrivit pentru fiecare scop Aici găsiți, printre altele: - **Notificări conversații** - URL de webhook pentru evenimentele apelurilor - **Webhook pentru identificarea apelantului** - URL pentru căutarea numelui apelantului în planul de apel Voys - **Agendă XML** - URL prin care telefoanele VoIP preiau agenda telefonică - **Coduri de acces** - URL pentru comanda punctului de acces (barieră, poartă sau ușă) prin planul de apel - **Webhook program de funcționare** - ACK dacă Tillor este deschis, NAK dacă Tillor este închis - **Webhook apelant permis** - ACK dacă apelantul poate fi conectat, NAK dacă apelantul trebuie trimis la mesageria vocală - **Webhook de rutare** - ACK cu o destinație, NAK dacă nu este setată nicio destinație În planul de apel Voys folosiți aceleași variabile care sunt indicate în Tillor (precum `{callerid}`, `{did}`, `{callername}`, `{callid}` și `{code}`). ## Configurarea notificărilor de apel în Voys [#gespreksnotificaties-in-voys-configureren] 1. În Voys, deschideți modulul [Notificări conversații](https://freedom.voys.nl/redirect/CallNotification) 2. Faceți clic pe **Adăugați** 3. La package/service alegeți **Aangepast** 4. Lipiți URL-ul Tillor de la **Notificări conversații** 5. Salvați Documentația Voys: - [Notificări de apel](https://help.voys.nl/gespreksnotificaties) ## Configurarea numelor apelanților (caller lookup) în planul de apel [#bellernamen-caller-lookup-in-call-plan-configureren] Pentru căutarea numelui apelantului folosiți în Voys un pas de tip webhook în planul de apel. 1. În Tillor, deschideți URL-ul **Webhook pentru identificarea apelantului** (la **Setări > Integrări > Voys**, sub **URL-uri de configurat**) și copiați-l 2. În Voys, deschideți modulul [Webhooks](https://help.voys.nl/webhooks) și creați un webhook cu acest șablon de URL 3. Activați acel webhook în planul de apel prin pasul de webhook 4. În șablonul de URL folosiți variabilele acceptate de Voys (`{callerid}`, `{did}`, `{callername}` și, la nevoie, `{code}`) 5. În rutarea webhook-ului setați **Variabele bellernaam**, pentru ca numele returnat să fie afișat pe aparate Webhook-urile pentru programul de funcționare și pentru rutare nu caută nume de apelanți. Pentru aceasta folosiți acest pas separat. Mai multe informații: - [Webhooks](https://help.voys.nl/webhooks) - [Ce sunt notificările de apel (diferența față de webhook-uri)](https://help.voys.nl/gespreksnotificaties) ## Programul de funcționare și destinațiile în planul de apel [#openingsuren-en-bestemmingen-in-het-belplan] Tillor este sursa pentru programul de funcționare, vacanțe și excepțiile de sărbători legale. Voys nu mai trebuie să cunoască singur acel calendar. 1. La **Setări > Integrări > Voys**, alegeți aparatul Voys pentru **deschis** și, opțional, pentru **închis** 2. Copiați **Webhook program de funcționare** sau **Webhook de rutare** din **URL-uri de configurat** 3. În Voys, creați un [webhook](https://help.voys.nl/webhooks) cu acel șablon de URL 4. Puneți webhook-ul ca pas în planul de apel, **deasupra** eventualelor meniuri de opțiuni 5. Lăsați **Menu gebruiken** dezactivat Două modele: - **Webhook program de funcționare** - `status=ACK` urmează traseul **HTTP en menu gelukt** (deschis), `status=NAK` urmează **HTTP of menu mislukt** (închis). Dacă este setată o destinație pentru deschis, aceasta se află la ACK ca `destination`. - **Webhook de rutare** - Tillor alege destinația. Setați în pasul reușit **Variabele eindbestemming**. ACK + `destination` dacă există o destinație, altfel NAK. La o eroare sau la un timeout, Voys urmează traseul eșuat. Tratați acest caz ca fiind închis. Documentația Voys: [Webhooks](https://help.voys.nl/webhooks). ## Trimiterea automată a apelanților la mesageria vocală [#bellers-automatisch-naar-voicemail-sturen] Cu **Webhook apelant permis**, lăsați Voys să decidă pentru fiecare apelant dacă apelul este conectat. Tillor verifică dacă numărul apelantului aparține unui client care are mesageria vocală automată activată. Mai întâi configurați planul de apel: 1. Copiați **Webhook apelant permis** din **URL-uri de configurat** la **Setări > Integrări > Voys** 2. În Voys, creați un [webhook](https://help.voys.nl/webhooks) cu acel șablon de URL 3. Puneți webhook-ul ca pas în planul de apel, **deasupra** pașilor care conectează apelul 4. Lăsați **Menu gebruiken** dezactivat 5. Direcționați traseul **HTTP en menu gelukt** către rutarea normală și traseul **HTTP of menu mislukt** către mesageria vocală 6. La **Setări > Integrări > Voys**, sub **Dirijare apeluri**, bifați **Mesagerie vocală automată în Voys** Cât timp această opțiune este dezactivată, nu vedeți **Trimite apelurile la mesageria vocală** în profilul clientului. Apoi activați mesageria vocală automată pentru fiecare client: 1. Deschideți profilul clientului și mergeți la fila **Comunicare** 2. La **Setări de comunicare**, bifați opțiunea **Trimite apelurile la mesageria vocală** 3. Faceți clic pe **Salvați** Iată cum funcționează răspunsul: - **ACK** - apelantul poate trece. Aceasta se aplică și numerelor necunoscute și apelanților cu număr ascuns. - **NAK** - numărul aparține unui client cu mesagerie vocală automată. Voys urmează traseul eșuat. Tillor compară numărul apelantului cu numărul de telefon din profilul clientului, indiferent de spații sau de notația prefixului de țară. Numerele de telefon ale persoanelor de contact nu contează. La o eroare sau la un timeout, Voys urmează tot traseul eșuat. Atunci toți apelanții ajung temporar la mesageria vocală, nu doar cei blocați. Folosiți, așadar, o destinație de mesagerie vocală ale cărei mesaje le verificați regulat. Acest webhook nu ține cont de programul de funcționare. Combinați-l cu webhook-ul pentru programul de funcționare sau cu cel de rutare, punând ambele ca pași separați în planul de apel. Documentația Voys: [Webhooks](https://help.voys.nl/webhooks). ## Rutare fixă pentru fiecare apelant [#vaste-routering-per-beller] Același **Webhook de rutare** poate trimite imediat un apelant către un aparat Voys propriu, un număr de interior sau un număr de telefon. Aceasta se aplică doar clienților pentru care ați ales o destinație și doar dacă **Rutare fixă în Voys** este activată. 1. Puneți **Webhook de rutare** în planul de apel, ca la programul de funcționare 2. Setați în pasul reușit **Variabele eindbestemming** 3. La **Setări > Integrări > Voys**, sub **Dirijare apeluri**, bifați **Rutare fixă în Voys** Cât timp această opțiune este dezactivată, nu vedeți **Rutare fixă a apelurilor** în profilul clientului. Webhook-ul folosește atunci doar aparatul pentru deschis sau închis. Apoi setați destinația pentru fiecare client: 1. Deschideți profilul clientului și mergeți la fila **Comunicare** 2. La **Rutare fixă a apelurilor**, alegeți un aparat Voys sau **Altele** pentru un număr de telefon sau un număr de interior (de exemplu 411) 3. Alegeți **Niciuna** pentru a dezactiva rutarea fixă 4. Faceți clic pe **Salvați** Iată cum alege webhook-ul de rutare destinația: - Dacă pentru acest apelant există o destinație fixă, aceasta este `destination`. - Altfel, `destination` este aparatul Voys pentru deschis sau închis. - **NAK** - nu există nicio destinație fixă și nici vreun aparat pentru starea curentă. Aceasta se aplică și numerelor necunoscute și apelanților cu număr ascuns, cât timp nu există un aparat pentru deschis sau închis. Tillor compară numărul apelantului cu numărul de telefon din profilul clientului, indiferent de spații sau de notația prefixului de țară. Numerele de telefon ale persoanelor de contact nu contează. La o eroare sau la un timeout, Voys urmează traseul eșuat. Documentația Voys: [Webhooks](https://help.voys.nl/webhooks). ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Fiecare apel care intră sau iese apare în Comunicare > Apeluri telefonice, cu clientul alături dacă numărul corespunde. Vezi [Apeluri telefonice](/communicatie/telefoongesprekken). - La un apel primit, apelantul apare ca un card în dreapta jos în Tillor, cu datele clientului. - Înregistrările și transcrierile vin odată cu terminarea apelului, dacă înregistrarea apelurilor este activată în contul dumneavoastră Voys. ## Probleme? [#problemen] Blocul apare abia după instalare. Faceți mai întâi clic pe **Instalați** pe pagina de detalii Voys. Voys transmite apelurile doar dacă modulul de notificări de apel folosește URL-ul **Notificări conversații** din Tillor. Verificați în Voys dacă acel URL este acolo și dacă provine din blocul **URL-uri de configurat**. Verificați dacă webhook-ul pentru căutarea numelui apelantului se află în planul de apel și dacă **Variabele bellernaam** este setată în pasul reușit. Webhook-urile pentru programul de funcționare și pentru rutare nu caută nume. Bifați mai întâi **Mesagerie vocală automată în Voys** la Setări > Integrări > Voys, sub **Dirijare apeluri**. Abia apoi opțiunea apare în fila **Comunicare** a clientului. Același lucru este valabil pentru **Rutare fixă a apelurilor**. La o eroare sau la un timeout al unui webhook, Voys urmează traseul eșuat. Verificați dacă Tillor este accesibil și dacă URL-ul din webhook este încă corect. Vezi avertismentul de la [Trimiterea automată a apelanților la mesageria vocală](#bellers-automatisch-naar-voicemail-sturen). Tillor compară numărul cu numărul de telefon din profilul clientului. Numerele persoanelor de contact contează pentru asocierea apelurilor, dar nu pentru mesageria vocală și rutarea fixă. ## Vezi și [#zie-ook] # Apeluri telefonice (/ro-RO/communicatie/telefoongesprekken) La Comunicare > Apeluri telefonice găsiți fiecare apel care intră sau iese prin furnizorul dumneavoastră de telefonie, cu clientul alături dacă Tillor recunoaște numărul. Folosiți pagina pentru a urmări apelurile și pentru a trimite apelantului, în timpul unui apel în curs, datele organizației dumneavoastră prin SMS. Înainte de a începe: - Apelurile apar abia după ce ați instalat și configurat [Voys](/communicatie/providers/voys). Fără această legătură, lista rămâne goală. - Înregistrările și transcrierile există doar dacă înregistrarea apelurilor este activată în contul dumneavoastră Voys. - Butonul SMS dintr-un apel în curs funcționează doar dacă trimiterea de SMS este configurată pentru mediul dumneavoastră. Vezi [Twilio](/communicatie/providers/twilio). ## Vizualizarea apelurilor [#gesprekken-bekijken] În tabelul **Toate apelurile** vedeți pentru fiecare apel: | Coloană | Ce vedeți | |---|---| | **Direcție** | **Primit** sau **Efectuat** | | **Început la** | Data și ora | | **De la** și **Către** | Numerele de telefon | | **Durată** | Lungimea apelului, după încheiere | | **Client** | Clientul asociat sau un nume transmis de Voys (neverificat) dacă apelul nu aparține niciunui client | | **Stare** | Stadiul în care se află apelul | Tillor asociază un apel cu un client pe baza numărului de telefon. Dacă numărul nu aparține încă unui client, adăugați-l în profilul clientului sau la o persoană de contact. Apelurile noi vor fi apoi asociate automat. Un apel trece prin aceste stări: | Stare | Semnificație | |---|---| | Creat | Apelul tocmai a început | | Sună | Telefonul sună | | Răspuns | Cineva a răspuns | | În curs | Apelul este în desfășurare | | Transfer asistat și Transfer direct | Apelul a fost transferat, cu sau fără anunț | | Închis și Încheiat | Apelul s-a terminat | | Eșuat | Apelul nu s-a realizat | ## Trimiterea datelor organizației prin SMS [#organisatiegegevens-via-sms-versturen] Un apelant vă cere adresa sau programul de funcționare? Trimiteți-le prin SMS în câteva secunde, în timp ce apelul este în curs. ### Așteptați până când apelul este în curs [#wacht-tot-het-gesprek-loopt] Acțiunea se află în panoul cu apeluri active din dreapta jos, nu în listă. Apelul trebuie să aibă starea **În curs**. Pe telefon, atingeți mai întâi pictograma de telefon din dreapta sus. ### Extindeți apelul [#klap-het-gesprek-uit] Dacă apelul este restrâns, extindeți-l. ### Faceți clic pe pictograma de mesaje [#klik-op-het-berichtenpictogram] Tooltip-ul spune **Trimiteți detaliile organizației apelantului prin SMS**. ### Alegeți limba [#kies-de-taal] Tillor marchează limba pe care o recunoaște la apelant cu *(detectat)*. Alegeți limba SMS-ului. Apelantul primește un link scurt către o pagină publică cu datele organizației dumneavoastră. Dacă adresa organizației este completată, apar și butoane de traseu pentru **Waze**, **Google Maps** și **Apple Maps**. Butonul de e-mail de pe acea pagină are deja un subiect și un text, cu numărul și ora apelului în ele dacă sunt cunoscute. Linkul către site primește etichete de urmărire, astfel încât să puteți măsura câți apelanți fac clic. ## Înregistrări și transcrieri [#opnames-en-transcripties] ### Deschideți apelul [#open-het-gesprek] Faceți clic în listă, la apel, pe **Transcriere**. Se deschide fereastra **Detalii apel**. ### Alegeți o filă [#kies-een-tabblad] La **Înregistrare**, apelul se redă în browserul dumneavoastră. La **Transcriere** se află textul scris pe vorbitori, iar la **Rezumat** un scurt rezumat. Tillor creează singur transcrierea și rezumatul de îndată ce apelul s-a terminat și există o înregistrare. Aceasta durează puțin. Un apel fără înregistrare nu are file. Înregistrările apelurilor pot conține informații sensibile pentru confidențialitate. Asigurați-vă că respectați legislația privind protecția datelor (GDPR) atunci când înregistrați apeluri și informați apelanții că apelurile sunt înregistrate. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - După încheiere, un apel apare în listă cu durata, clientul și, dacă există o înregistrare, o transcriere și un rezumat. - Un SMS trimis cu datele organizației apare în Comunicare > Notificări cu tipul **Detalii organizație**. ## Probleme? [#problemen] Verificați dacă Voys este instalat la Setări > Integrări și dacă notificările de apel din Voys indică spre URL-ul din Tillor. Vezi [Telefonie Voys](/communicatie/providers/voys). Tillor compară numărul apelantului cu numărul de telefon din profilul clientului sau de la o persoană de contact. Adăugați numărul și apelurile noi vor fi asociate. Apelurile deja intrate rămân așa cum au fost. Butonul se află doar în panoul cu apeluri active din dreapta jos și doar cât timp apelul are starea **În curs**. Nu se află în lista de pe această pagină. Voys nu a înregistrat apelul. Activați înregistrarea apelurilor în contul dumneavoastră Voys. Apelurile anterioare nu pot fi înregistrate retroactiv. ## Vezi și [#zie-ook] # Connector (/ro-RO/connector) Tillor Connector este o cutie mică în rețeaua parcului dumneavoastră. Leagă Tillor de dispozitivele de la fața locului: imprimante de bonuri, bariere, controlere de acces și cititoare de identitate. Fără connector, Tillor nu poate comanda aceste dispozitive. Dacă este oprit, imprimarea și comanda barierelor din Tillor nu funcționează. Cum procedați în acest caz găsiți la [Probleme](#problemen). Tillor livrează connectorul preconfigurat și îl monitorizează de la distanță. Nu trebuie să instalați sau să actualizați nimic. - Fiecare organizație are un singur connector. Dacă administrați mai multe parcuri, fiecare parc (organizație) primește propria cutie. - Connectorul se anunță la Tillor la fiecare 15 secunde. - Dacă Tillor nu aude nimic de la el timp de 3 minute, echipa Tillor primește automat o notificare. - Actualizările le instalează Tillor singur, fără ca dumneavoastră să faceți ceva. - Connectorul stabilește singur o conexiune securizată, de ieșire. Nu trebuie să deschideți porturi în router. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Connectorul se află între Tillor, pe internet, și dispozitivele din propria dumneavoastră rețea. Tillor trimite o comandă connectorului, iar connectorul o execută pe dispozitivul potrivit. Invers, connectorul raportează ce s-a întâmplat, de exemplu o plăcuță de înmatriculare citită. ```mermaid flowchart LR T[Tillor] <-->|conexiune securizată prin internet| C[Connector în parcul dumneavoastră] C --> P[Imprimantă de bonuri] C --> S[Barieră sau controler de acces] C --> I[Cititor de identitate] ``` De exemplu: - Imprimați un bon sau o etichetă. Tillor îl trimite connectorului, iar acesta îl pune pe imprimanta dumneavoastră. - Dați unui client o metodă de acces. Tillor trimite modificarea prin connector către controlerele de acces, vezi [Controlul accesului](/toegangscontrole#hoe-hangt-dit-samen). - Un oaspete scanează o carte de identitate la check-in. Connectorul trimite scanarea către Tillor, vezi [Scanări de identitate](/identiteitsscans). ## Ce face Tillor pentru dumneavoastră [#wat-tillor-voor-je-doet] - **Livrare**: cutia ajunge preconfigurată pentru organizația dumneavoastră. - **Instalare și conectare**: conectăm imprimantele, barierele și scanerele dumneavoastră la pornire. - **Actualizări**: versiunile noi sunt instalate automat, fără întrerupere. - **Monitorizare**: Tillor vede dacă connectorul este conectat și în caz de cădere dă singur de veste. ## Ce aveți nevoie dumneavoastră [#wat-je-zelf-nodig-hebt] - O priză în apropierea echipamentelor de rețea - Un cablu de rețea către routerul sau switch-ul dumneavoastră, în aceeași rețea cu imprimantele și barierele - O conexiune stabilă la internet ## Dispozitive conectate [#gekoppelde-apparaten] - **Imprimante**: vezi [Imprimantă](/printer) pentru configurare și utilizare. - **Bariere, porți și controlere de acces**: vezi [Controlul accesului](/toegangscontrole). - **Cititoare de identitate**: vezi [Scanări de identitate](/identiteitsscans) pentru crearea de clienți dintr-o scanare și perioadele de păstrare. În rețeaua parcului dumneavoastră puteți vedea starea connectorului la `http://[adres-van-de-connector]:3000/`. Acolo vedeți conexiunea cu Tillor, coada de imprimare și ultimele plăcuțe de înmatriculare citite. Suportul Tillor vă dă adresa la instalare. Mai multe despre protocol găsiți la [MQTT](/ontwikkelaars/mqtt). ## Probleme? [#problemen] Verificați dacă cutia primește curent și dacă cablul de rețea este bine fixat. Verificați dacă internetul din parcul dumneavoastră funcționează. Apoi scoateți scurt ștecherul cutiei și introduceți-l la loc. Dacă problema persistă, contactați suportul Tillor. O cădere o vedem de obicei deja noi înșine. Verificați mai întâi starea connectorului, vezi sfatul tehnic de mai sus. Verificați dacă dispozitivul este pornit și se află în aceeași rețea. Dacă connectorul este conectat și dispozitivul este accesibil, dar nu se întâmplă nimic, contactați suportul. Uitați-vă la **Operațiuni controler** pe pagina Controlul accesului. Dacă o comandă rămâne pe **În așteptare**, connectorul este offline. ## Noțiuni [#begrippen] - **Connector**: cutia din parcul dumneavoastră care leagă Tillor de dispozitivele dumneavoastră. - **Controler de acces**: o cutie de lângă o barieră care citește tag-uri și coduri QR. - **Soluție gestionată**: Tillor livrează, configurează și întreține cutia pentru dumneavoastră. Mai multe explicații găsiți în [glosar](/begrippen). ## Vezi și [#zie-ook] # Documente (/ro-RO/documenten) Cu gestionarea documentelor păstrați fișiere la un client, precum polițe de asigurare, cărți de identitate, contracte, autorizații și alte anexe. Fișierele care nu aparțin încă nimănui se află în lista centrală de documente până când le asociați unui client. Începeți cu [Documente la un client](#documenten-bij-een-klant) sau cu [Lista centrală de documente](#de-centrale-documentenlijst). - Un fișier poate avea cel mult 250 MB. - Puteți încărca PDF, Word, mesaje Outlook (.msg), Excel, PowerPoint, imagini (JPEG, PNG, GIF) și fișiere text. - Imaginile sunt convertite de Tillor în PDF după încărcare. Celelalte tipuri de fișiere rămân cum sunt, cu o previzualizare PDF alături. - Pentru un document șters primiți o copie ca anexă pe adresa dumneavoastră de e-mail, dacă fișierul a putut fi salvat. - Un PDF care aparține unei cereri de semnătură și PDF-ul semnat pot fi arhivate, dar nu șterse. - Un document arhivat este păstrat, dar nu mai apare printre documentele active. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] ```mermaid flowchart LR U[Încărcare sau e-mail] --> C[Lista centrală de documente] C -->|Asociere la client| K[Documentele clientului] K --> S[Cerere de semnătură] S --> O[PDF semnat la client] M[Mandat SEPA] --> K ``` Un document se află într-un singur loc: fie în lista centrală, fie la un client. Dacă îl asociați unui client, dispare din lista centrală. PDF-urile semnate și mandatele semnate ajung automat la documentele clientului. ## Documente la un client [#documenten-bij-een-klant] ### Vizualizarea documentelor [#documenten-bekijken] 1. Mergeți la Clienți > Prezentare generală și deschideți profilul clientului. 2. Faceți clic pe fila **Documente**. 3. Vedeți documentele acestui client, împărțite în **Activ** și **Arhivat**. 4. Faceți clic pe un document (sau pe ochi) pentru a-l vedea în dreapta, la **Previzualizare**. Cu pictograma de descărcare îl salvați. ### Editarea, mutarea sau arhivarea unui document [#een-document-bewerken-verplaatsen-of-archiveren] Meniul **…** de lângă un document conține **Editați**, **Mutați la client**, **Descărcați**, **Arhivați** (sau **Dezarhivați**) și **Ștergere**. ### Ștergerea unui document [#een-document-verwijderen] Înainte de a începe: un document care aparține unei cereri de semnătură nu poate fi șters. Arhivați-l în schimb. ### Alegeți Ștergere [#kies-verwijderen] Alegeți **Ștergere** din meniul **…** de lângă document. ### Confirmați [#bevestig] Confirmați în fereastra de dialog cu **Ștergere** sau anulați cu **Anulați**. Ștergerea nu poate fi anulată. După ștergere primiți pe adresa de e-mail a contului dumneavoastră un mesaj cu documentul șters ca anexă, astfel încât de obicei aveți o copie la îndemână. ### Solicitarea semnării unui document [#een-document-laten-ondertekenen] Sub documentele unui client se află **Cereri de semnătură**. Cu **Cere semnături** puneți un PDF să fie semnat online de client, de o persoană de contact, de un coleg sau de o parte externă. PDF-ul semnat ajunge la documente ca **[titlu] (semnat)**, cu tipul **Acord semnat** dacă PDF-ul original nu avea un tip. Vezi [Semnături](/handtekeningen). ## Lista centrală de documente [#de-centrale-documentenlijst] Pe lângă documentele de la clienți, Tillor are o listă centrală. Aici apar fișierele care nu sunt încă asociate unui client, de exemplu documente care sosesc prin e-mail. Mergeți la Administrare > Documente. ### Încărcarea unui document [#een-document-uploaden] Trageți un fișier în zona de încărcare sau faceți clic pe **Selectați fișier**. Fișierul este salvat automat și apare ca element nou în listă. În zona de încărcare se află o adresă de e-mail specială. Trimiteți fișierul ca anexă la acea adresă și va apărea automat în lista centrală. ### Asocierea unui document cu un client [#een-document-koppelen-aan-een-klant] Fiecare document din lista centrală are un formular de editare și un panou de previzualizare. ### Găsiți documentul [#zoek-het-document] Mergeți la Administrare > Documente și derulați până la document. ### Completați câmpurile [#vul-de-velden-in] - **Nume document**: numele documentului. - **Atribuiți clientului**: clientul căruia îi aparține acest document (opțional). - **Tip document**: de exemplu **Poliță de asigurare**, **Dovadă de plată a asigurării**, **Carte de identitate**, **Mandat SEPA**, **Acord semnat** sau **Altele** (opțional). - **Data de expirare a asigurării**: data la care expiră o asigurare sau o autorizație. Acest câmp apare doar la tipurile de document care pot avea o dată de expirare. - **Comentarii**: notițe libere despre document (opțional). ### Salvați [#sla-op] Faceți clic pe **Salvați modificările**. ### Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Documentul dispare din lista centrală și apare în fila **Documente** a clientului respectiv. - Dacă ați completat **Data de expirare a asigurării**, o vedeți ca etichetă la document. ## Sugestii AI pentru documente [#ai-suggesties-bij-documenten] Când încărcați un PDF, Tillor analizează conținutul în fundal. Dacă Tillor recunoaște un nume care corespunde unui client din administrația dumneavoastră, lângă **Atribuiți clientului** apare un buton de sugestie cu numele clientului și un procent care arată cât de sigur este Tillor. O astfel de sugestie poate apărea și pentru data de expirare a asigurării. Faceți clic pe buton pentru a prelua sugestia sau alegeți dumneavoastră alt client. O sugestie este întotdeauna doar o propunere. Faceți clic pe **Salvați modificările** pentru a face alegerea definitivă. ## Probleme? [#problemen] Dacă documentul aparține unei cereri de semnătură, ca PDF original sau ca PDF semnat, Tillor refuză ștergerea, deoarece este o dovadă. Arhivați-l cu **Arhivați** din meniul **…**. Mesajul este **Documentul nu a putut fi arhivat.** Încercați din nou. Același lucru este valabil pentru **Restaurarea a eșuat** la **Dezarhivați**. Modificările dumneavoastră la **Nume document**, client, tip sau comentarii nu au fost salvate. Verificați formularul și faceți din nou clic pe **Salvați modificările**. Documentul nu a putut fi descărcat. Încercați din nou. Acel câmp apare doar la tipurile de document care pot avea o dată de expirare, precum **Poliță de asigurare**. Alegeți mai întâi tipul potrivit la **Tip document**. Verificați tipul fișierului (PDF, Word, mesaj Outlook, Excel, PowerPoint, JPEG, PNG, GIF sau text) și dimensiunea (cel mult 250 MB). De îndată ce un document este asociat unui client, se află doar la acel client, la **Documente**. Dacă se află în arhivă, îl găsiți la **Arhivat**. ## Noțiuni [#begrippen] - **Tip de document**: felul documentului, de exemplu **Poliță de asigurare** sau **Carte de identitate**. - **Arhivat**: un document care este păstrat, dar nu mai apare printre documentele active. - **Lista centrală de documente**: fișiere care nu sunt încă asociate unui client. - **Cerere de semnătură**: o comandă de a pune un PDF la semnat. Vezi [cerere de semnătură](/begrippen#ondertekenverzoek). - **Client**: înregistrarea din Tillor de care este legat un document. Vezi [client](/begrippen#klant). ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/eigen-velden) Cu câmpurile personalizate adăugați singur câmpuri la o înregistrare. Gândiți-vă la un număr de garanție pentru butelia de gaz la un client, un supliment la o parcelă sau o oră estimată de sosire la o rezervare. Câmpul apare în formularul acelei înregistrări, la fel ca câmpurile pe care Tillor le aduce singur. Le gestionați la Setări > Câmpuri personalizate. - Tipul unui câmp și cheia nu mai pot fi modificate după creare - Text: implicit cel mult 1.000 de caractere, Text lung 10.000. O listă de opțiuni are cel mult 200 de opțiuni - Un grup de câmpuri are cel mult 30 de subcâmpuri. Rânduri repetate: implicit cel mult 100 de rânduri, niciodată mai mult de 500 - Fișiere: implicit cel mult 20 per câmp (niciodată mai mult de 50), fiecare de cel mult 50 MB - Un câmp care dispare din cauza unei condiții este golit la salvarea înregistrării - Un câmp șters dispare din formulare. Valorile completate rămân totuși pe înregistrări - Toate limitele pe tip se află la [Tipuri de câmpuri și setări](/eigen-velden/veldtypes) ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Creați un câmp o singură dată și apoi apare peste tot unde se completează acel fel de înregistrare. ```mermaid flowchart LR L[Lista de opțiuni] -->|folosită de| V[Câmp personalizat de tip Alegere] V -->|se află în formularul| R[Client, parcelă, ocupare, sarcină și alte înregistrări] T[Acces: cine poate vedea și edita] --> V R -->|valorile se regăsesc în| E[Exporturi, filtre și automatizări] ``` - **Listele de opțiuni** le creați separat de câmpuri. Dacă modificați o opțiune, este corect în fiecare câmp care folosește lista. - **Un câmp** aparține unui singur fel de înregistrare. Tipul și cheia sunt fixe. - **Accesul** îl stabiliți pentru fiecare câmp. Cine nu are voie să vadă un câmp nu vede niciodată valoarea, nici în exporturi sau automatizări. ## Unde puteți adăuga câmpuri personalizate [#waar-kun-je-eigen-velden-toevoegen] Fiecare fel de înregistrare are propria filă. După nume se află numărul de câmpuri. | Filă | Înregistrare | |---|---| | **Clienți** | Profil de client | | **Parcele** | Parcelă | | **Ocupări** | Ocupare | | **Contoare** | Contor | | **Sarcini** | Sarcină | | **Produse** | Produs | | **Documente** | Document | | **Rezervări** | Rezervare | | **Metode de acces** | Metodă de acces | Fila **Liste de opțiuni** nu are înregistrări. Acolo creați liste cu opțiuni pe care le refolosiți în câmpurile de alegere. ## Ce puteți face cu ele [#wat-je-ermee-kunt] - Să adăugați un câmp de un anumit tip, precum text, număr, sumă, dată, alegere sau fișier. Vezi [Tipuri de câmpuri și setări](/eigen-velden/veldtypes) - Să puneți câmpul în formular între câmpurile existente sau să-l afișați doar dacă o altă valoare se potrivește - Să faceți câmpul obligatoriu, eventual doar sub o condiție - Să stabiliți cine poate vedea câmpul și cine îl poate edita. Vezi [Vizibilitate și acces](/eigen-velden/zichtbaarheid-en-toegang) Valorile sunt disponibile în exportul de clienți și parcele și în automatizări. O automatizare poate completa un câmp personalizat și cu pasul **Setează câmp personalizat**. ## Cine îl poate folosi [#wie-kan-het-gebruiken] Crearea, modificarea, reordonarea și ștergerea câmpurilor este posibilă cu dreptul **Gestionează câmpurile personalizate**. Cine nu îl are poate deschide pagina dacă are voie să vadă setările, dar butoanele sunt atunci dezactivate. Completarea unui câmp pe o înregistrare o poate face oricine are voie să vadă și să editeze câmpul. ## Componente [#onderdelen] ## Noțiuni [#begrippen] - **[Câmp personalizat](/begrippen#eigen-veld)**: un câmp suplimentar pe care îl adăugați singur la o înregistrare - **Etichetă**: numele pe care colegii îl văd deasupra câmpului de introducere - **Cheie**: numele fix al câmpului, de exemplu `gasMeterNumber`. O vedeți în listă și este folosită în exporturi și filtre - **Tip**: ce fel de valoare păstrează câmpul - **[Listă de opțiuni](/begrippen#keuzelijst)**: o listă cu opțiuni pe care o folosiți în mai multe câmpuri de alegere Mai mulți termeni se află în [glosar](/begrippen). Un exemplu detaliat se află la [Exemple practice](/praktijk). # Crearea listelor de opțiuni (/ro-RO/eigen-velden/keuzelijsten) Un câmp de tip **Alegere** sau **Alegere multiplă** are nevoie de o listă de opțiuni. Creați lista o singură dată și o folosiți în câte câmpuri doriți. Dacă modificați o opțiune, este corect imediat peste tot. ### Deschideți fila Liste de opțiuni [#open-het-tabblad-keuzelijsten] Mergeți la Setări > Câmpuri personalizate și faceți clic pe **Liste de opțiuni**. Fiecare listă își arată opțiunile cu culoare și câte câmpuri o folosesc. ### Creați o listă [#maak-een-lijst-aan] Faceți clic pe **Listă de opțiuni nouă**. Completați un **Nume** și, eventual, o **Descriere**. Tillor creează singur o **Cheie**. ### Adăugați opțiuni [#voeg-opties-toe] Faceți clic pe **Adaugă opțiune** și completați **Etichetă**, de exemplu *Sezon*. Alegeți o culoare cu punctul colorat. O listă are nevoie de cel puțin o opțiune. ### Salvați [#sla-op] Faceți clic pe **Salvează**. Apoi alegeți lista la crearea unui câmp de tip **Alegere** sau **Alegere multiplă**. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Lista apare la crearea unui câmp de tip **Alegere** sau **Alegere multiplă**. - Dacă modificați ulterior eticheta sau culoarea unei opțiuni, este corect imediat în fiecare câmp care folosește lista. - **Valoarea** unei opțiuni rămâne fixă din momentul în care a fost folosită pe o înregistrare. ## Probleme? [#problemen] O listă care este încă folosită într-un câmp nu poate fi ștearsă. Tillor anunță că lista este încă folosită de un câmp. Scoateți mai întâi lista din acele câmpuri sau ștergeți acele câmpuri. Nu există încă nicio listă. Creați una în fila **Liste de opțiuni** și apoi alegeți-o în câmp. O listă are nevoie de cel puțin o opțiune și de cel mult 200. Adăugați o opțiune cu **Adaugă opțiune**. # Crearea unui câmp personalizat (/ro-RO/eigen-velden/veld-aanmaken) Cu un câmp personalizat păstrați o dată pe care Tillor nu o cunoaște singur, precum un număr de garanție pentru butelia de gaz la un client. Îl creați în câteva minute și în dreapta paginii vedeți imediat cum îl vor primi colegii. Apoi îl completați pe înregistrarea însăși, vezi [Vizibilitate și acces](/eigen-velden/zichtbaarheid-en-toegang). Înainte de a începe: - Aveți nevoie de dreptul **Gestionează câmpurile personalizate**. Fără acest drept, butonul **Câmp nou** este gri. - Dacă câmpul are nevoie de o alegere, creați mai întâi o [listă de opțiuni](/eigen-velden/keuzelijsten). Altfel scrie **Creează mai întâi o listă de alegere**. - Alegeți tipul cu atenție: nu îl mai puteți modifica după aceea. ### Deschideți Câmpuri personalizate și alegeți fila [#open-eigen-velden-en-kies-het-tabblad] Mergeți la Setări > Câmpuri personalizate și deschideți fila înregistrării căreia îi aparține câmpul, de exemplu **Clienți**. Faceți clic pe **Câmp nou**. Dacă fila este încă goală, sub **Pornire rapidă** vedeți câteva propuneri, precum **Număr de câini** la clienți. Faceți clic pe o propunere pentru a deschide formularul deja completat. Propunerile cu o listă de opțiuni cer mai întâi o listă. Vezi [Liste de opțiuni](/eigen-velden/keuzelijsten). ### Completați câmpul [#vul-het-veld-in] Sub **1. Câmp** alegeți la **Se aplică la** felul de înregistrare, dați câmpului o **Etichetă** și alegeți **Tip**. Fiecare card de tip are o scurtă explicație. Tillor creează singur o **Cheie** din eticheta dumneavoastră. Sub **3. Cheie** o puteți modifica cu **Modifică** înainte de a salva. ### Finisați câmpul [#stel-het-veld-af] Sub **2. Setări** se află opțiunile care aparțin tipului ales. Vezi [Tipuri de câmpuri și setări](/eigen-velden/veldtypes). În plus puteți alege: - **Lățime**: **Jumătate** sau **Lățime completă** în formular - **Poziția în formular**: lăsați câmpul la sfârșit (**Secțiunea implicită (jos)**) sau alegeți un câmp existent al formularului și puneți câmpul **Înainte** sau **După** acel câmp - **Obligatoriu**: înregistrarea nu poate fi salvată cât timp câmpul este gol - **Vizibilitate**: afișați câmpul doar dacă este îndeplinită o condiție - **Obligatoriu când**: faceți câmpul obligatoriu doar dacă este îndeplinită o condiție - **Reguli de validare**: comparați valoarea cu un alt câmp sau verificați-o cu o expresie - **Text ajutător**: o scurtă explicație sub câmpul de introducere ### Stabiliți cine are acces [#bepaal-wie-erbij-mag] Sub **4. Acces** scrie implicit că oricine poate vedea și edita câmpul. Faceți clic pe **Restricționează** pentru a modifica. Vezi [Vizibilitate și acces](/eigen-velden/zichtbaarheid-en-toegang). ### Salvați câmpul [#sla-het-veld-op] Faceți clic pe **Salvează**. Tillor anunță **Câmp salvat** și vă readuce la listă. Câmpul se află imediat în formularul înregistrării. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Câmpul se află imediat în formularul înregistrării, la locul pe care l-ați ales. - Înregistrările existente au încă o valoare goală. Dacă câmpul este obligatoriu, un coleg trebuie să îl completeze înainte de a salva din nou o astfel de înregistrare. - Valorile apar în exportul de clienți și parcele și sunt disponibile în automatizări. - Cine poate vedea sau edita câmpul stabiliți sub **4. Acces**. ## Locul și condițiile [#plaats-en-voorwaarden] Cu **Poziția în formular** puneți un câmp lângă câmpurile cărora le aparține, în loc de la sfârșit. Cu **Vizibilitate** afișați un câmp doar dacă o altă valoare o cere. În acest exemplu, **Iernare** apare doar la o parcelă cu **Tip de contract** Sezon, imediat după **Descriere**. O condiție este alcătuită din una sau mai multe reguli. La **Tip de condiție** alegeți **Reguli** sau **Expresie**. Expresia este pentru cazuri complicate și cere un fragment de cod. Pentru majoritatea câmpurilor sunt suficiente regulile. Dacă un câmp dispare pentru că „condiția nu mai este îndeplinită", Tillor șterge valoarea la salvarea înregistrării. Dacă câmpul revine, este gol. Un câmp obligatoriu sub o condiție este obligatoriu doar cât timp este vizibil. ## Editarea, mutarea sau ștergerea unui câmp [#een-veld-bewerken-verplaatsen-of-verwijderen] În listă, fiecare câmp are patru butoane. | Buton | Ce face | |---|---| | **Mută în sus** și **Mută în jos** | Schimbă ordinea câmpurilor în formular | | **Editează câmpul** | Deschide câmpul. Tipul, cheia și înregistrarea căreia îi aparține câmpul sunt atunci fixe | | **Ștergere** | Șterge câmpul după o confirmare | Un câmp șters dispare din formulare. Valorile completate rămân totuși pe înregistrări, dar nu mai sunt afișate sau editate. ## Probleme? [#problemen] Butonul este dezactivat fără dreptul **Gestionează câmpurile personalizate**. Cereți unui administrator să acorde dreptul. Nu se poate. Creați un câmp nou cu tipul corect și apoi ștergeți câmpul vechi. Tillor nu preia valorile câmpului vechi. Verificați la **Poziția în formular** dacă ați ales un câmp. La **Secțiunea implicită (jos)**, câmpul se află după câmpurile standard ale formularului. Dacă are o condiție la **Vizibilitate**, apare acolo doar dacă aceasta este îndeplinită. # Tipuri de câmpuri și setări (/ro-RO/eigen-velden/veldtypes) La crearea unui câmp alegeți un tip. Tipul nu mai poate fi modificat după aceea. Sub **2. Setări** se află opțiunile acelui tip. Toate opțiunile sunt opționale, dacă nu scrie altfel mai jos. La aproape fiecare tip puteți completa și un **Mesaj de eroare**. Acesta înlocuiește mesajul standard când o valoare nu este corectă. Cu **Text substituent** stabiliți ce apare în câmpul de introducere gol. ## Text și Text lung [#tekst-en-lange-tekst] **Text** este un singur rând, **Text lung** mai multe rânduri. | Setare | Ce face | |---|---| | **Lungime minimă** și **Lungime maximă** | Numărul de caractere. Fără maxim se aplică 1.000 de caractere la Text și 10.000 la Text lung | | **Format** | **Text liber**, **Adresă de e-mail**, **Număr de telefon**, **Adresă web**, **IBAN**, **Cod poștal**, **Doar cifre** sau **Model personalizat** | | **Model (expresie regulată)** | La **Model personalizat**. Întreaga valoare trebuie să se potrivească. Tillor refuză modelele cu repetări imbricate sau referințe înapoi și modelele mai lungi de 200 de caractere | ## Număr și Sumă [#getal-en-bedrag] **Sumă** folosește moneda organizației dumneavoastră. | Setare | Se aplică la | Ce face | |---|---|---| | **Minim** și **Maxim** | Număr, Sumă | Limita inferioară și limita superioară | | **Doar numere întregi** | Număr | Nu sunt permise zecimale | | **Afișare** | Număr, doar la numere întregi | **Câmp de introducere** sau **Contor (− / +)** cu butoane | | **Pas** | Număr | Valoarea trebuie să fie minimul (sau 0) plus un număr întreg de pași | | **Zecimale maxime** | Număr | Limitează zecimalele | ## Da / nu [#ja--nee] Un comutator pornit/oprit. Cu **Trebuie bifată**, înregistrarea poate fi salvată doar cu căsuța bifată. Util pentru un consimțământ. ## Dată [#datum] | Setare | Ce face | |---|---| | **Cea mai devreme dată** și **Cea mai târzie dată** | Limite fixe | | **Nu în trecut** și **Nu în viitor** | Comparat cu azi în fusul orar al organizației dumneavoastră | | **În câte zile de azi** | Cel mult atâtea zile înainte sau după azi | ## Alegere și Alegere multiplă [#keuze-en-meerkeuze] Alegeți o [listă de opțiuni](/eigen-velden/keuzelijsten). **Alegere** păstrează o opțiune, **Alegere multiplă** mai multe. La Alegere multiplă setați **Minim selectate** și **Maxim selectate**. O listă are cel mult 200 de opțiuni. ## Legătură către înregistrare [#koppeling-naar-record] Câmpul trimite la o altă înregistrare din Tillor. | Setare | Ce face | |---|---| | **Face legătura cu** | Client, Parcelă, Ocupare, Contor, Sarcină, Factură, Rezervare, Raport de plăți, Apel telefonic, Persoană de contact, Produs, Dulap de contoare, Plată, Document, Etichetă NFC sau Metodă de acces | | **Mai multe înregistrări** | Permite mai mult de o înregistrare asociată. Puteți atunci seta și un minim și un maxim | | **Afișare** | **Listă de opțiuni** sau **Listă derulantă** (o singură listă în care se poate căuta) | | **Doar înregistrările acestui client** | Limitează opțiunile la înregistrările clientului pe care îl editați. Doar la Persoană de contact, Factură, Rezervare, Ocupare, Plată, Document, Etichetă NFC și Metodă de acces | | **Doar înregistrările parcelei** | Limitează opțiunile la contoarele parcelei: la o ocupare, parcela acelei ocupări, la o parcelă, parcela însăși. Doar la Contor. Un contor al altei parcele nu poate fi salvat | | **Filtrează opțiunile** | TypeScript opțional care stabilește pentru fiecare opțiune dacă apare în listă, vezi [Filtrarea opțiunilor](#opties-filteren). La Persoană de contact, Produs, Dulap de contoare, Plată, Document, Etichetă NFC, Metodă de acces, Factură, Rezervare, Ocupare, Contor și Parcelă | Dacă o înregistrare asociată este ștearsă ulterior, câmpul arată **Șters**. Dacă există cel puțin 50 de înregistrări din care să alegeți, tastați mai întâi 2 caractere pentru a căuta. Dacă sunt mai puține, precum contoarele unei singure parcele, le vedeți imediat pe toate. ### Filtrarea opțiunilor [#opties-filteren] Cu **Filtrează opțiunile** stabiliți singur ce înregistrări oferă câmpul. Scrieți TypeScript, la fel ca la [formula tarifară](/terreinen#tariefformule), pe care Tillor o execută pentru fiecare opțiune. Dacă returnează `true`, opțiunea apare în listă; altfel nu. În filtru citiți câmpuri cu acolade. Meniul **Variabilă** arată ce există, inclusiv câmpuri personalizate: | Variabilă | Ce este | |-----------|------------| | `{option.…}` | Înregistrarea pe care ați putea-o alege, de exemplu `{option.type}` sau `{option.terrainId}` la un contor | | `{occupation.…}`, `{terrain.…}`, … | Înregistrarea pe care o editați, sub numele tipului ei, cu `customFields` pentru propriile câmpuri | Exemplu: doar contoarele de electricitate ale parcelei ocupării. ```ts return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId}; ``` ### Etichete proprii [#eigen-labels] Același filtru poate stabili și cum se numește o opțiune în listă. Ce returnați determină rezultatul: | Returnați | Rezultat | |----------------|-----------| | `true` | Opțiunea apare în listă sub propriul nume | | `false`, `null` sau un text gol | Opțiunea nu apare în listă | | Un text | Opțiunea apare în listă sub acel text | | `{ label, group }` | Opțiunea primește acea etichetă și apare sub titlul `group`. Ambele sunt opționale | Exemplu: doar contoarele ICY și Hydrodigit, cu tipul alături și grupate pe furnizor. ```ts if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false; return { label: {option.name} + " · " + {option.type}, group: {option.provider} }; ``` Eticheta se aplică în lista de opțiuni și pe chip-urile alese din formular. În locurile care arată doar valoarea, precum pagina de detalii sau un export, apare numele propriu al înregistrării. **Inserează exemplu** sub câmp oferă un punct de plecare. Un filtru care nu se compilează nu poate fi salvat; mesajul de sub câmp spune ce nu este în regulă. Filtrul nu limitează doar lista. Dacă alegeți totuși, prin API sau un formular vechi, o înregistrare pe care filtrul o omite, Tillor refuză salvarea, indicând numele câmpului. Automatizările și importurile nu sunt verificate, la fel cum pot completa și câmpuri ascunse. ## Grup de câmpuri [#groep-velden] Un set fix de subcâmpuri care se află împreună în formular, precum **Câini** și **Alte animale** sub **Animale**. | Setare | Ce face | |---|---| | **Adaugă subcâmp** | Fiecare subcâmp are etichetă, tip și setări proprii. Faceți clic pe **Mai mult** pentru cheie, lățime și condiții. Un grup poate avea cel mult 30 de subcâmpuri | | **Afișare** | **Chenar** (cu margine) sau **În linie** (câmpurile continuă în formular) | | **Coloane** | De la 1 la 4 | | **Lățime în grup** | Pentru fiecare subcâmp, câte coloane ocupă | ## Rânduri repetate [#herhalende-rijen] Un tabel în care adăugați rânduri cu **Adaugă rând**, de exemplu mai multe vehicule. Setați subcâmpurile ca la un grup. Cu **Rânduri minime** și **Număr maxim de rânduri** limitați lista. Fără maxim se aplică 100 de rânduri, iar mai mult de 500 nu este posibil. Un grup sau un rând repetat poate conține, la un nivel de adâncime, încă un grup sau un rând repetat, nu mai departe. ## Fișiere [#bestanden] Pentru documente și fotografii. Un fișier pe care îl încărcați poate fi deschis doar de cine are voie să vadă câmpul. | Setare | Ce face | |---|---| | **Mai multe fișiere** | Permite mai mult de un fișier | | **Fișiere minime** și **Fișiere maxime** | Fără maxim se aplică 20 de fișiere, iar mai mult de 50 nu este posibil | | **Dimensiune maximă per fișier (MB)** | Cel mult 50 MB per fișier, chiar dacă doriți o valoare mai mare | | **Tipuri de fișiere permise** | **Orice fișier**, **Imagini**, **PDF**, **Documente Office** sau o extensie proprie precum `.dwg` ori un tip MIME precum `application/zip` | Tillor verifică tipul pe baza conținutului fișierului, nu doar pe baza numelui. ## JSON [#json] Destinat datelor structurate pe care o legătură cu un alt sistem le transmite. Colegii rareori completează acest câmp în formular. Cu **Dimensiune maximă (KB)** setați o limită, implicit 64 KB și cel mult 256 KB. ## Setări pentru fiecare tip [#instellingen-voor-elk-type] | Setare | Ce face | |---|---| | **Criptați această valoare** | Păstrează valoarea criptată. Un câmp criptat nu poate fi căutat, filtrat sau sortat și nu este disponibil ca variabilă în automatizări. Doar pentru câmpurile de la nivelul cel mai înalt, deci nu pentru subcâmpuri. Toate câmpurile personalizate sunt oricum stocate criptat, indiferent dacă activați sau nu aceasta | | **Doar API** | Ascunde câmpul în formulare și în vizualizările de detalii. O legătură îl completează prin API. Un astfel de câmp nu poate fi obligatoriu | | **Doar API, doar citire** | Afișează totuși câmpul, dar dezactivat, astfel încât colegii văd valoarea, dar nu o pot modifica | | **Reguli de validare** | Comparați o dată, un număr sau o sumă cu un alt câmp (**Înainte**, **La sau înainte de**, **După**, **La sau după**, cu o deplasare în zile, săptămâni sau luni) sau verificați valoarea cu o expresie. Cel mult 10 reguli per câmp | O limită modificată nu se aplică retroactiv. O valoare pe care nu o modificați nu blochează salvarea înregistrării, chiar dacă nu mai respectă noua regulă. # Vizibilitate și acces (/ro-RO/eigen-velden/zichtbaarheid-en-toegang) Un câmp personalizat se află în formularul înregistrării de care aparține. Implicit, oricine are acces la acea înregistrare poate vedea și completa câmpul. Puteți restricționa acest lucru pentru fiecare câmp în parte. ## Unde vedeți valorile [#waar-je-de-waarden-ziet] Completați câmpurile personalizate în același loc cu celelalte date ale înregistrării. | Înregistrare | Unde | |---|---| | Client | Blocul **Datele clientului** din profilul clientului | | Parcelă, contor, ocupare, rezervare, produs, document, metodă de acces | Formularul pentru crearea sau editarea înregistrării | | Sarcină | Fereastra sarcinii. Salvați modificările cu **Salvează câmpurile** | Un câmp apare în locul ales la **Poziția în formular**. Dacă nu ați ales nimic, apare după câmpurile standard. Dacă un câmp este obligatoriu, nu puteți salva înregistrarea cât timp câmpul este gol. Un câmp cu **Vizibilitate** apare abia când condiția este îndeplinită. Câmpurile personalizate se regăsesc și în exportul clienților și al parcelelor și le puteți folosi în automatizări. ## Cine poate vedea sau edita un câmp [#wie-mag-een-veld-zien-of-bewerken] Deschideți câmpul la Setări > Câmpuri personalizate și mergeți la **4. Acces**. Faceți clic pe **Restricționează**. Aveți două blocuri. | Bloc | Ce face | |---|---| | **Cine poate vedea acest câmp** | Dacă îl lăsați gol, orice membru îl poate vedea. Cine nu are voie să îl vadă nu vede niciodată valoarea, nici în exporturi sau în automatizările pe care le editează | | **Cine poate edita acest câmp** | Dacă îl lăsați gol, oricine vede câmpul îl poate și edita. Ceilalți îl văd doar în citire | În fiecare bloc alegeți un **coleg sau un grup** și/sau un **drept**. Dacă cineva se potrivește cu unul dintre colegii, grupurile sau drepturile alese, are acces. Puteți edita câmpul doar dacă aveți voie să îl și vedeți. În listă, un astfel de câmp primește eticheta **Restricționat**. Treceți cu mouse-ul peste ea pentru explicație: doar anumiți colegi, grupuri sau drepturi pot vedea sau edita acest câmp. Opțiunea **Vizibilitate** (o condiție) ascunde un câmp doar în formular. Cine are voie să vadă câmpul poate totuși găsi valoarea. Folosiți **Cine poate vedea acest câmp** dacă nimeni altcineva nu trebuie să o citească. ## Cine poate gestiona câmpurile [#wie-mag-velden-beheren] Crearea, modificarea, reordonarea și ștergerea câmpurilor și gestionarea listelor de opțiuni necesită dreptul **Gestionează câmpurile personalizate**. Cum acordați drepturi găsiți la [Invitarea utilizatorilor și acordarea drepturilor](/gebruikers/gebruikers-en-rechten). Pagina **Câmpuri personalizate** este vizibilă pentru cine poate vizualiza sau edita setările sau are acest drept. Fără drept, vedeți doar câmpurile pe care aveți voie să le citiți, iar **Câmp nou**, editarea și ștergerea sunt dezactivate. ## Probleme? [#problemen] Verificați la **Cine poate vedea acest câmp** dacă acel coleg, grupul lui sau unul dintre drepturile lui este ales. Dacă este un câmp **Doar API**, nu apare în formulare. Uitați-vă la **Cine poate edita acest câmp**. Dacă acolo sunt alese colegi, grupuri sau drepturi, ceilalți sunt limitați la citire. Dacă cineva încearcă totuși să modifice valoarea, Tillor refuză. # Crearea și editarea unei facturi (/ro-RO/facturen/aanmaken-en-bewerken) O factură nouă este întotdeauna o ciornă: o creați în profilul clientului și completați rândurile. Cât timp este ciornă, puteți adăuga, modifica, muta și șterge rânduri. Apoi [o înregistrați](/facturen/boeken). Înainte să începeți: - Clientul există deja în Tillor. Vedeți [Gestionarea clienților](/klantenbeheer). - Pentru produsele cu o parcelă sau o ocupare, clientul are o ocupare pe acea parcelă. Fără ocupare creați o ofertă pe care nu o puteți înregistra. ## Crearea unei facturi [#een-factuur-aanmaken] Facturile le creați în profilul clientului, nu de la Administrare > Facturi. ### Deschideți clientul [#open-de-klant] Mergeți la Clienți > Prezentare generală și deschideți profilul clientului. ### Creați factura [#maak-de-factuur-aan] În blocul **Facturi** faceți clic pe **Factură nouă**. Tillor creează o factură ciornă și deschide imediat pagina facturii. Factura primește un număr provizoriu de ciornă. Numărul definitiv al facturii, data facturii și data scadenței vin abia la [înregistrare](/facturen/boeken). ## Adăugarea și modificarea rândurilor [#regels-toevoegen-en-aanpassen] Pe pagina facturii se află un tabel cu rândurile facturii. În partea de jos este un rând gol în care începeți un rând nou. ### Alegeți un produs sau scrieți o descriere [#kies-een-product-of-typ-een-omschrijving] Alegeți un **Produs** din listă și Tillor completează **Descrierea** și prețul. Puteți și să scrieți singuri o descriere. ### Completați cantitatea și prețul [#vul-aantal-en-prijs-in] Modificați **Cantitatea** și **Prețul (cu TVA)** pe unitate unde este nevoie. **Totalul** rândului se calculează automat. Dacă setarea pentru TVA pe rând este activată pentru organizația dumneavoastră, alegeți și cota de TVA. ### Adăugați o notă (opțional) [#voeg-een-notitie-toe-optioneel] Sub tabel puteți completa o **Notă (opțional)**. Acest text apare pe factură și este vizibil pentru client. Modificările sunt salvate automat aproape imediat. Puteți și să faceți clic pe **Salvați modificările**, sau pe **Anulare** pentru a anula modificările nesalvate. ### Reordonarea sau ștergerea rândurilor [#regels-herschikken-of-verwijderen] - Trageți un rând de mânerul din stânga lui pentru a schimba ordinea. - Faceți clic pe cruciulița din dreapta unui rând pentru a-l șterge. În cronologia **Evenimente** de lângă factură vedeți ce s-a modificat și când, cu starea dinainte și de după a câmpurilor și rândurilor. ## Rânduri cu o acțiune [#regels-met-een-actie] Dacă produsul ales are o acțiune pe rândul facturii, apar sub rând câmpuri suplimentare. Ce acțiuni are un produs stabiliți la produsul însuși. Vedeți [Acțiuni de produs](/producten/productacties). | Acțiune | Ce completați pe factură | |-------|-----------------------------| | **Reîncărcați eticheta NFC** | Eticheta care trebuie reîncărcată. După plată, Tillor adaugă suma la soldul etichetei. | | **Perioadă** | Data de început și de sfârșit și, la un produs cu parcelă, și **Parcela** (într-o listă sau **Alege pe hartă**). | | **Prelungiți perioada de ocupare** | Parcela pentru care prelungiți ocuparea, plus data de început și de sfârșit. | | **Solicitați date de contact** | Adresa de e-mail și numărul de telefon ale clientului. Dacă sunt obligatorii, nu puteți înregistra fără ele. | | **Creați metodă de acces** | Tipul metodei de acces și eventual un număr de înmatriculare sau un cod PIN. | | **Afișează alertă** | Nimic. Vedeți doar o alertă cu textul setat la produs. | | **Împiedicați înregistrarea** | Nimic. Factura nu poate fi înregistrată cât timp rândul este pe ea. | ### Alegerea perioadei și a parcelei [#periode-en-terrein-kiezen] La un rând cu **Perioadă** alegeți o dată de început și una de sfârșit. Dedesubt vedeți numărul de zile și **Cantitatea** pe care o facturează Tillor. Dacă perioada nu se potrivește exact cu o săptămână sau o lună a produsului, Tillor rotunjește în sus și apare **Rotunjit în sus**. Cu bifa **Pro rata** facturați în schimb proporțional o săptămână sau o lună parțială. Această bifă apare doar la produsele cu perioadă de o săptămână sau o lună. Dacă produsul cere o parcelă, alegeți mai întâi perioada și apoi **Parcela**. La înregistrare, Tillor creează rezervarea. Pe rând apare apoi un card cu numărul rezervării, starea, parcela și datele. Dacă clientul este înregistrat imediat la sosire depinde de produs: la **Înregistrează sosirea la plată** se întâmplă la plată, iar la **Înregistrare sosire la rezervare** la înregistrare. Un avans doar rezervă parcela. ### Prelungirea unei ocupări [#een-bezetting-verlengen] Cu **Prelungiți perioada de ocupare** facturați o perioadă pentru o ocupare a clientului, de exemplu taxa de staționare. ### Alegeți parcela [#kies-het-terrein] La **Selectați ocuparea activă** alegeți parcela. Lista arată ocupările active ale clientului. ### Alegeți perioada [#kies-de-periode] Alegeți **Data de început**. Apoi Tillor deschide imediat calendarul pentru **Data de sfârșit**. Sub date vedeți până când este facturată acum ocuparea și câte zile și ce cantitate cuprinde rândul. ### Setați rotunjirea [#stel-het-afronden-in] Bifa **Rotunjiți la limita perioadei următoare** este activată implicit. Rândul se încheie atunci la următoarea limită de perioadă a frecvenței de închiriere, astfel încât clientul să urmeze pe termen lung același ciclu. Cu bifa dezactivată, rândul durează exact o perioadă de la data de început. Rândul primește o descriere de forma **Numele produsului | Numele parcelei | Perioada**. Data de sfârșit contează ca ultimă zi, iar o jumătate de perioadă se facturează și ea pe jumătate. Dacă ocuparea are deja o dată **Plătit până la** și rotunjirea este activată, rândul nou începe în ziua următoare. Dacă **Plătit până la** este încă gol, alegeți singuri data de început, iar Tillor calculează data de sfârșit până la următoarea limită de perioadă. Ce se întâmplă după înregistrare și plată cu **Plătit până la** și **Facturat până la** găsiți la [Ocupări](/bezettingen). Două bife suplimentare ajută în situații excepționale: - **Afișați toate parcelele (ofertă)** vă lasă să alegeți orice parcelă pentru a crea o ofertă. Dacă clientul nu ocupă acea parcelă, nu puteți înregistra factura. Utilizatorii cu dreptul **Corecții de factură** pot totuși înregistra o astfel de factură, vedeți [Înregistrarea unei facturi](/facturen/boeken#problemen). - **Marcați ca credit (rambursare)** transformă rândul într-o rambursare. Cantitatea devine negativă, iar perioada merge de azi până la **Plătit până la**. Cu **Rotunjiți la limita perioadei** rotunjiți la o limită de perioadă. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Modificările sunt salvate automat aproape imediat. Cronologia **Evenimente** arată cine a modificat ce. - Nu pleacă nimic către client și nu se schimbă nimic la ocupări sau etichete. Acest lucru se întâmplă abia la [înregistrare](/facturen/boeken) și la plată. - O ciornă cu un rând **Împiedicați înregistrarea** nu o puteți înregistra. - O ciornă o ștergeți cu **Ștergeți factura** în meniul de acțiuni. ## Probleme? [#problemen] Doar facturile ciornă pot fi editate. O factură înregistrată o puteți readuce, în anumite condiții, la ciornă, vedeți [Corectarea unei facturi](/facturen/corrigeren#terugzetten-naar-concept). Clientul nu are nicio etichetă disponibilă. Atribuiți mai întâi o etichetă NFC clientului. Vedeți [NFC](/nfc). Butonul se află în profilul clientului, în blocul **Facturi**, nu în lista de facturi de la **Administrare**. La **Prelungiți perioada de ocupare**, lista arată doar ocupările active ale clientului. Creați mai întâi o ocupare, vedeți [Ocupări](/bezettingen), sau folosiți **Afișați toate parcelele (ofertă)** pentru o ofertă. ## Mai departe [#verder] # Imprimarea, descărcarea sau partajarea unei facturi (/ro-RO/facturen/afdrukken-en-downloaden) Cu **Imprimare** imprimați o factură, o salvați ca PDF sau o trimiteți la o imprimantă. Butonul se află pe fiecare pagină de factură, și la o ciornă. Săgeata de lângă el deschide un meniu cu celelalte opțiuni. Un link pentru client creați la [Partajarea unui link personal](#een-persoonlijke-link-delen). Înainte să începeți: pentru opțiunile de imprimantă trebuie să ruleze un Tillor Connector pentru organizația dumneavoastră. Fără connector, aceste opțiuni sunt gri. ## Imprimare sau salvare [#afdrukken-of-opslaan] | Opțiune | Ce face | |-------|--------------| | **Imprimare** | Deschide fereastra de imprimare a browserului. Puteți folosi și scurtătura Ctrl+P (Cmd+P pe Mac). | | **Deschideți într-o fereastră nouă** | Afișează PDF-ul într-o fereastră nouă. | | **Descărcați PDF** | Salvează factura ca fișier PDF. | | **Trimiteți la imprimanta A4** | Trimite factura la imprimanta A4 conectată. | | **Trimiteți la imprimanta de bonuri** | Trimite factura la imprimanta de bonuri conectată. | Cele două opțiuni de imprimantă sunt gri cât timp nu este activ niciun Tillor Connector pentru organizația dumneavoastră. Cum configurați imprimantele găsiți la [Imprimantă](/printer). ## Afișarea facturii pe o tabletă [#de-factuur-tonen-op-een-tablet] Dacă la recepție există o tabletă care afișează documentele clientului, puteți afișa factura acolo. Deschideți cele trei puncte din dreapta sus pe pagina facturii și alegeți **Previzualizare pe iPad**. La o plată în numerar, același buton se află și în fereastra de plată. ## Partajarea unui link personal [#een-persoonlijke-link-delen] La o factură înregistrată puteți crea un link pe care clientul îl poate deschide singur pentru a vedea factura și, dacă mai rămâne ceva de plată, pentru a plăti online. ### Deschideți meniul de acțiuni [#open-het-actiemenu] Faceți clic pe cele trei puncte din dreapta sus pe pagina facturii și alegeți **URL personal**. ### Partajați linkul [#deel-de-link] Tillor copiază linkul în clipboard și afișează mesajul **URL generat**. Lipiți-l într-un mesaj sau într-un e-mail către client. Meniul de acțiuni conține și alte opțiuni. Pentru copierea, stornarea și recalcularea unei facturi, vedeți [Corectarea unei facturi](/facturen/corrigeren). ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Imprimarea, descărcarea și trimiterea la imprimantă nu schimbă nimic la factură. - La **Previzualizare pe iPad**, clientul vede factura pe tabletă. În cronologia facturii apare că PDF-ul a fost trimis la tabletă. - Linkul personal nu are dată de expirare. Clientul vede acolo suma rămasă de plată și poate plăti online. Vedeți [Plata online a unui client](/betalingsverwerking/online). - Produsele pot imprima automat și la plată. Vedeți [Acțiuni de produs](/producten/productacties#thermisch-printen-en-a4-printen). ## Probleme? [#problemen] Nu există un Tillor Connector activ pentru organizația dumneavoastră. Verificați conexiunea și setările imprimantei, vedeți [Imprimantă](/printer). Această opțiune apare doar în meniul de acțiuni al unei facturi înregistrate. Tillor afișează atunci un mesaj cu motivul, de exemplu că s-a terminat hârtia sau tonerul. Remediați problema și încercați din nou. ## Mai departe [#verder] # Înregistrarea unei plăți (/ro-RO/facturen/betalingen-registreren) La o factură înregistrată cu o sumă rămasă de plată, efectuați o plată sau o înregistrați, de exemplu o plată cu cardul la terminal, numerar sau o debitare directă. Suma, starea plății și lista **Plăți** de lângă factură sunt apoi actualizate. Toate metodele găsiți și la [Procesarea plăților](/betalingsverwerking). Înainte să începeți: - Factura este înregistrată și mai rămâne o sumă de plată. Altfel, **Efectuați o plată** lipsește. - Pentru **Terminal** este conectat Mollie. Pentru **Mandat SEPA**, clientul are un mandat activ. Altfel, metoda nu apare în listă sau este gri. ## Efectuarea unei plăți [#een-betaling-uitvoeren] ### Deschideți factura înregistrată [#open-de-geboekte-factuur] Mergeți la Administrare > Facturi și deschideți o factură înregistrată. Butonul **Efectuați o plată** este acolo cât timp mai rămâne o sumă de plată. ### Alegeți metoda de plată [#kies-de-betaalmethode] Faceți clic pe **Efectuați o plată** și alegeți o **Metodă de plată**. | Metodă | O folosiți pentru | |---------|-----------------| | **Terminal** | O plată cu cardul. Alegeți un terminal de plată și Tillor trimite plata acolo. Vedeți [Terminal](/betalingsverwerking/terminal). | | **Transfer intern** | Mutarea sumei la o altă factură înregistrată a aceluiași client (**Factura destinație**). Vedeți [Transfer intern](/betalingsverwerking/interne-overboeking). | | **Numerar** | Înregistrarea unei plăți în numerar. Vedeți [Numerar](/betalingsverwerking/contant). | | **Transfer bancar** | Înregistrarea unui transfer bancar primit. | | **Mandat SEPA** | O debitare directă automată printr-un **Mandat** activ al clientului. Vedeți [Mandat](/betalingsverwerking/mandaat). | | **Altele** | O altă formă de plată, de exemplu un cec. Se află sub **Mai multe metode de plată** și este vizibilă doar dacă ați activat-o. O descriere este atunci obligatorie. | **Terminal** și **Mandat SEPA** apar doar dacă sunt disponibile pentru organizația dumneavoastră. **Mandat SEPA** este gri cât timp clientul nu are un mandat activ și nu există pentru notele de credit. ### Completați suma [#vul-het-bedrag-in] **Suma** este implicit întreaga sumă rămasă de plată. Introduceți o altă sumă sau folosiți butoanele **25%**, **50%**, **75%** și **100%**. Suma nu poate depăși ce mai rămâne de plată. ### Completați câmpurile suplimentare [#vul-de-extra-velden-in] La **Numerar**, **Transfer bancar** și **Altele** completați opțional **Data primirii** (nu în viitor) și un **Comentariu**. La o debitare directă alegeți **Mandatul** și eventual o **Întârziere (zile)**, unde 0 trimite imediat. Dacă alegeți **Transfer bancar** și clientul are o adresă de e-mail, puteți bifa **Trimiteți memento de comunicare structurată**. Clientul primește atunci un e-mail cu sfatul de a folosi comunicarea structurată la plățile următoare. ### Efectuați plata [#voer-de-betaling-uit] Faceți clic pe **Efectuează plata**. La **Numerar** există și un buton **Previzualizare pe iPad** pentru a arăta factura clientului pe o tabletă conectată. ## Sume maxime [#maximumbedragen] O plată în numerar nu poate depăși **Maxim numerar** de la Asistență > Setări > Plăți (implicit 2999 de euro). La o debitare directă, suma nu poate depăși maximul mandatului. ## Atribuirea unei plăți existente [#een-bestaande-betaling-koppelen] Dacă a intrat deja o plată sau o tranzacție bancară care aparține acestei facturi, o atribuiți în loc să creați una nouă. ### Deschideți meniul de acțiuni [#open-het-actiemenu] Faceți clic pe cele trei puncte din dreapta sus pe pagina facturii și alegeți **Atribuiți plata**. ### Alegeți plata [#kies-de-betaling] În fereastră alegeți o plată sau un grup. În filele **Grupuri de plăți**, **Plăți cu cardul și online** și **Tranzacții bancare** vedeți ce este disponibil. În partea de sus sunt sugestii care corespund sumei rămase de plată. ### Atribuiți [#koppel] Faceți clic pe **Atribuiți plata**, **Atribuiți grupul** sau **Atribuiți tranzacția bancară**, în funcție de ce ați ales. Pentru tranzacțiile bancare aveți nevoie și de dreptul **Vizualizați tranzacțiile bancare**. ## Crearea unui link pentru o plată parțială [#een-link-voor-een-deelbetaling-maken] Dacă clientul vrea să plătească doar o parte din suma rămasă, creați un link de plată pentru o sumă aleasă de dumneavoastră. Acest lucru este posibil la orice factură înregistrată cu o sumă rămasă de plată. ### Deschideți meniul de acțiuni [#open-het-actiemenu-1] Faceți clic pe cele trei puncte de lângă **Trimiteți notificare** și alegeți **Link pentru plată parțială**. ### Completați suma [#vul-het-bedrag-in-1] La **Sumă** introduceți ce poate plăti clientul. Suma trebuie să fie mai mare de 0 și nu poate depăși ce mai rămâne de plată. ### Creați linkul [#maak-de-link] Faceți clic pe **Creați și copiați linkul**. Tillor copiază linkul în clipboard și îl afișează la **Link de plată**. Cu butonul de copiere de lângă el îl copiați din nou. Trimiteți linkul singuri clientului, de exemplu prin e-mail sau chat. Clientul deschide pagina de plată obișnuită a facturii, dar aceasta cere acum doar suma dumneavoastră, cu mențiunea că este o plată parțială din suma rămasă. Clientul plătește apoi în modul pe care îl alege pe [pagina de plată](/betalingsverwerking/online). Linkul rămâne valabil, dar nu cere niciodată mai mult decât mai rămâne de plată în acel moment. Dacă între timp s-a plătit deja o parte, pagina de plată se ajustează. După o plată, factura are starea Parțial până când intră întreaga sumă. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Suma rămasă scade, iar starea plății se schimbă: Parțial cât timp mai rămâne ceva de plată, Plătită când totul a intrat. - La o debitare directă sau o plată cu cardul la terminal, factura are mai întâi starea În curs până când banii intră definitiv. - Dacă un rând are o acțiune la plată, Tillor o execută de îndată ce factura este plătită. De exemplu reîncărcarea unei etichete NFC, prelungirea **Plătit până la** a unei ocupări sau imprimarea unui bon. Vedeți [Cum se leagă toate?](/producten#hoe-hangt-dit-samen). - Plata ajunge în raportul de plăți al zilei. Vedeți [Rapoarte de plăți](/boekhouden/betalingsrapporten). ## Probleme? [#problemen] Factura trebuie să fie înregistrată și trebuie să mai rămână o sumă de plată. La o factură ciornă nu puteți plăti. Factura trebuie să fie înregistrată și trebuie să mai rămână o sumă de plată. Clientul nu are un mandat activ. Configurați-l în datele clientului, vedeți [Mandat](/betalingsverwerking/mandaat). Această metodă de plată este dezactivată implicit. Activați **Afișați metoda de plată „Altele”** la Asistență > Setări > Plăți. Plata a fost pornită, de exemplu o debitare directă, dar banii nu au intrat încă definitiv. De îndată ce plata este procesată, starea trece la **Plătită**. Vedeți [Stări](/facturen/statussen). ## Mai departe [#verder] # Înregistrarea unei facturi (/ro-RO/facturen/boeken) Prin înregistrare, o ciornă devine o factură definitivă cu număr de factură propriu. Abia după aceea puteți [trimite](/facturen/versturen) factura și o puteți [da spre plată](/facturen/betalingen-registreren). Verificați deci rândurile înainte de a înregistra, deoarece o factură înregistrată nu mai poate fi modificată liber. Înainte să începeți: - Factura are cel puțin un rând sau un total diferit de zero. - Rândurile cu **Perioadă** sau **Prelungiți perioada de ocupare** au o dată de început și una de sfârșit. - Dacă un rând are o acțiune care cere date, acestea sunt completate. De exemplu **Solicitați date de contact** sau **Creați metodă de acces**. - Pentru un client belgian cu număr de TVA este completat un Peppol ID. Vedeți [Peppol](/boekhouden/peppol). Dacă ceva nu este în ordine, **Înregistrați factura** este gri. Treceți cu mouse-ul peste buton pentru a citi motivul. Vedeți și [Probleme?](#problemen). ## Înregistrarea unei facturi [#een-factuur-boeken] ### Deschideți factura ciornă [#open-de-conceptfactuur] Mergeți la Administrare > Facturi și deschideți o factură cu starea Ciornă, de exemplu prin lista **Ciorne**. ### Verificați factura [#controleer-de-factuur] Verificați rândurile și nota. ### Faceți clic pe Înregistrați factura [#klik-op-boek-factuur] Factura primește un număr de factură în ordine crescătoare. Tillor anunță că factura a fost înregistrată. ## Ce se schimbă? [#wat-verandert-er] Așa arată o factură înainte și după înregistrare. Sunt două facturi de exemplu diferite, dar vedeți diferența de număr, stare și butoane. **Înainte de înregistrare**: un număr provizoriu de ciornă și butonul **Înregistrați factura**. **După înregistrare**: un număr definitiv de factură, o stare a plății și butoanele **Efectuați o plată** și **Trimiteți notificare**. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - **Data facturii** este ziua înregistrării. **Data scadenței** este acea zi plus **Scadență implicită (zile)** a organizației dumneavoastră, implicit 7 zile. O modificați la Asistență > Setări > Facturare. - Dacă totalul nu este un multiplu de 5 cenți, Tillor adaugă singur un rând **Rotunjire**. - Dacă factura are un total negativ, devine o **Notă de credit**. - Dacă clientul are un Peppol ID, Tillor trimite factura automat prin Peppol. Vedeți [Peppol](/boekhouden/peppol). - Rândurile cu **Prelungiți perioada de ocupare** setează **Facturat până la** al ocupării la sfârșitul rândului. **Plătit până la** urmează abia la plată. Vedeți [Cum se leagă toate?](/producten#hoe-hangt-dit-samen). - Rândurile cu **Perioadă** și **Cere parcela** creează o rezervare. Dacă clientul este înregistrat imediat la sosire depinde de produs. - Dacă este legat un mandat de debit direct, Tillor creează imediat o plată restantă. Banca este solicitată la două zile după înregistrare. - Clientul nu primește nimic automat. Notificarea o trimiteți dumneavoastră, vedeți [Trimiterea unei facturi](/facturen/versturen). - Vreți totuși să modificați ceva? În 7 zile și cât timp nu s-a trimis nimic, readuceți factura [la ciornă](/facturen/corrigeren#terugzetten-naar-concept). ## Alegerea unui alt termen de plată [#een-andere-betaaltermijn-kiezen] Dacă data scadenței diferă de cea implicită, nu trebuie să setați acest lucru în prealabil. ### Deschideți meniul de alegere [#open-het-keuzemenu] Faceți clic pe săgeata de lângă **Înregistrați factura** și alegeți **Termene de plată personalizate…**. ### Alegeți termenul [#kies-de-termijn] La **Termene de plată** alegeți o opțiune, de la **Scadentă la data facturii** până la **Net 60 zile**. Vedeți imediat **Data scadenței estimată**. ### Înregistrați [#boek] Faceți clic pe **Înregistrați factura**. ## Trimiterea către contabilitate [#doorsturen-naar-je-boekhouding] Trimiterea către software-ul de contabilitate se face în mod normal singură. Dacă vreți să o porniți din nou, de exemplu după o eroare, puteți face acest lucru pentru fiecare factură. Deschideți factura înregistrată, faceți clic pe cele trei puncte din dreapta sus și alegeți **Trimiteți către software-ul de contabilitate**. Ce sisteme sunt disponibile citiți la [Contabilitate](/boekhouden). [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) este disponibil la cerere. ## Probleme? [#problemen] Treceți cu mouse-ul peste buton. Tillor indică motivul. Cele mai frecvente sunt mai jos. Produsul de pe acel rând nu permite înregistrarea. Ștergeți rândul sau alegeți alt produs. Un rând cu **Perioadă** sau **Prelungiți perioada de ocupare** nu are o dată. Completați data de început și de sfârșit. Adăugați un rând sau asigurați-vă că totalul nu este zero. Pe rândurile cu **Solicitați date de contact** completați câmpurile obligatorii. Pe rândurile cu **Creați metodă de acces** alegeți un tip și, la recunoașterea numărului de înmatriculare, și numărul de înmatriculare. O astfel de factură este o ofertă și nu o puteți înregistra. Lăsați mai întâi clientul să ocupe parcela. Dacă aveți dreptul **Corecții de factură**, puteți alege, prin săgeata de lângă **Înregistrați factura**, **Forțați înregistrarea**. Ocuparea este atunci prelungită abia când clientul ocupă parcela. Suma facturii nu are voie să depășească suma maximă a mandatului legat. Modificați mandatul la **Mandat de debit direct** în **Informații factură** de lângă factură, sau reduceți suma. Vedeți [Mandat SEPA](/betalingsverwerking/mandaat). Un produs cu cont protejat (de exemplu o garanție) nu are voie să ducă soldul clientului sub zero. Dacă aveți dreptul **Ignorarea soldului contului**, puteți totuși înregistra cu o motivare. Vedeți [Protejarea soldului clientului](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). Pentru un client belgian cu număr de TVA trebuie să fie cunoscut un Peppol ID. Deschideți Clienți > client > Facturare, mergeți la **Setări de facturare** și completați ID-ul. Vedeți [Peppol](/boekhouden/peppol). ## Vezi și [#zie-ook] # Corectarea unei facturi (/ro-RO/facturen/corrigeren) O factură înregistrată nu o puteți modifica pur și simplu. Ce cale alegeți depinde de cât de departe a ajuns factura. Toate corecțiile, cu excepția revenirii la ciornă, se află în meniul de acțiuni (trei puncte) de lângă **Trimiteți notificare**. | Situație | Ce faceți | |----------|-------------| | Factura tocmai a fost înregistrată și nu a fost încă trimisă | [Revenire la ciornă](#terugzetten-naar-concept) | | Factura a fost deja trimisă sau este prea veche | [Stornare](#een-factuur-omkeren) cu o notă de credit | | Vreți să refolosiți aceleași rânduri | [Copiere](#een-factuur-kopiëren) | | Factura este pe clientul greșit | [Mutare](#een-factuur-verplaatsen-naar-een-andere-klant) | | Sumele nu sunt corecte | [Recalculare](#een-factuur-herberekenen) | ## Revenire la ciornă [#terugzetten-naar-concept] Cât timp factura nu a plecat încă din casă, o readuceți la ciornă și o înregistrați din nou după modificare. Este posibil dacă toate cele de mai jos sunt îndeplinite: - Factura este înregistrată. - Tillor nu a trimis încă nicio notificare pentru ea, pe niciun canal. - Factura nu a fost trimisă prin Peppol. - Data facturii este mai recentă de 7 zile. ### Deschideți factura înregistrată [#open-de-geboekte-factuur] Mergeți la Administrare > Facturi și deschideți factura. ### Readuceți-o la ciornă [#zet-hem-terug] Faceți clic pe **Reveniți la ciornă** și confirmați cu **Da, reveniți la ciornă**. Dacă butonul lipsește, factura nu îndeplinește condițiile. ### Modificați factura și înregistrați din nou [#pas-de-factuur-aan-en-boek-opnieuw] Modificați rândurile și faceți clic pe **Înregistrați factura**. În acest interval, factura are un număr de ciornă cu numărul inițial între paranteze. Rândul **Rotunjire** este eliminat și revine la o nouă înregistrare. La o nouă înregistrare, factura își primește înapoi numărul inițial, cu data facturii și data scadenței inițiale. O ciornă provenită dintr-o factură înregistrată nu o puteți șterge. După o revenire la ciornă, la acel eveniment din cronologia **Evenimente** apare un buton **Restaurați versiunea**. Cu el înlocuiți rândurile curente cu rândurile așa cum erau în momentul revenirii. Dacă factura este între timp din nou înregistrată, Tillor o readuce mai întâi la ciornă. Dacă factura a fost deja imprimată, arătată clientului sau partajată în alt mod, fiți prudenți. Clientul are atunci o versiune care în curând nu va mai fi corectă. ### Când revenirea nu mai este posibilă [#als-terugzetten-niet-meer-kan] Dacă factura nu mai îndeplinește condițiile, de exemplu pentru că s-a trimis deja o notificare sau factura are peste 7 zile, puteți totuși reveni la ciornă cu dreptul **Corecții de factură**. Deschideți cele trei puncte din dreapta sus pe pagina facturii și alegeți **Forțați revenirea la ciornă**. Folosiți acest lucru doar dacă este permis juridic și contabil. O notă de credit prin [stornare](#een-factuur-omkeren) este de obicei soluția mai curată. ## Stornarea unei facturi [#een-factuur-omkeren] Prin stornare creați o notă de credit care anulează o factură înregistrată. Funcționează întotdeauna, chiar dacă factura a fost deja trimisă sau plătită. ### Stornați factura [#keer-de-factuur-om] Deschideți cele trei puncte din dreapta sus pe factura înregistrată și alegeți **Stornați factura**. Tillor creează o ciornă nouă cu aceleași rânduri în sume negative și o deschide. ### Verificați și înregistrați [#controleer-en-boek] Modificați ciorna dacă este nevoie și faceți clic pe **Înregistrați factura**. Devine atunci o **Notă de credit**. Cele două facturi se referă una la alta. În **Informații factură** apare la nota de credit **Stornare a**, iar la factura inițială **Stornată ca**. În lista de facturi din profilul clientului vedeți la ciornă eticheta **Ciornă de stornare**, iar la factura inițială **Această factură a fost stornată**. Dacă ați mai stornat deja o factură, Tillor cere confirmare cu **Da, stornați din nou**, ca să nu creați din greșeală două note de credit. Dacă vreți să compensați nota de credit cu factura inițială, alegeți la plată **Transfer intern**. Vedeți [Transfer intern](/betalingsverwerking/interne-overboeking). ## Copierea unei facturi [#een-factuur-kopiëren] Alegeți **Copiați factura** în meniul de acțiuni al unei facturi înregistrate. Tillor creează o ciornă nouă cu aceleași rânduri, aceeași notă și același mandat de debit direct, și o deschide. Rândul **Rotunjire** nu este copiat. ## Mutarea unei facturi la alt client [#een-factuur-verplaatsen-naar-een-andere-klant] Dacă o factură este pe clientul greșit, o mutați. ### Deschideți meniul de acțiuni [#open-het-actiemenu] Faceți clic pe cele trei puncte din dreapta sus pe pagina facturii și alegeți **Mutați la client**. ### Alegeți clientul [#kies-de-klant] Alegeți **Client destinație** și faceți clic pe **Mutați factura**. Factura se mută împreună cu plățile asociate, loturile de contoare și comentariile. O factură înregistrată este apoi trimisă din nou către contabilitatea dumneavoastră. Dacă factura a fost deja trimisă prin Peppol, nu o puteți muta. ## Recalcularea unei facturi [#een-factuur-herberekenen] Dacă sumele unei facturi înregistrate nu corespund cu rândurile, alegeți **Recalculați factura** în meniul de acțiuni. Tillor recalculează totalurile. ## Ștergerea unei ciorne [#een-concept-verwijderen] O factură ciornă o puteți șterge cu **Ștergeți factura** în meniul de acțiuni. Reveniți apoi la profilul clientului. Facturile înregistrate nu le puteți șterge, le stornați. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] | Cale | Consecință | |-------|--------| | Revenire la ciornă | Numărul facturii se păstrează. La o nouă înregistrare, factura își primește înapoi numărul și datele inițiale. | | Stornare | Apare o notă de credit care face referire la factura inițială. Compensarea se poate face cu un [transfer intern](/betalingsverwerking/interne-overboeking). | | Copiere | Apare o ciornă nouă. Factura inițială nu se schimbă. | | Mutare | Plățile, loturile de contoare și comentariile se mută odată cu ea. O factură înregistrată merge din nou la contabilitatea dumneavoastră. | | Recalculare | Totalurile sunt recalculate din rânduri. | ## Probleme? [#problemen] Una dintre condiții nu este îndeplinită. S-a trimis deja o notificare sau factura are 7 zile sau mai mult? Atunci puteți storna sau, cu dreptul **Corecții de factură**, puteți forța revenirea. Pentru aceasta aveți nevoie de dreptul **Corecții de factură**. Dacă factura a fost trimisă prin Peppol, mutarea nu este posibilă. Un administrator le stabilește. Vedeți [Utilizatori](/gebruikers). ## Mai departe [#verder] # Prezentare generală (/ro-RO/facturen) La Administrare > Facturi găsiți toate facturile parcului dumneavoastră, cu sumele restante în partea de sus. O factură începe ca ciornă și devine definitivă abia când o înregistrați. Apoi o puteți trimite, da spre plată și, eventual, corecta. - O factură nouă o creați în profilul clientului, nu din această listă. - O factură înregistrată primește o dată a scadenței: ziua înregistrării plus termenul de scadență implicit al organizației, implicit 7 zile. Puteți alege un alt termen pentru fiecare factură. - Dacă totalul nu este un multiplu de 5 cenți, Tillor adaugă la înregistrare un rând **Rotunjire**. - Tillor nu trimite singur clientului o factură înregistrată. Faceți acest lucru dumneavoastră cu **Trimiteți notificare**. - Revenirea la ciornă este posibilă până la 7 zile după data facturii, cât timp nu s-a trimis nicio notificare și factura nu a fost trimisă prin Peppol. După aceea stornați factura cu o notă de credit. - O plată în numerar poate fi implicit de maximum 2999 de euro. O modificați cu **Maxim numerar** la Asistență > Setări > Plăți. - O debitare directă cu un mandat SEPA pleacă spre bancă la două zile după înregistrare. Până atunci puteți anula plata. - Linkul personal al unei facturi nu are dată de expirare. Clientul vede acolo ce mai rămâne de plată. - Dacă clientul are un Peppol ID, Tillor trimite factura automat prin Peppol după înregistrare. ## Cum se leagă toate? [#hoe-hangt-dit-samen] O factură este începutul unui lanț. O plată este legată de o factură înregistrată, plățile unei zile ajung într-un raport de plăți, iar acel raport merge la contabilitate. ```mermaid flowchart LR A[Factură ciornă] -- Înregistrare --> B[Factură înregistrată] B -- Trimiteți notificare --> K[Clientul primește factura] K -- Clientul plătește online --> C[Plată] B -- Dumneavoastră înregistrați o plată --> C C -- Sold și starea plății --> B C -- Grupate pe zile --> D[Raport de plăți] D -- Mollie și transferuri interne --> E[Contabilitate] ``` - Soldul rămas și starea plății facturii rezultă singure din plăți. - O plată fără factură o puteți atribui mai târziu unei facturi înregistrate. - Ce plăți ajung în contabilitate citiți la [Contabilitate](/boekhouden). ## Lista de facturi [#de-facturenlijst] În partea de sus sunt patru contoare: **Total facturi**, **Facturi deschise** (neplătite sau parțial plătite), **Facturi restante** (data scadenței a trecut) și **Total restant** (suma totală a facturilor deschise). Dedesubt sunt patru liste: - **Plăți în curs**: facturi înregistrate a căror plată a fost pornită, dar încă nu a fost primită definitiv - **Facturi cu sold restant**: facturi înregistrate cu o sumă încă de plătit, sortate după data scadenței - **Ciorne**: ultimele zece facturi ciornă create - **Toate facturile**: lista completă, filtrată implicit pe facturile înregistrate Facturile noi nu le creați din această listă. Le creați în profilul clientului, vedeți [Crearea unei facturi](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken). ### Căutare și filtrare [#zoeken-en-filteren] Bara de căutare caută după numărul facturii, prenumele sau numele clientului, adresa de e-mail și sumă. În lista **Toate facturile** puteți filtra suplimentar după: | Filtru | Ce faceți cu el | |--------|-------------------| | **Perioadă** | Doar facturile dintr-o anumită perioadă | | **Stare** | **Ciornă** sau **Înregistrată** | | **Starea plății** | **Neplătită**, **Parțial**, **În curs** sau **Plătită** | | **Tip de client** | **Standard**, **Rulotă de închiriat pentru lucrători** sau **Rulotă tractată pentru lucrători** | | **Client** | Toate facturile unui singur client | | **Produse** | Facturi cu un anumit produs pe un rând | | **Sumă** | Facturi cu o sumă minimă sau maximă | În lista **Facturi cu sold restant** există și filtrul **De reamintit**. Alegeți un număr de zile (7 până la 90) și vedeți facturile restante create cu cel puțin atâtea zile în urmă și pentru care în ultimele zile nu s-a trimis nicio somație prin e-mail sau SMS. Util pentru a stabili cui trebuie să îi trimiteți din nou un memento. ### Facturi pe client [#facturen-per-klant] În profilul unui client găsiți toate facturile acelui client în blocul **Facturi** din fila **Prezentare generală**, sau în fila **Facturare**. Tot acolo creați o factură nouă. ## Ghiduri [#handleidingen] ## Conexe [#gerelateerd] ## Noțiuni [#begrippen] - **Ciornă**: o factură pe care o puteți încă modifica, cu un număr provizoriu de ciornă. - **Înregistrată**: o factură definitivă cu un număr de factură propriu. Vedeți [Înregistrare](/begrippen#boeken). - **Notă de credit**: o factură înregistrată cu un total negativ, de exemplu după stornarea unei facturi. - **Starea plății**: dacă și cât s-a plătit din factură. Vedeți [Stări](/facturen/statussen). - **Client**: clientul pentru care este factura. Vedeți [Client](/begrippen#klant). - **Ocupare**: un client pe o parcelă pentru o perioadă. Vedeți [Ocupare](/begrippen#bezetting). # Stările facturilor (/ro-RO/facturen/statussen) Fiecare factură are o **stare** (dacă este deja definitivă) și, odată înregistrată, o **stare a plății** (cât s-a plătit). Le puteți filtra pe amândouă în [lista de facturi](/facturen). ## Starea facturii [#factuurstatus] | Stare | Semnificație | |--------|-----------| | Ciornă | Factura poate fi încă editată și are un număr provizoriu de ciornă. Încă nu o puteți trimite și nici nu o puteți da spre plată. | | Înregistrată | Factura este definitivă și are un număr de factură propriu. O puteți trimite, da spre plată și corecta. | O ciornă care provine dintr-o factură înregistrată readusă la ciornă are un număr de ciornă cu numărul inițial al facturii între paranteze. Vedeți [Corectarea unei facturi](/facturen/corrigeren). ## Starea plății [#betalingsstatus] Starea plății se află lângă numărul unei facturi înregistrate. | Stare | Semnificație | |--------|-----------| | Neplătită | Încă nu s-a plătit nimic. | | Parțial | S-a plătit o parte și mai rămâne o sumă de plată. | | În curs | Întreaga sumă a fost inițiată, de exemplu o debitare directă, dar banii nu au fost încă procesați definitiv. | | Plătită | Factura este achitată integral. | O factură este **restantă** dacă data scadenței a trecut și mai rămâne o sumă de plată. Aceasta nu este o stare separată. O vedeți în contorul **Facturi restante** din lista de facturi. ## Tipul facturii [#factuurtype] | Tip | Semnificație | |------|-----------| | **Factură** | O factură obișnuită cu un total pozitiv. | | **Notă de credit** | O factură înregistrată cu un total negativ, de exemplu după [stornarea unei facturi](/facturen/corrigeren#een-factuur-omkeren). | ## Etichete în lista din profilul clientului [#labels-in-de-lijst-op-het-klantprofiel] | Etichetă | Semnificație | |-------|-----------| | **Trimisă prin Peppol** | Factura a fost trimisă prin Peppol. | | **Ciornă de stornare** | Această ciornă a fost creată pentru a storna o altă factură. | | **Această factură a fost stornată** | Există o notă de credit sau o ciornă care anulează această factură. | ## Mai departe [#verder] # Trimiterea unei facturi (/ro-RO/facturen/versturen) Cu **Trimiteți notificare** trimiteți clientului o factură înregistrată prin e-mail, SMS, WhatsApp sau poștă. Tillor nu face acest lucru niciodată singur. Dacă factura a fost deja trimisă, dar nu a fost plătită, trimiteți un memento. Clientul poate plăti apoi prin linkul din mesaj, vedeți [Plata online a unui client](/betalingsverwerking/online). Înainte să începeți: - Factura este înregistrată. La o ciornă, butoanele lipsesc. - Clientul are cel puțin o adresă de e-mail, un număr de telefon sau o adresă poștală completă (stradă, cod poștal și localitate). Altfel, butoanele lipsesc. - Pentru un memento, mai rămâne o sumă de plată. ## Trimiterea unei facturi [#een-factuur-versturen] ### Deschideți factura înregistrată [#open-de-geboekte-factuur] Mergeți la Administrare > Facturi și deschideți o factură cu starea Înregistrată. ### Faceți clic pe Trimiteți notificare [#klik-op-verstuur-notificatie] Se deschide o fereastră **Trimiteți notificarea**. ### Alegeți canalele [#kies-de-kanalen] Puteți alege dintre: - **E-mail**: clientul primește un e-mail cu factura ca atașament. Este activat implicit dacă există o adresă de e-mail. - **SMS**: clientul primește un mesaj SMS. Disponibil doar cu un număr de telefon. - **WhatsApp**: vizibil doar dacă WhatsApp Business este instalat. Necesită un număr de telefon și o metodă de plată la Meta sau o conversație în curs cu clientul. - **Poștă**: factura pleacă ca PDF prin poștă. Disponibil doar cu o adresă poștală completă. Este dezactivat implicit și afișează o sumă orientativă de taxe poștale pe scrisoare. Un canal care nu este posibil pentru acest client este dezactivat, cu motivul alăturat, de exemplu **Nicio adresă de e-mail înregistrată**. Alegeți cel puțin un canal. ### Trimiteți [#verstuur] Faceți clic pe **Trimite**. ## Trimiterea unui memento [#een-aanmaning-versturen] Un memento se poate trimite imediat ce factura este înregistrată și mai rămâne o sumă de plată. ### Deschideți meniul de alegere [#open-het-keuzemenu] Faceți clic pe săgeata de lângă **Trimiteți notificare** și alegeți **Trimiteți memento**. ### Alegeți canalele [#kies-de-kanalen-1] Aici **E-mail** și **SMS** sunt activate implicit dacă clientul are o adresă de e-mail și un număr de telefon. La **Poștă**, clientul primește o scrisoare de memento cu factura ca atașament, cu un cod QR pentru vizualizare sau plată online. ### Alegeți, dacă doriți, recomandat [#kies-eventueel-aangetekend] Dacă ați bifat **Poștă**, puteți alege **Corespondență recomandată cu confirmare de primire**. Acest lucru este posibil doar la un memento, nu la prima notificare a facturii, și doar dacă serviciul recomandat este disponibil pentru adresa respectivă. Tillor afișează atunci suma suplimentară orientativă, peste taxele poștale obișnuite. Butonul se numește atunci **Trimiteți cu cost suplimentar**. ### Trimiteți [#verstuur-1] Faceți clic pe **Trimite**. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] Pe pagina facturii, în blocul **Notificări**, vedeți ce mesaje au fost trimise. Toate mesajele organizației dumneavoastră se află la Comunicare > Notificări. Trimiterile poștale pornesc cu **În așteptare**. Apoi urmează starea scrisorii: **PDF primit**, **Validat**, **Se procesează**, **În centrul de imprimare** și **Predat serviciului poștal**. De îndată ce transportatorul confirmă, starea devine **Trimis**. Corespondența care nu poate fi livrată devine **Eșuat**. O scrisoare anulată la transportator primește starea **Omis**. Deschideți mesajul pentru suma taxelor poștale, referința transportatorului și ultima stare de urmărire. Mai multe despre acest lucru găsiți la [Notificări](/notificaties). - Tillor trimite mesajul imediat. Clientul primește un link pentru a vedea factura și a plăti online. - Un memento rămâne o acțiune separată pentru fiecare factură. Filtrul **De reamintit** din [lista de facturi](/facturen) vă ajută să alegeți cui trimiteți din nou un memento. - Automatizările pot trimite memento-uri și automat. Vedeți [Automatizări](/automatiseringen). O factură pentru care s-a trimis deja o notificare nu mai poate fi readusă simplu la ciornă. Vedeți [Corectarea unei facturi](/facturen/corrigeren#terugzetten-naar-concept). ## Probleme? [#problemen] Factura trebuie să fie înregistrată, iar clientul trebuie să aibă o adresă de e-mail, un număr de telefon sau o adresă poștală completă. Completați datele în profilul clientului. Un memento se poate trimite doar pentru o factură înregistrată cu o sumă rămasă de plată. Deschideți mesajul la Comunicare > Notificări pentru mesajul de eroare. Apoi verificați adresa de e-mail, numărul de telefon sau adresa poștală a clientului și trimiteți din nou. Vedeți [Notificări](/notificaties). ## Mai departe [#verder] # Invitarea utilizatorilor și acordarea permisiunilor (/ro-RO/gebruikers/gebruikers-en-rechten) Un coleg cu un cont Tillor se numește în Tillor utilizator. Dumneavoastră stabiliți cine are acces la organizație și ce poate vedea și face fiecare persoană, prin permisiuni. Pentru colegii pe care îi alegeți des împreună, creați apoi un [grup](/gebruikers/groepen). Înainte de a începe: - Aveți nevoie de permisiunea **Gestionați permisiunile utilizatorilor**. Fără ea, butoanele **Invitați utilizator** și **Editați permisiunile** sunt inactive. - Puteți acorda doar permisiuni pe care le aveți dumneavoastră. O permisiune pe care vă lipsește nu o puteți activa pentru altcineva. - Permisiunea **Gestionați permisiunile utilizatorilor** în sine o poate acorda altcuiva doar un utilizator cu **Toate permisiunile**. ## Invitarea unui coleg [#een-collega-uitnodigen] ### Deschideți utilizatorii [#open-de-gebruikers] Mergeți la Asistență > Setări > Utilizatori. Vedeți **Membri** organizației și **Invitații în așteptare**. ### Faceți clic pe Invitați utilizator [#klik-op-gebruiker-uitnodigen] Se deschide fereastra **Invitați utilizator**. ### Completați adresa de e-mail [#vul-het-e-mailadres-in] Introduceți **Adresă de e-mail** a colegului dumneavoastră și faceți clic pe **Invitați**. Ce se întâmplă apoi depinde de adresa de e-mail: Utilizatorul devine imediat membru al organizației dumneavoastră. Tillor afișează **Utilizatorul a fost adăugat la organizație**. Persoana vede organizația dumneavoastră imediat printre organizațiile ei. Tillor afișează **Invitația a fost trimisă** și trimite o invitație prin e-mail. Până când persoana se autentifică prima dată, apare la **Invitații în așteptare** cu insigna **În așteptare**. La prima autentificare devine membru al organizației dumneavoastră. Cu **Revocați invitația** retrageți invitația, iar Tillor afișează **Invitația a fost revocată**. Un utilizator nou primește la început aceste permisiuni: **Vizualizați setările**, **Editați setările**, **Vizualizați integrările**, **Gestionați integrările**, **Notificări de alarmă contor**, **Notificări de mesaje din inbox**, **Alerte pentru tabletă și chioșc**, **Gestionarea cererilor de semnare** și **Gestionează câmpurile personalizate**. Verificați dacă se potrivesc și ajustați-le. ## Editarea permisiunilor [#rechten-bewerken] ### Faceți clic pe Editați permisiunile la utilizator [#klik-bij-de-gebruiker-op-rechten-bewerken] Se deschide fereastra **Editați permisiunile utilizatorului**. Sus sunt grupurile din care face parte utilizatorul. Cu **Caută permisiuni** găsiți rapid o permisiune. ### Activați sau dezactivați permisiuni [#zet-rechten-aan-of-uit] Permisiunile sunt grupate pe componente, de exemplu **Facturare**, **Plăți** sau **Inbox**. Jos vedeți câte permisiuni efective are utilizatorul. ### Salvați permisiunile [#sla-de-rechten-op] Faceți clic pe **Salvați permisiunile**. Tillor afișează **Permisiunile utilizatorului au fost salvate**. ### De unde vine o permisiune? [#waar-komt-een-recht-vandaan] La fiecare permisiune este indicată sursa. Astfel vedeți de ce cineva poate sau nu poate face ceva. | Sursă | Semnificație | |---|---| | **Direct** | Ați acordat dumneavoastră permisiunea direct acestui utilizator. O puteți dezactiva aici | | Numele unui grup | Acel [grup](/gebruikers/groepen#groepsrechten) acordă permisiunea. Nu o puteți dezactiva aici, ci la grup | | **Blocat** cu numele unui grup | Acel grup refuză permisiunea. Chiar dacă utilizatorul o avea el însuși, rămâne blocată | | **Neacordat** | Nimeni nu acordă permisiunea | Butonul **Editați permisiunile** este inactiv pentru propriul rând și pentru utilizatorii cu insigna **Toate permisiunile**. Acești utilizatori au totul și nu îi puteți limita. ## Configurarea notificărilor unui coleg [#meldingen-van-een-collega-instellen] Cu pictograma clopoțel (**Setări notificări**) de la un utilizator deschideți notificările lui din această organizație. Pentru fiecare notificare alegeți e-mail, push sau apel telefonic. Cu **Toate notificările** dezactivați un canal dintr-o dată. Modificările se aplică imediat și sunt valabile doar în această organizație. Notificările care se trimit întotdeauna nu pot fi dezactivate. Ce este o notificare și unde le regăsiți găsiți la [Notificări](/notificaties#meldingen-in-de-app). ## Eliminarea unui utilizator [#een-gebruiker-verwijderen] Faceți clic pe pictograma coș de gunoi (**Eliminați din organizație**) și confirmați cu **Eliminați utilizatorul**. Tillor afișează **Utilizatorul a fost eliminat din organizație**. Persoana pierde imediat accesul la această organizație. Contul ei Tillor rămâne, la fel și eventualele alte organizații. Nu vă puteți elimina pe dumneavoastră. Un utilizator cu **Toate permisiunile** îl puteți elimina doar dacă aveți și dumneavoastră **Toate permisiunile**. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Utilizatorul vede organizația dumneavoastră printre organizațiile lui și poate folosi ce are permisiuni să folosească. - O modificare a permisiunilor se aplică imediat după salvare. - Un utilizator eliminat pierde imediat accesul. Contul lui Tillor rămâne. ## Probleme? [#problemen] Nu aveți permisiunea **Gestionați permisiunile utilizatorilor**. Rugați un coleg cu **Toate permisiunile** să v-o acorde. Acea adresă de e-mail este deja membră a organizației dumneavoastră sau există deja o invitație în așteptare pentru acea adresă. Verificați listele **Membri** și **Invitații în așteptare**. Dacă invitația există deja, revocați-o și invitați din nou dacă persoana nu a primit e-mailul. Rugați-o să verifice folderul de spam. Devine membră abia când se autentifică exact cu adresa de e-mail cu care ați invitat-o. Dacă se autentifică cu altă adresă, revocați invitația și invitați acea adresă. Puteți acorda doar permisiuni pe care le aveți dumneavoastră. Dacă la permisiune apare numele unui grup, acel grup acordă sau blochează permisiunea, iar dumneavoastră o ajustați la grup. Colegul are **Toate permisiunile** sau este propriul dumneavoastră rând. Pe acestea nu le puteți edita. Verificați în fereastra **Editați permisiunile utilizatorului** dacă un grup arată permisiunea ca **Blocat**. O refuzare dintr-un grup câștigă întotdeauna în fața unei permisiuni acordate direct. Nu vă puteți elimina pe dumneavoastră. Un utilizator cu **Toate permisiunile** îl eliminați doar dacă aveți și dumneavoastră **Toate permisiunile**. ## Vezi și [#zie-ook] # Grupuri (/ro-RO/gebruikers/groepen) Un grup este un set fix de colegi, de exemplu **Recepție** sau **Serviciul tehnic**. Folosiți un grup în aceste locuri: - **Atribuirea sarcinilor**: la atribuirea unei sarcini căutați după numele grupului - **Menționare și anunțare**: o menționare sau o notificare către un grup ajunge la toți membrii - **Partajarea vizualizărilor**: la o vizualizare de sarcini alegeți **Anumite grupuri**, vezi [Vizualizări](/taken/weergaven#wie-ziet-een-weergave) - **Automatizări**: pașii care creează sau actualizează o sarcină pot atribui grupuri ## Crearea unui grup [#een-groep-maken] ### Deschideți Grupuri [#open-groepen] Mergeți la Asistență > Setări > Grupuri. ### Faceți clic pe Grup nou [#klik-op-nieuwe-groep] Completați un **Nume**, de exemplu Recepție. ### Alegeți membrii [#kies-de-leden] La **Membri** alegeți persoanele. Puteți adăuga doar utilizatori care sunt deja membri ai organizației. ### Faceți clic pe Salvează [#klik-op-opslaan] Tillor afișează **Grup salvat**. Faceți clic pe un grup pentru a-i modifica numele sau membrii. Dacă ștergeți un grup, sarcinile rămân atribuite persoanelor trecute direct pe ele. Dispare doar grupul în sine. ## Permisiunile grupului [#groepsrechten] Un grup poate și să acorde sau să retragă permisiuni. La grup faceți clic pe cheiță (**Permisiunile grupului**). Pentru fiecare permisiune alegeți: | Alegere | Ce face | |---|---| | **Permite** | Toți din grup primesc permisiunea („Acordat tuturor") | | **Moștenește** | Grupul nu face nimic cu această permisiune. Fiecare membru își păstrează accesul propriu („Moștenește accesul propriu"). Aceasta este starea inițială | | **Refuză** | Permisiunea este blocată pentru toți din grup („Blocat pentru toți") | Cu **Caută permisiuni** găsiți rapid o permisiune. Jos vedeți câte permisiuni ați setat. Faceți clic pe **Salvează**, după care Tillor afișează **Permisiunile grupului au fost salvate**. Fără această permisiune butonul **Permisiunile grupului** este inactiv. Nici nu puteți șterge un grup care mai are permisiuni de grup. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Permisiunile grupului se adaugă peste permisiunile proprii ale fiecărui membru. O refuzare câștigă întotdeauna: dacă o permisiune este la un grup pe **Refuză** și la altul pe **Permite**, rămâne blocată. - În fereastra **Editați permisiunile utilizatorului** a unui membru vedeți pentru fiecare permisiune ce grup o acordă sau o blochează. Vezi [Editarea permisiunilor](/gebruikers/gebruikers-en-rechten#rechten-bewerken). - Dacă adăugați un membru, permisiunile grupului se aplică și lui. Dacă îl eliminați, nu se mai aplică. - A atribui o sarcină, a menționa pe cineva sau a trimite o notificare grupului ajunge la toți cei care sunt membri în acel moment. ## Grupuri din Microsoft Entra [#groepen-uit-microsoft-entra] Dacă gestionați deja personalul în Microsoft Entra ID, Entra poate ține automat la zi membrii unui grup. Sub lista de grupuri apare atunci tabelul **Grupuri Entra**, în care legați fiecare grup Entra de un grup Tillor. La un grup legat, Entra este sursa. Un membru pe care îl adăugați sau îl eliminați manual în Tillor este readus la starea din Entra la următoarea sincronizare. Vezi [Grupuri Microsoft Entra](/gebruikers/microsoft-entra) pentru a configura legătura. ## Probleme? [#problemen] Încercați din nou. Dacă tot eșuează, contactați suportul Tillor. Nu aveți permisiunea **Gestionați permisiunile utilizatorilor**. Un alt grup al acelui membru refuză permisiunea. O refuzare câștigă întotdeauna. Deschideți fereastra **Editați permisiunile utilizatorului** a membrului ca să vedeți ce grup o blochează. În listă apar doar utilizatorii organizației dumneavoastră. Invitați mai întâi persoana. Vezi [Invitarea utilizatorilor](/gebruikers/gebruikers-en-rechten). Dacă grupul este legat de Microsoft Entra, Entra este sursa, iar următoarea sincronizare aliniază membrii. Modificați membrul în Entra. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/gebruikers) Aici stabiliți cine lucrează cu Tillor și ce are voie să facă: invitați utilizatori, acordați permisiuni, grupați colegii și ajustați setările organizației. Un utilizator este oricine are un cont cu acces la organizația dumneavoastră. Gestionați acestea la Asistență > Setări. - Un utilizator nou primește un set fix de permisiuni de început (setări, integrări, câteva notificări, cereri de semnare și câmpuri personalizate). Tot restul acordați dumneavoastră - Puteți acorda doar permisiuni pe care le aveți dumneavoastră. Permisiunea **Gestionați permisiunile utilizatorilor** o poate transmite doar un utilizator cu **Toate permisiunile** - O refuzare printr-un grup câștigă întotdeauna în fața unei permisiuni acordate direct - Nu vă puteți elimina pe dumneavoastră și nici nu vă puteți edita propriile permisiuni - Nu aveți o parolă Tillor separată: vă autentificați prin Google, Microsoft sau Apple - Datele companiei, precum codul de TVA sau IBAN, nu le modificați singur. Le modifică suportul Tillor ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Un utilizator are permisiuni în două moduri: direct sau printr-un grup. Un grup poate și să refuze o permisiune. ```mermaid flowchart TD U[Utilizator] -->|acordat direct| R[Permisiunile utilizatorului] U -->|este membru al| G[Grup] G -->|Permite| R G -->|Moștenește| N[Nu face nimic, utilizatorul își păstrează permisiunile proprii] G -->|Refuză| B[Permisiune blocată, chiar dacă utilizatorul o avea el însuși] R --> A[Ce vede și ce poate face utilizatorul în Tillor] B --> A ``` - **Direct**: activați o permisiune în fereastra **Editați permisiunile utilizatorului**. Vezi [Invitarea utilizatorilor și acordarea permisiunilor](/gebruikers/gebruikers-en-rechten). - **Printr-un grup**: la **Permisiunile grupului** alegeți pentru fiecare permisiune **Permite**, **Moștenește** sau **Refuză**. Se aplică tuturor din grup. Vezi [Grupuri](/gebruikers/groepen). - **Refuzat**: dacă o permisiune este la un grup pe **Refuză**, este blocată, indiferent câte alte grupuri sau permisiuni directe o acordă. - Aceleași grupuri le folosiți pentru atribuirea sarcinilor, menționare și partajarea vizualizărilor. ## Contul dumneavoastră [#je-eigen-account] Faceți clic în bara laterală pe numele dumneavoastră (jos) și alegeți **Cont**. Acolo gestionați profilul, numărul de telefon, sesiunile active, aplicațiile OAuth și platformele de autentificare conectate. La **Notificări** alegeți pentru fiecare notificare dacă Tillor vă contactează prin e-mail sau push. Vezi [Autentificare și acces](/inloggen). ## Chei API [#api-sleutels] O cheie API permite unui alt program să comunice cu Tillor în numele dumneavoastră. Aparține contului dumneavoastră. Le gestionați pe pagina contului. ### Deschideți contul dumneavoastră [#open-je-account] Faceți clic în bara laterală pe numele dumneavoastră (jos) și alegeți **Cont**. ### Creați cheia [#maak-de-sleutel] Deschideți secțiunea **Chei API** și faceți clic pe **Creați cheie API**. ### Copiați-o imediat [#kopieer-hem-meteen] După aceea Tillor nu mai afișează cheia integral. Prin **Dezvoltatori** (același meniu de utilizator) găsiți și scurtătura **Mergeți la cheile API**. Păstrați cheile API în siguranță și nu le partajați niciodată pe canale nesecurizate. Dacă o cheie a fost compromisă, ștergeți-o sau faceți clic pe **Regenerați** și creați una nouă dacă este nevoie. ## Componente [#onderdelen] ## Termeni [#begrippen] - **Utilizator**: cineva cu un cont care are acces la [organizația](/begrippen#organisatie) dumneavoastră. - **[Permisiune](/begrippen#recht)**: o autorizare de a vedea sau de a face ceva, precum **Editați produsele**. - **Toate permisiunile**: o insignă pentru utilizatorii care au voie să facă totul. Permisiunile lor nu se editează. - **[Grup](/begrippen#groep)**: un set fix de colegi, eventual cu permisiuni proprii. - **Invitație**: o cerere în așteptare către cineva fără cont de a deveni membru. - **Cheie API**: un cod prin care un alt program lucrează cu Tillor. Mai mulți termeni găsiți în [lista de termeni](/begrippen). # Setări de plăți (/ro-RO/gebruikers/instellingen-betalingen) La Asistență > Setări > Plăți găsiți câteva setări care influențează înregistrarea plăților și trimiterea notificărilor. Setările se aplică întregii organizații. ## Setări [#instellingen] | Setare | Ce face | |---|---| | **Afișați metoda de plată „Altele”** | Adaugă metoda **Altele** în ecranul de plată. Cu ea înregistrați plăți cu o descriere proprie, de exemplu un cec sau un schimb. Implicit dezactivat. | | **Implicit: memento transfer bancar manual** | Bifează implicit memento-ul cu comunicarea structurată atunci când înregistrați un transfer bancar manual. Puteți în continuare să bifați sau să debifați pentru fiecare plată. Implicit dezactivat. | | **Maxim numerar** | O sumă în euro întregi. Implicit 2999. | | **Adresa expeditorului e-mailului** | Adresa cu care Tillor trimite notificări prin e-mail. | ## Maxim numerar [#maximumbedrag-contant] Cu **Maxim numerar** stabiliți cât de mare poate fi o singură plată în numerar. Implicit este 2999 de euro. Tillor verifică la fiecare plată în numerar, chiar dacă vine printr-o integrare. Dacă suma este mai mare, înregistrați-o în tranșe sau alegeți altă metodă. Vezi [Numerar și transfer](/betalingsverwerking/contant). ## Adresa expeditorului notificărilor [#afzenderadres-van-meldingen] Dacă lăsați **Adresa expeditorului e-mailului** goală, notificările au ca expeditor numele organizației dumneavoastră, cu o adresă Tillor. Dacă introduceți o adresă de e-mail validă, de exemplu `meldingen@recreatiepark-het-meer.be`, Tillor folosește acea adresă, cu numele organizației dumneavoastră ca nume de expeditor. Introduceți doar adresa, fără nume. O adresă nevalidă nu se salvează. ## Salvarea modificărilor [#wijzigingen-opslaan] Faceți clic jos pe **Salvați setările**. Cu **Anulare** readuceți formularul la valorile salvate. ## Vezi și [#zie-ook] # Setări de facturare (/ro-RO/gebruikers/instellingen-facturatie) La Asistență > Setări > Facturare configurați valorile implicite pentru facturi și pentru PDF-ul pe care îl trimiteți clienților. Setările se aplică întregii organizații. ## Ce apare pe PDF-ul facturii [#wat-staat-er-op-de-factuur-pdf] | Setare | Ce face | |---|---| | **Condiții generale pe PDF-ul facturii** | PDF-ul primește pentru fiecare pagină un verso cu condiții generale. În subsol apare o trimitere la ele. Textul condițiilor este fix și menționează denumirea juridică a organizației dumneavoastră. Implicit dezactivat. | | **Tabel de defalcare TVA pe PDF-ul facturii** | Lângă totaluri apare un tabel cu baza de impozitare și suma TVA pentru fiecare cotă de TVA. Implicit dezactivat. | | **Linii per pagină PDF factură** | Numărul maxim de linii pe o pagină. Dacă sunt mai multe linii, urmează o pagină nouă. Implicit 20, minimum 1. | ## Termen de plată [#betaaltermijn] La **Scadență implicită (zile)** introduceți numărul de zile dintre data facturii și data scadenței. Se aplică facturilor la care nu ați ales dumneavoastră o dată de scadență. Implicit sunt 7 zile. Puteți introduce 0, caz în care factura scade în ziua înregistrării. Vezi [Înregistrarea unei facturi](/facturen/boeken). ## Alegerea cotelor de TVA [#btw-tarieven-kiezen] La **Cote TVA permise** găsiți cotele pe care le puteți alege în lista de TVA de pe facturile ciornă. Implicit sunt 0%, 6%, 9%, 12% și 21%. 1. Introduceți un procent între 0 și 100 în câmpul de sub listă. Se acceptă virgula sau punctul. 2. Faceți clic pe **Adaugă cotă**. 3. Eliminați o cotă cu crucea de lângă procent. 4. Faceți clic pe **Salvați setările**. Lista este mereu ordonată de la mic la mare. O cotă care există deja în listă nu o adăugați de două ori. Dacă pe o linie de factură existentă este o cotă pe care o eliminați ulterior din listă, acea cotă rămâne pe linie. Această listă o vedeți doar dacă **Listă derulantă a cotei de TVA pe liniile facturii ciornă** este activată. Atunci o factură ciornă primește o coloană de TVA în care alegeți o cotă pentru fiecare linie. Dacă alegeți un produs, cota produsului rămâne valoarea inițială. Vezi [TVA](/boekhouden/belasting) și [Crearea și editarea facturilor](/facturen/aanmaken-en-bewerken). ## Facturi automate pentru consum [#automatische-facturen-voor-verbruik] La **Suma minimă pentru facturile automate de utilități** introduceți o sumă în euro. Pentru clienții cu facturare automată a utilităților, Tillor creează o factură abia când suma restantă atinge această sumă. Dacă lăsați câmpul gol (**Fără minim**), orice sumă restantă se facturează. Dacă un client are un minim propriu în profilul clientului, acel minim se aplică acelui client în locul acestei setări. Vezi [Gestionarea contoarelor](/meterbeheer). ## Salvarea modificărilor [#wijzigingen-opslaan] Faceți clic jos pe **Salvați setările**. Cu **Anulare** readuceți formularul la valorile salvate. Dacă aveți doar permisiunea **Vizualizați setările**, câmpurile sunt inactive. ## Vezi și [#zie-ook] # Configurarea perioadelor de chirie (/ro-RO/gebruikers/instellingen-huurperiodes) La o ocupare alegeți o **Frecvența chiriei**. Ce alegeri vedeți acolo stabiliți la Asistență > Setări > Perioade de chirie. Fiecare perioadă pe care o adăugați aici devine o alegere în listă. ## Adăugarea unei perioade [#een-periode-toevoegen] ### Adăugați o perioadă [#voeg-een-periode-toe] Deschideți **Perioade de chirie** și faceți clic pe **Adăugați perioadă**. Apare un bloc cu valorile inițiale: ianuarie, 12 luni. ### Completați perioada [#vul-de-periode-in] Alegeți **Luna de start** și la **Durată (luni)** introduceți un număr de la 1 la 12. O perioadă de 12 luni care începe în ianuarie este un an calendaristic. O perioadă de 1 lună este o chirie lunară. La **Etichetă** puteți pune un nume propriu, de exemplu Anual. ### Alegeți cum rotunjiți [#kies-hoe-je-afrondt] Bifa **Rotunjește datele de start la perioada următoare** este implicit activată. Ce face citiți la [Rotunjirea la perioada următoare](#afronden-naar-de-volgende-periode). ### Salvați [#sla-op] Faceți clic pe **Salvați setările**. Cu **Eliminați perioada** scoateți o perioadă. Cu **Anulare** readuceți formularul la lista salvată. Dacă nu ați adăugat încă nicio perioadă, apare **Nicio perioadă de chirie configurată**. În formularul unei ocupări nu puteți atunci alege nicio frecvență de chirie. ## Unde regăsiți perioadele [#waar-zie-je-de-periodes-terug] În formularul unei ocupări lista este la **Frecvența chiriei**, cu **Fără frecvență** în partea de sus. O perioadă de 1 lună se numește acolo **Lunar**. O perioadă de 12 luni apare ca **An (ian - dec)**, cu prima și ultima lună a perioadei. Alte durate apar ca **6 luni (apr - sep)**. Dacă ați completat o **Etichetă** la o perioadă, acea etichetă apare în locul acelui text, în listă și în coloana **Frecvența chiriei** a ocupărilor. Dacă eliminați o perioadă din setări, ocupările create deja cu ea își păstrează frecvența chiriei. ## Rotunjirea la perioada următoare [#afronden-naar-de-volgende-periode] Bifa stabilește starea inițială a opțiunii **Rotunjiți la limita perioadei următoare** de pe linia de factură cu care prelungiți o ocupare. Pe linia de factură puteți în continuare să bifați sau să debifați singur. - Dacă bifa este activată, linia se termină la următoarea limită de perioadă. Dacă începeți la mijlocul unei perioade, prima parte se calculează proporțional. Apoi clientul urmează același ciclu ca ceilalți chiriași. - Dacă bifa este dezactivată, linia durează exact o perioadă de la data de start. Vezi [Crearea și editarea facturilor](/facturen/aanmaken-en-bewerken) și [Ocupări](/bezettingen). ## Vezi și [#zie-ook] # Setări de control acces (/ro-RO/gebruikers/instellingen-toegangscontrole) La Asistență > Setări > Control acces configurați comportamentul barierelor pentru numerele de înmatriculare a căror perioadă de acces a expirat. ## Permiteți ieșirea numerelor de înmatriculare expirate [#verlopen-kentekens-laten-uitrijden] Un vizitator cu un număr de înmatriculare a cărui perioadă de acces a expirat nu mai trece altfel de bariera de ieșire. Cu **Permiteți ieșirea numerelor de înmatriculare expirate**, bariera de ieșire se deschide totuși, în timpul unei perioade de grație după expirare. Funcționează doar în afara programului de funcționare. Dacă recepția este deschisă, personalul rezolvă vehiculul la ghișeu. Bifa este implicit activată. Dacă o dezactivați, bariera de ieșire rămâne închisă pentru un număr de înmatriculare expirat. | Setare | Ce face | |---|---| | **Permiteți ieșirea numerelor de înmatriculare expirate** | Activează sau dezactivează perioada de grație. | | **Perioadă de grație la ieșire (zile)** | Numărul de zile după expirare în care un vehicul mai poate ieși în afara programului de funcționare. Implicit 2, cel mult 30. Cu 0 nu există grație. | Grația se aplică doar numerelor de înmatriculare la o ieșire. Un număr de înmatriculare blocat sau inactiv nu primește niciodată grație. Pentru alte metode de acces, precum etichetele NFC sau codurile QR, grația nu există. Programul de funcționare provine din Asistență > Setări > Program de funcționare. Vezi [Program de funcționare](/gebruikers/organisaties#openingsuren). ## Salvarea modificărilor [#wijzigingen-opslaan] Faceți clic jos pe **Salvați setările**. Cu **Anulare** readuceți formularul la valorile salvate. ## Vezi și [#zie-ook] # Grupuri Microsoft Entra (/ro-RO/gebruikers/microsoft-entra) Prin provizionare, Microsoft Entra ID trimite utilizatorii și grupurile dumneavoastră către Tillor. Dacă legați un grup Entra de un [grup](/gebruikers/groepen) Tillor, membrii acelui grup urmează Entra: cine este adăugat în Entra primește sarcinile și vizualizările grupului, iar cine este scos sau dezactivat le pierde. Pentru aceasta nimeni nu trebuie să se autentifice din nou. Entra folosește pentru aceasta protocolul SCIM. Tillor nu citește singur nimic din tenantul dumneavoastră Microsoft: Entra stabilește ce utilizatori și grupuri trimite. Doar în timpul [configurării rapide](#snel-instellen) browserul dumneavoastră comunică cu Microsoft pentru a crea aplicația pentru dumneavoastră. ## Ce se întâmplă și ce nu [#wat-er-wel-en-niet-gebeurt] - **Doar membri existenți.** Entra nu creează conturi Tillor. Cineva care nu este încă membru al organizației dumneavoastră nu contează până când [îl invitați](/gebruikers/organisaties). De îndată ce devine membru, intră imediat în grupurile lui legate - **Fără date ale nemembrilor.** Despre persoanele fără cont Tillor, Tillor nu păstrează nume sau adresă de e-mail, doar un cod ilizibil prin care le recunoaște dacă devin membri mai târziu - **Nimic fără legătură.** Un grup Entra schimbă ceva în Tillor abia când îl legați de un grup Tillor la **Grupuri Entra nelegate** - **Unu la unu.** Un grup Tillor aparține cel mult unui grup Entra - **Numele rămâne al Tillor.** Dacă redenumiți grupul în Entra, vedeți noul nume după **Entra ·**, dar grupul Tillor își păstrează propriul nume - **Grupurile imbricate** nu se extind. Un grup care este membru al altui grup nu contează ca membru. Dacă doriți și acele persoane, atribuiți grupul imbricat separat în Entra și legați-l de același grup Tillor sau de altul - **Autentificarea nu se schimbă.** Oamenii se autentifică în continuare cu Microsoft, vezi [Autentificare](/inloggen) ## Înainte de a începe [#voordat-je-begint] Aveți nevoie de: - În Tillor permisiunea **Editați setările** - În Microsoft Entra rolul **Cloud Application Administrator** sau **Application Administrator** (sau mai mare) - O licență Entra care permite provizionarea automată către aplicații proprii (Microsoft Entra ID P1 sau mai mare) Asigurați-vă că colegii dumneavoastră au în Tillor același cont Microsoft sau aceeași adresă de e-mail ca în Entra. Astfel Tillor recunoaște cine este cine, vezi [Cum recunoaște Tillor oamenii](#hoe-tillor-mensen-herkent). ## Configurare rapidă [#snel-instellen] Dacă sunteți dumneavoastră administrator Entra, Tillor pregătește legătura dintr-o dată. 1. Mergeți la **Asistență > Setări** și alegeți **Grupuri** 2. La **Microsoft Entra** faceți clic pe **Configurează cu Microsoft** și apoi pe **Autentifică-te și configurează** 3. În fereastra Microsoft autentificați-vă cu contul de administrator și acordați permisiunea. Microsoft cere permisiunea de a gestiona aplicații și provizionarea și de a citi grupurile dumneavoastră Tillor creează apoi aplicația în Entra, completează URL-ul tenantului și tokenul, face ca utilizatorii să fie recunoscuți după contul lor Microsoft și face ca Entra să trimită tipul fiecărui grup. Apoi pornește sincronizarea, iar Tillor vă trimite imediat pe dumneavoastră și toate grupurile, ca să nu așteptați prima sincronizare. La final, Tillor citește pentru fiecare grup tipul și dacă are o echipă Teams asociată. Vedeți fiecare pas bifat. Tillor face acest lucru în fundal: puteți închide fereastra sau chiar pagina. Dacă faceți mai târziu din nou clic pe **Configurează cu Microsoft**, vedeți cât a avansat sau, până la o oră după terminare, dacă a reușit sau a eșuat. Apoi puteți relua cu **Configurează din nou**. Entra trimite astfel toți utilizatorii și grupurile dumneavoastră. Nu trebuie să alegeți nimic în prealabil: grupurile ajung la **Grupuri Entra nelegate** și nu schimbă nimic până nu le legați. Continuați pentru aceasta la [Legarea grupurilor în Tillor](#groepen-koppelen-in-tillor). Membrii grupurilor vin cu prima sincronizare. Aceasta durează câteva minute, la organizațiile mari câteva ore. Tillor folosește accesul doar pentru această configurare. Ajunge criptat la sarcina din fundal și apoi nu mai este păstrat nicăieri; Microsoft îl lasă să expire singur după aproximativ o oră. Dacă parcurgeți din nou **Configurează cu Microsoft**, Tillor regăsește aceeași aplicație și nu creează una a doua. Configurarea rapidă creează un token nou. Un token pe care l-ați lipit anterior manual în Entra nu mai funcționează după aceea. Dacă configurarea se oprește la jumătate, faceți clic pe **Încearcă din nou**. Dacă autentificarea nu reușește, de exemplu pentru că organizația dumneavoastră blochează permisiunile pentru aplicații, sau dacă doriți ca Entra să trimită doar anumite grupuri, configurați legătura manual, ca mai jos. ## Configurare manuală [#handmatig-instellen] ### Crearea tokenului în Tillor [#token-maken-in-tillor] 1. Mergeți la **Asistență > Setări** și alegeți **Grupuri** 2. Sus este **Microsoft Entra**. Dacă legătura este deja configurată, faceți clic pe **Conexiune** 3. Copiați **URL-ul tenantului**. Arată astfel: `https://…/api/orgs//scim/v2` 4. Faceți clic pe **Generează tokenul** și copiați tokenul care apare Tokenul se afișează o singură dată. Lipiți-l imediat în Entra. Dacă l-ați pierdut, faceți clic pe **Înlocuiește tokenul** și folosiți tokenul nou. ### Crearea unei aplicații în Entra [#een-app-maken-in-entra] 1. Deschideți [centrul de administrare Microsoft Entra](https://entra.microsoft.com) 2. Mergeți la **Identity > Applications > Enterprise applications** și faceți clic pe **New application** 3. Faceți clic pe **Create your own application** 4. Dați aplicației un nume, de exemplu **Tillor**, alegeți **Integrate any other application you don't find in the gallery (Non-gallery)** și faceți clic pe **Create** Dacă aveți deja o enterprise application pentru Tillor, o puteți folosi și pe aceea. ### Legarea provizionării [#provisioning-koppelen] 1. În aplicație deschideți **Provisioning** și faceți clic pe **Get started** (sau **New configuration**) 2. Setați **Provisioning Mode** pe **Automatic** 3. La **Admin Credentials** completați: - **Tenant URL**: URL-ul tenantului din Tillor - **Secret Token**: tokenul din Tillor 4. Faceți clic pe **Test Connection**. Entra trebuie să anunțe că legătura a reușit 5. Faceți clic pe **Save** ### Verificarea atributelor [#attributen-controleren] La **Mappings** deschideți regula **Provision Microsoft Entra ID Users**: - Setați **externalId** pe **objectId** (implicit este **mailNickname**). Astfel Tillor recunoaște pe cineva după contul lui Microsoft, chiar dacă adresa de e-mail diferă - Lăsați **userName** (← **userPrincipalName**), **active** și **emails[type eq "work"].value** (← **mail**) neschimbate Lăsați **Provision Microsoft Entra ID Groups** activată. Setările implicite (**displayName**, **externalId** ← **objectId**, **members**) sunt corecte. Dacă vreți să vedeți în Tillor ce fel de grup este, adăugați aceste atribute la grupuri. La **Show advanced options** alegeți mai întâi **Edit attribute list for customappsso** și adăugați atributele țintă, apoi pentru fiecare regulă **Add New Mapping**: | Sursă în Entra | Atribut țintă | Tip | |---|---|---| | Expresia `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 | Dacă o sursă lipsește din lista din Entra, săriți acea regulă. Dacă un grup are o echipă Teams asociată, Entra nu poate trimite astfel; Tillor vede asta doar prin **Configurează cu Microsoft**. Alte atribute le puteți lăsa. Tillor nu le păstrează. ### Atribuirea grupurilor [#groepen-toewijzen] 1. În aplicație deschideți **Users and groups** și faceți clic pe **Add user/group** 2. Alegeți grupurile pe care Tillor trebuie să le primească, de exemplu **Recepție**, și faceți clic pe **Assign** 3. La **Provisioning > Settings** verificați că **Scope** este pe **Sync only assigned users and groups** Entra trimite un grup împreună cu membrii lui. Nu trebuie să atribuiți membrii separat. ### Pornirea provizionării [#provisioning-starten] La **Provisioning** setați **Provisioning Status** pe **On** și faceți clic pe **Save**. Prima rundă poate dura puțin, în funcție de numărul de utilizatori. Apoi Entra trimite modificările aproximativ la fiecare 40 de minute. Dacă vreți să actualizați imediat o persoană, folosiți **Provision on demand** în Entra. ### Legarea grupurilor în Tillor [#groepen-koppelen-in-tillor] Reîmprospătați **Setări > Grupuri**. Sus este rândul **Microsoft Entra** cu ultima sincronizare și câte grupuri sunt legate. Sub grupurile dumneavoastră Tillor sunt **Grupuri Entra nelegate** cu grupurile trimise care încă nu fac nimic. Faceți clic pe **Arată** dacă lista este închisă și folosiți câmpul de căutare pentru a găsi un grup. Pentru fiecare grup alegeți la **Leagă de…** ce trebuie să se întâmple și apoi faceți clic pe **Salvează**. Cu **Anulează modificările** aruncați alegerile. Un grup Tillor poate fi legat de un singur grup Entra; grupurile deja legate nu le mai puteți alege. | Alegere | Ce se întâmplă | |---|---| | **Creează nou** | Tillor creează un grup cu numele din Entra și îl umple cu membrii recunoscuți | | Un grup existent | Membrii acelui grup sunt înlocuiți cu membrii recunoscuți din Entra. Dacă Entra nu a trimis încă membrii acelui grup, membrii actuali rămân până când sincronizarea îi livrează | De acum Entra actualizează membrii la fiecare sincronizare. Grupul legat dispare din listă, iar în grupurile dumneavoastră Tillor apare sub grup **Entra · [nume]** cu tipul de grup. Legarea se face doar din **Grupuri Entra nelegate**. Un grup Tillor pe care îl gestionați manual, precum IT, nu îl legați din grupul însuși. După fiecare nume de grup apare ce fel de grup este în Entra. Cu butoanele de deasupra listei afișați un singur tip. | Etichetă | Ce este | |---|---| | **Securitate** | Un grup de securitate obișnuit, adesea grupul pe care vreți să-l legați | | **Securitate cu e-mail** | Un grup de securitate cu adresă de e-mail proprie | | **Listă de distribuție** | Doar o listă de e-mail | | **Microsoft 365** | Un grup cu o căsuță poștală comună și un site SharePoint, uneori cu o echipă Teams | | **Windows Server AD** | Provine din Active Directory local (hibrid) și este gestionat acolo | | **Dinamic** | Entra stabilește singur membrii cu o regulă | | **Teams** | Are o echipă Teams asociată | | **Tip necunoscut** | Tillor nu cunoaște încă tipul. Parcurgeți din nou **Configurează cu Microsoft** | Grupurile de site SharePoint, precum **Owners**, **Members** și **Visitors** ale unui site, nu sunt grupuri Entra. Acestea nu ajung niciodată în Tillor. Ce vedeți este grupul Microsoft 365 din spatele site-ului. ## Cum recunoaște Tillor oamenii [#hoe-tillor-mensen-herkent] Pentru fiecare utilizator trimis de Entra, Tillor caută un membru existent al organizației dumneavoastră: 1. Mai întâi după **contul Microsoft** cu care persoana se autentifică în Tillor (ID-ul de obiect Entra, dacă setați **externalId** pe **objectId**) 2. Altfel după **adresa de e-mail**: adresa de serviciu din Entra sau **userPrincipalName** dacă este o adresă de e-mail Dacă Tillor nu găsește pe nimeni sau utilizatorul este dezactivat în Entra, nu contează în grup. De îndată ce persoana devine membră a organizației, contează imediat. Dacă îl reactivați în Entra, contează la următoarea sincronizare. ## Ce se întâmplă la modificările din Entra [#wat-er-gebeurt-bij-wijzigingen-in-entra] | În Entra | În Tillor | |---|---| | Membru adăugat într-un grup legat | Intră în grupul Tillor (dacă este membru al organizației) | | Membru scos din grup | Iese din grupul Tillor | | Utilizator dezactivat (**Account enabled** dezactivat) | Iese din toate grupurile Tillor legate. Contul lui Tillor rămâne | | Utilizator sau grup neatribuit aplicației | Entra trimite o dezactivare sau ștergere, cu același efect | | Grup șters | Sub grupul Tillor apare **Eliminat în Entra. Membrii au fost păstrați.** Grupul Tillor rămâne cu ultimii lui membri și nu mai este actualizat | Eliminarea cuiva complet din organizație o faceți în Tillor, la [Organizație](/gebruikers/organisaties). Entra gestionează doar membrii grupurilor. ## Ce regăsiți în jurnalul de activitate [#wat-je-terugziet-in-het-activiteitenlog] În [jurnalul de activitate](/activiteitenlog) vedeți: - Fiecare modificare a membrilor unui grup Tillor pe care o aplică Entra, cu cine a intrat sau a ieșit. Apare pe numele sistemului, nu al unui utilizator - Fiecare rundă de sincronizare a Entra, un rând pe rundă. O rundă în care Entra nu trimite nimic nu o vedeți - Cine a legat sau a dezlegat un grup Entra de un grup Tillor și cine a înlocuit tokenul ## Modificarea sau oprirea legăturii [#koppeling-wijzigen-of-stoppen] - **Dezlegare**: la grupul Tillor faceți clic pe **Dezleagă**. Grupul Tillor rămâne cum este și îl gestionați din nou manual. Grupul Entra revine la **Grupuri Entra nelegate** - **Alt grup Tillor**: dezlegați și apoi legați grupul Entra de un alt grup la **Grupuri Entra nelegate**. Grupul anterior își păstrează membrii, dar nu mai este actualizat - **Oprire completă**: în Entra setați **Provisioning Status** pe **Off** sau ștergeți enterprise application ## Înlocuirea tokenului [#token-vervangen] În rândul **Microsoft Entra** faceți clic pe **Conexiune** și apoi pe **Înlocuiește tokenul** dacă tokenul a fost compromis sau dacă aveți nevoie de el din nou. Vechiul token nu mai funcționează imediat. Lipiți tokenul nou în Entra la **Provisioning > Admin Credentials > Secret Token** și faceți clic pe **Save**. Până faceți asta, sincronizarea în Entra eșuează. ## Rezolvarea problemelor [#problemen-oplossen] **Configurarea cu Microsoft se oprește la un pas** La pas apare mesajul de la Microsoft. De obicei contului dumneavoastră îi lipsește rolul de administrator sau permisiunea. Verificați rolurile la [Înainte de a începe](#voordat-je-begint) și faceți clic pe **Încearcă din nou**. Tillor reutilizează aplicația și provizionarea create deja. **Test Connection eșuează** Verificați că URL-ul tenantului a fost preluat complet, inclusiv `/scim/v2`, și că tokenul este ultimul generat. După **Înlocuiește tokenul**, un token vechi nu mai funcționează. **Un grup nu apare în listă** Așteptați să se încheie prima sincronizare și reîmprospătați pagina. Dacă ați configurat legătura manual, Entra trimite doar grupurile atribuite aplicației: verificați **Users and groups** în aplicație și așteptați runda următoare sau folosiți **Provision on demand**. **Cineva lipsește din grupul Tillor** - Este acea persoană membră a organizației dumneavoastră Tillor? Entra nu creează conturi - Adresa de e-mail din Entra corespunde cu cea din Tillor? Altfel setați **externalId** pe **objectId**, ca Tillor să îl recunoască după contul Microsoft. Funcționează doar dacă s-a autentificat deja o dată în Tillor cu Microsoft - Este utilizatorul activ în Entra? - Este membru direct al grupului, și nu printr-un grup imbricat? **Modificarea mea manuală dispare** La un grup legat, Entra este sursa. Modificați membrii în Entra sau dezlegați grupul. **Mai multe detalii despre o rundă eșuată** În Entra deschideți **Provisioning > Provisioning logs**. Acolo vedeți pentru fiecare utilizator și grup ce a încercat Entra și ce răspuns a dat Tillor. ## Vezi și [#zie-ook] # Organizație (/ro-RO/gebruikers/organisaties) Pe pagina **Setări** (jos în meniul principal, Asistență > Setări) gestionați setările organizației dumneavoastră. În stânga treceți între componente. Ce componente vedeți depinde de permisiunile dumneavoastră. | Componentă | Pentru ce | |---|---| | **General** | Profilul organizației, fusul orar, țara implicită și culorile de brand. Vezi [General](#algemeen) | | **Program de funcționare** | Program săptămânal, sezoane, excepții și sărbători. Vezi [Program de funcționare](#openingsuren) | | **Facturare** | PDF, termen de scadență și cote de TVA. Vezi [Setări de facturare](/gebruikers/instellingen-facturatie) | | **Imprimare** | Imprimante și momente de imprimare. Vezi [Imprimare](#afdrukken) | | **Plăți** | Metoda de plată Altele și adresa expeditorului. Vezi [Setări de plăți](/gebruikers/instellingen-betalingen) | | **Perioade de chirie** | Frecvențe de chirie pentru ocupări. Vezi [Configurarea perioadelor de chirie](/gebruikers/instellingen-huurperiodes) | | **Tarif parcelă** | Formula pentru tariful calculat. Vezi [Formula tarifului](/terreinen#tariefformule) | | **Control acces** | Ieșirea cu un număr de înmatriculare expirat. Vezi [Setări de control acces](/gebruikers/instellingen-toegangscontrole) | | **Hartă** | Centrul hărții și orientarea hărții. Vezi [Configurarea hărții implicite](/kaart#kaartstandaard-instellen) | | **Tipuri de parcelă** | Tipuri pentru parcele. Vezi [Tipuri de parcelă](/terreinen#terreintypes) | | **Etichete de sarcini** | Etichete pentru sarcini. Vezi [Etichete](/taken/labels) | | **Grupuri** | Reuniți colegi. Vezi [Grupuri](/gebruikers/groepen) | | **Câmpuri personalizate** | Câmpuri suplimentare la clienți, parcele și altele. Vezi [Câmpuri personalizate](/eigen-velden) | | **Apple Wallet** | Fundalul pass-ului și punctul de acces. Vezi [Apple Wallet](#apple-wallet) | | **Tablete și chioșcuri** | Tablete și chioșcuri. Vezi [Tablete și chioșcuri](/mobiele-app/tablets-en-kiosken) | | **Integrări** | Legături cu alte servicii. Vezi [Integrări](#integraties) | | **Utilizatori** | Membri, invitații și permisiuni. Vezi [Gestionarea permisiunilor utilizatorilor](#gebruikersrechten-beheren) | - Ce componente vedeți depinde de permisiunile dumneavoastră. Modificările le salvați jos cu **Salvați setările** - Cam cu o săptămână înainte de o sărbătoare legală, Tillor trimite un e-mail la adresa de suport dacă programul de funcționare al acelei zile este încă gol - După salvarea setărilor wallet, Tillor retrimite toate pass-urile wallet active. Vizitatorii văd asta de obicei după ce deschid pass-ul - De îndată ce organizația dumneavoastră are facturi sau plăți, moneda nu mai poate fi schimbată Datele companiei de pe facturi (nume, adresă, cod de TVA, IBAN, logo) se configurează în timpul onboarding-ului. Contactați suportul Tillor dacă doriți să le modificați. ## Integrări [#integraties] Alegeți **Integrări** pentru a vedea legăturile disponibile, precum telefonia Voys, conturile bancare, Mollie sau software de contabilitate (de ex. Admisol). Sub **Integrări** în meniul din stânga găsiți categorii (comunicare, plăți, contabilitate, contoare). Faceți clic pe o integrare din listă pentru a deschide pagina de detalii. Acolo instalați legătura sau ajustați setările (fără fereastră de dialog separată). Vezi și [prezentarea integrărilor](/integraties). ## General [#algemeen] La **General** configurați profilul organizației, fusul orar, țara implicită și culorile de brand. Aveți nevoie de permisiunea **Editați setările** pentru a salva modificările. ## Program de funcționare [#openingsuren] La **Program de funcționare** editați un singur program săptămânal. Cu opțiunile colorate treceți la **perioade de sezon** (de exemplu 1 iulie–31 august) sau la o **excepție** (o singură dată sau o perioadă precum 24–26 decembrie). **Sărbătorile legale** din următoarele 12 luni sunt deja acolo: alegeți o sărbătoare și completați orele (sau lăsați-le goale dacă în ziua respectivă sunteți închis). Lăsați goală o zi a săptămânii dacă în ziua respectivă sunteți închis. AI-ul din inbox folosește aceste ore ca ore de program ale biroului. Cam cu o săptămână înainte de o sărbătoare legală, Tillor trimite un e-mail de memento la **adresa de suport** a organizației (sau la adresa de e-mail generală dacă nu există adresă de suport) dacă orele pentru acea sărbătoare nu au fost încă completate. Dacă folosiți Partoo, programul de funcționare se sincronizează automat. Vezi [Partoo](/integraties/partoo). Un site web poate prelua orele rezolvate (inclusiv etichetele de sezon precum Vară sau Iarnă) și următoarele sărbători prin [API-ul Program de funcționare](/ontwikkelaars/voorbeelden/opening-hours). ## Imprimare [#afdrukken] La **Imprimare** configurați imprimările PDF, adresele IP ale imprimantelor și **programul momentelor de imprimare**. Adăugați pentru fiecare zi a săptămânii unul sau mai multe momente (sau lăsați ziua goală). Plățile online, prin mandat și prin transfer așteaptă următorul moment din acea zi înainte ca factura să ajungă în coada imprimantei. ## Apple Wallet [#apple-wallet] La **Apple Wallet** configurați două lucruri alăturat: în stânga **fundalul pass-ului**, în dreapta **locația punctului de acces**. **Fundalul pass-ului** (stânga): fotografie opțională pe toată suprafața pentru aspectul Poster Generic pe iPhone cu **iOS 27**. Încărcați JPEG, PNG sau WebP; fișierele mari se micșorează automat. Trageți pe previzualizare pentru a alege ce parte din fotografie rămâne vizibilă în spatele codului QR. Previzualizarea arată imediat alegerea; abia după **Salvare** jos în **Setări** fotografia (sau ștergerea) intră în vigoare, iar Tillor trimite focalizarea către pass-urile de acces. Pe iPhone cu **iOS 26 sau mai vechi**, pass-ul folosește aspectul generic clasic cu aceleași date (stare, numele vizitatorului, valabilitate, cod QR). Fără o imagine proprie, toate pass-urile primesc fundalul degrade standard Tillor. Cu o fotografie proprie, sus apare **logoul organizației** din datele companiei dumneavoastră, în culoare pe fotografie. Pe degradeul standard logoul este alb pe fundalul închis. Pe pass-urile Poster Generic (iOS 27) codul QR este **pătrat**; pe dispozitivele mai vechi este dreptunghiular, ca la un pass generic clasic. **Locația punctului de acces** (dreapta): faceți clic pe hartă sau trageți pinul pentru a seta punctul GPS al punctului de acces principal. **Apple Wallet** și **Google Wallet** folosesc acea locație pe pass-ul de acces. Pe iPhone, iOS poate sugera pass-ul pe ecranul de blocare când un vizitator este în apropiere. Alegeți **Folosiți centrul hărții parcului** pentru a elimina pinul și a folosi centrul hărții parcului. După salvarea **Setărilor**, Tillor actualizează toate pass-urile wallet active din organizație (Apple prin push silențios, Google prin sincronizarea obiectului). Oaspeții văd de obicei actualizarea după ce deschid pass-ul în Wallet; uneori este încă nevoie de o reîmprospătare manuală în aplicația Wallet. Previzualizarea din Tillor arată aceeași decupare ca pe pass: trageți imaginea astfel încât punctul central să fie în locul dorit. Pe verso pass-ului wallet apar numărul de telefon și adresa de e-mail ale organizației (e-mailul de suport dacă este configurat, altfel adresa generală). La pass-urile blocate, expirate sau revocate, aceste date apar și în spatele textului pentru recepție pe ecranul de blocare (Apple) sau în Google Wallet. ## Gestionarea permisiunilor utilizatorilor [#gebruikersrechten-beheren] La **Utilizatori** vedeți **Membri** organizației dumneavoastră și **Invitații în așteptare**. Cum invitați și eliminați colegi și cum le configurați notificările găsiți la [Invitarea utilizatorilor și acordarea permisiunilor](/gebruikers/gebruikers-en-rechten). ### Editarea permisiunilor [#rechten-bewerken] Faceți clic la un utilizator pe **Editați permisiunile**. Toate explicațiile, inclusiv despre grupuri și permisiuni blocate, le găsiți la [Editarea permisiunilor](/gebruikers/gebruikers-en-rechten#rechten-bewerken). Mai jos sunt permisiunile care ridică des întrebări. ### Conturi bancare [#bankrekeningen] | Permisiune | Ce are voie utilizatorul? | |---|---| | **Vizualizați tranzacțiile bancare** | Pagina **Administrare > Tranzacții bancare** și blocul **Tranzacții ale contului bancar** de la **Administrare > Rapoarte de plăți** | | **Sincronizați tranzacțiile bancare** | Butonul **Sincronizați contul bancar** (import manual) | Permisiunile se află în dialogul de permisiuni, în grupul **Tranzacții bancare**. Vezi și [Conturi bancare](/boekhouden/betalingsrapporten/betaalmethodes/ponto) pentru legătura cu open banking. ### Atribuirea unei plăți [#betaling-koppelen] | Permisiune | Ce are voie utilizatorul? | |---|---| | **Atribuiți plata** | **Atribuiți plata** pe o factură înregistrată, **Atribuiți** la grupurile de plăți și **Atribuiți facturii** la tranzacțiile bancare (nu este vizibil fără permisiune) | Permisiunea se află în dialogul de permisiuni, în grupul **Plăți**. ### Aplicații OAuth [#oauth-apps] | Permisiune | Ce are voie utilizatorul? | |---|---| | **Autorizare aplicații OAuth** | Să acorde permisiune unor terți (de ex. Cursor, Claude, ChatGPT) prin OAuth și să folosească în continuare tokenurile OAuth existente | Utilizatorii existenți păstrează permisiunea după migrare. Utilizatorii noi nu o primesc automat. Bifați-o în dialogul de permisiuni al utilizatorului. Dezactivați-o pentru a-l împiedica să conecteze aplicații OAuth noi; tokenurile existente ale acelui utilizator se opresc atunci și ele. Utilizatorii cu această permisiune în cel puțin o organizație au voie să autorizeze. Vezi și [MCP](/ontwikkelaars/mcp). ## Acordul de prelucrare [#verwerkersovereenkomst] Dacă în locul Tillor apare un ecran **Este necesar un acord de prelucrare a datelor**, organizația dumneavoastră trebuie să semneze acordul de prelucrare (DPA) actual înainte de a continua. Puteți descărca mai întâi documentul cu **Descărcați documentul DPA**. Apoi solicitați un cod de verificare. Acesta ajunge prin SMS la numărul de telefon al persoanei responsabile. Introduceți codul și faceți clic pe **Acceptați DPA**. ## Datele de pe facturi [#gegevens-op-facturen] Datele companiei, precum numele, adresa, codul de TVA și IBAN, apar automat pe facturi. Acestea se configurează în timpul onboarding-ului. Contactați suportul Tillor pentru a le modifica. ## Vezi și [#zie-ook] # Dovezi și valabilitate (/ro-RO/handtekeningen/bewijs-en-geldigheid) Tillor înregistrează la fiecare semnare cine a semnat, când și cum, și sigilează PDF-ul astfel încât orice modificare ulterioară să fie vizibilă. Rezultatul este o semnătură electronică simplă, potrivită pentru contracte de închiriere, regulamente interne, declarații de renunțare (waivers) și condiții. Pentru documentele pentru care legea cere o semnătură mai puternică, Tillor nu este locul potrivit. ## Ce se află pe paginile de dovadă? [#wat-staat-er-op-de-bewijspaginas] La finalul PDF-ului semnat se adaugă una sau mai multe pagini **Dovada semnării**. Acolo găsești: - titlul documentului, cererea, organizația ta, numărul de pagini și când a fost creată, trimisă și finalizată cererea - două amprente ale fișierului: ale PDF-ului așa cum l-ai încărcat și ale paginilor semnate înainte de adăugarea paginilor de dovadă. Dacă se schimbă un singur caracter din fișier, amprenta nu mai corespunde - pentru fiecare semnatar: nume, rol, tip, adresa de e-mail, numărul de telefon și limba, când a plecat linkul și când a deschis persoana pagina pentru prima dată, momentul semnării, adresa IP și dispozitivul - cum a fost confirmat semnatarul: cu un cod unic, pe ce canal a fost trimis codul și când, sau autentificat în Tillor la angajați - fraza cu care semnatarul și-a dat acordul, exact așa cum apărea pe ecran - ce a completat semnatarul: fiecare câmp de text, de dată și de bifat, cu valoarea lui, inclusiv ce a rămas gol - semnătura și parafa așa cum au fost desenate și pe ce pagini apar. O semnătură tastată apare ca imagine a numelui tastat, la fel ca una desenată - cum s-a semnat: pe pagina de semnare prin link, în Tillor de un angajat autentificat sau pe tableta de la recepție (cu cod sau cu identitatea confirmată de un angajat) - **istoricul de audit**: fiecare pas cu momentul, cine l-a făcut și de la ce adresă IP și dispozitiv. De exemplu *Link de semnare trimis*, *Pagina de semnare deschisă*, *Cod de verificare trimis*, *Cod greșit introdus*, *Semnat* și *Finalizat și sigilat* Orele sunt în fusul orar al organizației tale, cu ora UTC (ora standard mondială) alături. Adresele IP și dispozitivele sunt păstrate criptat de Tillor. Le vezi în Tillor și pe paginile de dovadă. Semnăturile și valorile completate apar în document la locurile alese de tine. Încărcarea ta originală este păstrată separat și nu se schimbă niciodată. Aceiași pași îi vezi și pe pagina cererii, la **Istoric**, și la client, la **Evenimente**. Cele două amprente sunt sume de control SHA-256. O amprentă SHA-256 se schimbă complet de îndată ce se modifică un singur octet al unui fișier, de aceea dovedește că fișierul nu a fost modificat. Pe pagina de dovadă apare și amprenta certificatului de sigiliu (vezi mai jos). ## Sigiliu și marcă temporală [#zegel-en-tijdstempel] PDF-ul semnat este, ca ultim pas, **sigilat** cu o semnătură digitală a organizației tale, creată de Tillor. Dacă îl deschizi în Adobe Reader sau în alt cititor de PDF, vezi un panou de semnătură. Dacă după sigilare se modifică ceva în fișier, cititorul te avertizează. Cititorul spune uneori că semnatarul este **necunoscut** sau **nevalidat**. Este normal: certificatul vine de la Tillor și nu de la o autoritate de certificare plătită. Ce certificat este, apare cu amprenta lui pe pagina de dovadă. Sigiliul primește și o **marcă temporală** de la un serviciu independent și gratuit de marcare temporală (FreeTSA sau DigiCert, dacă primul nu răspunde). Aceasta dovedește, independent de Tillor, când a existat fișierul exact în această formă. Momentul apare pe pagina cererii, la **Marcă temporală**. ## Ce fel de semnătură este [#welk-soort-handtekening] Este o **semnătură electronică simplă** conform regulilor europene eIDAS. Tillor verifică adresa de e-mail sau numărul de telefon cu un cod, înregistrează desenul semnăturii și păstrează dovada. Aceasta se potrivește cu contractele de închiriere, regulamentele interne, declarațiile de renunțare și condițiile. O semnătură **calificată**, de exemplu cu itsme sau cu un card eID, nu este posibilă. Dacă ai un document pentru care legea o cere, semnează-l în afara Tillor. ## Ce se întâmplă cu dovada? [#wat-gebeurt-er-met-het-bewijs] - PDF-ul original și PDF-ul semnat rămân la documentele clientului. Le poți arhiva, dar nu le poți șterge. - Dovada face parte din PDF-ul semnat. Cine a primit o copie are deci și paginile de dovadă. - Istoricul de audit rămâne pe pagina cererii, chiar dacă cererea a fost refuzată, anulată sau a expirat. ## Probleme? [#problemen] Este corect și normal. Sigiliul vine de la Tillor, nu de la o autoritate de certificare plătită. Important este ca cititorul să nu raporteze nicio modificare după sigilare. Certificatul apare cu amprenta lui pe pagina de dovadă. Fișierul a fost modificat după sigilare, de exemplu prin salvarea sau editarea lui din nou. Descarcă din nou PDF-ul semnat de pe pagina de detalii a cererii sau de la documentele clientului. Acel fișier este nemodificat. Asta nu se poate în Tillor. Semnează documentul respectiv în afara Tillor. ## Vezi și [#zie-ook] # Cere semnături (/ro-RO/handtekeningen/handtekening-vragen) Cu o cerere de semnare pui una sau mai multe persoane să semneze un PDF online. O creezi în două părți: mai întâi alegi clientul și PDF-ul, apoi stabilești în editor semnatarii și câmpurile. Cum urmărești apoi cine a semnat găsești la [Urmărirea unei cereri](/handtekeningen/opvolgen). Înainte de a începe: - Ai nevoie de permisiunea **Gestionarea cererilor de semnare**. Dacă nu o ai, butonul **Cere semnături** apare gri. - Fișierul trebuie să fie un PDF, de până la 250 MB. Un alt tip de fișier este refuzat de Tillor cu **Acesta nu este un PDF. Alegeți un fișier PDF.** - Fiecare semnatar are nevoie de o adresă de e-mail sau de un număr de telefon pentru a primi linkul sau codul. Pentru un client sau o persoană de contact, le completezi mai întâi în datele lor. - Fiecare semnatar are nevoie de cel puțin un câmp de semnătură sau de inițiale. ## Crearea unei cereri de semnare [#een-ondertekenverzoek-maken] ### Pornește cererea [#start-het-verzoek] Alege de unde începi. Mergi la Administrare > Semnături și apasă **Cere semnături**. Alege **Client**. Deschide fila **Documente** a clientului și apasă **Cere semnături**. Clientul este deja completat. La **Document** alege un PDF care se află deja la acel client sau lasă **Încarcă un PDF nou** și trage PDF-ul în casetă (sau apasă **Alegeți PDF**). Completează un **Titlu**, de exemplu *Contract de închiriere 2027*. Dacă îl lași gol, Tillor preia numele documentului. Apoi apasă **Continuă**. Un PDF încărcat ajunge la documentele clientului. Tillor nu îl modifică niciodată: semnăturile ajung într-o copie separată. ### Adaugă semnatari [#voeg-ondertekenaars-toe] La **Semnatari** apasă **Adaugă semnatar** și alege: - **Client: [nume]** - **Contact al clientului** - **Angajat** - **Parte externă**: completează **Nume**, **Adresă de e-mail** și/sau **Număr de mobil** și **Limbă**. Cel puțin una dintre cele două date de contact este necesară. Fără adresă de e-mail, persoana primește linkul prin SMS. Poți adăuga maximum 10 semnatari. Aceștia semnează de sus în jos, iar următorul primește linkul abia după ce cel dinainte a semnat. Cu **Semnează mai devreme** și **Semnează mai târziu** (săgețile) schimbi ordinea, iar cu coșul de gunoi elimini pe cineva. În caseta de sub nume poți completa opțional un **Rol**, de exemplu *Chiriaș* sau *Garant*. Fiecare semnatar primește o culoare proprie. O regăsești la câmpurile lui din document. ### Plasează câmpurile [#plaats-de-velden] La **Câmpuri pentru** alege semnatarul pentru care plasezi câmpuri. Apoi alege tipul de câmp și atinge sau trage pe o pagină a documentului. Trage un câmp pentru a-l muta și trage colțul pentru a-l mări sau micșora. | Câmp | Ce face semnatarul | | --- | --- | | **Semnătură** | Plasează semnătura desenată atingând caseta | | **Inițiale** | Plasează parafa desenată atingând caseta | | **Nume** | Nimic: Tillor completează numele semnatarului | | **Data semnării** | Nimic: Tillor completează ziua semnării | | **Text** | Tastează un rând, până la 200 de caractere, de exemplu un număr de înmatriculare | | **Text lung** | Tastează câteva rânduri, până la 2.000 de caractere, de exemplu o observație | | **Casetă de bifat** | Bifează o condiție | | **Dată** | Alege o dată, de exemplu o zi de sosire | Apasă pe un câmp plasat pentru a-l selecta. Sub butoane vezi atunci: - **Semnatar**: trece câmpul pe numele altui semnatar, fără a-l desena din nou. - La **Text**, **Text lung**, **Casetă de bifat** și **Dată** apar și **Întrebare sau etichetă** (pe care semnatarul o vede la caseta de completare) și **Obligatoriu**. Un câmp care nu este obligatoriu poate rămâne gol. - Cruciulița de pe câmp îl șterge. Dacă cineva are nevoie de inițiale pe fiecare pagină, folosește **Inițiale pe fiecare pagină**. Tillor plasează atunci un câmp de inițiale pe toate paginile pentru acel semnatar. Cât timp un semnatar nu are câmp de semnătură sau de inițiale, vezi **Încă niciun câmp de semnătură** la acea persoană. ### Stabilește mesajul și termenul [#stel-bericht-en-termijn-in] La **Cerere** completezi: - **Titlu**: așa cum îl văd semnatarii. - **Mesaj pentru semnatari**: opțional, apare în e-mail și pe pagina de semnare. - **Semnează până la**: data limită. Implicit este 14 zile după creare. Se poate semna până la sfârșitul acelei zile. - **Memento după**: după câte zile (de la 1 la 14) primește un memento semnatarul care este la rând. Implicit 3 zile. ### Trimite cererea [#verstuur-het-verzoek] Apasă **Trimite** și confirmă. Primul semnatar primește linkul. Dacă vrei să continui mai târziu, apasă **Salvează ciorna**. Cu coșul de gunoi de lângă (**Șterge ciorna**) arunci cererea, după confirmare. PDF-ul rămâne la documentele clientului. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Cererea primește starea În curs. O găsești la client, la **Documente**, și la Administrare > Semnături. Tillor afișează **Trimisă primului semnatar**. - Primul semnatar primește un e-mail cu un link personal sau un SMS dacă există doar un număr de telefon. Fiecare semnatar următor primește linkul imediat ce cel dinainte a semnat. - Un semnatar care este la rând și nu răspunde primește automat un memento după numărul de zile de la **Memento după**, de maximum 2 ori. Poți trimite oricând și tu un memento, vezi [Urmărirea unei cereri](/handtekeningen/opvolgen#een-herinnering-sturen). - De îndată ce toți au semnat, cererea devine Finalizată și PDF-ul semnat se află la client. - Dacă termenul a trecut fără ca toți să fi semnat, cererea devine Expirată. Dacă vrei să modifici ceva cât timp nu a semnat încă nimeni, sau doar tu, apasă **Înapoi la editare**. Cererea devine din nou ciornă: linkurile trimise nu mai funcționează și toți semnează din nou după ce o retrimiți. Dacă altcineva a semnat deja, anulează cererea și creează una nouă. Vrei ca o automatizare să reacționeze la o cerere finalizată, de exemplu cu o sarcină? Folosește declanșatorul **Cerere de semnătură finalizată**, vezi [Declanșatoare](/automatiseringen/triggers). ## Probleme? [#problemen] Nu ai permisiunea **Gestionarea cererilor de semnare**. Cere unui administrator să o adauge la Setări > Utilizatori. Ai ales un alt tip de fișier, de exemplu Word. Salvează mai întâi documentul ca PDF și alege acel fișier. În primul ecran, **Client** sau **Document** este gol. Completează-le pe amândouă și apasă din nou **Continuă**. Tillor verifică cererea înainte de plecare și spune ce lipsește: - **Adaugă cel puțin un semnatar înainte de trimitere.** - Un semnatar nu are încă un câmp de semnătură sau de inițiale. Tillor selectează acea persoană. Trage apoi pe document pentru a plasa un câmp. - Un semnatar nu are adresă de e-mail sau număr de telefon și deci nu poate primi un link sau un cod. Aceasta se aplică și unui client sau unei persoane de contact: completează mai întâi o adresă de e-mail sau un număr de telefon în datele lor. În listă, la o astfel de persoană apare **Fără adresă de e-mail sau număr de telefon**. - **Dă un titlu cererii.** Este posibil ca cererea să nu fi plecat. Reîncarcă pagina. Dacă cererea este încă Ciornă, apasă din nou **Trimite**. Modificările tale nu au fost salvate. Reîncarcă pagina și verifică ce a rămas înainte de a continua. Reîncarcă pagina. Dacă tot nu merge, verifică dacă fișierul este un PDF valid. Apasă pe câmp și alege la **Semnatar** persoana corectă. Câmpul rămâne la locul lui. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/handtekeningen) Cu **Semnături** pui un PDF, precum un contract de închiriere, un regulament intern, o declarație de renunțare (waiver) sau o garanție, să fie semnat online. Semnatarii semnează unul după altul, iar tu stabilești unde pe pagini apare fiecare semnătură, parafă sau câmp de completat. Cum procedezi găsești la [Cere semnături](/handtekeningen/handtekening-vragen). Când toți au semnat, Tillor creează un PDF semnat cu pagini de dovadă la final. Acesta se află apoi la **Documente** ale clientului, iar fiecare semnatar primește o copie. PDF-ul tău original rămâne păstrat nemodificat. Pregătirea, trimiterea, reamintirea, retragerea și anularea cererilor de semnare cer permisiunea **Gestionarea cererilor de semnare**, în grupul **Semnături** de la Setări > Utilizatori. Dacă nu ai această permisiune, butoanele respective apar gri. Toți utilizatorii din organizația ta pot vedea cererile și pot semna ei înșiși când le vine rândul. - O cerere are maximum 10 semnatari și doar fișiere PDF, de până la 250 MB. - Implicit se poate semna 14 zile, până la sfârșitul ultimei zile. Poți alege tu o altă dată. - Un semnatar care este la rând primește implicit un memento după 3 zile (poți alege de la 1 la 14 zile), cu maximum 2 mementouri automate. Acestea pleacă odată cu verificarea zilnică a Tillor. - La semnare, semnatarul confirmă cu un cod de 6 cifre. Codul este valabil 10 minute, iar după 2 minute se poate cere unul nou. - PDF-ul tău original nu se schimbă niciodată. Originalul și PDF-ul semnat le poți arhiva, dar nu le poți șterge, deoarece reprezintă dovada. - Cererea primește starea Expirată în timpul verificării zilnice, nu exact în momentul în care termenul a trecut. ## Unde găsești [#waar-vind-je-het] - Administrare > Semnături arată toate cererile de semnare cu starea lor și câte semnături sunt deja puse. - Pe profilul unui client, în fila **Documente**, se află butonul **Cere semnături**, iar dedesubt **Cereri de semnătură** ale acelui client. ## Cum se leagă lucrurile? [#hoe-hangt-dit-samen] O cerere de semnare aparține întotdeauna unui client și unui PDF. Semnatarii nu trebuie să fie chiar clientul: poate semna și o persoană de contact, un coleg sau o parte externă. ```mermaid flowchart LR A[PDF la client] --> B[Cerere de semnare cu semnatari și câmpuri] B --> C[Semnatarul 1 semnează] C --> D[Semnatarul 2 semnează] D --> E[PDF semnat cu pagini de dovadă] E --> F[Documentele clientului] E --> G[Copie pentru fiecare semnatar] ``` ## Cum decurge o cerere [#hoe-een-verzoek-verloopt] ```mermaid flowchart LR A[Ciornă] -->|Trimite| B[În curs] B -->|toți au semnat| C[Finalizată] B -->|semnatarul refuză| D[Refuzată] B -->|Anulează cererea| E[Anulată] B -->|termen depășit| F[Expirată] B -->|Înapoi la editare| A ``` ## Stări [#statussen] | Stare | Semnificație | |---|---| | Ciornă | Încă pregătești cererea. Nu s-a trimis nimic. | | În curs | Cererea a fost trimisă și se semnează. | | Finalizată | Toți au semnat, iar PDF-ul semnat se află la client. | | Refuzată | Un semnatar a refuzat. Cererea s-a oprit. | | Anulată | Tu sau un coleg ați retras cererea. | | Expirată | Nu s-a semnat la timp. | Pentru fiecare semnatar vezi **În așteptare** (încă nu este la rând), **Link trimis** (este la rând), **Semnat** sau **Refuzat**. ## Cine poate semna [#wie-kan-ondertekenen] | Tip | Cum semnează persoana | |---|---| | **Client** | Printr-un link personal pe e-mail sau prin SMS dacă există doar un număr de telefon | | **Persoană de contact** | Ca clientul, pentru o persoană de contact a acelui client | | **Angajat** | Chiar în Tillor, fără cod | | **Parte externă** | Ca clientul, cu un nume și o adresă de e-mail sau un număr de telefon pe care le completezi tu | Un client, o persoană de contact sau o parte externă poate semna și la recepție, pe o tabletă cu aplicația Tillor. Vezi [Pe tableta de la recepție](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie). ## Automatizare [#automatiseren] O cerere de semnare poate porni o [automatizare](/automatiseringen/triggers). Cu **Cerere de semnătură finalizată** creezi, de exemplu, o sarcină de îndată ce un contract de închiriere a fost semnat, iar cu **Cerere de semnătură modificată** reacționezi la fiecare schimbare de stare. Aceleași evenimente le poți trimite ca [webhook](/ontwikkelaars/webhooks) către propriul sistem. ## Termeni [#begrippen] - **Cerere de semnare**: sarcina de a pune un singur PDF să fie semnat, cu semnatari, câmpuri și un termen. Vezi [cerere de semnare](/begrippen#ondertekenverzoek). - **Semnatar**: cineva care trebuie să semneze. Un client, o persoană de contact, un angajat sau o parte externă. - **Câmp**: un loc în PDF unde un semnatar semnează, pune parafa sau completează ceva. - **Ciornă**: o cerere pe care încă o pregătești. Nu s-a trimis nimic. - **Pagini de dovadă**: paginile de la finalul PDF-ului semnat, care arată cine a semnat, când și cum. Vezi [pagină de dovadă](/begrippen#bewijspagina). - **Sigiliu**: semnătura digitală a organizației tale cu care este închis PDF-ul semnat. Vezi [sigiliu](/begrippen#zegel). # Cum semnează cineva (/ro-RO/handtekeningen/ondertekenen) Această pagină arată ce trăiesc semnatarii tăi, ca să poți răspunde la întrebări, și cum pui pe cineva să semneze la recepție pe tabletă. O cerere o trimiți singur prin [Cere semnături](/handtekeningen/handtekening-vragen). Înainte de a începe: - Cererea trebuie să aibă starea În curs, iar semnatarul trebuie să fie la rând. Dacă nu este încă rândul nimănui, apare **Nu este încă rândul tău**. - Pentru tabletă ai nevoie de permisiunea **Gestionarea cererilor de semnare**, iar aplicația Tillor trebuie să fie online pe un dispozitiv al organizației tale. - Semnatarul are nevoie de un număr de telefon sau de o adresă de e-mail, pentru că acolo se trimite codul. Doar un angajat semnează fără cod. ## Pe tableta de la recepție [#op-de-tablet-aan-de-receptie] Dacă are cineva în fața ta, nu trebuie să deschidă linkul singur. Aceasta merge la un client, o persoană de contact sau o parte externă care este la rând. ### Deschide cererea [#open-het-verzoek] Mergi la Administrare > Semnături și deschide cererea, sau deschide-o din fila **Documente** a clientului. ### Apasă pe Semnează pe tabletă [#klik-op-op-tablet-tekenen] La semnatarul care este la rând apasă **Semnează pe tabletă** și alege cum se confirmă identitatea: - **Cu cod**: semnatarul confirmă pe tabletă cu codul primit prin SMS sau e-mail, ca la link. - **Fără cod**: ai verificat identitatea la recepție, de exemplu cu o carte de identitate. Nu se cere cod. Pe foaia de dovadă apare că identitatea a fost confirmată de un angajat, iar în istoric cine a fost. Tillor afișează **Deschis pe tabletă**. ### Pune persoana să semneze [#laat-de-persoon-tekenen] Documentul se deschide în aplicația de pe tabletă, cu numele semnatarului sus, cu litere mari. Verifică acest nume împreună cu persoana din fața ta. Pașii sunt aceiași ca prin link, vezi mai jos. Imediat după trimitere, tableta poate afișa încă puțin **Se pregătește documentul…**. După semnare sau refuz, tableta revine la ecranul de start după câteva secunde. Dacă sunt mai mulți semnatari, îi trimiți pe fiecare separat la tabletă când le vine rândul. Pe foaia de dovadă apare că semnătura a fost pusă pe tabletă. ## Ce face semnatarul? [#wat-doet-de-ondertekenaar] Semnatarul primește un e-mail sau un SMS dacă există doar un număr de telefon. Acesta conține un link personal către pagina de semnare, cu mesajul tău și numele organizației tale. Pagina funcționează pe telefon, tabletă și computer, în limba semnatarului. Semnatarul vede documentul direct în aplicație, după ce ai ales **Semnează pe tabletă**. Nu este nevoie de link sau de e-mail. Cine semnează pe tabletă cu cod primește codul pe propriul telefon sau în propriul e-mail. Apoi pașii sunt aceiași. ### Început [#beginnen] Pe primul card apare cine mai semnează, locul în rând (de exemplu *Semnatarul 2 din 3*) și pașii. În dreapta se află documentul, cu semnăturile semnatarilor anteriori deja la locul lor. Cu **Începeți semnarea** semnatarul pornește. Fiecare pas are un buton înapoi. Butonul înapoi al telefonului funcționează și el. ### Desenează-ți semnătura [#teken-je-handtekening] Semnatarul desenează o **Semnătură** cu degetul sau cu mouse-ul, sau alege **Tastează** și își tastează numele complet. Tillor pune atunci numele tastat într-o scriere de mână. Dacă există câmpuri de inițiale, urmează în același fel o **Inițiale** (desenate sau tastate). Cu **Șterge** semnatarul o ia de la capăt. Trecerea între **Desenează** și **Tastează** golește caseta. ### Plasează-ți semnătura [#plaats-je-handtekening] Semnatarul atinge fiecare casetă marcată din document (**Clic pentru a semna** sau **Clic pentru inițiale**). **Câmpul următor** sare la următoarea casetă goală. Cu **Caseta anterioară** și **Caseta următoare** semnatarul parcurge toate casetele. O a doua atingere pe o casetă completată nu face nimic. ### Completează-ți datele [#vul-je-gegevens-in] Doar dacă ai plasat câmpuri de completat: text, dată sau o bifă. La fiecare câmp apare **obligatoriu** sau **opțional**. Un câmp obligatoriu gol oprește pasul. Ce se tastează apare imediat în document. Numele și data semnării le completează Tillor singur. ### Confirmă și semnează [#bevestig-en-onderteken] Semnatarul bifează că a citit documentul. Dacă mai lipsește ceva, apare o listă cu butoane care duc la acel pas. Abia când totul este gata, semnatarul trimite un cod de 6 cifre cu **Trimite codul de verificare**: prin SMS dacă există un număr de telefon, altfel prin e-mail. Codul este valabil 10 minute. Dacă nu ajunge, după 2 minute se poate apăsa **Retrimite codul**. Apoi semnatarul apasă el însuși **Semnează**. Nu se semnează niciodată automat. ## Ce vezi după aceea? [#wat-zie-je-daarna] - Dacă nu este încă rândul cuiva, apare **Nu este încă rândul tău** și urmează un mesaj când vine momentul. - Cine a semnat deja vede **Ai semnat** până când ceilalți termină. - De îndată ce toți au semnat, fiecare semnatar poate descărca PDF-ul semnat prin același link (**Semnat de toți**). - La o cerere retrasă, semnatarul vede **Cerere retrasă**, la o cerere expirată **Termen de semnare încheiat**, iar la o cerere refuzată **Semnare oprită**. - Un angajat semnează în Tillor, prin butonul **Semnează acum** de pe pagina de detalii sau prin linkul din mesaj. Un cod nu este necesar, deoarece persoana este deja autentificată. Și aici semnătura poate fi desenată sau tastată. ## Refuz [#weigeren] Cu **Refuză semnarea** un semnatar poate respinge cererea și poate da opțional un motiv (până la 500 de caractere). Cererea se oprește atunci, nimeni altcineva nu mai este solicitat, iar cel care a creat cererea primește un mesaj. Vezi [Urmărirea unei cereri](/handtekeningen/opvolgen#wat-gebeurt-er-daarna). ## Probleme? [#problemen] Butonul apare doar dacă aplicația Tillor de pe un dispozitiv al organizației tale a avut contact cu Tillor în ultimele minute și doar la un client, o persoană de contact sau o parte externă care este la rând. Deschide aplicația pe tabletă, așteaptă puțin și reîncarcă pagina. Verifică și dacă **Afișează bonuri și documente** este activat în [setările dispozitivului](/mobiele-app/toestelinstellingen#kassabonnen-en-geluid). Vezi și [Tablete și kioscuri](/mobiele-app/tablets-en-kiosken). Tillor nu a putut ajunge la o tabletă care afișează documente. Verifică dacă aplicația este deschisă și dacă dispozitivul are conexiune, apoi încearcă din nou. Codul merge la numărul de telefon sau la adresa de e-mail dacă nu există număr de telefon. Pune semnatarul să verifice folderul de spam și să folosească după 2 minute **Retrimite codul**. Dacă numărul sau adresa nu sunt corecte, modifică-le la client sau la persoana de contact și trimite un memento. La o parte externă, anulezi cererea și creezi una nouă cu datele corecte. Codul introdus nu este corect sau a expirat. Un cod este valabil 10 minute. Semnatarul cere unul nou cu **Retrimite codul** și îl introduce. Fiecare încercare greșită apare în istoric ca **Cod greșit introdus**. Mai lipsește ceva. Sub **Mai aveți de făcut înainte de a semna:** apare ce mai trebuie: desenarea semnăturii sau a inițialelor, atingerea unei casete sau completarea unui câmp obligatoriu. Și bifa că documentul a fost citit trebuie să fie activă. Dacă cererea a fost readusă la ciornă, anulată sau a expirat, vechiul link nu mai funcționează. După retrimitere, semnatarul primește un link nou. La o cerere anulată sau expirată trebuie să creezi o cerere nouă. Pagina era deja deschisă în timp ce cererea s-a modificat, de exemplu pentru că este deja semnată. Pagina arată acum stadiul ei. Nu s-a întâmplat nimic greșit. ## Vezi și [#zie-ook] # Urmărirea unei cereri (/ro-RO/handtekeningen/opvolgen) După trimitere, urmărești o cerere de semnare pe pagina de detalii: cine a semnat deja, cine este la rând și ce mai poți face. Tot aici trimiți un memento, anulezi o cerere și descarci PDF-ul semnat. Înainte de a începe: - Oricine poate vizualiza. Trimiterea de mementouri, anularea, readucerea la ciornă și trimiterea la tabletă cer permisiunea **Gestionarea cererilor de semnare**. Fără această permisiune, butoanele respective apar gri. - Cererea trebuie să fi fost trimisă. O Ciornă o editezi în editor, vezi [Cere semnături](/handtekeningen/handtekening-vragen). ## Deschiderea cererii [#het-verzoek-openen] Deschide Administrare > Semnături. Lista arată pentru fiecare cerere **Titlu**, **Client**, **Stare**, câte au fost deja **Semnat**, când a fost **Creat** și până când se poate semna (**Semnează până la**). Caută după titlu sau numele clientului sau filtrează cu **Stare**, de exemplu doar cererile care sunt încă în curs. Apasă pe o cerere pentru a o deschide. Aceleași cereri se află și la client, în fila **Documente**, la **Cereri de semnătură**. ## Pagina de detalii [#de-detailpagina] În stânga vezi datele cererii, semnatarii în ordine și **Istoric**. În dreapta se află documentul, cu semnăturile deja puse. Sus apare cine este așteptat, de exemplu *Se așteaptă semnătura lui Marc Janssens.* Pentru fiecare semnatar vezi dacă încă așteaptă (**În așteptare**), a primit linkul (**Link trimis**), a **Semnat** sau a **Refuzat**, cu momentul. Pagina se reîmprospătează singură când cineva semnează. ### Înainte și după: de la În curs la Finalizată [#voor-en-na-van-bezig-naar-afgerond] Așa arată același tip de cerere în timpul semnării și după. Mai întâi este În curs: chiriașul a semnat, iar garantul este la rând. De îndată ce ultimul semnatar a semnat, cererea este Finalizată. Toate semnăturile sunt în document, istoricul este completat, iar sus apare butonul pentru descărcarea PDF-ului semnat. ## Trimiterea unui memento [#een-herinnering-sturen] La un semnatar care este la rând, apasă **Trimite memento**. Persoana primește din nou același link, iar Tillor afișează **Linkul a fost trimis din nou**. Linkul din primul mesaj continuă să funcționeze. Butonul nu apare la angajați, care semnează în Tillor, și nici la semnatarii care încă așteaptă. În plus, Tillor trimite singur mementouri. Un semnatar care este la rând primește un memento după numărul de zile setat la **Memento după** (implicit 3), numărate de la primul mesaj sau de la mementoul anterior. Aceasta se întâmplă de maximum 2 ori per semnatar și în timpul verificării zilnice a Tillor. Un memento poate deci ajunge cu până la o zi mai târziu decât numărul de zile setat. ## Semnarea pe tabletă [#laten-tekenen-op-de-tablet] Dacă semnatarul se află la recepție, apeși la acea persoană **Semnează pe tabletă**. Cum funcționează și de ce butonul lipsește uneori citești la [Pe tableta de la recepție](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie). ## Semnarea personală ca angajat [#zelf-ondertekenen-als-medewerker] Dacă este rândul unui coleg sau al tău, persoana primește un mesaj cu un link către Tillor. Pe pagina de detalii apare atunci butonul **Semnează acum**. ## Anularea unei cereri [#een-verzoek-annuleren] Apasă **Anulează cererea** și confirmă. Linkurile de semnare nu mai funcționează atunci, iar semnăturile deja puse nu sunt folosite. Dacă vrei totuși să continui, apasă **Păstrează**. Anularea este posibilă doar cât timp cererea este În curs. O cerere finalizată, refuzată sau expirată este definitivă. ## Înapoi la editare [#terug-naar-bewerken] Dacă nu a semnat încă nimeni, sau doar tu, pe pagina de detalii apare **Înapoi la editare**. Cererea devine din nou ciornă, linkurile trimise nu mai funcționează, iar toți semnează din nou după trimitere. Dacă altcineva a semnat deja, butonul lipsește. Anulează atunci cererea și creează una nouă. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - **Cineva semnează**: semnatarul primește starea **Semnat**, iar următorul primește linkul. Pagina se reîmprospătează singură. - **Toți au semnat**: vezi scurt *Toți au semnat. PDF-ul semnat este în pregătire.* Cererea devine Finalizată. PDF-ul semnat apare ca **[titlu] (semnat)** la **Documente** ale clientului, cu același tip de document ca PDF-ul original. Dacă acesta nu avea tip, primește tipul **Acord semnat**. Fiecare semnatar primește o copie. - **Cineva refuză**: cererea se oprește cu starea Refuzată. Cel care a creat cererea primește o notificare, iar ceilalți semnatari nu mai sunt solicitați. La semnatar apare motivul, dacă a fost completat. - **Tu anulezi**: cererea primește starea Anulată, iar linkurile nu mai funcționează. - **Termenul a trecut**: după ziua de la **Semnează până la**, nimeni nu mai poate semna. Tillor pune cererea pe Expirată în timpul verificării zilnice. Până la acea verificare vezi pe pagina de detalii că termenul a trecut. Dacă vrei ca cineva să mai semneze, creează o cerere nouă. ## PDF-ul semnat [#de-ondertekende-pdf] Pe pagina de detalii descarci PDF-ul cu **Descarcă PDF-ul semnat**, sub istoric. Tot acolo se află și **Marcă temporală**, vezi [Dovezi și valabilitate](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel). Prin e-mail, PDF-ul este atașat mesajului către semnatar. Dacă nu reușește, apare un buton pentru a-l descărca. Cine are doar un număr de telefon primește un SMS cu un link. PDF-ul semnat și PDF-ul original sunt dovada semnării. De aceea nu le poți șterge, doar arhiva. ## Istoric și evenimente [#verloop-en-gebeurtenissen] La **Istoric** apare fiecare pas cu momentul și cine l-a făcut: creat, trimis, link trimis, pagină deschisă, cod trimis, cod greșit, semnat, refuzat, readus la ciornă, anulat, expirat și finalizat. Aceeași linie apare la client, în fila **Evenimente**, și în [jurnalul de activitate](/activiteitenlog). ## Probleme? [#problemen] Butonul apare doar la un semnatar cu starea **Link trimis**, deci care este la rând. La un angajat nu apare niciodată, deoarece acesta semnează în Tillor. Dacă apare dar este gri, nu ai permisiunea **Gestionarea cererilor de semnare**. Încearcă din nou. Dacă tot nu merge, verifică adresa de e-mail și numărul de telefon ale semnatarului. La un client sau o persoană de contact le modifici în datele lor. La o parte externă, anulezi cererea și creezi una nouă cu datele corecte. A semnat deja altcineva decât tine. Atunci cererea nu mai poate reveni la ciornă. Anulează cererea cu **Anulează cererea** și creează una nouă. Anularea este posibilă doar la o cerere care este În curs. Reîncarcă pagina și vezi care este starea acum. O cerere finalizată, refuzată sau expirată nu mai poate fi anulată. Vezi *Termenul de semnare a trecut; cererea expiră la următoarea verificare zilnică.* Nimeni nu mai poate semna acum. După ce a rulat verificarea, cererea este Expirată. Tillor încă pregătește PDF-ul. Reîncarcă pagina după câteva minute. De îndată ce este gata, se află la documentele clientului și apare **Descarcă PDF-ul semnat**. Dacă nici după un sfert de oră nu este gata, Tillor încearcă din nou la următoarea verificare zilnică. Este intenționat. PDF-ul original și PDF-ul semnat sunt dovada. Le poți totuși arhiva. ## Vezi și [#zie-ook] # Scanări de identitate (/ro-RO/identiteitsscans) Cu un cititor de acte de identitate scanezi pașapoarte, cărți de identitate, permise de conducere, vize și documente de ședere. Tillor recunoaște tipul documentului, citește datele și creează rapid cu ele un client, fără să retastezi totul. Cititorul trimite scanarea prin [conectorul Tillor](/connector) din rețeaua ta locală către organizația ta. Cum creezi apoi un client găsești la [Crearea unui client dintr-o scanare](#klant-aanmaken-vanuit-een-scan). - O scanare fără client asociat este ștearsă automat de Tillor după 7 zile, împreună cu fișierele aferente. - O scanare asociată rămâne păstrată până când o dezasociezi sau o ștergi tu. Termenul de păstrare îl stabilești tu. - Crearea unui client pe baza unei scanări cere cel puțin un prenume în scanare. - Dacă există deja un client cu același cod numeric personal, asociezi scanarea acelui client în loc să creezi un duplicat. - Fișierele scanării sunt stocate criptat. Pe imaginile paginilor apare un filigran **Not valid as ID**. Portretul rămâne fără filigran. - Conectorul ascultă implicit pe portul 8765. ## Cum se leagă lucrurile? [#hoe-hangt-dit-samen] ```mermaid flowchart LR subgraph lokaal[Rețea locală] R[Cititor de acte] C[Conector Tillor] end T[Scanare în așteptare în Tillor] K[Client sau persoană de contact] R --> C C --> T T -->|Creare sau asociere client| K T -->|Neasociată după 7 zile| X[Ștearsă automat] ``` O scanare începe ca scanare în așteptare. Dacă o asociezi unui client sau unei persoane de contact, rămâne păstrată la acel client. ## Crearea unui client dintr-o scanare [#klant-aanmaken-vanuit-een-scan] Înainte de a începe: - Scanarea trebuie să se afle în Tillor ca scanare în așteptare. Dacă nu se află, vezi Probleme mai jos. - Scanarea are nevoie de un prenume. ### Deschide lista de clienți [#open-de-klantenlijst] Mergi la Clienți > Prezentare generală și apasă **Creați un client nou**. Cât timp există scanări în așteptare, butonul afișează un meniu: alege **Manual** sau o scanare din listă. ### Verifică scanarea [#controleer-de-scan] După ce ai ales o scanare, se deschide o confirmare cu o previzualizare a documentului și datele din zona de citire automată. Apasă **Creați clientul**. Aceeași cale funcționează prin **Începeți rezervarea** (**Client nou…**) și prin panoul din dreapta jos cu **Creați client pe baza scanării**. ### Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Tillor creează clientul, asociază scanarea și completează, unde este posibil, prenumele, numele, data nașterii, adresa și alte câmpuri. - Ajungi pe noul profil de client. - Scanarea nu mai este în coada de așteptare și rămâne păstrată la client. - Asocierea apare în fila **Evenimente** a clientului. ## Asocierea la un client sau o persoană de contact existentă [#koppelen-aan-een-bestaande-klant-of-contactpersoon] Pe lângă un client nou, poți asocia o scanare și unui client sau unei persoane de contact existente. Pe profilul clientului apare un card punctat **Atribuiți o scanare de identitate în așteptare** cât timp există scanări în așteptare potrivite. Alege o scanare cu **Alegeți scanarea…** și apasă **Atribuiți acestui client**. Pe cardul unei persoane de contact poți asocia o scanare care nu are încă un contact și conține cel puțin un prenume, cu **Atribuiți contactului**. Poți pune și să se creeze un contact nou cu **Creați contact din scanare**. După asociere, Tillor completează datele clientului sau ale contactului unde este posibil. Ca prenume, Tillor preia doar prima parte a prenumelui, de exemplu `Andy` din `Andy Adhemar R`. Pe scanare rămân vizibile toate prenumele. ## Dezasocierea, exportul sau ștergerea unei scanări [#een-scan-ontkoppelen-exporteren-of-verwijderen] La o scanare asociată există acțiunile **Descărcați**, **Exportați PDF**, **Dezasociați scanarea** și **Ștergeți scanarea**. Ștergerea elimină definitiv scanarea și toate fișierele criptate și nu poate fi anulată. ## Termen de păstrare și responsabilitatea ta [#bewaartermijn-en-jouw-verantwoordelijkheid] Scanările care nu sunt încă asociate unui client sunt șterse automat de Tillor după 7 zile (scanarea și fișierele aferente). Asociază sau prelucrează la timp scanările în așteptare prin **Creați un client nou**, panoul din dreapta jos sau cardul punctat de pe profilul unui client. Pentru scanările asociate se aplică o altă regulă: acestea rămân păstrate până când organizația ta le dezasociază sau le șterge. Tu stabilești dacă, când și pe ce temei juridic se scanează actele de identitate și cât timp sunt necesare scanările asociate. Tillor prelucrează scanările ca persoană împuternicită, la instrucțiunea ta. Respectarea legislației privind confidențialitatea, termenele de păstrare pentru scanările asociate și ștergerea la timp atunci când stocarea nu mai este necesară sunt responsabilitatea ta, ca operator de date. ## Probleme? [#problemen] Verifică pe cititor adresa IP a conectorului și portul 8765, precum și dacă conectorul rulează. Vezi [Conector](/connector). Doar scanările fără client asociat contează ca fiind în așteptare. Dacă scanarea este deja asociată, sau mai veche de 7 zile și deci ștearsă, nu mai apare. La scanare apare motivul. Dacă scanarea nu are prenume, apare *completează-l pe scaner sau asociază manual această scanare*. Dacă documentul este încă valabil și există deja un client cu acest cod numeric personal, deschide clientul propus în partea de sus a cardului sau asociază scanarea acelui client. Clientul nu a fost creat, iar scanarea rămâne în așteptare. Încearcă din nou. Dacă nu reușește, creează clientul manual și asociază scanarea cu **Atribuiți clientului**. Încearcă din nou sau folosește panoul din dreapta jos. ## Termeni [#begrippen] - **Scanare de identitate**: datele citite și imaginile unui singur act de identitate. - **Scanare în așteptare**: o scanare care nu este încă asociată unui client și dispare după 7 zile. - **Zonă de citire automată (MRZ)**: rândurile cu litere și cifre din partea de jos a documentului pe care le citește cititorul. - **Conector**: cutia din rețeaua ta locală care trimite scanările către Tillor. Vezi [conector](/begrippen#connector). - **Client**: înregistrarea din Tillor. Vezi [client](/begrippen#klant). ## Vezi și [#zie-ook] # Citirea și răspunsul la conversații (/ro-RO/inbox/gesprekken) În inbox se află toate conversațiile canalelor dvs. conectate, într-un singur loc. Aici le citiți, răspundeți și le puneți în ordine. Cum conectați un canal, găsiți la [Inbox](/inbox). Înainte de a începe: - Aveți nevoie de permisiunea **Vizualizați inboxul** pentru a citi conversațiile și de **Gestionați inboxul** pentru a răspunde sau a arhiva. Fără **Vizualizați inboxul**, inboxul nu apare în bara laterală. - Trebuie să fie conectat cel puțin un canal. Altfel veți vedea un link către Setări > Integrări. ## Deschiderea inboxului [#de-inbox-openen] ### Accesați inboxul [#ga-naar-de-inbox] În bara laterală, la **Asistență**, alegeți **Inbox** (marcajul **1** din captura de ecran). Dacă nu este conectat încă niciun canal, Tillor afișează un link către Setări > Integrări. ### Alegeți o conversație [#kies-een-gesprek] În stânga se află lista **Conversații**, cu firele de discuție din toate canalele. Cu **Deschise** și **Arhivate** treceți între conversațiile active și cele rezolvate. Faceți clic pe o conversație pentru a o deschide în dreapta. O conversație deschisă afișează mesajele în ordine, cu nume și oră. Jos se află câmpul de răspuns (marcajul **2** din exemplu). Fundalul unei conversații urmează canalul: bej pentru WhatsApp, baloane albastre pentru Messenger, roz pentru Instagram și gri deschis pentru chatul de pe website. ## Trimiterea unui răspuns [#een-antwoord-sturen] ### Deschideți conversația [#open-het-gesprek] Faceți clic pe conversație în listă. ### Scrieți răspunsul [#typ-je-antwoord] Scrieți în câmpul de răspuns de jos. ### Trimiteți [#verstuur] Faceți clic pe **Trimiteți** sau apăsați **Ctrl+Enter**. La mesajele dvs., lângă oră apare o bifă pentru trimis, o bifă dublă pentru livrat și o bifă dublă albastră pentru citit. Răspunsurile pe care le trimiteți din aplicația WhatsApp Business sau din aplicația Messenger apar de asemenea în conversație, atât timp cât integrarea este activă. Un mesaj pe care l-ați trimis nu poate fi editat. Canalele nu oferă această posibilitate. La Messenger și Instagram, lângă un mesaj text propriu există un buton de ștergere. Acesta ascunde mesajul doar în Tillor; clientul păstrează mesajul în propria aplicație. Fotografiile primite pe Messenger sunt salvate și afișate în conversație; în listă apare atunci o pictogramă de fotografie în loc de text. Reacțiile cu emoji la mesajele Messenger apar ca numărătoare sub mesaj. ### WhatsApp și fereastra de răspuns de 24 de ore [#whatsapp-en-het-antwoordvenster-van-24-uur] Un client care vă trimite un mesaj pe WhatsApp deschide o fereastră de răspuns gratuită de 24 de ore. Tillor afișează **Fereastra de răspuns gratuită este deschisă** cu o numărătoare inversă. Dacă fereastra este închisă, apare **Fereastra de 24 de ore este închisă** și răspunsul dvs. pleacă drept șablon WhatsApp cu plată, până când clientul scrie din nou. - Dacă pentru contul dvs. WhatsApp Business nu este adăugată o metodă de plată în Meta WhatsApp Manager, Tillor blochează răspunsurile cu plată. Răspunsurile gratuite din interiorul ferestrei rămân posibile. - Dacă Meta nu a aprobat încă șablonul în limba organizației dvs., răspunsul dvs. așteaptă. Aceasta durează de obicei câteva minute și poate dura până la 48 de ore. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Răspunsul dvs. apare în conversație cu o bifă: trimis, livrat sau citit. Dacă livrarea eșuează, apare **Nelivrat**. - O conversație arhivată dispare din **Deschise**. Dacă clientul scrie din nou, conversația reapare. - Conversația apare și la client, la Clienți > client > Comunicare. ## Găsirea și punerea în ordine a conversațiilor [#gesprekken-terugvinden-en-opruimen] - **Căutare**: filtrați firele de discuție după nume sau număr de telefon, în **Deschise** sau **Arhivate**. - **Necitite**: în **Deschise**, conversațiile necitite apar îngroșate, cu un punct roșu. Faceți clic pe **Marcați totul ca citit** în partea de sus a listei pentru a marca totul ca citit dintr-o dată. - **Arhivare**: faceți clic pe **Arhivați** la o conversație rezolvată din **Deschise**. - **Restaurare**: deschideți o conversație din **Arhivate** și faceți clic pe **Restaurați** pentru a o repune în listă și a putea răspunde din nou. - **Meniu contextual**: faceți clic dreapta sau apăsați lung pe o conversație pentru **Marcați ca citit**, **Marcați ca necitit**, **Fixați conversația** sau **Anulați fixarea conversației**, **Arhivați** și **Restaurați**. Numărul de lângă **Inbox** în bara laterală reprezintă conversațiile deschise al căror ultim mesaj este de la client și care așteaptă încă un răspuns. Mesajele noi apar în direct; numărul se actualizează singur. ## Etichete [#tags] Cu etichetele marcați conversațiile pentru întreaga echipă. 1. Deschideți o conversație și folosiți, în panoul lateral, blocul **Etichete**. 2. Creați o etichetă cu **Etichetă nouă** sau alegeți una existentă. Din meniul etichetelor le editați sau le ștergeți. 3. Filtrați lista cu pictograma de etichetă de lângă filtrul de platformă. Etichetele cu **AI poate aplica** pot fi adăugate de Tillie după un răspuns automat. Etichetele pe care echipa dvs. le-a pus deja rămân. ## Notificări [#meldingen] Utilizatorii cu **Notificări de mesaje din inbox** primesc o notificare push la fiecare mesaj nou de la un client. Răspunsurile dvs. nu generează notificare. Cu **Vizualizați inboxul** vedeți la un mesaj nou și o notificare în dreapta jos, în același dock cu scanările de identitate în așteptare și apelurile telefonice active. Acolo apar expeditorul, canalul și un fragment din text. Faceți clic pe ea pentru a deschide conversația. Notificarea dispare după aproximativ zece secunde, dacă nu țineți cursorul deasupra ei. Dacă conversația este deja deschisă, nu apare nicio notificare. ## Conversații și clienți [#gesprekken-en-klanten] Tillor asociază o conversație cu un client, acolo unde este posibil: - WhatsApp după numărul de telefon. - Messenger după un nume care se potrivește sau după un număr de telefon ori o adresă de e-mail pe care clientul le împărtășește singur în conversație. - Instagram după un nume sau un nume de utilizator `@` care se potrivește. Meta nu transmite prin Messenger și Instagram nicio adresă de e-mail sau număr de telefon. Conversațiile deschise ale unui client apar și la Clienți > client > Comunicare. Panoul lateral din dreapta arată, pentru fiecare canal, datele participantului, cum ar fi numărul WhatsApp, numele de utilizator Instagram cu link către profil sau pagina de pe care scrie vizitatorul la chatul de pe website. Cu pictograma de panou de deasupra conversației ascundeți sau afișați panoul. ## Probleme? [#problemen] Aveți nevoie de permisiunea **Vizualizați inboxul**. Cereți unui administrator să o acorde la Setări > Utilizatori, cu **Editați permisiunile** la numele dvs. Pentru răspunsuri aveți nevoie de **Gestionați inboxul**. Nici într-o conversație arhivată nu puteți răspunde: faceți mai întâi clic pe **Restaurați**. Verificați dacă conversația este deschisă și dacă aveți **Gestionați inboxul**. La WhatsApp, cauza poate fi și fereastra de răspuns închisă, vezi mai sus. Încercați apoi din nou. Canalul nu a putut livra mesajul. La WhatsApp, cauza este de obicei fereastra de 24 de ore închisă sau lipsa unei metode de plată la Meta. Nu este încă conectat niciun canal sau nu a sosit încă niciun mesaj. Conectați un canal la Setări > Integrări. Tillor ajustează automat conversația atunci când un client editează sau retrage un mesaj pe Messenger sau Instagram, ori îl editează pe WhatsApp (în 15 minute). ## Vezi și [#zie-ook] # Asistentul IA al inboxului (Tillie) (/ro-RO/inbox/inbox-ai-assistant) **Tillie** este numele implicit al asistentului AI din [inboxul Tillor](/inbox). Ea răspunde la întrebările frecvente, adună datele pentru cereri de rezervare sau de vânzare și predă conversația echipei dvs. atunci când este nevoie de un coleg. Tillie funcționează pe **toate canalele inboxului**: [chatul de pe website](/inbox/website-chat), [WhatsApp Business](/inbox/whatsapp-business-inbox), [Messenger](/inbox/messenger) și [Instagram Direct](/inbox/instagram). Instalați **Asistentul IA al inboxului** separat la **Setări > Integrări**. Asistentul aparține inboxului, nu doar widgetului de pe website. ## Instalarea integrării [#integratie-installeren] 1. Mergeți la **Setări > Integrări** (bara laterală, la **Asistență**) 2. Deschideți **Asistentul IA al inboxului** în listă 3. Faceți clic pe **Instalați** 4. La **Setări** stabiliți ce are voie să facă Tillie (vezi câmpurile de mai jos) | Câmp | Ce face? | |------|----------| | **IA inbox activată** | Comutatorul principal pentru toate funcțiile IA din inbox. Dezactivați-l pentru a opri fără a dezinstala | | **Trimite răspunsuri automate** | Dezactivat: Tillie nu trimite mesaje vizitatorilor. Traducerile, detectarea limbii și ciornele de răspuns pentru echipă pot rămâne activate separat | | **Activează automat IA pentru conversații noi** | Se aplică doar dacă răspunsurile automate sunt activate. Dezactivat: fiecare conversație nouă începe fără IA; o activați pentru fiecare conversație din bara laterală. Activat: conversațiile noi din inbox, pe toate canalele, primesc imediat IA (cu o pauză de 30 de minute după un mesaj al echipei) | | **Generează ciorne pentru echipă** | Le permite colegilor să genereze o ciornă AI în câmpul de redactare. Ciorna nu este niciodată trimisă automat | | **Traduce mesajele** | Traduce mesajele primite în limba organizației și răspunsurile echipei în limba contactului. Răspunsurile echipei primesc și punctuație corectă, majuscule și prescurtări de chat scrise complet (chiar și atunci când nu este nevoie de traducere) | | **Detectează limba contactului** | Folosește AI pentru a recunoaște limba vizitatorului dacă aceasta nu este încă cunoscută și o salvează în conversație | | **Numele asistentului AI** | Numele din răspunsuri și prompturi (implicit **Tillie**) | | **Servere MCP (JSON)** | Opțional. Conexiuni MCP doar-citire (URL și anteturi) | | **Instrumente MCP** | După salvare: **Încărcați instrumentele**, listați instrumentele doar-citire și activați sau dezactivați fiecare instrument | Activați **IA inbox activată**, **Traduce mesajele** (și eventual **Detectează limba contactului**) și dezactivați **Trimite răspunsuri automate**. Tillie traduce atunci, dar nu trimite nimic vizitatorilor. ### Instrumente MCP (opțional) [#mcp-tools-optioneel] Dacă parcul dvs. are un server MCP cu conexiuni doar-citire, Tillor poate prelua **date live despre parc** în timpul unei conversații. De exemplu activități, rulote de vânzare sau alte date pe care le oferă serverul dvs. Tillor **nu are o listă fixă de nume de instrumente**. Ce instrumente există vedeți după **Încărcați instrumentele** în setările integrării. Puteți activa doar instrumentele pe care serverul dvs. MCP le marchează ca doar-citire. 1. Completați **Servere MCP (JSON)** (URL și anteturi). 2. Salvați și faceți clic pe **Încărcați instrumentele**. 3. Activați instrumentele care se potrivesc parcului dvs. În funcție de configurarea AI a mediului dvs., Tillie alege singură ce instrument activat se potrivește, pe baza descrierii instrumentului de pe serverul dvs. Ea nu apelează niciodată instrumente pe care nu le-ați activat. Rezultatele din MCP ajung în răspunsul lui Tillie. Ele nu înlocuiesc baza de cunoștințe: prețuri, disponibilitate și reguli nu inventează nici acum, dacă nu au nicio sursă. Tillie folosește un model AI pe care Tillor îl configurează pentru mediul dvs. Dacă asistentul nu răspunde, contactați suportul Tillor. ## Ce face Tillie după un mesaj al vizitatorului [#wat-tillie-doet-na-een-bezoekersbericht] După fiecare mesaj nou primit într-o conversație în care IA este activă: 1. Tillor afișează un **indicator de scriere** pe canal în timp ce se generează răspunsul 2. Tillor stabilește intenția: **rezervare**, **vânzare** sau **altele** (organizațiile cu flux pentru rulote de închiriat au și **rulotă de închiriat**) 3. Tillie răspunde în limba vizitatorului; apoi indicatorul de scriere dispare Tillie decide singură, pe baza instrucțiunilor ei, când răspunde și când tace. La o salutare de deschidere („bună", „hei", „salut") răspunde cu un scurt bun venit și cu întrebarea cu ce poate ajuta. După o mulțumire de încheiere, nu mai reacționează la un scurt „mulțumesc", „ok" sau „nu" din partea vizitatorului, astfel încât să nu apară o buclă de mulțumiri. | Intenție | Comportament | |----------|--------------| | **Rezervare** | Cere datele lipsă: sosire, plecare, tip (cort, mobilhome, rulotă de turism), câini da/nu (și câți), număr de persoane, copii și vârste, apoi nume, e-mail și număr de telefon, și opțional numărul de înmatriculare pentru check-in (se poate omite). Datele pe care Tillor le cunoaște deja (de ex. din widgetul de pe website sau din WhatsApp) sunt completate; se cer doar câmpurile lipsă. La o zi a săptămânii („luni"), Tillie pune mai întâi o întrebare de confirmare („Vă referiți la …?") înainte de a continua. Fiecare răspuns se încheie cu o singură întrebare. Răspunde la scurte întrebări de politică din baza de cunoștințe (de ex. modificarea ulterioară a rezervării) și apoi continuă cu colectarea. Dacă totul este complet, Tillie rezumă **cererea** și predă conversația unui coleg - nu există încă o rezervare definitivă | | **Rulotă de închiriat** | Adună numele, e-mailul, adresa, țara și motivul șederii (la cerere), apoi predă echipei dvs. | | **Vânzare** | Explică faptul că vizitatorul trebuie să treacă pe la birou pentru o vizionare sau o achiziție și transmite acest lucru echipei dvs. | | **Altele** | Răspunde doar dacă răspunsul se află în baza de cunoștințe. Altfel Tillie spune sincer că nu știe, se oferă să transmită întrebarea unui coleg și predă conversația | Tillie **nu inventează prețuri, disponibilitate sau reguli**. Doar ceea ce se află în baza de cunoștințe poate fi spus ca fapt. ### Formular de rezervare pe website-ul dvs. [#boekingsformulier-op-je-website] Conectați un formular propriu la [chatul de pe website](/inbox/website-chat)? Atunci îl puteți lăsa pe Tillie doar să confirme și să predea imediat, fără întrebări de preluare. Aceasta se potrivește unui formular după care fila se închide. Vezi [API-ul chatului de website - metadate](/ontwikkelaars/website-chat#metadata-boekingsformulier). ## Pentru fiecare conversație: Automat, Activat sau Dezactivat [#per-gesprek-automatisch-aan-of-uit] În detaliile conversației din bara laterală alegeți pentru fiecare fir de discuție: | Mod | Comportament | |-----|--------------| | **Automat** | Tillie răspunde, dar face o pauză de **30 de minute** după fiecare mesaj al echipei dvs. | | **Activat** | Tillie răspunde întotdeauna, chiar și imediat după un mesaj al echipei | | **Dezactivat** | Tillie nu răspunde la această conversație | În timpul pauzei vedeți o numărătoare inversă în bara laterală. ## Etichete după un răspuns AI [#tags-na-een-ai-antwoord] În panoul lateral puteți crea și atribui **etichete** la nivel de organizație (permisiunea **Gestionați inboxul**). Folosiți **Etichetă nouă** pentru a crea o etichetă. Deschideți meniul etichetelor la o conversație pentru a atribui etichete; editarea și ștergerea fiecărei etichete se află în același meniu. Bifați **AI poate aplica** dacă Tillie are voie să adauge acea etichetă după un răspuns automat. Tillie alege atunci singură zero sau mai multe dintre aceste etichete pe baza conversației; etichetele pe care echipa dvs. le-a pus deja rămân. Etichete tipice sunt, de exemplu, **Vânzare**, **Rezervare** și **Urgent**. Tillie recunoaște aceste nume și le leagă de ceea ce a stabilit deja în conversație: | Intenția lui Tillie | Se potrivește cu nume de etichete precum | |---|---| | Vânzare | Verkoop, Sale | | Rezervare | Boeking, Reservatie, Booking | | Rulotă de închiriat | Caravan, Verhuur | | Predare urgentă | Urgent, Spoed, Dringend | Numele etichetei nu trebuie să se potrivească exact: **Boeking aanvragen** contează de asemenea ca etichetă de rezervare. Intră în discuție doar etichetele cu **AI poate aplica**. ## Limbă, ton și date de contact [#taal-toon-en-contactgegevens] Răspunsurile urmează limba vizitatorului - nu doar cele patru limbi ale widgetului (`en`, `nl`, `de`, `fr`), ci orice limbă în care Tillie poate răspunde (de ex. spaniolă, poloneză, turcă). Dacă cineva cere explicit o altă limbă, Tillie trece la ea și salvează limba aleasă în conversație. **Rezumatele de predare** (vizibile doar echipei dvs.) urmează întotdeauna **limba organizației** din Tillor, pentru fiecare predare (rezervare, rulotă de închiriat, vânzare, întrebare deschisă, cerere explicită de a vorbi cu un coleg), indiferent de limba conversației. Tillie primește această limbă a organizației în fiecare prompt. Mesajele către vizitatori (AI și echipă) sunt întotdeauna **text simplu**, fără markdown, deoarece WhatsApp, Instagram, Messenger și widgetul nu îl acceptă. Pe WhatsApp, Tillie poate pune sub un răspuns scurt până la trei butoane de răspuns, atunci când o atingere este o alegere pe care mesajul însuși o menționează deja. Mesajul rămâne lizibil dacă clientul scrie în loc să atingă. În afara ferestrei de 24 de ore, răspunsul pleacă drept șablon fără butoane. Tillie rămâne calmă și profesionistă, nu vorbește despre concurenți și nu ignoră regulile de siguranță dacă un vizitator cere să ignore instrucțiunile. Datele de contact pentru redirecționare provin din **profilul organizației dvs. Tillor** (nume, adresă, telefon, e-mail, website). **Programul biroului** îl stabiliți la **Setări > Program de funcționare** (program săptămânal, perioade de sezon, sărbători legale și excepții); Tillie folosește acest program pentru a spune când poate răspunde un coleg. Păstrați aceste câmpuri la zi. Cu aproximativ o săptămână înainte de o sărbătoare legală, Tillor reamintește prin e-mail adresei de suport dacă programul pentru acea zi nu a fost încă completat. ## Evenimente în conversație (doar pentru echipa dvs.) [#gebeurtenissen-in-het-gesprek-alleen-voor-je-team] În timpul preluării unei rezervări, Tillie actualizează numele, e-mailul și telefonul de îndată ce vizitatorul le comunică. În inbox apare atunci un eveniment **Date actualizate de AI** (de la → la), vizibil doar echipei dvs. La predare apare un eveniment **Predare AI**: un card vizibil cu un rezumat (tabel pentru datele de rezervare sau de rulotă de închiriat, plus note pentru întrebări deschise). Rezumatul este întotdeauna în **limba organizației dvs.** (nl, en, de sau fr), chiar dacă vizitatorul scrie în altă limbă. Vizitatorul nu vede acest card. ## Baza de cunoștințe: faptele pe care Tillie le poate folosi [#kennisbank-feiten-die-tillie-mag-gebruiken] Tillie răspunde la întrebări pe baza unei **baze de cunoștințe**: articole scurte cu fapte verificate despre parcul dvs., de exemplu program de funcționare, reguli pentru animale de companie, piscina, stațiile de încărcare sau cum se modifică ulterior o rezervare. Unele articole se aplică tuturor organizațiilor Tillor, altele sunt specifice parcului dvs. Într-o conversație, Tillie folosește doar articolele generale plus articolele adăugate pentru organizația dvs. Doriți să adăugați, să modificați sau să ștergeți subiecte? Transmiteți aceasta suportului Tillor. Noi completăm și întreținem baza de cunoștințe împreună cu dvs., adaptată la ceea ce recepția dvs. vrea să poată răspunde. ## Fluxuri de conversație: scenariul pentru fiecare intenție [#gespreksflows-draaiboek-per-bedoeling] Pe lângă baza de cunoștințe, Tillie urmează **fluxuri de conversație**: reguli despre ce date cere, în ce ordine și când predă conversația echipei dvs. Fiecare intenție (rezervare, rulotă de închiriat, vânzare, altele - vezi tabelul de mai sus) are un astfel de flux. Fluxurile sunt configurate implicit, dar Tillor le adaptează împreună cu dvs. la parcul dvs. Doriți, de exemplu, să se ceară alte date la o cerere de rezervare sau ca Tillie să predea mai repede? Transmiteți aceasta suportului Tillor. Verificați răspunsurile AI din inbox înainte de a le încredința vizitatorilor. Rezervarea prin chat rămâne o **cerere** - nu o rezervare definitivă. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - O conversație pe care Tillie o predă apare în inbox cu un bloc **Tillie a predat această conversație echipei dvs.** și cu datele adunate. - Echipa dvs. primește o notificare. La o predare urgentă, aceasta se face prin notificarea **Predare urgentă AI**. Vezi [Tipuri de notificări](/communicatie/notificatietypes). - Dacă un coleg răspunde, Tillie face o pauză de 30 de minute în modul **Automat**. ## Probleme? [#problemen] Verificați dacă **IA inbox activată** și **Trimite răspunsuri automate** sunt activate la Setări > Integrări > Asistentul IA al inboxului. Apoi uitați-vă în bara laterală a conversației dacă modul nu este pe **Dezactivat** sau dacă rulează o numărătoare inversă după un mesaj al echipei dvs. **Activează automat IA pentru conversații noi** este dezactivat. Activați comutatorul sau alegeți **Activat** pentru fiecare conversație. Tillie folosește doar ceea ce se află în baza de cunoștințe și nu inventează prețuri, disponibilitate sau reguli. Completați baza de cunoștințe. ## Conexe [#gerelateerd] # Prezentare generală (/ro-RO/inbox) În inbox citiți și răspundeți la mesajele clienților și ale vizitatorilor care sosesc prin WhatsApp, Messenger, Instagram sau chatul de pe website, toate într-un singur loc. Îl găsiți în bara laterală la **Asistență > Inbox**. Mai întâi conectați canalele pe care doriți să le folosiți, apoi lucrați zilnic în [Citirea și răspunsul la conversații](/inbox/gesprekken). Inboxul este destinat comunicării în ambele sensuri cu clienții. Notificările automate WhatsApp, de exemplu la un sold NFC scăzut, trec prin Twilio și nu prin aceste integrări. - Un mesaj nou apare ca un card în dreapta jos și dispare după aproximativ zece secunde. Numărul de lângă **Inbox** reprezintă conversațiile deschise care așteaptă un răspuns - Asistentul AI Tillie face o pauză de 30 de minute după ce un coleg a răspuns - Un mesaj de chat pe website poate conține cel mult 4096 de caractere, fără imagini sau fișiere - Un client poate edita un mesaj WhatsApp până la 15 minute după trimitere, iar dvs. vedeți aceasta în conversație - Memento-ul prin e-mail către un vizitator al website-ului pleacă după aproximativ 5 minute de inactivitate. Linkul funcționează 30 de zile - Un mesaj propriu pe care îl ștergeți în Tillor (Messenger și Instagram) dispare doar în Tillor, nu și la client ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Fiecare canal se instalează separat. Toate conversațiile ajung apoi în aceeași listă, iar Tillor le asociază cu un client acolo unde este posibil. ```mermaid flowchart LR W[WhatsApp] --> I[Inbox] M[Messenger] --> I G[Instagram] --> I C[Chat pe website-ul dvs.] --> I I --> K[Client asociat prin număr de telefon sau nume] I --> A[Tillie răspunde sau predă] A --> T[Echipa dvs.] I --> T T -->|răspuns| W T -->|răspuns| M T -->|răspuns| G T -->|răspuns| C ``` - Echipa dvs. răspunde în Tillor. Răspunsul ajunge înapoi la client prin același canal. - Tillie, asistentul AI, poate răspunde și poate preda o conversație echipei dvs. Dvs. stabiliți aceasta pentru fiecare conversație. - Răspunsurile pe care le trimiteți în afara Tillor, de exemplu în aplicația WhatsApp Business, apar de asemenea în conversație. ## Conectarea canalelor [#kanalen-koppelen] Instalați câte o integrare pentru fiecare canal la Setări > Integrări. La Messenger, Tillor preia la conectare conversațiile existente ale paginii. Dacă Messenger este deja conectat, puteți porni această sincronizare și manual din inbox. ## Munca de zi cu zi [#dagelijks-werken] ## Permisiuni [#rechten] | Permisiune | Ce poate face utilizatorul? | |-----------|------------------------| | **Vizualizați inboxul** | Poate deschide inboxul și citi conversațiile | | **Gestionați inboxul** | Poate trimite răspunsuri, arhiva, restaura și fixa conversații, le poate marca drept necitite și își poate șterge propriile mesaje în Tillor (Messenger și Instagram) | | **Notificări de mesaje din inbox** | Primește notificări push la mesaje noi de la clienți | Setați permisiunile la Setări > Utilizatori. ## Termeni [#begrippen] - **Conversație sau fir de discuție**: toate mesajele cu un client sau vizitator pe un singur canal. - **Deschise și Arhivate**: cele două file ale listei de conversații. Arhivarea scoate o conversație din **Deschise**, restaurarea o repune. - **Tillie**: numele implicit al asistentului AI din inbox. Puteți modifica numele. Mai mulți termeni găsiți în [glosar](/begrippen). # Instagram (/ro-RO/inbox/instagram) Cu **Instagram** primiți mesajele Instagram Direct în [inboxul Tillor](/inbox). Integrarea folosește o **pagină Facebook** conectată, cu un **cont Instagram Professional** în Meta Business Suite. Înainte de a începe: - Aveți nevoie de permisiunea **Gestionați integrările**. - Contul dvs. Instagram este un cont Professional (Business sau Creator), conectat la o pagină Facebook. ## Instalarea integrării [#integratie-installeren] 1. Mergeți la **Setări** (bara laterală, la **Asistență**) 2. Alegeți **Integrări** și deschideți **Instagram** în listă (marcajul **2**) 3. Faceți clic pe **Instalați** (marcajul **1**) și parcurgeți fluxul Meta OAuth (permisiuni de mesagerie Instagram) 4. Alegeți **pagina Facebook** care este conectată la contul dvs. Instagram Professional 5. Verificați câmpul cu **numele de utilizator Instagram** de sub alegerea paginii (Tillor afișează contul conectat, de exemplu `@uwaccount`) 6. Salvați setările Fără un cont Instagram Professional conectat la pagina selectată, Tillor nu poate finaliza integrarea. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - După instalare, mesajele Instagram Direct primite ajung automat în [inbox](/inbox). - Răspunsurile trimise prin aplicația Instagram apar și ele în inbox. Mesajele pe care le trimiteți prin Tillor nu sunt afișate de două ori. - Dacă totuși nu sosesc mesaje, contactați suportul Tillor. Conexiunea Instagram cu Meta trebuie să fie configurată pentru întreaga platformă. - Messenger și Instagram sunt integrări separate. Dacă vreți ambele canale în inbox, instalați-le pe amândouă. ## Probleme? [#problemen] ### Conectarea eșuează sau nu există Instagram pe pagină [#koppelen-mislukt-of-geen-instagram-op-de-pagina] Dacă instalarea se oprește cu *De app kon niet worden gekoppeld* sau *Geen Instagram Professional account*, verificați în Meta: 1. **Instagram Professional** - contul dvs. Instagram trebuie să fie Business sau Creator (nu cont personal). 2. **Conectarea paginii** - în [Meta Business Suite](https://business.facebook.com/) sau în Business Settings: conectați contul Instagram la **pagina Facebook** cu care vă autentificați. 3. **Acces la mesaje** - în aplicația Instagram: **Setări** > **Mesaje și răspunsuri la story-uri** > **Instrumente conectate** > permiteți accesul la mesaje (necesar pentru Direct în aplicațiile de inbox). 4. **Autentificare Meta corectă** - folosiți un cont care este **administrator** al paginii Facebook, cu permisiuni de mesagerie. La instalare, Tillor caută toate paginile Facebook de pe contul dvs. și o alege pe prima care are un cont Instagram Professional conectat. Dacă aveți mai multe pagini, după instalare puteți alege o altă pagină în setările integrării. La instalare, Tillor cere întotdeauna permisiunile `instagram_basic`, `instagram_manage_messages` și `pages_read_engagement`. Setați-le mai întâi pe **Ready for testing** la **Use cases** (Messenger/Instagram) în Meta Developer Console. **Invalid Scopes** înseamnă că ele nu sunt încă pe aplicația Meta. Permisiunile `instagram_business_*` aparțin unei alte metode de autentificare și nu sunt pentru Tillor. ## Conexe [#gerelateerd] # Messenger (/ro-RO/inbox/messenger) Cu **Messenger** primiți în [inboxul Tillor](/inbox) mesajele clienților printr-o pagină Facebook conectată. Înainte de a începe: - Aveți nevoie de permisiunea **Gestionați integrările**. - Vă autentificați la Meta cu un cont care este administrator al paginii Facebook. ## Instalarea integrării [#integratie-installeren] 1. Mergeți la **Setări** (bara laterală, la **Asistență**) 2. Alegeți **Integrări** și deschideți **Messenger** în listă (marcajul **2**) 3. Faceți clic pe **Instalați** (marcajul **1**) și parcurgeți fluxul Meta OAuth 4. Pe pagina de detalii alegeți ce **pagină Facebook** primește mesajele Messenger 5. Salvați setările Tillor afișează pagina conectată la **Setări**, pe pagina de detalii. După instalare, Tillor primește automat mesajele Messenger. Răspunsurile pe care le trimiteți și prin aplicația Messenger apar în inbox. Mesajele pe care le trimiteți prin Tillor nu sunt afișate de două ori. Pentru **Instagram Direct** instalați integrarea separată [Instagram](/inbox/instagram). ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Tillor preia conversațiile existente ale paginii. Puteți porni această sincronizare și ulterior, singur, din inbox. - Mesajele noi ajung automat în [inbox](/inbox). Tillor le asociază cu un client cu același nume sau după un număr de telefon ori o adresă de e-mail pe care clientul le împărtășește în conversație. ## Probleme? [#problemen] Verificați la Setări > Integrări > Messenger dacă este aleasă **pagina Facebook** corectă și dacă setările au fost salvate. Meta nu transmite prin Messenger nicio adresă de e-mail sau număr de telefon. Tillor asociază doar după un nume care se potrivește sau după datele pe care clientul le împărtășește singur. ## Conexe [#gerelateerd] # Conversații prin chatul de pe website (/ro-RO/inbox/website-chat-gesprekken) O conversație apare în inbox de îndată ce vizitatorul își trimite primul mesaj, cu canalul **Chat pe website**. Cum reacționați găsiți la [Citirea și răspunsul la conversații](/inbox/gesprekken). Această pagină explică ce se vede în plus la chatul de pe website. În panoul lateral din dreapta se află un buton **Deschideți pe website** cu pagina în care vizitatorul a fost activ ultima dată, plus datele vizitatorului și ale sesiunii. Câmpurile suplimentare din formularul vizitatorului apar și ele acolo. ## Cine este vizitatorul? [#wie-is-de-bezoeker] - Tillor recunoaște un vizitator după browserul său. Același browser, pe același dispozitiv, deschide deci aceeași conversație. - Numele, e-mailul și telefonul din formularul vizitatorului sunt păstrate în acel browser după primul mesaj. Dacă vizitatorul revine mai târziu, nu trebuie să completeze nimic din nou. - Dacă acea stocare este goală, de exemplu într-un alt browser sau după o curățare, widgetul completează datele din conversația existentă. - Mesajele sunt text de până la 4096 de caractere. Imaginile și fișierele nu sunt acceptate. ## Scriere și prezență [#typen-en-aanwezigheid] | Ce | Cine vede | Unde | |-----|--------------|------| | **Se scrie…** în timp ce vizitatorul scrie | Echipa dvs. | Sub conversație în inbox, chiar și înainte de primul mesaj | | **Se scrie…** în timp ce un coleg scrie | Vizitatorul | În widget | | **Online** (punct verde) sau **Văzut ultima dată** cu o oră | Echipa dvs. | Deasupra conversației | Vizitatorul contează ca online atât timp cât fila este vizibilă. Widgetul transmite un semn de viață aproximativ la fiecare 20 de secunde. Preluarea mesajelor, scrierea și citirea contează și ele ca activitate. ## Bife [#vinkjes] Vizitatorii văd bife la propriile mesaje: | Bife | Semnificație | |---------|-----------| | Una | Trimis | | Două gri | Echipa dvs. a deschis conversația și a încărcat mesajele | | Două albastre | Echipa dvs. a marcat conversația ca citită | În inbox vedeți bife la propriile răspunsuri: | Bife | Semnificație | |---------|-----------| | Una | Trimis | | Două gri | Vizitatorul este pe pagină și a preluat mesajele, chiar și cu chatul închis | | Două albastre | Vizitatorul are fereastra de chat deschisă | Răspunsurile din inbox apar automat în widget, chiar dacă vizitatorul deschide fereastra mai târziu. ## Activitatea vizitatorului în conversație [#bezoekersactiviteit-in-het-gesprek] După primul mesaj, echipa dvs. vede în conversație text informativ gri. Vizitatorul nu îl vede. Aceste rânduri nu măresc niciun contor de necitite și nu generează notificări push. | Eveniment | Text în inbox | |-------------|-------------------| | Chat închis | Utilizatorul a închis chatul | | Altă filă sau fereastră minimizată | Utilizatorul a schimbat fila sau a minimizat browserul | | Altă pagină deschisă | Utilizatorul a navigat la URL-ul paginii | Navigarea este observată și pe site-urile care schimbă intern pagina fără reîncărcare. Widgetul transmite pagina curentă aproximativ la fiecare 20 de secunde, astfel încât panoul lateral afișează ultima pagină activă. ## Tillie în chatul de pe website [#tillie-op-website-chat] Tillie, asistentul AI, funcționează și în widget. Instalați pentru aceasta separat **Asistentul IA al inboxului**. Instalarea, baza de cunoștințe și comportamentul se găsesc la [Asistentul IA al inboxului (Tillie)](/inbox/inbox-ai-assistant). Mesajele lui Tillie primesc în widget un robot în loc de sigla organizației. De îndată ce vizitatorul scrie, echipa dvs. poate vedea **Se scrie…**. Primul mesaj pleacă abia la **Trimiteți**, împreună cu datele de contact completate. ## Vezi și [#zie-ook] # Setările chatului de pe website (/ro-RO/inbox/website-chat-instellingen) Setările se află la Setări > Integrări > Chat de website. Instalarea și plasarea fragmentului de cod sunt descrise în [Punerea chatului pe website-ul dvs.](/inbox/website-chat). ## Widget [#widget] | Câmp | Ce face? | |------|----------| | **Widget activat** | Ascunde chatul peste tot fără a elimina integrarea. Implicit activat | | **Afișați pe paginile publice Tillor** | Afișează butonul de chat pe paginile publice Tillor, precum permisul de acces, factura restantă și harta publică. Propriul site folosește fragmentul de cod. Implicit activat | | **Mesaj de bun venit** | Text în antetul chatului și înainte de primul mesaj al vizitatorului. Cel mult 500 de caractere. Lăsat gol, se folosește un text implicit în limba widgetului | | **Tooltip lansator** | Etichetă pentru butonul plutitor, destinată cititoarelor de ecran. Cel mult 80 de caractere | | **Mesaj de răspuns în curând** | Rândul de sub numele organizației în antetul chatului, de exemplu „De obicei răspundem rapid" | | **Pictogramă lansator** | Pictograma de pe butonul de chat: **Balon de vorbire**, **Chat rotunjit**, **Semn de întrebare**, **Căutare** sau **Persoană** | | **Culoare de accent** | Culoarea butonului de chat și a mesajelor vizitatorului. Alegeți o culoare sau introduceți o valoare hex, de exemplu `#2563eb` | | **Domenii permise** | Nume de gazdă separate prin virgulă care au voie să încarce chatul. Gol înseamnă: orice domeniu | | **Trimiteți e-mail vizitatorilor despre răspunsurile necitite** | Vezi [mai jos](#herinnering-per-e-mail). Implicit activat | Antetul chatului afișează automat sigla organizației dvs. Mesajele asistentului AI primesc un robot în loc de acea siglă. Niciuna dintre ele nu se poate seta la Chat de website. Dacă nu setați **Mesaj de bun venit**, **Tooltip lansator** sau **Mesaj de răspuns în curând**, widgetul folosește un text implicit în propria limbă. Această limbă o setați pe fragmentul de cod cu `data-locale` (vezi [Opțiuni pe fragmentul de cod](#opties-op-het-snippet)). ## Formularul vizitatorului [#bezoekersformulier] Aici stabiliți ce completează un vizitator înainte de primul mesaj. Dacă există câmpuri obligatorii, acestea apar împreună cu câmpul de mesaj pe un singur ecran. Vizitatorul completează totul și face clic pe **Trimite**, fără un pas intermediar separat. ### Câmpuri standard [#standaardvelden] | Câmp | Ce face? | |------|----------| | **Nume obligatoriu** | Vizitatorii își completează numele. Numele este păstrat la conversație | | **E-mail obligatoriu** | Vizitatorii își completează adresa de e-mail. Adresa este păstrată la conversație | | **Telefon obligatoriu** | Vizitatorii completează un număr de telefon. Tillor îl convertește într-un format fix și îl folosește pentru a asocia conversația cu apeluri și clienți | Fiecare câmp se activează sau se dezactivează separat. Dacă este activat doar telefonul, vizitatorul vede doar câmpul de telefon. ### Câmpuri suplimentare [#extra-velden] Faceți clic pe **Adăugați câmp** pentru întrebări proprii. Puteți adăuga cel mult 8 câmpuri suplimentare. Ștergeți un câmp cu **Eliminați câmpul**. | Opțiune | Explicație | |-------|--------| | **Etichetă câmp** | Ce vede vizitatorul în widget. Cel mult 80 de caractere | | **Cheie câmp** | Numele intern al câmpului. Începeți cu o literă mică și folosiți doar litere mici, cifre și `_` (cel mult 32 de caractere) | | **Tip câmp** | **Text** sau **E-mail** | | **Obligatoriu** | Vizitatorul trebuie să completeze câmpul înainte de a putea conversa. Un câmp nou este implicit obligatoriu | | **Text substituent** | Indiciu în câmpul de introducere. Cel mult 120 de caractere | Răspunsurile la câmpurile suplimentare apar în inbox la conversație, lângă canal și ID-ul vizitatorului. ## Memento prin e-mail [#herinnering-per-e-mail] Vizitatorii închid adesea pagina înainte ca echipa dvs. sau Tillie să răspundă. Cu **Trimiteți e-mail vizitatorilor despre răspunsurile necitite**, vizitatorul primește un e-mail cu butonul **Continuați conversația**, de îndată ce există un răspuns pe care nu l-a citit. - Vizitatorul trebuie să fi furnizat o adresă de e-mail, prin formularul vizitatorului sau completată în prealabil. Fără adresă, nu se întâmplă nimic. - E-mailul pleacă abia după ce vizitatorul nu a mai fost activ aproximativ 5 minute. Pentru fiecare serie de răspunsuri necitite primește un singur e-mail. - Butonul deschide chatul și continuă conversația, chiar și pe alt dispozitiv sau într-un alt browser. Linkul funcționează 30 de zile. - Vizitatorul poate răspunde și direct la e-mail. Acel răspuns apare în aceeași conversație din inbox, cu o mică pictogramă de plic lângă mesaj. - Răspunsurile lui Tillie contează, la fel ca răspunsurile echipei dvs. ## Opțiuni pe fragmentul de cod [#opties-op-het-snippet] Pe lângă `data-org-id` și `data-widget-key` puteți pune atribute opționale pe script. Aceasta este destinată celui care plasează fragmentul pe site. | Atribut | Ce face? | |-----------|----------| | `data-locale` | Limba widgetului: `en`, `nl`, `de`, `fr`, `pt` sau `ro`, eventual cu regiune, precum `nl-BE`. Implicit `en`; o altă limbă revine la engleză. Regiunea stabilește formatul datei și al orei | | `data-accent-color` | Culoare de accent pentru această pagină, ca hex din 6 cifre. Are prioritate față de culoarea de la **Setări** | | `data-messages` | Obiect JSON pentru a modifica texte individuale, de exemplu `{"send":"Versturen","messagePlaceholder":"Typ uw bericht…"}` | | `data-sounds` | `false` dezactivează sunetele la reacții noi ale echipei și la trimitere. Implicit activat | | `data-launcher` | `false` ascunde butonul de chat plutitor. Deschideți apoi chatul cu propriul buton prin [SDK-ul widgetului](/ontwikkelaars/website-chat#widget-sdk) | | `data-visitor` | Obiect JSON pentru a completa în prealabil numele, e-mailul și telefonul, de exemplu `{"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"}` | | `data-visitor-name`, `data-visitor-email`, `data-visitor-phone` | Completează în prealabil unul dintre aceste câmpuri | | `data-debug` | `true` afișează rânduri de jurnal în consola browserului | Atributele completează doar câmpurile goale. Dacă vizitatorul a completat deja date în acest browser, acestea rămân. Un exemplu cu texte în olandeză: ```html ``` Puteți activa depanarea și fără a modifica fragmentul: rulați în consola browserului `localStorage.setItem('tillor-inbox-debug', '1')` și reîmprospătați pagina. ## Protecție împotriva spamului [#spambeveiliging] Widgetul nu folosește captcha. Tillor protejează trimiterea cu cheia widgetului și cu **Domenii permise**. Dacă formularul dvs. de contact are un captcha propriu, acesta poate rămâne ca strat suplimentar. ## Condiții pentru vizitatori [#voorwaarden-voor-bezoekers] Sub câmpul de mesaj se află o scurtă mențiune că, prin trimitere, vizitatorul este de acord cu [termenii chatului de pe website](https://tillor.eu/chat-terms). Linkul se deschide într-o filă nouă și urmează limba din `data-locale`. ## Vezi și [#zie-ook] # Punerea chatului pe website-ul dvs. (/ro-RO/inbox/website-chat) Cu integrarea Chat de website, site-ul dvs. primește un buton de chat. Mesajele vizitatorilor ajung în [inbox](/inbox), alături de WhatsApp, Messenger și Instagram. ### Instalați integrarea [#installeer-de-integratie] Mergeți la Setări > Integrări și deschideți **Chat de website**. Faceți clic pe **Instalați**. Nu este nevoie de conexiune cu un cont extern; Tillor creează singur cheia widgetului. ### Configurați widgetul [#stel-de-widget-in] La **Setări**, pe aceeași pagină, completați cel puțin **Mesaj de bun venit** și **Culoare de accent**. Completați și **Domenii permise**, astfel încât doar site-ul dvs. să aibă voie să încarce chatul. Toate opțiunile se găsesc la [Setările chatului de pe website](/inbox/website-chat-instellingen). ### Copiați fragmentul de cod [#kopieer-het-snippet] Faceți clic pe **Copiați fragmentul** la **Încorporați pe site-ul dvs.**. Dacă blocul nu apare, salvați setările și reîmprospătați pagina. ### Lipiți fragmentul pe site-ul dvs. [#plak-het-snippet-op-je-site] Lipiți fragmentul înaintea etichetei de închidere `` pe fiecare pagină unde trebuie să apară butonul de chat. La un site cu un șablon sau un footer comun, îl plasați o singură dată în acel șablon. ## Ce vedeți după aceea? [#wat-zie-je-daarna] Deschideți site-ul. În dreapta jos se află un buton de chat. Trimiteți singur un mesaj de test: conversația apare în inbox cu canalul **Chat pe website**. O explicație despre ce vedeți dvs. și vizitatorul găsiți la [Conversații prin chatul de pe website](/inbox/website-chat-gesprekken). Cheia este lizibilă în fragmentul de cod, ca la alte produse de chat. Limitați abuzul cu **Domenii permise** (nume de gazdă separate prin virgulă, de exemplu `recreatiepark-het-meer.be, www.recreatiepark-het-meer.be`). Dacă lăsați câmpul gol, chatul funcționează pe orice domeniu pe care se află fragmentul. ## Chat pe paginile publice Tillor [#chat-op-publieke-tillor-paginas] Dacă **Chat de website** este instalat, **Widget activat** este activat și **Afișați pe paginile publice Tillor** este activat, butonul de chat apare și pe paginile publice ale organizației dvs. Acolo nu trebuie să plasați niciun fragment de cod. Este vorba, printre altele, de paginile pentru un permis de acces, o factură restantă, o etichetă NFC, datele organizației și harta publică. - Pe acele pagini, Tillor folosește **Culoarea de accent** din setări. - **Domeniile permise** se aplică doar propriului website, nu paginilor Tillor. - Dacă dezactivați **Widget activat**, butonul dispare peste tot. Dacă dezactivați doar **Afișați pe paginile publice Tillor**, chatul continuă să funcționeze pe propriul site. ## Dezactivarea temporară a chatului [#de-chat-tijdelijk-uitzetten] Dezactivați **Widget activat** la Setări > Integrări > Chat de website. Integrarea rămâne instalată, iar cheia widgetului nu se schimbă. Activați din nou comutatorul pentru a readuce chatul. ## Probleme? [#problemen] Verificați mai întâi dacă **Widget activat** este activat. Dacă există o listă la **Domenii permise**, uitați-vă dacă numele de gazdă al paginii se află în ea, inclusiv `www.` dacă site-ul dvs. funcționează cu acesta. Verificați și dacă fragmentul se află efectiv pe acea pagină și nu doar într-un șablon pe care pagina respectivă nu îl folosește. Tillor afișează atunci mesajul că fragmentul nu a putut fi încărcat. Salvați setările și reîmprospătați pagina. Pe paginile Tillor nu este nevoie de fragment. Propriul site afișează chatul doar cu fragmentul de la pasul 3. Aceasta o rezolvă un dezvoltator cu SDK-ul widgetului. Vezi [API-ul chatului de website](/ontwikkelaars/website-chat). Tillor limitează cât trimite un vizitator prin chat, ca un script să nu-ți poată inunda inboxul și răspunsurile lui Tillie: 10 mesaje pe minut și 200 pe zi per vizitator, și 30 pe minut și 600 pe zi pentru toți cei din aceeași rețea împreună (cum ar fi wifi-ul campingului tău). Atașamente: 10 pe oră per vizitator și 50 pe oră per rețea. După un minut vizitatorul poate continua; niciun mesaj deja trimis nu se pierde. ## Vezi și [#zie-ook] # WhatsApp Business (/ro-RO/inbox/whatsapp-business-inbox) Cu **WhatsApp Business** primiți și răspundeți la mesajele clienților prin WhatsApp în [inboxul Tillor](/inbox). Aceasta **nu** este același lucru cu notificările WhatsApp prin Twilio. Pentru mesaje WhatsApp automate (notificări) vezi [Twilio](/communicatie/providers/twilio). Aplicația marketplace **WhatsApp Business** este doar pentru conversațiile din inbox. Înainte de a începe: - Aveți nevoie de permisiunea **Gestionați integrările**. - Aveți un cont WhatsApp Business la Meta și vă autentificați cu un cont care îl administrează. ## Instalarea integrării [#integratie-installeren] 1. Mergeți la **Setări > Integrări** 2. Deschideți **WhatsApp Business** în listă (marcajul **2**) 3. Faceți clic pe **Instalați** (marcajul **1**) și parcurgeți fluxul Meta OAuth 4. Alegeți ce **număr WhatsApp** primește mesajele din inbox 5. Salvați setările După instalare, Tillor primește automat mesajele. Răspunsurile pe care le trimiteți și prin aplicația WhatsApp Business sau printr-un dispozitiv conectat apar în inbox. Mesajele pe care le trimiteți prin Tillor nu sunt afișate de două ori. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Mesajele primite apar automat în [inbox](/inbox), asociate clientului cu același număr de telefon. - Răspunsurile le trimiteți în Tillor. În afara ferestrei de 24 de ore, ele pleacă drept șablon cu plată, vezi [Citirea și răspunsul la conversații](/inbox/gesprekken#whatsapp-en-het-antwoordvenster-van-24-uur). ## Probleme? [#problemen] Verificați la Setări > Integrări > WhatsApp Business dacă este ales **numărul WhatsApp** corect și dacă setările au fost salvate. Adăugați în Meta WhatsApp Manager o metodă de plată pentru contul dvs. WhatsApp Business. Fără metodă de plată, Tillor blochează răspunsurile cu plată. ## Conexe [#gerelateerd] # Prezentare generală (/ro-RO/integraties) O integrare conectează Tillor la un alt serviciu, de exemplu pentru plăți, contabilitate, telefonie, camere sau fișa dvs. Google. Le gestionați pe toate la Setări > Integrări. Cum instalați una găsiți la [Instalarea unei integrări](/integraties/integratie-installeren). ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] O integrare aparține întregii organizații, nu unui singur utilizator. După instalare, conexiunea funcționează acolo unde este nevoie: conexiunea cu camerele la punctele de acces, conexiunea de e-mail pe profilul clientului, conexiunea de plată la facturi. Unele conexiuni trec prin connector, un mic program de pe un computer din propria rețea. Acesta trebuie atunci să fie online. ```mermaid flowchart LR A[Setări > Integrări] --> B[Instalarea integrării] B --> C[Plăți și facturi] B --> D[Profil client și inbox] B --> E[Puncte de acces și camere] E -. prin .-> F[Connector în rețeaua dvs.] ``` - Puteți vizualiza cu permisiunea **Vizualizați integrările**. Instalarea, modificarea și dezinstalarea cer **Gestionați integrările**. - Dezinstalarea nu poate fi anulată. Instalați apoi integrarea din nou și completați datele din nou. - Partoo primește programul dvs. de funcționare pentru următoarele 90 de zile și o actualizare în fiecare noapte. Vezi [Partoo](/integraties/partoo). - Plățile efectuate cu mai mult de 24 de ore în urmă nu mai primesc suprapunere pe camere. Vezi [UniFi Protect](/integraties/unifi-protect). - Ce integrări vedeți depinde de organizația dvs. Lipsește una? Întrebați administratorul dvs. Tillor sau suportul. ## Integrări disponibile [#beschikbare-integraties] | Integrare | Pentru ce | Explicație | |---|---|---| | Mollie | Plăți online și cu cardul, debitare directă SEPA | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | | Conturi bancare | Importul tranzacțiilor bancare și asocierea cu facturi | [Ponto și conturi bancare](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | | Admisol | Trimiterea rapoartelor de plăți către contabilitate | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | | Odoo | Exportul clienților și al facturilor în Odoo | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | | ICY | Citirea contoarelor | [Gestionarea contoarelor](/meterbeheer) | | Voys | Asocierea apelurilor telefonice cu clienții | [Voys](/communicatie/providers/voys) | | WhatsApp Business | Mesaje WhatsApp în inbox | [WhatsApp Business](/inbox/whatsapp-business-inbox) | | Messenger | Conversații Facebook Messenger în inbox | [Messenger](/inbox/messenger) | | Instagram | Conversații Instagram Direct în inbox | [Instagram](/inbox/instagram) | | Chat de website | Chat live pe website-ul dvs. | [Chat de website](/inbox/website-chat) | | Asistentul IA al inboxului | Răspunsuri automate la întrebările frecvente | [Asistentul IA al inboxului](/inbox/inbox-ai-assistant) | | UniFi Protect | Conectarea camerelor la punctele de acces și la plăți | [UniFi Protect](/integraties/unifi-protect) | | Partoo | Program de funcționare identic pe Google și alte fișe | [Partoo](/integraties/partoo) | | Outlook | Vizualizarea e-mailurilor unui client pe profilul clientului | [Outlook](/integraties/outlook) | ## Termeni [#begrippen] - **Integrare**: o conexiune între Tillor și un serviciu extern. - **Connector**: programul din rețeaua dvs. care conectează la Tillor dispozitive precum camere și imprimante. Vezi [Connector](/connector). - **Instalare și dezinstalare**: activarea sau eliminarea unei conexiuni. Eliminarea nu poate fi anulată. - **Cheie API**: un cod secret cu care Tillor are voie să lucreze într-un alt serviciu. - **Suprapunere**: text care rulează peste imaginile camerelor, de exemplu o plată. Mai multe explicații găsiți în [glosar](/begrippen). # Instalarea unei integrări (/ro-RO/integraties/integratie-installeren) Instalați o integrare în Setări > Integrări. O căutați, completați datele serviciului extern și faceți clic pe **Instalați**. Apoi o ajustați în blocul **Setări** sau o eliminați cu **Dezinstalează**. Ce este disponibil găsiți în [prezentarea generală](/integraties). Înainte de a începe: - Cu permisiunea **Vizualizați integrările** vedeți lista și setările, dar nu puteți modifica nimic. - Țineți la îndemână datele de autentificare sau cheile serviciului extern. La Outlook sunteți redirecționat pentru a vă autentifica acolo. - La o conexiune care trece prin connector, cum este UniFi Protect, connectorul trebuie să fie online. ## Instalarea unei integrări [#een-integratie-installeren] ### Căutați integrarea [#zoek-de-integratie] Folosiți bara de căutare sau alegeți în stânga, sub **Integrări**, o categorie: **Comunicare**, **Supraveghere**, **Plăți**, **Contabilitate** sau **Contoare**. **Toate integrările** afișează tot. O integrare deja conectată are eticheta **Conectat**. ### Deschideți integrarea [#open-de-integratie] Faceți clic pe ea. Unele pagini au sus linkul **Vizualizați documentația**. ### Completați datele și faceți clic pe Instalați [#vul-de-gegevens-in-en-klik-op-installeren] Ce completați diferă de la un serviciu la altul. La Outlook sunteți redirecționat către serviciul propriu-zis pentru a vă autentifica. ## Ajustare sau eliminare [#aanpassen-of-verwijderen] După instalare, pe aceeași pagină apare un bloc **Setări**. Ajustați acolo conexiunea și salvați. Cu **Dezinstalează** eliminați conexiunea. Acest lucru nu poate fi anulat. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Conexiunea funcționează imediat pentru întreaga organizație. - Ce face conexiunea vedeți la locul potrivit, de exemplu pe profilul clientului sau la un punct de acces. - După **Dezinstalează**, conexiunea se oprește. Ce se află deja în celălalt serviciu rămâne acolo. ## Probleme? [#problemen] Nu există nicio integrare care să se potrivească cu termenul de căutare sau cu categoria. Încercați alt termen sau alegeți **Toate integrările**. Dacă lipsește o integrare pe care o așteptați, ea nu este activată pentru organizația dumneavoastră. Întrebați suportul. Nu aveți permisiunea **Gestionați integrările**. Întrebați administratorul. Integrarea nu a putut fi conectată. Verificați datele completate și încercați din nou. Încercați din nou. Dacă nu reușește, scrieți la support@tillor.eu. Modificarea dumneavoastră nu a fost salvată. Încercați să salvați din nou. ## Vezi și [#zie-ook] # Conectarea Outlook (/ro-RO/integraties/outlook) Cu conexiunea Outlook vedeți pe profilul clientului e-mailurile pe care organizația dumneavoastră le-a schimbat cu acel client. Tillor le preia live din Outlook și nu le păstrează el însuși. Înainte de a începe: - Aveți nevoie de un cont Microsoft ale cărui e-mailuri Tillor are voie să le citească. - Pentru a vedea e-mailurile pe profilul clientului, aveți nevoie de permisiunea **Vizualizați inboxul**. Fără ea lipsește fila **Outlook**. ## Instalare [#installeren] ### Deschideți integrarea [#open-de-integratie] Mergeți la Setări > Integrări > Outlook. ### Faceți clic pe Instalați [#klik-op-installeren] Sunteți redirecționat către Microsoft. ### Autentificați-vă și acordați permisiunea [#log-in-en-geef-toestemming] Autentificați-vă cu contul ale cărui e-mailuri Tillor are voie să le citească. După conectare vedeți, sub **Setări**, numele, adresa de e-mail și numele de utilizator ale contului conectat, precum și până când este activă conexiunea. ## Alegerea căsuțelor poștale [#mailboxen-kiezen] Implicit, Tillor caută doar în căsuța poștală a contului conectat. La **Căsuțe poștale** alegeți căsuțe suplimentare, de exemplu o căsuță partajată a recepției. - **Personală** este căsuța poștală a contului conectat. - **Partajat** sunt căsuțele partajate pe care contul le poate deschide. Tillor le caută singur. - **Adăugată manual** sunt adrese pe care le tastați dumneavoastră. Tastați adresa și alegeți **Adăugați [adresă]**. ## E-mailurile pe profilul clientului [#mail-op-het-klantprofiel] Pe profilul clientului apare o filă **Outlook**, între **Comunicare** și **Evenimente**. Fila există doar dacă Outlook este conectat și aveți permisiunea **Vizualizați inboxul**. - Sus apare numărul de mesaje și căsuțele în care s-a căutat. Cu **Reîmprospătează** preluați cele mai noi e-mailuri. - Tillor caută după adresa de e-mail a clientului și a contactelor sale. Dacă nimeni nu are adresă de e-mail, apare un mesaj că nu există nimic de căutat. - Fiecare mesaj arată subiectul, dacă este **Primit** sau **Trimis**, de la cine către cine, și o agrafă la atașamente. Faceți clic pe un mesaj pentru a deschide textul și atașamentele. Cu **Deschide în Outlook** mergeți la mesajul din Outlook. - Același e-mail aflat în mai multe căsuțe poștale apare o singură dată în listă. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Tillor doar citește e-mailurile și nu păstrează nimic. Dacă eliminați conexiunea, fila **Outlook** dispare de pe profilul clientului. ## Probleme? [#problemen] Tillor nu a putut prelua contul Microsoft conectat. Reîncărcați pagina sau conectați Outlook din nou prin **Instalați**. Outlook a fost conectat înainte ca Tillor să poată căuta căsuțe partajate. Faceți clic pe **Reconectează Outlook** sau tastați chiar dumneavoastră adresa căsuței partajate. Puteți totuși să tastați manual adresa unei căsuțe poștale la **Adăugată manual**. Tillor nu a putut încărca e-mailuri din Outlook. Încercați din nou cu **Reîmprospătează** sau verificați conexiunea. Contul conectat nu are acces la acea căsuță poștală. Verificați drepturile căsuței în Outlook. Outlook nu este conectat sau vă lipsește permisiunea **Vizualizați inboxul**. Încercați să deschideți din nou mesajul. Dacă nu ajută, mergeți la mesajul propriu-zis cu **Deschide în Outlook**. ## Vezi și [#zie-ook] # Conectarea Partoo (/ro-RO/integraties/partoo) Partoo vă gestionează listările pe Google și pe alte site-uri. Cu această conexiune, Tillor trimite programul de funcționare către locația dumneavoastră din Partoo, astfel încât nu trebuie să-l țineți la zi în două locuri. Programul propriu-zis îl gestionați în Tillor, vezi [Setările organizației](/gebruikers/organisaties#openingsuren). Înainte de a începe: - Creați în Partoo un utilizator separat pentru Tillor, fără autentificare în doi pași. Cu autentificare în doi pași, Tillor nu se poate conecta. - Completați programul de funcționare în Tillor, vezi secțiunea Program de funcționare din setările organizației. ## Instalare [#installeren] ### Deschideți integrarea [#open-de-integratie] Mergeți la Setări > Integrări > Partoo. ### Completați datele utilizatorului Partoo [#vul-de-gegevens-van-de-partoo-gebruiker-in] Completați **E-mail** și **Parolă** ale acelui utilizator. ### Alegeți locația [#kies-je-vestiging] Lista locațiilor apare abia după ce e-mailul și parola au fost completate. La **Locație** alegeți locația dumneavoastră. Tastați pentru a căuta la **Căutați locații…**. ### Faceți clic pe Instalați [#klik-op-installeren] ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Tillor trimite orele săptămânale, sezoanele și zilele excepționale din [programul de funcționare al organizației dumneavoastră](/gebruikers/organisaties#openingsuren): - Orele săptămânale sunt cele ale săptămânii curente. Partoo nu cunoaște sezoane, așa că Tillor trimite orele sezonului care este valabil acum. - Zilele din următoarele 90 de zile cu program diferit, cum ar fi un alt sezon, o sărbătoare legală sau o excepție, sunt trimise ca date separate. O perioadă de închidere devine o singură perioadă. - Tillor trimite aceste date în fiecare noapte și imediat după fiecare modificare a programului de funcționare, a fusului orar, a țării implicite sau a conexiunii înseși. Se modifică doar ce diferă față de Partoo. ## Ajustare sau eliminare [#aanpassen-of-verwijderen] Modificați e-mailul, parola sau locația în blocul **Setări**. Lăsați parola goală pentru a o păstra pe cea actuală. Cu **Dezinstalează** se oprește trimiterea. Ce se află deja în Partoo rămâne acolo. ## Probleme? [#problemen] Verificați datele utilizatorului Partoo. Dacă utilizatorul are autentificarea în doi pași activată, dezactivați-o sau creați un utilizator separat. Acordați în Partoo utilizatorului acces la locația dumneavoastră și apoi verificați din nou. Încercați din nou peste puțin timp. Dacă persistă, scrieți la support@tillor.eu. Verificați mai întâi programul de funcționare din Tillor, fusul orar și țara implicită. După o modificare, Tillor le trimite imediat, iar apoi încă o dată în fiecare noapte. ## Vezi și [#zie-ook] # Conectarea UniFi Protect (/ro-RO/integraties/unifi-protect) Cu conexiunea UniFi Protect ajungeți dintr-o încercare de acces sau dintr-un eveniment al punctului de acces, cu un singur clic, la înregistrarea camerei corespunzătoare. În plus, plățile cash și plățile cu cardul pot rula ca text peste imaginile unei camere, astfel încât să puteți revedea înregistrarea în cazul unei diferențe de casă. Instalarea este aceeași ca la orice integrare, vezi [Instalarea unei integrări](/integraties/integratie-installeren). Înainte de a începe: - Camerele sunt citite prin [connector](/connector) la parcul dumneavoastră. Acesta trebuie să fie online. Dacă nu este, Tillor anunță **Connectorul Tillor este offline sau inaccesibil.** - Aveți nevoie de datele consolei dumneavoastră UniFi OS. Este dispozitivul sau serverul pe care rulează UniFi Protect. - Pentru legătura cu punctele de acces, acestea trebuie să existe, vezi [Control acces](/toegangscontrole). ## Instalare [#installeren] ### Deschideți integrarea [#open-de-integratie] Mergeți la Setări > Integrări > UniFi Protect. ### Completați consola [#vul-de-console-in] - **Gazdă consolă**: adresa IP locală sau numele de gazdă al consolei dumneavoastră UniFi OS. - **Cheie API**: un cod secret pe care îl creați în consolă și cu care Tillor are voie să citească camerele. - **ID consolă cloud**: ID-ul lung de după `/consoles/` în URL-ul unifi.ui.com al consolei dumneavoastră. ### Alegeți camerele pentru plăți [#kies-de-betaalcameras] La **Cameră plăți cash** și **Cameră plăți POS** alegeți o cameră sau lăsați **Nu înregistrați**. POS este terminalul de plată cu cardul. ### Faceți clic pe Instalați [#klik-op-installeren] Imediat ce gazda și cheia API sunt completate, Tillor încarcă camerele consolei. ## Asocierea camerelor cu punctele de acces [#cameras-koppelen-aan-toegangspunten] După instalare, în blocul **Setări** apare tabelul **Camere puncte de acces**. Asociați fiecare **Punct de acces** cu o **Cameră**. Dacă lista este goală, adăugați mai întâi puncte de acces. Apoi, în detaliile unei încercări de acces și ale unui eveniment al punctului de acces apare linkul **Deschideți în UniFi Protect**. Acesta deschide înregistrarea din jurul acelui moment în UniFi Protect, într-o filă nouă. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Dacă ați ales o cameră la **Cameră plăți cash** sau **Cameră plăți POS**, Tillor trimite către acea cameră fiecare plată care ajunge la **Plătit**. Plățile cash merg către camera pentru cash, plățile cu cardul pe un terminal către camera POS. - Plățile achitate cu mai mult de 24 de ore în urmă nu mai primesc text peste imagini. - Plățile prin Mollie contează doar dacă aparțin profilului principal Mollie. - Dacă modificați datele, salvați. Dacă lăsați **Cheie API** goală, rămâne valabilă cheia existentă. Cu **Dezinstalează** eliminați conexiunea. ## Probleme? [#problemen] Consola nu are camere sau cheia API nu are acces la ele. Verificați cheia și dacă camerele sunt vizibile în UniFi Protect. Verificați gazda, cheia API și dacă connectorul este online. Tillor anunță: **Verificați gazda, cheia API și connectorul.** Camerele se încarcă prin connector, în rețeaua dumneavoastră locală. Porniți connectorul sau restabiliți conexiunea, vezi [Connector](/connector). La acel punct de acces nu este asociată nicio cameră. Asociați una în tabelul **Camere puncte de acces**. Verificați dacă camera de la **Cameră plăți cash** sau **Cameră plăți POS** nu este pe **Nu înregistrați**. O plată achitată cu mai mult de 24 de ore în urmă nu mai primește suprapunere. O plată Mollie contează doar la profilul principal. ## Vezi și [#zie-ook] # Hartă (/ro-RO/kaart) Pe hartă vedeți dintr-o privire care parcele sunt libere, rezervate sau ocupate, pentru fiecare zi aleasă. Tot aici trasați limitele parcelelor, astfel încât Tillor să le cunoască suprafața, și măsurați distanțe. Parcelele propriu-zise le gestionați la [Parcele](/terreinen). - Harta se deschide mereu pe ziua de azi. Stilul, etichetele și straturile sunt însă păstrate. - Rezervările cu check-out efectuat și cele anulate nu contează pentru culoare, eticheta de plecare sau rezervarea dublă. - Etichetele cu nopți și plecare dispar sub nivelul de zoom 17,5. Numele parcelei rămâne afișat. - O parcelă fără limită trasată nu apare pe hartă. Trasarea este posibilă doar cu **Mod editare** activat. - Harta se deschide pe centrul hărții pe care îl setați la **Setări > Hartă**. Același punct stabilește și vremea. ## Deschiderea hărții [#de-kaart-openen] Mergeți la Parc > Hartă. Vedeți imediat toate parcelele cu starea lor de ocupare. - **Suprafață verde** - parcela rezervabilă este liberă - **Suprafață gri** - parcela este **nerezervabilă** și nu are la data aleasă niciun sejur activ (nicio rezervare sau ocupare); etichetele cu nopți și plecare lipsesc - **Suprafață cyan** - rezervare **făcută**, fără check-in încă (și în zilele următoare din perioada sejurului, atât timp cât nu s-a făcut check-in) - **Suprafață albastră** - rezervare **cu check-in** (sejur activ la data aleasă) - **Suprafață galbenă** - parcela are o ocupare activă (închiriere pe termen lung; valabilă la orice dată aleasă cât timp ocuparea este în curs) - **Suprafață roșie** (suprapunere ușoară, contur roșu) - rezervare dublă: perioade de rezervare suprapuse pe aceeași parcelă Faceți clic pe o parcelă de pe hartă pentru a deschide o fereastră cu numele, rezervările, eventuala ocupare activă (oaspetele) și scurtături. ## Alegerea datei [#datum-kiezen] În dreapta butonului **Setări hartă** alegeți o **dată** (implicit azi). Harta arată atunci cum arată parcelele în acea zi. După reîmprospătarea paginii, data revine la **azi**; doar celelalte setări ale hărții (stil, etichete, straturi) sunt păstrate. Rezervările cu **check-out efectuat** și cele **anulate** nu contează pentru culoare, eticheta de plecare sau rezervarea dublă (nici nu apar în fereastra de pe hartă). La locurile libere, sub numele parcelei apare o etichetă cu pictogramă de lună și numărul de nopți până la următorul check-in. La o rezervare sau ocupare cu dată de plecare apare o etichetă cu pictogramă de plecare și numărul de nopți până la check-out (0 = azi). Treceți cu mouse-ul peste o etichetă pentru textul complet. La o **rezervare dublă** (două sau mai multe rezervări cu perioade de sejur suprapuse pe aceeași parcelă), parcela primește un contur roșu și o suprapunere roșie ușoară; înaintea numărului parcelei apare o pictogramă triunghiulară roșie. În fereastră vedeți un avertisment cu rezervările implicate. Sub nivelul de zoom **17,5**, harta ascunde automat etichetele cu nopți și plecare; numele parcelei rămâne vizibil. Măriți până la cel puțin **17,5** (sau dezactivați **Nopți și check-out** în setările hărții) pentru a vedea acele etichete. La zoom redus, numele parcelelor sunt afișate mai mici, ca să se suprapună mai puțin. ## Straturi și culori [#lagen-en-kleuren] În stânga jos sunt trei butoane: **Straturi**, **Exportă PDF** și **Setări hartă**, iar în dreapta lor selectorul de dată. Cu **Straturi** stabiliți ce vedeți și cum sunt colorate parcelele. - La **Culori** alegeți **Ocupare** sau **Tip de parcelă**. La **Ocupare**, parcelele se colorează așa cum s-a descris mai sus. La **Tip de parcelă**, fiecare parcelă primește **Culoarea hărții** a tipului său, vezi [Tipuri de parcelă](/terreinen#terreintypes). - La **Ocupare**, sub **Straturi de parcele** există o bifă pentru fiecare fel: **Liberă**, **Rezervată**, **Cu check-in**, **Ocupată**, **Nerezervabilă** și **Rezervare dublă**. Debifați pentru a ascunde acele parcele. - Sub **Tipuri de parcelă** alegeți ce tipuri apar pe hartă. **Fără tip** aparține parcelelor fără tip. Cu **Exportă PDF** descărcați un PDF cu parcelele aflate acum pe hartă: nume, suprafață, gaz și preț calculat, la data aleasă. ## Setări hartă [#kaartinstellingen] Cu **Setări hartă** ajustați afișarea. | Setare | Descriere | |------------|--------------| | **Stil** | **Satelit**, **Hibrid** sau **Străzi** | | **Mod editare** | Afișează instrumentele pentru trasarea și editarea limitelor parcelelor | | **Numele parcelelor** | Afișează numele parcelelor pe hartă. Funcționează doar dacă cel puțin un strat este activ | | **Nopți și check-out** | Afișează lângă numele parcelelor câte nopți sunt libere și când pleacă un sejur. Funcționează doar dacă **Numele parcelelor** este activat | Setările dumneavoastră sunt salvate automat. ## Setarea implicită a hărții [#kaartstandaard-instellen] Sub Asistență > Setări > Hartă stabiliți unde se deschide harta și cum este rotită. | Setare | Descriere | |---|---| | **Centrul hărții** | Faceți clic pe hartă sau trageți pinul în mijlocul parcului. Dedesubt sunt coordonatele. | | **Orientarea hărții** | Direcția busolei în grade (0-360) cu care se deschide harta. | Centrul hărții contează și în afara hărții. Este locul pentru care se preia vremea la Parc > Vreme, iar sugestiile de adresă la completarea unei adrese dau prioritate locurilor din apropiere. Dacă la **Apple Wallet** nu ați setat **Locația punctului de acces**, Apple Wallet și Google Wallet folosesc centrul hărții pentru cardul de acces. Vezi [Organizație](/gebruikers/organisaties#apple-wallet). Dacă centrul este într-un loc greșit, nici vremea nu va fi corectă. ## Trasarea limitelor parcelelor [#terreingrenzen-intekenen] Cu modul de editare fixați pe hartă limita exactă a unei parcele. Din aceasta Tillor calculează suprafața în m², pe care o folosește formula de tarif. 1. Mergeți la **Parc > Hartă** 2. Faceți clic pe **Setări hartă** în stânga jos 3. Activați **Mod editare** 4. Faceți clic pe punctele dorite de pe hartă pentru a desena un poligon 5. Închideți poligonul făcând clic pe punctul de început 6. Selectați în fereastra de dialog parcela pe care vreți s-o asociați 7. Faceți clic pe **"Actualizați"** Parcela apare acum ca o suprafață colorată pe hartă. Parcelele fără locație trasată sunt în fruntea listei de alegere, ca să le găsiți și să le asociați ușor. ## Măsurarea distanțelor [#afstanden-meten] Cu funcția de măsurare puteți măsura rapid distanțe și suprafețe pe hartă - util la împărțirea terenului sau la estimarea distanțelor dintre locații. 1. Faceți clic în stânga sus pe hartă pe **Măsurați distanța** sau **Măsurați suprafața** 2. Plasați puncte pe hartă (închideți o suprafață făcând clic pe punctul de început) 3. Măsurătoarea este afișată pe hartă; folosiți **Ștergeți măsurătorile** pentru a o lua de la capăt ## Deschiderea unei parcele de pe hartă [#een-terrein-openen-vanaf-de-kaart] Prin hartă puteți naviga rapid către o parcelă: 1. Faceți clic pe o parcelă de pe hartă 2. Fereastra arată numele, starea de ocupare, rezervările active și, la o ocupare, oaspetele 3. Faceți clic pe **"Vizualizați detaliile"** pentru a merge la pagina de detalii 4. Atât timp cât nu există o ocupare activă, puteți începe **"Creați rezervare"** ## Ce se întâmplă după trasare? [#wat-gebeurt-er-na-het-intekenen] - Parcela primește o culoare pe hartă, iar Tillor completează **Suprafață** pe pagina parcelei. - **Tarif calculat** este recalculat, deoarece suprafața contează. Vezi [Parcele](/terreinen#hoe-het-tarief-tot-stand-komt). - **Suprafață totală** din fruntea listei de parcele include de acum și această parcelă. ## Probleme? [#problemen] Parcela nu are încă o limită trasată. Activați **Mod editare**, trasați parcela și alegeți-o în fereastra de dialog. Parcelele fără locație sunt în fruntea listei de alegere. Dacă parcela apare, verificați la **Straturi** dacă stratul stării ei este activat. Măriți până la cel puțin nivelul 17,5 și verificați în **Setări hartă** dacă sunt activate atât **Numele parcelelor**, cât și **Nopți și check-out**. Parcelele gri, nerezervabile și fără sejur nu au niciodată o astfel de etichetă. Centrul hărții este setat greșit. Mutați pinul sub Asistență > Setări > Hartă. Această opțiune apare doar dacă parcela nu are o ocupare activă. Data aleasă nu este păstrată. După o reîmprospătare, harta revine la azi. ## Vezi și [#zie-ook] # Gestionarea clienților (/ro-RO/klantenbeheer) Un client este locul din Tillor unde se adună tot ce ține de o persoană sau de o firmă: date, persoane de contact, facturi, ocupări, rezervări, documente și acces. Creați un client, îl regăsiți în listă și îi actualizați datele pe profilul clientului. Începeți cu [Adăugarea unui client nou](#een-nieuwe-klant-toevoegen). - La creare este obligatoriu doar **Prenume**. Toate celelalte date le completați ulterior pe profilul clientului. - Tillor avertizează la un **posibil client duplicat** dacă prenumele și numele împreună, adresa de e-mail sau numărul de telefon există deja la alt client. O adresă de e-mail sau un număr de telefon contează începând cu 4 caractere. - Sugestiile de adresă apar de la 3 caractere tastate în câmpul **Stradă**. - Scanările documentelor de identitate fără client asociat sunt șterse de Tillor după 7 zile. - Ștergerea unui client elimină și toate datele aferente și nu poate fi anulată. ## Cum se leagă lucrurile? [#hoe-hangt-dit-samen] Tot ce înregistrați în Tillor este legat de un client. O ocupare leagă clientul de o parcelă și, prin aceasta, și de contoarele de pe acea parcelă. Consumul acestor contoare ajunge pe factura clientului. ```mermaid flowchart LR K[Client] --> C[Persoane de contact] K --> R[Rezervări] K --> B[Ocupări] B --> T[Parcelă] T --> M[Contoare] M --> V[Consum] V --> F[Facturi] K --> F F --> P[Plăți] K --> D[Documente și cereri de semnare] K --> O[Comentarii și sarcini] ``` ## Adăugarea unui client nou [#een-nieuwe-klant-toevoegen] Înainte de a începe: - O scanare de identitate, dacă vreți să creați clientul cu ajutorul ei. Dacă nu există nicio scanare în coadă, alegeți pur și simplu introducerea manuală. - Nu sunteți sigur dacă clientul există deja? Căutați-l mai întâi în listă, vezi [Căutarea și filtrarea clienților](#klanten-zoeken-en-filteren). ### Deschideți lista de clienți [#open-de-klantenlijst] Mergeți la Clienți > Prezentare generală și faceți clic în dreapta sus pe **Creați un client nou**. Cât timp există scanări de identitate în așteptare, butonul afișează un meniu cu **Manual** și scanările din coadă. ### Alegeți cum creați clientul [#kies-hoe-je-de-klant-aanmaakt] Alegeți **Manual**. Se deschide un formular cu **Prenume**, **Nume**, **Adresă de e-mail** și **Număr de telefon**. Completați ce știți și faceți clic pe **Creați clientul**. Dacă există posibil deja un client cu date asemănătoare, jos apare un mesaj galben cu un link către acel client. Alegeți o scanare din meniu, de exemplu **Lotte Peeters**. În confirmare vedeți o previzualizare a documentului (față, verso, portret) și datele din zona lizibilă automat. Faceți clic pe **Creați clientul**. Tillor creează clientul, asociază scanarea și completează datele din document. Scanările în așteptare se află și în panoul din dreapta jos, cu **Creați client pe baza scanării**. Mai multe despre scanări găsiți la [Scanări de identitate](/identiteitsscans). ### Verificați dacă nu este un client duplicat [#controleer-op-een-dubbele-klant] Dacă există posibil deja un client cu același nume, aceeași adresă de e-mail sau același număr de telefon, Tillor afișează **Posibil client duplicat** cu numele și numărul clientului. Faceți clic pe **Folosiți acest client** pentru a deschide acel client sau pe **Creați oricum** dacă este într-adevăr altă persoană. Scanările fără client asociat sunt șterse de Tillor **automat după 7 zile**. Prelucrați-le la timp. Pentru scanările **asociate**, **organizația dumneavoastră** stabilește termenul de păstrare și temeiul juridic. Tillor le păstrează până când le disociați sau le ștergeți. Respectarea legislației privind confidențialitatea și a termenelor de păstrare adecvate este **responsabilitatea dumneavoastră** ca operator de date. ### Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Ajungeți pe noul profil al clientului, unde completați restul: adresă, cod TVA, persoane de contact și câmpuri proprii. - Dacă clientul a fost creat dintr-o scanare, scanarea aparține clientului și nu mai este în coadă. - Crearea apare ca primul rând în fila **Evenimente** a clientului. - Dacă vreți ca ceva să se întâmple imediat la un client nou, de exemplu un e-mail de bun venit, folosiți o [automatizare](/automatiseringen). ## Verificarea unui cod TVA [#een-btw-nummer-controleren] În fila **Prezentare generală**, în blocul **Datele clientului**, completați **Cod TVA**. Tillor verifică numărul în registrul european VIES de îndată ce este completată și **Țară** și numărul este suficient de lung. - Dacă numărul este valid, vedeți o bifă verde și o fereastră cu denumirea oficială a firmei și adresa din VIES. Faceți clic pe **Aplicați adresa companiei** pentru a prelua acea adresă în formular. - Dacă numărul este invalid, vedeți o pictogramă roșie și un mesaj de eroare. ## Profilul clientului [#het-klantprofiel] Când faceți clic pe un client, vedeți profilul clientului. Sus se află datele rezumative ale clientului, iar dedesubt comentariile fixate. Prin file ajungeți la restul. | Fila | Ce găsiți acolo | |---|---| | **Prezentare generală** | Datele clientului (formular editabil), comunicări recente, facturi, citiri, comentarii, ocupări și notificări | | **Facturare** | Toate facturile acestui client și [soldul pe cont](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken) | | **Control acces** | Drepturi de acces și numere de înmatriculare | | **Contacte** | Persoane de contact suplimentare | | **Tag-uri NFC** | Tag-uri NFC asociate | | **Rezervări** | Toate rezervările | | **Comunicare** | Mesaje și istoricul comunicării | | **Outlook** | E-mailuri de la și către client din căsuțele dumneavoastră Outlook. Această filă apare doar dacă [Outlook](/integraties/outlook) este conectat și aveți voie la **Vizualizați inboxul** | | **Evenimente** | Cronologie cu modificări, inclusiv crearea clientului sau a contactului, asocierea sau disocierea unui document de identitate și, la actualizările clientului, contactului, setărilor de facturare și metodelor de acces, valorile înainte/după | | **Documente** | Fișiere și atașamente salvate și [cererile de semnare](/handtekeningen) | | **Sarcini** | Sarcini asociate acestui client | ### Dintr-o privire [#in-één-oogopslag] În fila **Prezentare generală** se află, în stânga sus, cardul **Dintr-o privire**. Acesta arată doar ce necesită atenție la momentul respectiv și se închide dacă nu există nimic de arătat: - **Rezervări active** și **Rezervări viitoare**, cu un buton **Vizualizați rezervarea** - **Contoare active cu alarme** - **Sarcini deschise** ale acestui client - **Scanări de identitate** ale acestui client Aceleași date le vedeți în cardul unui apel primit. Un comentariu pe care îl fixați apare direct sub datele clientului, în partea de sus a profilului. Vezi [Comentarii](/notities#opmerking-vastzetten). ### Zile de naștere [#verjaardagen] Dacă clientul sau partenerul său are azi ziua de naștere, în partea de sus a profilului clientului apare un bloc verde **Zi de naștere azi**, cu numele și vârsta, iar pe pagină cad confetti. Pentru client, data provine din câmpul **Data nașterii**. Partenerul este contactul cu relația **Partener**. O dată de naștere de 29 februarie se consideră, în anii fără 29 februarie, 28 februarie. ## Editarea datelor clientului [#klantgegevens-bewerken] În fila **Prezentare generală**, în blocul **Datele clientului**, modificați câmpurile. Jos în formular se află **Anulați** și **Salvați**. Fiecare modificare apare în fila **Evenimente**, cu o prezentare **Înainte / după** pe câmp, astfel încât să vedeți exact ce s-a modificat. Dacă organizația dumneavoastră a creat [câmpuri proprii](/eigen-velden) pentru clienți, acestea apar ca câmpuri suplimentare în același bloc. ### Completarea adresei [#adres-invullen] Adresa constă din **Stradă**, **Nr.** și **Ap.**, urmate de **Cod poștal**, **Localitate** și **Țară**. - Dacă tastați cel puțin trei caractere din stradă, Tillor sugerează adrese. Alegeți una: se completează strada, numărul, codul poștal, localitatea și țara. Sugestiile provin din OpenStreetMap, o bază de date cartografică gratuită. - Dacă tastați **Kerkstraat 5** în câmpul **Stradă**, cifra trece în **Nr.**. Un spațiu după număr vă duce la **Ap.**. Dacă lipiți o adresă completă, aceasta este împărțită la fel. În țările în care numărul stă înaintea străzii, numărul nu este mutat automat. - Dacă codul poștal sau localitatea sunt deja completate, Tillor verifică adresa. O bifă verde cu **Adresă găsită** înseamnă că adresa există. O pictogramă galbenă cu **Scriere sugerată** arată ortografia uzuală. Faceți clic pe **Actualizează adresa** pentru a o prelua. - Adresa este păstrată pe un singur rând, de exemplu pe facturi și în exporturi. Sugestiile sunt un ajutor, nu o obligație. Puteți oricând să completați singur. ## Căutarea și filtrarea clienților [#klanten-zoeken-en-filteren] Mergeți la Clienți > Prezentare generală. Sus se află o bară de căutare. - Tastați un nume, o adresă de e-mail, un număr de telefon sau un număr de client. - Rezultatele se actualizează pe măsură ce tastați, cu o scurtă întârziere. - Puteți filtra și după **Creat** (interval de date), **Stare** și **Tip**. ## Ștergerea unui client [#een-klant-verwijderen] Folosiți **Ștergeți clientul** în meniul din partea de sus a profilului clientului. Tillor întreabă **Sigur doriți să ștergeți acest client?** Dacă confirmați, dispar și toate datele aferente. Acest lucru nu poate fi anulat. ## Scenarii frecvente [#veelvoorkomende-scenarios] ### Un client nou rezervă pentru prima dată [#een-nieuwe-klant-boekt-voor-het-eerst] 1. Clientul sună sau rezervă online. 2. Adăugați clientul cu **Creați un client nou**. 3. Completați adresa și celelalte date pe profilul clientului (fila **Prezentare generală** > **Datele clientului**). 4. Creați o ocupare pe parcela dorită, vezi [Ocupări](/bezettingen#een-bezetting-aanmaken). 5. Consumul contoarelor asociate este urmărit automat de Tillor. Îl vedeți la **Citiri** în **Prezentare generală**. ### Modificarea datelor clientului [#klantgegevens-wijzigen] Deschideți profilul clientului, modificați adresa în formular și faceți clic pe **Salvați**. ## Probleme? [#problemen] Mesajul este **Clientul nu a putut fi creat.** Verificați dacă **Prenume** este completat și dacă adresa de e-mail este validă, cu arond și domeniu. Apoi încercați din nou. Există deja un client cu același prenume și nume, aceeași adresă de e-mail sau același număr de telefon. Faceți clic pe **Folosiți acest client** dacă este aceeași persoană sau pe **Creați oricum** dacă este altă persoană. Modificările dumneavoastră nu au fost salvate. Verificați în formular dacă există o adresă de e-mail invalidă sau un câmp obligatoriu gol și faceți din nou clic pe **Salvați**. Doar scanările fără client asociat contează ca fiind în așteptare. Dacă scanarea este deja asociată unui client sau are mai mult de 7 zile, nu mai apare acolo. Vezi [Scanări de identitate](/identiteitsscans). La scanare apare motivul. De obicei scanarea nu are prenume: *completați-l pe scanner sau asociați manual această scanare*. Sau există deja un client cu același număr de registru național. Deschideți atunci acel client și asociați scanarea la el. Numărul nu este valid sau nu este înregistrat în VIES. Verificați dacă **Țară** este corectă și dacă numărul este complet. Tillor anunță și că numărul de TVA trebuie să aibă cel puțin un anumit număr de caractere dacă este prea scurt pentru țara aleasă și cere atât un număr, cât și o țară dacă lipsește una dintre ele. Fila apare doar dacă [Outlook](/integraties/outlook) este conectat și aveți permisiunea **Vizualizați inboxul**. Tastați cel puțin trei caractere în câmpul **Stradă**. Dacă sugestiile nu apar, completați pur și simplu adresa singur. ## Noțiuni [#begrippen] - **Client**: înregistrarea din Tillor a unei persoane sau a unei firme. Vezi [client](/begrippen#klant). - **Persoană de contact**: o persoană suplimentară a unui client, de exemplu un partener sau un contact de urgență. - **Ocupare**: un client pe o parcelă pentru o perioadă. Vezi [ocupare](/begrippen#bezetting). - **Rezervare**: o rezervare pentru un sejur. Vezi [rezervare](/begrippen#reservering). - **Evenimente**: cronologia cu toate modificările unui client. Vezi [eveniment](/begrippen#gebeurtenis). - **VIES**: registrul european în care Tillor verifică un cod TVA. ## Vezi și [#zie-ook] # Alarme și starea contoarelor (/ro-RO/meterbeheer/alarmen-en-status) Un contor dă o alarmă atunci când raportează o abatere, cum ar fi o problemă de conexiune sau o defecțiune tehnică. Aici citiți unde vedeți acest lucru, ce înseamnă indicatorul de stare și cum ștergeți o alarmă. ## Urmărirea unei alarme [#een-alarm-opvolgen] ### Căutați contorul cu o alarmă [#zoek-de-meter-met-een-alarm] Mergeți la Parc > Contoare. Un contor cu o alarmă activă are un triunghi. ### Deschideți contorul și citiți alarma [#open-de-meter-en-lees-het-alarm] În lista de alarme vedeți, pentru fiecare alarmă, mesajul, **Început la** și dacă este Activ sau Rezolvat. Mesajul depinde de tipul contorului și de furnizor. ### Rezolvați problema [#los-het-probleem-op] Verificați bateria și semnalul în detaliile contorului și, dacă este nevoie, mergeți la contor. ### Ștergeți alarma [#wis-het-alarm] Alegeți în meniul de acțiuni al contorului **Șterge alarmele**. ## Ce înseamnă starea [#wat-de-status-betekent] - **Indicator de stare**: contoarele inteligente (ICY și Tillor Hydrodigit) arată dacă au comunicat recent și dacă există alarme. Indicatorul își schimbă culoarea la o alarmă activă sau dacă contorul nu a transmis nimic de mai bine de o zi. - **Nivelul bateriei** și **calitatea semnalului**: ca procent în detaliile contorului, pentru contoarele care le transmit. ## Controlere ICY [#icy-controllers] Modulele ICY de pe locuri comunică printr-un controler aflat în tabloul de contoare. Dacă un controler cade, niciun contor din spatele lui nu mai transmite nimic. Dacă parcul dumneavoastră are contoare ICY, în Parc > Contoare, deasupra listei, apare cardul **Controlere ICY**. Acesta spune câte controlere există, câte nu au mai fost văzute de ICY în ultima oră și câte alarme sunt deschise pe controlere. Faceți clic pe **Arată** pentru tabel: - **Controler**: numele tabloului de contoare în care se află cele mai multe contoare ale controlerului, cu o bulină verde sau roșie. Dacă numele la ICY diferă de acesta, apare lângă el cu gri. Dacă contoarele nu se află în niciun tablou, vedeți doar numele de la ICY. - **Contoare**: câte dintre contoarele dumneavoastră comunică prin acest controler. La un contor, acest nume se află la **Controler** în cardul **Informații**. - **Alarme**: alarmele pe care ICY le raportează chiar pe controler, cu data de la care există. O alarmă dispare din listă de îndată ce ICY nu o mai raportează; nu trebuie s-o ștergeți. O alarmă pe care Tillor nu o cunoaște încă pe nume apare ca **Alarmă necunoscută** cu codul de la ICY. Cine primește notificări push pentru alarmele contoarelor primește o notificare și la o alarmă nouă și la una rezolvată pe un controler. - **Văzut ultima dată**: când a văzut ICY controlerul ultima oară. Dacă a trecut mai mult de o oră, ora apare cu roșu. Un controler cu o alarmă sau un controler tăcut de mai mult de o oră apare în fruntea listei, iar cardul se deschide atunci de la sine. Tillor actualizează lista de fiecare dată când contoarele ICY sunt citite. ## Când toate contoarele tac deodată [#als-al-je-meters-tegelijk-stilvallen] Contoarele Tillor Hydrodigit și Tillor EM300 își trimit valoarea către Tillor printr-un receptor, gateway-ul LoRa. În mod normal trimit o măsurătoare de aproximativ două ori pe zi. Dacă fiecare contor LoRa activ recent al organizației dumneavoastră nu a trimis nimic de mai bine de 24 de ore, cauza este probabil gateway-ul sau conexiunea cu Tillor, și nu contoarele. Un singur contor tăcut nu declanșează acest mesaj: sunt necesare cel puțin două contoare active. Atunci administratorii Tillor primesc o notificare, cu ultima măsurătoare primită și contoarele implicate. Acele contoare nu mai apar separat, încă o dată, ca contor care necesită atenție. Nu trebuie să setați nimic. Dacă vedeți la contoarele dumneavoastră o **Ultima citire** comună și veche, contactați suportul. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - O alarmă ștearsă nu mai apare ca activă în listă. Triunghiul de lângă contor în Parc > Contoare aparține doar alarmelor active. - Dacă contorul raportează din nou problema, primiți o alarmă nouă. ## Probleme? [#problemen] Cauza încă există. Verificați bateria, semnalul și locul contorului și, dacă este nevoie, sunați suportul. Verificați dacă toate au o **Ultima citire** veche. Atunci cauza este gateway-ul sau conexiunea. Contactați suportul. Uitați-vă în cardul **Controlere ICY** dacă un controler are o alarmă sau este în roșu. Atunci cauza este acel controler sau conexiunea lui, și nu contoarele. Verificați alimentarea și rețeaua tabloului de contoare și, dacă este nevoie, contactați ICY. Mesajul despre gateway cere cel puțin două contoare active. Verificați singur starea, bateria și semnalul acelui contor. ## Vezi și [#zie-ook] # Loturi de consum (/ro-RO/meterbeheer/consumptie-batches) Această pagină explică modul în care Tillor împarte consumul unui client în perioade, astfel încât să înțelegeți de ce o sumă arată într-un anumit fel. Un **lot de consum** (sau perioadă de consum) este o perioadă de consum al contorului pentru un client și un contor. Tillor urmărește automat când începe o perioadă, când se încheie și dacă a fost deja facturată. Dacă doriți doar să facturați, mergeți la [Facturarea consumului](/meterbeheer/verbruik-factureren). ## Ciclul de viață al unui lot [#levenscyclus-van-een-batch] ```mermaid flowchart TD A[Creat
doar indexul de început] -- citiri --> B[Deschis
index de început și de sfârșit] B -- închidere --> C[Închis
blocat] C -- facturare --> D[Facturat
finalizat] ``` ### Stări [#statussen] | Stare | Descriere | |--------|--------------| | **Deschis** | Citirile noi se adaugă automat la perioadă | | **Închis** | Perioada este încheiată și așteaptă facturarea | | **Facturat** | Consumul a fost preluat într-o factură | ## Când se creează un lot? [#wanneer-wordt-een-batch-aangemaakt] - **La ocupare**: când asociați un client unei parcele cu contoare și introduceți un index de început - **La citire manuală**: când introduceți un index pentru un contor de pe o parcelă cu ocupare activă și nu există încă un lot deschis pentru acea combinație client-contor ## Când se închide un lot? [#wanneer-wordt-een-batch-gesloten] - **La încheierea ocupării**: când clientul părăsește parcela (ocuparea este ștearsă) - **La corecția sau resetarea contorului**: când indexul contorului scade (de exemplu, contor înlocuit sau corectat) - sistemul închide perioada anterioară, creează un lot „salt" închis cu consum negativ (de exemplu -90 la 100→10), iar următoarea citire începe un nou lot deschis - **La o ocupare nouă**: când este asociat un alt client (sau același client din nou) cu indexuri de început explicite Dacă indexul unui contor scade (corecție, resetare sau înlocuire), Tillor închide automat lotul în curs, creează un lot „salt" închis cu consum negativ și deschide imediat un lot nou la noul index. Lotul salt se recunoaște ușor și poate fi marcat ca plătit. Următoarea citire se adaugă la lotul nou. ## Exemple [#voorbeelden] Clientul ocupă parcela, consumă și pleacă. Cel mai frecvent scenariu. ``` 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 ``` Ocuparea continuă; facturați pe perioade fără a închide lotul. ``` 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) ``` Doar indexul de început, apoi o corecție. Lot salt cu consum de -90 m³, apoi un lot nou deschis. ``` 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³ ``` Mai întâi consum normal, apoi contorul este înlocuit. Lot salt cu consum de -140 m³, apoi un lot nou deschis. ``` 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³ ``` Citire cu același index ca la început. Tillor ajustează data de început. ``` 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" ``` Clientul părăsește parcela și revine mai târziu. Lot nou, fără legătură cu cel anterior. ``` 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 ``` Ați facturat consumul în timp ce ocuparea continua; apoi ștergeți factura ciornă. ``` 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 ``` Două perioade separate pe același contor: al doilea lot **nu** începe de la indexul de sfârșit al primului. Tillor **nu** le îmbină. ``` 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) ``` Prima factură acoperă perioada până la indexul X; apoi vin citiri noi și o **a doua** factură pentru continuare. Ștergerea primei facturi nu o modifică pe a doua. ``` 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 ``` ## Facturare [#facturering] ### Varianta 1: prin butonul de facturare (factură nouă) [#manier-1-via-factuurknop-nieuwe-factuur] 1. Mergeți la **Clienți** > client > fila **Prezentare generală** (cardul **Citiri**) 2. Faceți clic pe **Facturați consumul** 3. Sistemul creează o factură cu consumul ca linie sau îl adaugă la o factură ciornă existentă 4. Loturile sunt marcate ca facturate și asociate facturii ### Varianta 2: marcare manuală ca facturat [#manier-2-handmatig-als-gefactureerd-markeren] Dacă ați facturat consumul în afara Tillor: 1. Deschideți lotul în cardul **Citiri** (profilul clientului) sau **Consum** (**Parc** > **Contoare** > contor) 2. Faceți clic pe pictograma de avertisment de lângă perioadă 3. Confirmați cu **Da, marchează ca facturat** 4. Lotul este închis fără legătură cu o factură Doar loturile marcate manual pot fi „anulate". Loturile asociate unei facturi reale nu pot fi anulate - factura trebuie mai întâi ștearsă. ### Lot nou automat [#automatische-nieuwe-batch] Când marcați un lot ca facturat (iar ocuparea este încă în curs), Tillor creează automat un **lot nou deschis** care începe de la indexul de sfârșit al celui anterior. Astfel consumul continuă fără goluri. ``` Batch 1: 0 → 50 m³ (gefactureerd) ↓ Batch 2: 50 → (open, klaar voor nieuwe uitlezingen) ``` ## Ștergerea unei facturi [#factuur-verwijderen] Dacă ștergeți o **factură ciornă** căreia îi era asociat consum, Tillor ajustează automat loturile de consum. ### Ce se întâmplă întotdeauna? [#wat-gebeurt-er-altijd] - Legătura cu acea factură dispare. - Lotul apare din nou ca **nefacturat** și poate ajunge din nou pe o factură. ### Când redevin două loturi unul singur? [#wanneer-worden-twee-batches-weer-één] Uneori, după facturare, Tillor a pornit automat un **lot nou deschis** la **indexul de sfârșit** al perioadei facturate. Dacă ștergeți acea factură, sistemul caută o astfel de continuare: | Condiție | Consecință | |------------|--------| | Există un alt lot cu **același index de început** ca **indexul de sfârșit** al lotului facturat (aceeași citire ca punct de legătură) | Continuarea este **îmbinată** în lotul inițial. Obțineți din nou **o singură** perioadă continuă. | | Continuarea **nu a fost încă facturată** (nicio factură pe ea) | Îmbinarea este **permisă**. | | Continuarea **începe la o altă citire** decât indexul de sfârșit al lotului facturat | **Fără** îmbinare: sunt două perioade separate. | | Continuarea **a fost deja refacturată** (altă factură) | **Fără** îmbinare: acea perioadă rămâne pe cealaltă factură. | ### Indexul de sfârșit după îmbinare [#eindstand-na-samenvoegen] După îmbinare, lotul trebuie să fie din nou **deschis** (dacă continuarea era deschisă), iar **indexul de sfârșit** este indexul de sfârșit actual al acelei continuări - deci inclusiv citirile primite **după** factură. Dacă din punct de vedere tehnic continuarea nu avea index de sfârșit, dar există citiri mai noi pe contor, Tillor completează indexul de sfârșit cu **cea mai recentă citire de după punctul de legătură** (aceeași logică ca la crearea unui lot). Doar loturile **fără** legătură cu o factură pot fi readuse manual la „nefacturat" prin pictograma de anulare (la **Parc** > **Contoare** > contor, la perioadele decontate). Loturile asociate unei facturi reale urmează regulile de mai sus abia **după** ce ștergeți acea factură. ## Situații specifice [#specifieke-situaties] ### Perioadă fără consum [#periode-zonder-verbruik] Dacă apare o citire cu același index ca la început (consum = 0), Tillor ajustează automat data de început. Perioada afișată arată doar perioada în care a avut loc efectiv consum. ### Clientul se întoarce [#klant-keert-terug] Când un client ocupă din nou o parcelă după o plecare anterioară: - Se creează un **lot complet nou** - Lotul nu începe acolo unde s-a încheiat cel anterior - Alegeți din nou un index de început (sau indexul contorului de la acel moment) ### Contor asociat mai multor clienți [#meter-gekoppeld-aan-meerdere-klanten] Fiecare combinație client-contor are propriile loturi. Aceeași parcelă poate avea mai multe ocupări (de exemplu, perioade diferite), fiecare cu propriile perioade de consum. ## Prezentare în aplicație [#overzicht-in-de-applicatie] Unde vedeți loturile: - **Clienți** > client > fila **Prezentare generală** > cardul **Citiri**: pentru fiecare contor doar perioadele **restante** (accent portocaliu), cu butonul **Facturați consumul** deasupra. - **Parc** > **Contoare** > contor > cardul **Consum**: pentru fiecare client mai întâi perioadele restante (portocaliu), dedesubt perioadele decontate (verde dacă sunt legate de o factură, gri dacă sunt marcate manual). - **Clienți** > **Consum nefacturat**: tabel cu clienții al căror consum mai trebuie facturat. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/meterbeheer) Cu gestionarea contoarelor citiți de la distanță contoarele parcului dumneavoastră și vedeți cine ce consumă, fără ca cineva să treacă pe la dulapurile de contoare. Vedeți indexurile contoarelor, consumul pe perioadă și alarmele, iar consumul îl decontați cu clientul care se află în acel moment pe parcelă. Contoarele dumneavoastră le găsiți la Parc > Contoare. ## Cum se leagă toate? [#hoe-hangt-dit-samen] Un contor nu aparține niciodată direct unui client. Contorul este asociat unei **parcele**, iar clientul este asociat acelei parcele printr-o **ocupare**. Cine are acum o ocupare pe parcelă primește consumul contoarelor de pe acea parcelă. ```mermaid flowchart LR M[Contor] -->|îl asociați la| T[Parcelă] K[Client] -->|primește o ocupare pe| T T --> V[Consumul clientului] V --> F[Factură] ``` Asta are trei consecințe care îi surprind adesea pe oameni: - Nu există un buton pentru a asocia un contor unui client. O faceți în doi pași: contorul la parcelă, clientul la parcelă. Consultați [Asocierea unui contor la un client](/meterbeheer/meter-koppelen). - Dacă un client se mută, nu mutați contorul. Ocuparea se încheie, iar următorul client primește consumul începând de la propriul index de început. - Dacă pe parcelă nu există ocupare, consumul nu aparține nimănui și nici nu poate fi facturat. - O parcelă are cel mult o ocupare activă în același timp. O parcelă cu ocupare nu apare în lista de alegere de la **Creați ocupare**. - Contoarele de pe o rețea LoRa partajată trimit o măsurătoare de aproximativ două ori pe zi. Consultați caseta de mai jos. - Tillor semnalează o posibilă defecțiune la receptor (gateway) dacă toate contoarele LoRa active recent nu au trimis nimic mai mult de 24 de ore și doar dacă există cel puțin două contoare active. - Dacă doriți să facturați consumul unui client și suma restantă este sub suma minimă, Tillor așteaptă următoarea zi de facturare. - La facturarea automată, Tillor oprește o factură dacă consumul de electricitate sau de apă este cel puțin dublul a ceea ce consumă clientul de obicei. - Un contor șters nu mai poate fi recuperat, împreună cu toate indexurile și perioadele de consum. LoRa este o conexiune fără fir cu rază mare de acțiune și consum redus de energie. Contorul trimite indexul către un receptor de pe parcul dumneavoastră sau din apropiere, gateway-ul, iar acesta îl transmite mai departe către Tillor. Dev EUI este numărul unic al unui contor LoRa, de 16 caractere (cifre 0-9 și litere a-f). Acest număr îl introduceți la crearea contorului. Contoarele ICY se recunosc după numărul de serie. ## Ce doriți să faceți? [#wat-wil-je-doen] ## Cum ajung indexurile în Tillor? [#hoe-komen-de-meterstanden-binnen] Contoarele inteligente își transmit singure indexul, de obicei zilnic sau săptămânal. Nu trebuie să faceți nimic: indexurile noi apar automat la contor și la clientul care se află pe parcelă. Dacă un contor nu are o conexiune inteligentă, introduceți dumneavoastră indexul. ## Termeni [#begrippen] - **Contor**: un contor de apă, gaz sau electricitate. Consultați [Termeni](/begrippen#meter). - **Parcelă**: locul unde este montat contorul și unde se află un client. Consultați [Termeni](/begrippen#terrein). - **Ocupare**: un client pe o parcelă pentru o perioadă. Consultați [Termeni](/begrippen#bezetting). - **Perioadă de consum** (lot de consum): consumul unui client pe un contor, de la un index de început la un index de sfârșit. - **Consum nefacturat**: consum care nu a fost încă facturat. - **Index de început**: indexul contorului cu care un client își începe ocuparea. # Asocierea unui contor la un client (/ro-RO/meterbeheer/meter-koppelen) Un contor nu îl asociați clientului însuși. Asociați contorul unei parcele și dați clientului o ocupare pe acea parcelă. Apoi consumul ajunge singur la client. Consultați [Cum se leagă toate?](/meterbeheer#hoe-hangt-dit-samen) pentru schemă. Înainte de a începe: - Contorul există deja la Parc > Contoare. Un contor care este deja asociat unei parcele nu apare în lista de alegere. - Parcela există și nu are încă o ocupare activă. Dacă parcela este ocupată, nu apare în lista de alegere de la **Creați ocupare**; dacă vedeți **Nu s-au găsit parcele disponibile.**, toate sunt ocupate. - Clientul există. ## Pasul 1: asocierea contorului la parcelă [#stap-1-de-meter-aan-het-terrein-hangen] ### Deschideți parcela [#open-het-terrein] Mergeți la Parc > Parcele și faceți clic pe parcelă. ### Faceți clic pe Adăugați contor [#klik-op-meter-toevoegen] În partea de jos a cardului **Contoare** se află **Adăugați contor**. Alegeți contorul din listă. ### Confirmați cu Atribuiți contorul [#bevestig-met-meter-toekennen] Contorul apare acum în cardul **Contoare** al parcelei. ## Pasul 2: plasarea clientului pe parcelă [#stap-2-de-klant-op-het-terrein-zetten] ### Deschideți clientul [#open-de-klant] Mergeți la Clienți > Prezentare generală și deschideți clientul. În fila **Prezentare generală** se află cardul **Ocupări**. ### Faceți clic pe Creați ocupare [#klik-op-bezetting-aanmaken] Alegeți parcela. Dacă pe parcelă există contoare, puteți completa pentru fiecare contor un **index de început**. Pentru aceasta alegeți o citire existentă sau tastați o valoare. Dacă nu există contoare, vedeți **Niciun contor asociat**. ### Confirmați [#bevestig] Faceți clic din nou pe **Creați ocupare**. ## Dezasocierea unui contor [#een-meter-loskoppelen] Deschideți parcela, mergeți la cardul **Contoare** și alegeți în meniul (...) de lângă contor **Dezasociați de la parcelă**. Contorul rămâne și îl puteți asocia unei alte parcele. Această opțiune se află doar pe pagina parcelei, nu în meniul contorului însuși. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Tillor pornește pentru fiecare contor de pe parcelă o perioadă de consum pentru acest client, începând de la indexul de început. Consultați [Loturi de consum](/meterbeheer/consumptie-batches). - Indexurile noi se adaugă la acea perioadă. Le vedeți la client în cardul **Citiri** și la contor în cardul **Consum**. - Dacă ocuparea se încheie, Tillor închide perioada. Apoi puteți factura consumul, consultați [Facturarea consumului](/meterbeheer/verbruik-factureren). - Dacă ulterior asociați un contor suplimentar unei parcele cu ocupare în curs, pentru acel contor începe o perioadă de consum imediat ce introduceți un index. ## Probleme? [#problemen] Lista afișează doar contoare fără parcelă. Dacă contorul este deja asociat unei alte parcele, mergeți la acea parcelă și alegeți **Dezasociați de la parcelă**. Toate parcelele au deja o ocupare activă. Încheiați mai întâi ocuparea de pe parcela pe care doriți să o folosiți sau creați o parcelă nouă. Această opțiune se află doar în meniul (...) de pe pagina parcelei, în cardul **Contoare**. Tillor afișează **Nu s-a putut dezasocia contorul** dacă nu a reușit; încercați din nou. Verificați trei lucruri: este contorul asociat parcelei, are clientul o ocupare activă pe acea parcelă și a venit un index după început? Fără ocupare, consumul nu aparține nimănui. ## Vezi și [#zie-ook] # Ștergerea unui contor (/ro-RO/meterbeheer/meter-verwijderen) Un contor care nu mai există îl ștergeți în trei pași. Acest lucru nu poate fi anulat. Dacă doriți doar să scoateți contorul de pe o parcelă, dezasociați-l, consultați [Asocierea unui contor la un client](/meterbeheer/meter-koppelen#een-meter-loskoppelen). ### Deschideți meniul de acțiuni [#open-het-actiemenu] Faceți clic pe cele trei puncte de lângă contor, în listă sau pe pagina contorului, și alegeți **Șterge contorul**. ### Pasul 1 din 3: Continuă [#stap-1-van-3-doorgaan] Citiți că, pentru toți cei din organizația dumneavoastră, contorul dispare. Faceți clic pe **Continuă** sau pe **Anulați** pentru a opri. ### Pasul 2 din 3: vedeți ce dispare [#stap-2-van-3-bekijk-wat-verdwijnt] Vedeți toate indexurile cu fotografii, observațiile, alarmele și abaterile, precum și numărul de perioade de consum. Perioadele de consum care nu au fost încă facturate apar cu roșu. Dacă contorul este încă asociat unei parcele, și acest lucru este afișat. Faceți clic pe **Continuă**. ### Pasul 3 din 3: tastați numele [#stap-3-van-3-typ-de-naam] Tastați numele contorului. Abia atunci devine activ **Șterge definitiv**. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Contorul, indexurile, fotografiile, observațiile și alarmele lui dispar, inclusiv pentru colegii dumneavoastră. - Perioadele de consum care nu fuseseră încă facturate nu mai pot fi facturate. Facturați-le sau marcați-le deci mai întâi, consultați [Facturarea consumului](/meterbeheer/verbruik-factureren). - Dacă ștergeți contorul pe propria lui pagină, reveniți apoi la lista de contoare. ## Probleme? [#problemen] Trebuie să retastați exact numele contorului. Verificați majusculele și spațiile. Contorul nu a fost șters. Încercați din nou; dacă tot nu reușește, contactați suportul. Aveți nevoie de dreptul **Editați contoarele**. Cereți-l administratorului dumneavoastră. ## Vezi și [#zie-ook] # Vizualizarea indexurilor și a tendințelor (/ro-RO/meterbeheer/meterstanden-en-trends) Pe pagina unui contor vedeți ultimul index, cine folosește în prezent contorul și cum evoluează consumul. Astfel vedeți rapid dacă un contor funcționează cum trebuie și dacă ceva este în neregulă. Dacă doriți să decontați consumul, mergeți la [Facturarea consumului](/meterbeheer/verbruik-factureren). ## Deschiderea unui contor [#een-meter-openen] ### Mergeți la Parc > Contoare [#ga-naar-park--meters] Vedeți toate contoarele cu **Nume**, **Tip** (apă, electricitate sau gaz), **Furnizor**, **Modul** (Campère sau PRM, doar la contoarele ICY), **Parcelă** și **Ultima citire** cu data. Contoarele cu o alarmă activă au un triunghi. ### Faceți clic pe contor [#klik-op-de-meter] Sus vedeți datele contorului și, printre altele, cardurile **Informații**, **Consum**, **Consum și tendințe**, alarmele și activitatea. Ce se află unde: - **Informații**: număr de serie, tip, parcelă, ultima măsurătoare și, dacă contorul o transmite, nivelul bateriei. La un contor ICY se vede și ce **Modul** este montat pe loc (Campère sau PRM), prin ce **Controler** comunică acel modul (cu numele dulapului de contoare al acelui controler), **Timp de deconectare** setat la ICY și, dacă ICY îl cunoaște, **Numărul de serie al modulului**. - **Client** în antet: clientul cu o ocupare activă pe parcela contorului. Dacă apare **Fără client**, parcela nu este ocupată sau contorul nu este asociat nicăieri. - **Consum**: pentru fiecare client, consumul restant și cel decontat. - **Activitate**: sub cardul **Consum**, cronologia cu crearea contorului, modificările și indexurile introduse, modificate sau șterse manual. Modificările pe care Tillor le constată la ICY, precum un alt număr de serie sau un alt timp de deconectare al modulului, apar și ele acolo. ## Citirea consumului și a tendințelor [#verbruik-en-trends-lezen] Sus în cardul **Consum și tendințe** apare consumul din **Săptămâna aceasta** și din **Săptămâna trecută**, diferența **față de săptămâna trecută** și media pe săptămână (**Medie / săptămână**). Dacă contorul are prea puțin istoric, apare **Istoric insuficient**. Sub grafic se află **Concluzii**: prognoza pentru următoarele 30 de zile, totalul pe perioada aleasă, o zi de vârf, zilele fără consum și evoluția. Dacă consumul din ultimele 7 zile este mult peste cel normal, apare **Utilizare ridicată**, cu vremea din acele zile. Consultați [Vreme](/weer). Cu butoanele din dreapta sus a cardului comutați **Grupare** între **Pe zi** și **Pe oră**, iar **Tip de grafic** între arie și bare. Pe oră afișează consumul orar ca bare; o oră care încă nu s-a încheiat primește indicația **în desfășurare**. - Dacă alegeți o perioadă de cel mult două zile, precum **Astăzi** sau **Ieri**, graficul afișează automat bare pe oră. - La o perioadă mai lungă, **Pe oră** afișează ultimele 31 de zile. Faceți clic sus în dreapta pe butonul calendarului. În stânga alegeți o perioadă rapidă: **Astăzi**, **Ieri**, **Ultimele 7 zile**, **Ultima lună**, **Ultimele 3 luni** sau **Toate**. În dreapta alegeți o **Data de început** și o **Data de sfârșit** în calendar și confirmați cu **Aplicați**. Dacă faceți clic pe o singură zi, se afișează acea zi. Puteți ajusta și ora de început și de sfârșit. ## Contoare comutabile [#schakelbare-meters] Pentru contoarele pe care le puteți porni sau opri de la distanță, precum ICY, graficul de istoric afișează și starea pornit/oprit. O linie verde înseamnă că contorul a fost pornit. O linie roșie cu marcaje punctate înseamnă oprit. Dacă o citire nu are informația pornit/oprit, se consideră pornit. La un contor ICY alegeți în meniul de acțiuni, la **Amperaj**, câți amperi primește locul. Vedeți doar valorile până la maximul setat la ICY pentru modulul de pe acel loc: dacă acesta este 16 A, 20 A și 25 A nu apar în listă. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Datele dumneavoastră nu se modifică: sunt doar afișări. Tendințele și vremea se actualizează imediat ce sosesc indexuri noi. ## Probleme? [#problemen] Contorul nu are încă suficiente zile cu măsurători pentru o comparație cu săptămâna trecută. Reveniți mai târziu. Pentru perioada aleasă nu există consum. Alegeți o perioadă mai lungă, de exemplu **Toate**. Verificați la [Alarme și starea contorului](/meterbeheer/alarmen-en-status) dacă există o alarmă sau o defecțiune la receptor. Tillor nu oferă nicio valoare peste maximul setat la ICY pentru modulul de pe acel loc. Dacă acest maxim nu este corect, contactați ICY. Pe parcela contorului nu există ocupare activă sau contorul nu este asociat niciunei parcele (**Fără parcelă**). Consultați [Asocierea unui contor la un client](/meterbeheer/meter-koppelen). ## Vezi și [#zie-ook] # Facturarea consumului (/ro-RO/meterbeheer/verbruik-factureren) Consumul unui client este gata de facturat de îndată ce există o perioadă de consum cu consum. Îl puneți pe o factură cu un singur buton sau lăsați Tillor să factureze automat într-o zi fixă. Cum apare și cum se închide o perioadă citiți la [Loturi de consum](/meterbeheer/consumptie-batches). Înainte de a începe: - Clientul are sau a avut o ocupare pe o parcelă cu contoare. Fără ocupare nu există consum de facturat, consultați [Asocierea unui contor la un client](/meterbeheer/meter-koppelen). - Există consum restant. Dacă vedeți **Nu s-au găsit contoare cu consum restant.**, nu este nimic de facturat. ## Facturarea consumului [#verbruik-factureren] ### Deschideți clientul [#open-de-klant] Mergeți la Clienți > Prezentare generală, deschideți clientul și priviți în cardul **Citiri**. Acolo apar, pentru fiecare contor, perioadele restante. ### Faceți clic pe Facturați consumul [#klik-op-factureer-verbruik] Tillor pune pentru fiecare perioadă o linie principală cu suma pe o factură, iar dedesubt o linie de informații cu datele și indexurile. Dacă există deja o factură ciornă potrivită, Tillor adaugă liniile la aceasta. ### Alegeți singur contoarele și factura [#kies-zelf-welke-meters-en-welke-factuur] Deschideți săgeata de lângă buton și alegeți **Adăugați cu selecție...**. La **Facturare avansată** alegeți o factură ciornă existentă la **Factură (opțional)** sau lăsați gol pentru o factură nouă. La **Selectați contoarele** bifați ce contoare se includ. Mergeți la Clienți > Consum nefacturat. Vedeți clienții cu consum care mai trebuie facturat, cu suma totală pentru fiecare client. Implicit apar aici doar clienții fără facturare automată. Facturați direct din rând. Dacă ați facturat consumul în altă parte, îl marcați fără factură: 1. Deschideți perioada în cardul **Citiri** (profilul clientului) sau **Consum** (Parc > Contoare > contor). 2. Faceți clic pe pictograma de avertisment de lângă perioadă. 3. Confirmați cu **Da, marchează ca facturat**. Tillor nu creează în acest caz o factură. Doar perioadele marcate astfel le readuceți cu pictograma de anulare de la perioadele decontate. O perioadă legată de o factură reală devine liberă abia după ce ștergeți acea factură. ## Facturare automată [#automatisch-factureren] Dacă la un client este activată facturarea automată a utilităților, Tillor creează singur factura în ziua aleasă și o trimite. Setați acest lucru în profilul clientului. Două reguli stabilesc dacă acea factură este într-adevăr creată: - **Suma minimă.** Dacă suma restantă este sub minim, Tillor așteaptă o zi de facturare ulterioară. Minimul pentru toți clienții se află la **Setări > Facturare** ca **Suma minimă pentru facturile automate de utilități**. În profilul clientului puteți seta, la setările de facturare, o **Sumă minimă** proprie, care are prioritate pentru acel client. Dacă lăsați ambele goale, orice sumă este facturată. - **Consum mult peste cel obișnuit.** Dacă consumul restant de electricitate sau de apă este cel puțin dublul a ceea ce consumă clientul de obicei, Tillor nu creează factura. Primiți un e-mail la adresa de suport a organizației dumneavoastră, iar factura nu se emite până când cineva nu a verificat-o. Tillor compară fiecare tip cu el însuși: electricitatea cu electricitatea anterioară, apa cu apa anterioară. Consumul obișnuit este valoarea mediană a ultimelor facturi de acel tip. Nu există o limită fixă în m³ sau kWh. Dacă clientul nu are încă o factură anterioară pentru acel tip, factura pleacă totuși automat. Dacă după verificare indexul este corect, facturați consumul singur prin profilul clientului sau prin **Clienți > Consum nefacturat**. Setați acolo filtrul **Facturare automată** pe **Cu dată** pentru a vedea clienții opriți. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Perioadele trec de la restante la decontate. Dacă ocuparea este încă activă, Tillor deschide imediat o perioadă nouă de la indexul de sfârșit, astfel încât să nu apară goluri. - Liniile se află pe o factură ciornă. Înregistrați-o și trimiteți-o ca orice altă factură, consultați [Facturi](/facturen). - Dacă ștergeți din nou factura ciornă, consumul devine din nou disponibil. Consultați [Ștergerea unei facturi](/meterbeheer/consumptie-batches#factuur-verwijderen). ## Probleme? [#problemen] Consumul nu a putut fi pus pe factură. Încercați din nou. Dacă nu reușește cu o factură ciornă aleasă, alegeți **Creați factură nouă**. Consumul a fost de cel puțin două ori peste cel obișnuit. Verificați indexul și facturați singur dacă totul este corect. Lista afișează implicit doar clienții fără facturare automată. Setați filtrul **Facturare automată** pe **Cu dată** pentru ceilalți clienți. Dacă nici atunci clientul nu apare, nu există consum restant. Verificați dacă clientul are o ocupare activă pe parcela unde este montat contorul și dacă după indexul de început a venit un index. O perioadă fără consum nu produce nicio sumă. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/nfc) O etichetă NFC este un card, o brățară, un breloc sau un autocolant pe care un client îl ține în fața unui cititor, ca la plata contactless. Cu ea face un duș, deschide o ușă sau își încarcă mașina. Pe această pagină vedeți cum se leagă o etichetă, un client și un sold. Pașii pentru a asocia sau a reîncărca o etichetă se află la [Gestionarea etichetelor](/nfc/nfc-tags). Toate etichetele organizației dumneavoastră le găsiți pe pagina **Controlere**, în cardul **Etichete NFC**. - O etichetă apare automat în Tillor de îndată ce a fost ținută pentru prima dată în fața unui cititor. Nu o creați dumneavoastră. - O etichetă aparține cel mult unui client și are starea **Activ**, **Inactiv** sau **Blocat**. - Soldul este în euro pe etichetă. Orice modificare a soldului este păstrată întotdeauna ca tranzacție și nu poate fi editată sau ștearsă. - O plată care trebuie încă scrisă pe etichetă rămâne deschisă 2 minute. Apoi expiră. - O etichetă blocată nu mai funcționează la cititoare. ## Cum se leagă toate? [#hoe-hangt-dit-samen] Eticheta în sine nu știe nimic. Tillor ține minte cine o are, care este soldul și unde are voie să meargă. Cititorul întreabă Tillor acest lucru în momentul în care clientul ține eticheta în fața lui. ```mermaid flowchart TD K[Client] --> T[Etichetă NFC] T --> G[Grupuri de acces
unde are voie eticheta să meargă?] T --> S[Sold
câtă valoare este pe ea?] L[Cititor la duș, ușă sau stație de încărcare] -->|clientul ține eticheta în fața lui| T L --> TR[Tranzacție
sumă, motiv și cititor] S --> TR ``` - Fără client, cititorul refuză eticheta. Pe ecran apare atunci **Etichetă neasociată**. - Fără grupul de acces potrivit, cititorul refuză eticheta cu **Fără acces**. - Fără sold suficient apare **Sold insuficient**. Toate mesajele de pe ecran se află la [Mesaje pe ecran](/controllers/troubleshooting/scherm). - Fiecare debitare sau reîncărcare apare ca linie în [tranzacții](/nfc/nfc-transacties). - O etichetă este și o metodă de acces. O adăugați unui client la [Control acces](/toegangscontrole#een-toegangsmethode-toevoegen). ## Componente [#onderdelen] ## Termeni [#begrippen] - **Etichetă**: cardul, brățara, autocolantul sau brelocul. - **UID**: numărul unic al etichetei. - **Sold**: valoarea de pe etichetă. - **Grup de acces**: stabilește pentru ce cititoare este valabilă o etichetă. - **Tranzacție**: o debitare sau o reîncărcare a soldului. Mai multe explicații se află în [lista de termeni](/begrippen). # Gestionarea etichetelor (/ro-RO/nfc/nfc-tags) O etichetă NFC este utilizabilă abia când este asociată unui client. Atunci clientul poate face duș, poate deschide o ușă sau poate încărca, iar dumneavoastră puteți ține evidența soldului. Toți pașii de mai jos îi faceți în profilul clientului. Ce se întâmplă la fiecare scanare citiți la [Tranzacții](/nfc/nfc-transacties). Înainte de a începe: - Eticheta trebuie să fie deja în Tillor. Acest lucru se întâmplă automat de îndată ce a fost ținută pentru prima dată în fața unui cititor. - Eticheta nu trebuie să fie asociată altui client. Altfel nu apare în listă. - Dacă nu există nicio etichetă liberă, lista afișează **Nu s-au găsit etichete disponibile**. ## Asocierea unei etichete la un client [#een-tag-koppelen-aan-een-klant] ### Deschideți fila Etichete NFC [#open-het-tabblad-nfc-tags] Mergeți la Clienți > client > Etichete NFC. Vedeți toate etichetele acestui client. Deasupra tabelului filtrați după **UID** și **Tip** (**Card**, **Brățară**, **Autocolant** sau **Breloc**). ### Alegeți eticheta [#kies-de-tag] Faceți clic pe **Selectați un card** și alegeți eticheta. Puteți căuta în listă. ### Faceți clic pe Atribuiți [#klik-op-toewijzen] Tillor afișează **Card atribuit clientului** și eticheta apare în tabel. În tabel vedeți pentru fiecare etichetă **UID** (pictograma indică tipul), **Stare**, **Sold**, când a fost **Folosit ultima dată** și **Grupuri de acces**. ## Ce puteți face cu o etichetă? [#wat-kun-je-met-een-tag-doen] Deschideți meniul de acțiuni (trei puncte) de lângă etichetă. | Acțiune | Ce face | |---|---| | **Editează soldul** | Adaugă o sumă sau setează soldul, vedeți mai jos. | | **Blochează** / **Deblochează** | Setează starea pe **Blocat** sau o readuce. | | **Grupuri de acces** | Stabilește pentru ce grupuri de acces este valabilă eticheta. | | **Trimite notificare de sold scăzut** | Trimite clientului o notificare că soldul este scăzut. | | **Copiază URL-ul personal** | Copiază linkul către pagina proprie a etichetei. | | **Elimină de la client** | Desface eticheta de client. | | **Vezi detalii** | Deschide pagina de detalii cu tranzacții și activitate. | ### Ajustarea soldului [#het-saldo-aanpassen] ### Alegeți Editează soldul [#kies-saldo-bewerken] Deschideți meniul de acțiuni și alegeți **Editează soldul**. ### Alegeți cum modificați soldul [#kies-hoe-je-het-saldo-wijzigt] La **Opțiune** alegeți **Adaugă sold** (o sumă în plus) sau **Setează soldul** (o sumă exactă). Jos vedeți rezultatul, de exemplu **Actual: ... → Nou: ...**. ### Confirmați [#bevestig] Introduceți suma și faceți clic pe **Adaugă** sau **Setează**. Suma trebuie să fie pozitivă. Tillor afișează **Sold actualizat** sau **Sold setat**. ### Blocarea unei etichete [#een-tag-blokkeren] O etichetă pierdută sau furată o blocați prin **Blochează**. Starea devine **Blocat** și eticheta nu mai funcționează la cititoare. Cu **Deblochează** din același meniu ridicați blocarea. Clientul își poate bloca eticheta și singur pe pagina personală. ### Alegerea grupurilor de acces [#toegangsgroepen-kiezen] Alegeți **Grupuri de acces** și bifați sau debifați grupurile. Modificarea se aplică imediat. Dacă vedeți **Nu există grupuri de acces disponibile**, pentru organizația dumneavoastră nu au fost încă configurate grupuri. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - O etichetă asociată apare în tabel și la client. Dacă clientul o ține în fața unui cititor, cititorul întreabă Tillor dacă are voie. - Fiecare modificare de sold devine o [tranzacție](/nfc/nfc-transacties), chiar și atunci când ajustați soldul manual. Motivul este atunci **Ajustare manuală**. - La **Activitate**, pe pagina de detalii, vedeți înainte și după pentru fiecare modificare (sold, blocare, asociere cu clientul). - La **Elimină de la client** eticheta rămâne. Este din nou liberă pentru a fi dată altui client. Tranzacțiile se păstrează. - Prin **Copiază URL-ul personal** clientul primește o pagină proprie. Acolo își poate bloca cardul și, dacă ați configurat plățile online, îl poate reîncărca singur. Acest lucru produce o factură pentru client. ## Probleme? [#problemen] Tillor afișează **Nu s-au găsit etichete disponibile**. În listă apar doar etichetele care nu aparțin încă nimănui. Desfaceți eticheta de celălalt client cu **Elimină de la client** sau țineți o etichetă nouă în fața unui cititor pentru ca ea să apară în Tillor. Soldul sau grupurile de acces nu au putut fi salvate. Încercați din nou. Dacă nu reușește, reîmprospătați pagina și verificați dacă eticheta este încă asociată clientului. Citiți motivul pe ecranul controlerului, consultați [Mesaje pe ecran](/controllers/troubleshooting/scherm). De obicei eticheta este **Blocat**, nu este asociată unui client, grupul de acces potrivit nu este activat sau soldul este prea mic. Suma trebuie completată și să fie mai mare decât zero. Altfel Tillor afișează **Suma este obligatorie**, **Sumă invalidă** sau **Suma trebuie să fie pozitivă**. Reîncărcarea prin pagina personală funcționează doar dacă organizația dumneavoastră a configurat plățile online și dacă eticheta este asociată unui client. Consultați [Procesare plăți](/betalingsverwerking). ## Vezi și [#zie-ook] # Tranzacții (/ro-RO/nfc/nfc-transacties) Fiecare modificare a soldului unei etichete NFC este înregistrată ca tranzacție, chiar și o ajustare manuală. Astfel vedeți exact când și din ce cauză s-a schimbat soldul. Tranzacțiile nu pot fi editate sau șterse. ## Vizualizarea tranzacțiilor [#transacties-bekijken] ### Deschideți eticheta [#open-de-tag] Mergeți la Clienți > client > Etichete NFC, deschideți meniul de acțiuni (trei puncte) de lângă etichetă și alegeți **Vezi detalii**. ### Priviți la Tranzacții [#kijk-bij-transacties] Cardul **Tranzacții** se află pe pagina de detalii. Cea mai nouă este deasupra. La mai mult de cinci tranzacții paginați în partea de jos. Deasupra tabelului există filtre pentru **Dată**, **Stare**, **Origine** și **Motivul anulării**. Implicit sunt active **În așteptare** și **Confirmată**. Dacă doriți să vedeți și tranzacțiile anulate și expirate, faceți clic pe **Ștergeți filtrele**. ## Coloane [#kolommen] | Coloană | Semnificație | |---|---| | **Sumă** | Modificarea soldului. Pozitivă la reîncărcare, negativă la utilizare. | | **Motiv** | Cauza, de exemplu **Utilizare duș la** un controler, **Debitare POS**, **Alimentare POS**, **Ajustare manuală** sau **Adăugat deoarece factura ... a fost plătită**. | | **Controler** | Controlerul care a provocat tranzacția. Dacă apare **Sistem**, nu a existat un controler: o modificare manuală, aplicația de recepție sau o factură plătită. | | **Dată** | Data și ora. | | **Stare** | Vedeți mai jos. | | **Origine** | **Online** sau **Offline**. | | **Descriere**, **Motivul anulării** | Explicație suplimentară și, la o tranzacție anulată, motivul. | ## Stări [#statussen] | Stare | Semnificație | |---|---| | În așteptare | Debitarea este rezervată și trebuie încă scrisă pe etichetă. | | Confirmată | Tranzacția este finalizată și soldul a fost ajustat. | | Anulată | Tranzacția nu a avut loc. Motivul se află la **Motivul anulării**. | | Expirată | Eticheta nu a fost ținută la timp în fața cititorului. O rezervare rămâne deschisă 2 minute. | Motivele posibile de anulare sunt **Sold insuficient**, **Neautorizat**, **Scrierea pe card a eșuat** și **Expirată**. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - O tranzacție în așteptare devine Confirmată de îndată ce eticheta a primit noul sold. Dacă nu reușește în 2 minute, devine Expirată și soldul nu se schimbă. - La **Origine** apare **Offline** dacă tranzacția nu s-a desfășurat live prin Tillor. - Un recepționer poate face aceeași debitare sau reîncărcare în aplicația Tillor. Soldul este atunci actualizat doar în Tillor. Aceasta apare ca **Debitare POS** sau **Alimentare POS**, fără controler. ## Probleme? [#problemen] Deschideți tranzacțiile și priviți motivul și data ultimelor linii. O linie cu **Ajustare manuală** a fost introdusă de un coleg. Dacă vedeți tranzacții pe **Expirată** sau **Anulată**, pentru ele nu s-a debitat nimic. Așteptați să treacă cele 2 minute. Tranzacția devine atunci Expirată. Rugați clientul să țină din nou eticheta în fața cititorului. Eticheta nu a fost încă folosită, iar soldul nu a fost ajustat. Nu există atunci nimic de afișat. ## Vezi și [#zie-ook] # Notificări (/ro-RO/notificaties) Prezentarea generală a notificărilor arată fiecare mesaj pe care Tillor l-a trimis către clienți și colegi, prin e-mail, SMS, poștă, WhatsApp sau push. Vedeți dintr-o privire care mesaje au ajuns, care sunt încă pe drum și care au eșuat. Cum trimiteți singur un mesaj despre o factură găsiți la [Trimiterea unei facturi sau a unui memento](/communicatie/e-mails). Deschideți prezentarea prin Comunicare > Notificări. - Dacă un mesaj rămâne blocat mai mult de 5 minute fără să fi fost predat, Tillor încearcă automat din nou - Dacă după 2 zile nu a avut loc nicio trimitere, Tillor trece mesajul pe **Eșuat**. Același lucru se aplică unui SMS care rămâne atâta timp pe **În așteptare** - Lista **Comunicări recente** afișează implicit 50 de mesaje pe pagină - Un clic pe un link dintr-un e-mail sau SMS se numără doar dacă are loc la cel puțin aproximativ o secundă și jumătate după trimitere. Astfel, programele de e-mail care deschid linkurile în avans nu sunt numărate ca clic - Mesajele despre facturi nu pleacă de la sine la înregistrarea unei facturi. Dumneavoastră porniți trimiterea - Un card cu o notificare nouă în Tillor dispare după câteva secunde. Notificarea rămâne în clopoțel până o citiți - Notificările care sunt trimise întotdeauna nu pot fi dezactivate ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Un mesaj începe cu un motiv. Apoi Tillor alege canalul și păstrează rezultatul în prezentare. ```mermaid flowchart LR A[Dumneavoastră apăsați pe Trimiteți notificare] --> D[Mesaj] B[Se întâmplă ceva, de exemplu o alarmă de contor] --> D C[O automatizare trimite un mesaj] --> D D --> E{Pentru cine?} E -- Client --> F[E-mail, SMS, poștă sau WhatsApp] E -- Coleg --> G[Push, e-mail sau telefon, conform preferințelor sale] F --> H[Notificări: stare pe canal] G --> H G --> I[Clopoțel în Tillor] H --> J[Vizibil și la client și pe factură] ``` - **Către un client** alegeți de obicei singur canalul, de exemplu în fereastra **Trimiteți notificarea** de pe o factură. O [automatizare](/begrippen#automatisering) poate trimite de asemenea un mesaj unui client. - **Către un coleg**, colegul respectiv stabilește singur cum îl contactează Tillor, pentru fiecare tip de notificare. Vezi [Notificările din aplicație](#meldingen-in-de-app). - **Rezultatul** îl vedeți aici, precum și la client și pe factura de care aparține mesajul. Coloana **Origine** vă duce direct acolo. ## Vizualizarea notificărilor [#notificaties-bekijken] Sus se află patru statistici: - **Total notificări**: toate încercările de trimitere - **Notificări trimise**: mesajele care au fost livrate - **Notificări eșuate**: mesajele care nu au putut fi livrate - **Notificări returnate**: mesajele care au fost returnate, în special e-mailurile Dedesubt se află patru liste: **Notificări returnate**, **Notificări în așteptare** (încă în coadă sau pe drum), **Comunicări recente** (toate stările) și **Notificări eșuate**. Cu filtrele **Tip** și **Canal** de deasupra fiecărei liste restrângeți ce vedeți. Ce tipuri există găsiți la [Tipuri de notificări](/communicatie/notificatietypes). Fiecare rând arată: | Coloană | Ce vedeți | |---|---| | **Tip** | Ce fel de mesaj este, de exemplu Factură nouă sau Alarmă la contor sau controler | | **Origine** | Factura, clientul sau plata de care aparține mesajul | | **Canal** | E-mail, SMS, Poștă, WhatsApp sau Push | | **Stare** | Starea livrării | | **Destinatar** | Adresa de e-mail, numărul de telefon, adresa poștală sau utilizatorul | | **Data** | Când a fost creată încercarea de trimitere | ### Vizualizarea detaliilor de livrare [#leveringsdetails-bekijken] Apăsați pe canalul dintr-un rând pentru a vedea ce s-a trimis exact și ce s-a întâmplat. Fereastra arată starea livrării, un eventual mesaj de eroare, destinatarul (**Către**), adresa expeditorului (**De la**) și **Subiectul** în cazul e-mailului. Mai vedeți când a fost pregătit mesajul (**Creat la**) și când a plecat cu adevărat (**Trimis la**). **Trimis de** arată utilizatorul care a pornit trimiterea sau **Sistem** dacă s-a întâmplat automat. Jos se află **Conținutul** și eventualele **Atașamente**. La e-mail și WhatsApp vedeți și **Citit la**, iar în listă o pictogramă de ochi la mesajele citite. La e-mail și SMS apare **Apăsat la** dacă clientul a apăsat pe un link. La poștă apar câmpuri suplimentare: **Referință transportator**, **Stare urmărire** și **Ultima actualizare de urmărire** (ultimul eveniment al serviciului poștal), **Cost poștal** în momentul trimiterii și, la o trimitere recomandată, eticheta **Recomandată** cu costul suplimentar și o explicație despre refacturare. ### Stări [#statussen] | Stare | Semnificație | |---|---| | În așteptare | Mesajul este în curs de procesare sau se află în coadă | | Trimis | Mesajul a fost livrat | | Eșuat | Livrarea a eșuat | | Omis | Mesajul nu a fost (sau nu mai este) trimis, de exemplu pentru că push nu era disponibil sau pentru că o scrisoare a fost anulată la serviciul poștal | | Întârziat | Mesajul este programat și pleacă mai târziu | | Returnat | Mesajul nu a putut ajunge la adresa de e-mail sau la număr | | Reclamație | Destinatarul a marcat mesajul ca spam | O scrisoare prin poștă pornește pe **În așteptare**. De îndată ce serviciul poștal confirmă că scrisoarea este pe drum sau livrată, devine **Trimis**. Poșta nelivrabilă devine **Eșuat**. O scrisoare anulată devine **Omis**. Acel rând îl găsiți mai ales sub **Comunicări recente**. ## Notificările din aplicație [#meldingen-in-de-app] Tot ce vă trimite Tillor ca și coleg, de exemplu o sarcină atribuită, o menționare într-un comentariu sau o alarmă de contor, regăsiți și în Tillor însuși. Fiecare notificare apare o singură dată, chiar dacă a fost trimisă și prin e-mail, și prin push. Nu trebuie să setați nimic pentru asta. - **Clopoțel**: în dreapta sus, în bară, și în stânga jos, în meniu (**Notificări**), se află un clopoțel cu numărul de notificări necitite. Apăsați pe el pentru cele mai recente notificări. Cu **Marcați totul ca citit** actualizați lista dintr-o dată - **Vizualizarea e-mailului**: apăsați pe o notificare pentru a deschide e-mailul primit pentru ea, cu sus un buton către pagina corespunzătoare (de exemplu **Deschide sarcina**). O notificare fără e-mail vă duce direct la acea pagină. Notificarea este apoi citită - **Card în dreapta jos**: dacă primiți o notificare cât timp aveți Tillor deschis, apare ca un card în dreapta jos, în același loc ca o conversație primită. Apăsați pe card sau închideți-l cu cruciulița. Un card închis rămâne necitit în clopoțel. Dacă vă aflați deja pe pagina la care se referă notificarea, nu primiți card - **Rămâne afișată**: notificările pentru care sunteți și sunați, de exemplu un connector care nu mai este accesibil, rămân afișate până le închideți - **Inbox**: mesajele noi din inbox își păstrează propriul card și propriul contor la **Inbox**. În clopoțel apar imediat ca citite. Același lucru se aplică rezumatului zilnic al contoarelor care necesită atenție - **Pe zile**: în listă, notificările dumneavoastră sunt grupate pe zile, cu categoria alături. Cu butoanele de sus afișați o singură categorie Notificările sunt personale: le vedeți doar pe ale dumneavoastră, pe organizație. Într-o [automatizare](/begrippen#automatisering) alegeți, la pasul **Notifică colegii**, cu **Afișează în Tillor**, dacă notificarea primește un card și un contor de necitite. Dacă opțiunea este dezactivată, notificarea apare în listă ca citită. ### Dezactivarea notificărilor [#meldingen-uitzetten] ### Deschideți contul dumneavoastră [#open-je-account] Apăsați în meniu pe numele dumneavoastră și alegeți **Cont**. ### Mergeți la Notificări [#ga-naar-meldingen] Activați sau dezactivați canalele pentru fiecare tip de notificare. În rândul **Toate notificările** dezactivați un canal dintr-o dată pentru tot. Un canal pe care îl dezactivați la **Toate notificările** rămâne dezactivat pentru fiecare notificare de dedesubt, cu excepția notificărilor care sunt trimise întotdeauna. Un tip pentru care dezactivați toate canalele nu mai apare nici în aplicație. Pentru un coleg setați acest lucru la Setări > Utilizatori, vezi [Setarea notificărilor unui coleg](/gebruikers/gebruikers-en-rechten#meldingen-van-een-collega-instellen). ## Notificări externe [#externe-notificaties] Un sistem extern conectat, de exemplu software-ul dumneavoastră de newsletter sau de rezervări, poate înregistra în Tillor e-mailurile pe care le-a trimis el însuși unui client. Le găsiți la client, pe factură și sub **Comunicări recente**, printre mesajele Tillor. Le recunoașteți după eticheta **Extern** cu numele sistemului. - Tillor nu a trimis mesajul și nu poate verifica starea. Starea provine de la sistemul extern - Notificările externe nu sunt incluse în statisticile de sus și nu apar în listele **Notificări returnate**, **Notificări în așteptare** și **Notificări eșuate** - În fereastra de detalii, imaginile sunt blocate implicit. Astfel, expeditorul nu observă că deschideți mesajul. Apăsați pe **Încarcă imaginile** pentru a le afișa totuși - Sistemul extern își poate actualiza sau șterge ulterior propriile notificări. Vedeți asta în [jurnalul de activitate](/activiteitenlog) al clientului sau al facturii Cine poate înregistra notificări externe se stabilește cu drepturile **Înregistrare notificări externe** și **Gestionare notificări externe ale altora**. Explicația tehnică pentru integratori se află la [Dezvoltatori > Notificări externe](/ontwikkelaars/externe-notificaties). ## Probleme? [#problemen] Adresa de e-mail sau numărul clientului nu există ori nu poate primi mesaje. Deschideți mesajul din lista **Notificări returnate** și citiți mesajul de eroare. Mergeți prin coloana **Origine** la profilul clientului, corectați adresa de e-mail și trimiteți din nou mesajul cu **Trimiteți notificare** de pe factură. Deschideți mesajul din **Notificări eșuate** și citiți mesajul de eroare. De obicei numărul de telefon nu este corect sau lipsește prefixul de țară. Corectați numărul în profilul clientului și trimiteți din nou. Operatorul de telefonie transmite uneori livrarea cu întârziere. După 2 zile, Tillor trece automat SMS-ul pe **Eșuat**. Deschideți fereastra de detalii pentru mesajul de eroare și verificați numărul. Deschideți mesajul din **Notificări în așteptare** sau **Notificări eșuate**. Verificați adresa poștală din profilul clientului (strada, codul poștal și localitatea) și trimiteți scrisoarea din nou cu **Trimiteți notificare** sau **Trimiteți memento** de pe factură. Scrisoarea a fost anulată la serviciul poștal. Căutați trimiterea sub **Comunicări recente** și vedeți la **Stare urmărire** ce s-a întâmplat. Trimiteți din nou doar dacă clientul încă trebuie să primească scrisoarea. Butonul apare doar pe o factură înregistrată și doar dacă clientul are o adresă de e-mail, un număr de telefon sau o adresă poștală completă. Completați una dintre aceste date în profilul clientului. Verificați la **Cont**, la **Notificări**, dacă ați dezactivat toate canalele pentru acel tip. Un tip fără canale nu mai apare nici în clopoțel. ## Termeni [#begrippen] - **[Notificare](/begrippen#notificatie)**: un mesaj pe care Tillor îl trimite unui client sau coleg, prin e-mail, SMS, poștă, WhatsApp sau push. - **Canal**: calea pe care pleacă un mesaj. O notificare poate trece prin mai multe canale. - **Livrare**: o încercare de trimitere printr-un canal, cu propria stare. - **Returnat**: mesajul s-a întors pentru că adresa sau numărul nu există. - **Alertă**: o notificare pentru un [utilizator](/begrippen#gebruiker) Tillor, vizibilă în clopoțel. - **Extern**: un mesaj pe care un sistem conectat l-a trimis el însuși și care este doar înregistrat în Tillor. Mai mulți termeni găsiți în [lista de termeni](/begrippen). ## Vezi și [#zie-ook] # Comentarii (/ro-RO/notities) Cu comentariile, colegii colaborează în jurul clienților, facturilor, rezervărilor și altor înregistrări, fără ca clientul să vadă ceva. Scrieți un comentariu pe pagina de detalii a înregistrării, menționați un coleg cu @ și fixați comentariile importante. Începeți cu [Adăugarea unui comentariu](#een-opmerking-toevoegen). - Comentariile sunt întotdeauna interne. Nu devin niciodată vizibile pentru clienți, nici pe facturi, nici în e-mailuri. - Un coleg pe care îl menționați cu @ primește o notificare. - Un comentariu rezolvat nu mai poate fi editat sau fixat. - Rezolvarea unui comentariu anulează automat fixarea unui comentariu fixat. - Ștergerea unui comentariu nu poate fi anulată. - Un comentariu fixat rămâne vizibil în partea de sus a înregistrării, fără să trebuiască să derulați până la cardul **Comentarii**. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] ```mermaid flowchart LR R[Înregistrare: client, factură, rezervare...] --> O[Comentariu] O -->|Menționare cu @| M[Notificare pentru coleg] O -->|Fixare| P[Sus în înregistrare] O -->|Memento| T[Sarcină de urmărit] O -->|Rezolvare| X[Rezolvat și restrâns] ``` Toate comentariile organizației dumneavoastră se găsesc și împreună la Comunicare > Comentarii, cu o trimitere la înregistrarea de care aparțin. ## Unde găsiți comentariile? [#waar-vind-je-opmerkingen] Pe paginile de detalii există un card **Comentarii**. În funcție de înregistrare: - Clienți > Prezentare generală sau Clienți > Comunicare: pe profilul clientului - Administrare > Facturi: pe pagina de detalii a facturii - Clienți > Rezervări: pe pagina de detalii a rezervării - Parc > Terenuri: pe pagina de detalii a terenului - Parc > Contoare: pe pagina de detalii a contorului - Administrare > Rapoarte de plată: pe raportul de plată ## Adăugarea unui comentariu [#een-opmerking-toevoegen] ### Deschideți înregistrarea [#open-het-record] Deschideți, de exemplu, un profil de client sau o factură și mergeți la cardul **Comentarii**. ### Apăsați pe Adăugați un comentariu [#klik-op-reactie-toevoegen] Scrieți comentariul în câmpul de text **Scrieți un comentariu...**. - Tastați **@** și alegeți un coleg din listă pentru a-l menționa. Acesta primește o notificare. - Tastați **/** pentru a lega un client, o factură, un contor, un teren sau o altă înregistrare. - Adăugați un atașament prin **Atașați un fișier**, prin lipire sau trăgând fișiere. ### Apăsați pe Trimiteți [#klik-op-verzenden] Comentariul dumneavoastră apare acum pe card. Cu **Răspundeți** la un comentariu existent porniți un fir de discuție. ### Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Comentariul apare pe înregistrare și în prezentarea centrală. - Un coleg menționat primește o notificare. - Dacă vreți să fiți sigur că cineva răspunde, apăsați pe ceasul de lângă comentariu (**Setați un memento de urmărire**). Tillor creează atunci o sarcină, ca să puteți verifica ulterior dacă a fost preluat. ## Gestionarea comentariilor [#opmerkingen-beheren] La fiecare comentariu se află butoane de acțiune în dreapta sus, în măsura în care aveți drepturile. ### Editarea sau ștergerea unui comentariu [#opmerking-bewerken-of-verwijderen] - **Editați**: modificați textul. Este posibil la propriile comentarii, nu și la cele rezolvate. - **Eliminați**: eliminați comentariul, după confirmare. Acest lucru nu poate fi anulat. ### Fixarea unui comentariu [#opmerking-vastzetten] Vreți să păstrați vizibil în partea de sus un comentariu important? 1. Apăsați pe pictograma de pin (**Fixați**). 2. Comentariul primește eticheta **Fixat** și apare în fruntea listei. 3. Apăsați din nou pe pictograma de pin pentru a anula fixarea (**Anulați fixarea**). Comentariile rezolvate nu pot fi fixate. #### Unde apare un comentariu fixat [#waar-staat-een-vastgezette-opmerking] - Pe un profil de client apare direct sub datele clientului, sus, deasupra filelor. - Pe o factură, rezervare, teren sau contor apare în cardul **Dintr-o privire**, sus, împreună cu sarcinile deschise. Acel card se restrânge dacă nu conține nimic. ### Marcarea unui comentariu ca rezolvat [#opmerking-als-opgelost-markeren] Pentru discuțiile care s-au încheiat: 1. Apăsați pe bifă (**Rezolvați**). 2. Comentariul este marcat ca **Rezolvat** și dispare din lista deschisă. 3. Pe o pagină de detalii, comentariile rezolvate apar jos, într-o secțiune care se poate restrânge. 4. Apăsați din nou pe bifă pentru a anula (**Redeschideți**). ### Descărcarea comentariilor ca PDF [#opmerkingen-als-pdf-downloaden] Cu pictograma de imprimare descărcați toate comentariile unei înregistrări ca PDF (**Descărcați toate comentariile ca PDF**) sau o singură discuție (**Descărcați acest fir de comentarii ca PDF**). ## Prezentarea tuturor comentariilor [#overzicht-van-alle-opmerkingen] Mergeți la Comunicare > Comentarii pentru o prezentare centrală. Sus vedeți statistici (total, deschise, rezolvate și fixate). Dedesubt: - **Comentarii deschise**: comentariile care sunt încă deschise. - **Comentarii rezolvate**: comentarii încheiate, pentru referință. Fiecare comentariu arată **Origine** (de exemplu client sau factură), ca să puteți merge direct la înregistrare. ### Filtrare [#filteren] - **Ultima săptămână**, **Ultima lună** sau **Toate**: filtrați după data creării. - **Afișați doar mențiunile**: doar comentariile în care sunteți menționat. - Căutați cu **Caută comentarii...** sau filtrați după autor, persoană menționată, rezolvat, fixat și comentariu principal sau răspuns. ## Probleme? [#problemen] Comentariul dumneavoastră nu a fost salvat. Verificați că câmpul de text nu este gol și încercați din nou **Trimiteți**. Dacă apare **Niciun utilizator găsit**, încercați un alt nume sau o adresă de e-mail. În listă apar doar utilizatorii organizației dumneavoastră. Un comentariu rezolvat este blocat. Apăsați mai întâi pe bifă pentru a-l deschide din nou (**Redeschideți**). Editarea este posibilă doar la propriile comentarii. Rezolvarea unui comentariu anulează fixarea lui. Redeschideți-l cu bifa și fixați-l apoi din nou. Modificarea nu a fost aplicată. Reîncărcați pagina și încercați din nou. Încercați din nou. Dacă PDF-ul nu apare, browserul dumneavoastră blochează o fereastră pop-up. Permiteți ferestrele pop-up pentru acest site. ## Termeni [#begrippen] - **Comentariu**: un text intern pe o înregistrare, eventual cu atașamente. Vezi [comentariu](/begrippen#opmerking). - **Menționare**: un coleg pe care îl numiți cu @. Acesta primește o notificare. - **Fixare**: păstrarea unui comentariu în partea de sus a înregistrării. - **Rezolvat**: un comentariu încheiat care dispare din lista deschisă. - **Origine**: înregistrarea de care aparține un comentariu. - **Sarcină**: un to-do care poate rezulta dintr-un memento la un comentariu. Vezi [sarcină](/begrippen#taak). ## Vezi și [#zie-ook] # Parc (/ro-RO/park) La **Parc** găsiți tot ce ține de locul fizic: harta cu ocuparea de astăzi, lista terenurilor, contoarele și dulapurile de contoare, precum și vremea. Începeți cu [Terenurile](/terreinen), deoarece o ocupare, un contor și un tarif depind toate de ele. ## Ce găsiți unde? [#wat-vind-je-waar] | Meniu | Pentru ce | Explicații | |---|---|---| | Parc > Hartă | Harta parcului dumneavoastră, colorată pe zile după ocupare | [Harta](/kaart) | | Parc > Terenuri | Toate terenurile, tariful lor și contoarele de pe ele | [Terenuri](/terreinen) | | Parc > Contoare | Toate contoarele de apă, gaz și electricitate | [Gestionarea contoarelor](/meterbeheer) | | Parc > Dulapuri de contoare | Dulapurile în care sunt montate contoare și ce contoare se află în ele | Gestionați dulapurile de contoare și contoarele atribuite lor | | Parc > Vreme | Vremea pe zile la locația parcului dumneavoastră | [Vremea](/weer) | ## Dulapuri de contoare [#meterkasten] La Parc > Dulapuri de contoare gestionați dulapurile de contoare și contoarele atribuite lor. Cu **Dulap de contoare nou** adăugați un dulap, cu un nume și o descriere. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] **Terenul** este punctul de ancorare. La un teren atașați contoarele. Un client ajunge pe un teren printr-o **ocupare**, iar un oaspete pentru o ședere scurtă printr-o **rezervare**. Consumul contoarelor de pe teren merge către clientul cu ocuparea activă. ```mermaid flowchart LR M[Contoare] --> T[Teren] T --> K[Hartă] B[Ocupare
client pe o perioadă mai lungă] --> T R[Rezervare
ședere cu dată de check-in și check-out] --> T T --> V[Tarif și consum pe factură] ``` Un teren primește culoare pe hartă abia după ce i-ați desenat limita. Vezi [Desenarea limitelor terenurilor](/kaart#terreingrenzen-intekenen). - Un teren are cel mult o ocupare activă în același timp. - Un teren nou nu este implicit rezervabil. Bifați **Rezervabil** dacă clienții îl pot rezerva online. - Suprafața nu o puteți introduce de mână. Tillor o calculează de îndată ce desenați terenul pe hartă și o folosește pentru tarif. - Harta se deschide întotdeauna pe ziua de astăzi. Celelalte setări ale hărții (stil, etichete, straturi) sunt păstrate. - Etichetele cu nopți și plecare apar abia de la nivelul de zoom 17,5. - Vremea este preluată în fiecare noapte pentru centrul hărții organizației dumneavoastră. ## Termeni [#begrippen] - **Teren**: un loc din parcul dumneavoastră cu un nume, un tarif și eventual contoare. Vezi [Termeni](/begrippen#terrein). - **Hartă**: harta interactivă de la Parc. - **Dulap de contoare**: un dulap cu contoare. Vezi [Termeni](/begrippen#meterkast). - **Ocupare**: un client pe un teren pentru o perioadă. Vezi [Termeni](/begrippen#bezetting). - **Rezervabil**: un teren pe care clienții îl pot rezerva online. ## Vezi și [#zie-ook] # Setări de imprimare (/ro-RO/printer/afdrukinstellingen) Aceasta este lista tuturor setărilor de la Setări > Imprimare. Setările se aplică întregii organizații. Configurarea pas cu pas o găsiți la [Configurarea imprimantelor](/printer/printers-instellen). | Setare | Semnificație | | ---------- | --------- | | **Imprimare PDF** | Activează imprimarea facturilor și a documentelor pe imprimante fizice. Fără aceasta, Tillor nu imprimă nimic. | | **Imprimare automată a facturii la plată** | Facturile plătite ajung automat în coada imprimantei. Pentru fiecare tip de plată alegeți dacă se întâmplă imediat, la următoarea oră limită sau deloc. | | **Imprimare automată a documentului de identitate la asociere** | Dacă asociați o scanare de identitate unui client sau contact (și la crearea unui client dintr-o scanare), rezumatul ajunge ca PDF la imprimanta A4. Necesită: **Imprimare PDF** activată și o **IP imprimantă PDF** completată. | | **IP imprimantă PDF** | Adresa de rețea a imprimantei A4 pentru facturi și documente, de exemplu `192.168.1.100`. | | **IP imprimantă termică** | Adresa de rețea a imprimantei de bonuri, de exemplu `192.168.1.101`. | | **Lățimea hârtiei pentru bonuri** | Lățimea rolei de bonuri: **80 mm** (implicit) sau **58 mm**. Tillor adaptează la aceasta lungimea rândurilor și logo-ul bonului. | | **IP imprimantă de etichete** | Adresa de rețea a imprimantei de etichete, de exemplu `192.168.1.102`. | | **Program de prag de imprimare** | Pentru fiecare zi a săptămânii unul sau mai multe momente, până la minut, de exemplu 09:00 și 13:30. Gol înseamnă că în ziua respectivă nu există momente limită. | | **Momentul imprimării automate după tipul de plată** | Pentru fiecare canal (terminal/recepție, manual, online, mandat, transfer): **Imprimați imediat**, **Următoarea oră de prag** sau **Nu imprimați automat**. Implicit, terminalul și manualul imprimă imediat. Online, mandat și transfer așteaptă ora limită. | | **Pauză tipărire până la** | Ține coada de imprimare până la momentul ales. **Șterge pauza** elimină pauza. Puteți pune în pauză și din [coada de imprimare](/printer/printwachtrij). | Apăsați jos pe **Salvați setările** pentru a aplica modificările. Se aplică imediat. Imprimantele trebuie să se afle în aceeași rețea cu connectorul și să aibă o adresă IP fixă. Dați imprimantei o adresă fixă în router, altfel adresa se poate schimba. ## Vezi și [#zie-ook] # Imprimarea unei facturi sau a unui bon (/ro-RO/printer/documenten-afdrukken) Imprimați o factură de pe pagina facturii, pe imprimanta A4 sau pe imprimanta de bonuri. La plăți, Tillor poate imprima bonuri și singur. Puteți afișa o factură și pe tabletă, fără a o imprima. Înainte de a începe: - Imprimantele sunt configurate, vezi [Configurarea imprimantelor](/printer/printers-instellen). - Există un connector activ pentru organizația dumneavoastră. Fără el, opțiunile **Trimiteți la imprimanta A4** și **Trimiteți la imprimanta de bonuri** nu apar în meniu. ## Imprimarea unei facturi [#een-factuur-afdrukken] ### Deschideți factura [#open-de-factuur] Mergeți la Administrare > Facturi și deschideți factura. ### Alegeți cum imprimați [#kies-hoe-je-afdrukt] Apăsați pe **Imprimați**. Browserul dumneavoastră își deschide propria fereastră de imprimare. Apăsați pe săgeata de lângă **Imprimați** și alegeți **Trimiteți la imprimanta A4** sau **Trimiteți la imprimanta de bonuri**. Tillor pune o comandă în coada de imprimare. ## Bonuri după o plată [#bonnen-na-een-betaling] Activați în Setări > Imprimare **Imprimare automată a facturii la plată**. Facturile plătite ajung atunci la imprimanta A4 și eventual la imprimanta de bonuri, imediat sau la următoarea oră limită, în funcție de canalul de plată. Pentru fiecare produs puteți activa în plus **Imprimare termică** și **Imprimare A4** și puteți seta numărul de copii pe pagina produsului. Aceste copii ies suplimentar de îndată ce produsul respectiv se află pe o factură plătită. ## Afișarea unei facturi pe tabletă [#een-factuur-op-de-tablet-tonen] Vreți să arătați o factură fără a o imprima? Alegeți în meniul cu cele trei puncte de la factură **Previzualizare pe iPad** sau apăsați în fereastra de plată a unei plăți în numerar pe **Previzualizare pe iPad**. PDF-ul apare pe tableta asociată, iar Tillor anunță **PDF trimis pe iPad**. Vezi [Tablete și chioșcuri](/mobiele-app/tablets-en-kiosken). ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - O comandă către o imprimantă apare în [coada de imprimare](/printer/printwachtrij) cu o stare. La momentul imprimării ajunge la imprimantă. - Dacă imprimarea eșuează, în cele mai multe cazuri Tillor încearcă automat din nou. Apoi comanda rămâne pe **Eșuat** până o reîncercați sau o anulați dumneavoastră. - Factura în sine nu se schimbă: imprimarea nu înregistrează și nu trimite nimic. ## Probleme? [#problemen] Nu există un connector activ pentru organizația dumneavoastră sau **Imprimare PDF** este dezactivată. Vezi [Configurarea imprimantelor](/printer/printers-instellen). Mesajul este **Trimiterea documentului la imprimantă a eșuat.** Deschideți [coada de imprimare](/printer/printwachtrij) pentru motiv la **Ultima eroare**, de exemplu o imprimantă offline sau fără hârtie. PDF-ul nu a putut fi descărcat. Încercați din nou. PDF-ul nu a putut ajunge pe tabletă. Atunci nu este nicio tabletă accesibilă. Deschideți aplicația Tillor pe tabletă și verificați dacă la Setări > Tablete și chioșcuri este **Conectat**. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/printer) Cu legătura cu imprimanta imprimați facturi, bonuri și etichete direct din Tillor pe o imprimantă din parcul dumneavoastră, fără să descărcați mai întâi documentul. Configurați imprimantele o singură dată la [Configurarea imprimantelor](/printer/printers-instellen), iar apoi imprimați cu un clic sau lăsați Tillor să o facă la o plată. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Tillor nu trimite o comandă de imprimare direct la imprimanta dumneavoastră. Comanda ajunge mai întâi în coada de imprimare. La momentul imprimării, Tillor o predă connectorului, un mic program de pe un calculator din rețeaua dumneavoastră, iar acesta pune imprimanta să imprime. ```mermaid flowchart LR A[Imprimați o factură sau
intră o plată] --> B[Coada de imprimare în Tillor] B -- imediat sau la momentul imprimării --> C[Connector în rețeaua dumneavoastră] C --> D[Imprimantă] B -- eșuează --> E[Tillor încearcă din nou] ``` De aceea connectorul trebuie să fie online, iar imprimanta accesibilă în aceeași rețea. Fără un connector activ nu vedeți opțiunile de trimitere către o imprimantă. Vezi [Connector](/connector). - Există trei tipuri de imprimante: o imprimantă A4 pentru facturi și documente, o imprimantă termică pentru bonuri de casă și o imprimantă de etichete. - Lățimea rolei de bonuri este de 80 mm (implicit) sau 58 mm. - O comandă eșuată este reîncercată automat de Tillor după 10 secunde, 5 minute și 15 minute. Apoi ajunge pe **Eșuat**. Dacă hârtia s-a terminat sau imprimanta este offline, ajunge imediat pe **Eșuat**. - În fiecare luni dimineață, Tillor încearcă încă o dată toate comenzile care sunt pe **Eșuat**. - Imprimarea poate fi pusă în pauză pentru 15 minute, 1 oră, 4 ore, 6 ore, 1 zi sau până o reluați dumneavoastră. - Implicit, plățile cu terminalul și plățile manuale se imprimă imediat. Plățile online, mandatele și transferurile așteaptă următorul moment de imprimare. ## Ce doriți să faceți? [#wat-wil-je-doen] ## Termeni [#begrippen] - **Coadă de imprimare**: lista comenzilor de imprimare pe care Tillor trebuie încă să le trimită. - **Moment de imprimare**: un moment fix într-o zi a săptămânii în care Tillor trimite comenzile grupate, numit și oră limită. - **Imprimantă termică**: imprimanta pentru bonuri de casă. - **Connector**: programul din rețeaua dumneavoastră care comandă imprimanta. Vezi [Connector](/connector). - **Adresă IP**: adresa de rețea a unei imprimante, de exemplu `192.168.1.100`. Mai multe explicații găsiți în [lista de termeni](/begrippen). # Configurarea imprimantelor (/ro-RO/printer/printers-instellen) Pentru ca Tillor să poată imprima, trebuie să știe ce imprimante aveți și unde se află în rețeaua dumneavoastră. Setați acest lucru o singură dată pentru întreaga organizație. Apoi puteți [imprima documente](/printer/documenten-afdrukken). Fiecare setare, cu explicații, se află în [Setări de imprimare](/printer/afdrukinstellingen). Înainte de a începe: - Connectorul rulează pe un calculator din aceeași rețea cu imprimantele. Vezi [Connector](/connector). Dacă nu este activ, nu veți vedea ulterior opțiuni de trimitere către o imprimantă. - Cunoașteți adresa IP a fiecărei imprimante, adică adresa de rețea, de exemplu `192.168.1.100`. Dați imprimantei o adresă fixă în router, altfel adresa se poate schimba și imprimarea se oprește. ## Adăugarea unei imprimante [#een-printer-toevoegen] ### Deschideți Imprimare [#open-afdrukken] Mergeți la Setări > Imprimare. ### Activați Imprimare PDF [#zet-pdf-afdrukken-aan] Fără acest comutator, Tillor nu imprimă nimic. ### Completați adresele imprimantelor [#vul-de-printeradressen-in] Sub **Adrese IP ale imprimantelor** completați adresa pentru **IP imprimantă PDF** (A4), **IP imprimantă termică** (bonuri) și **IP imprimantă de etichete**. Lăsați gol ce nu aveți. La **Lățimea hârtiei pentru bonuri** alegeți 80 mm sau 58 mm, potrivit rolei de bonuri. ### Alegeți când se imprimă [#kies-wanneer-er-afgedrukt-wordt] La **Program de prag de imprimare** setați pentru fiecare zi a săptămânii unul sau mai multe momente (de exemplu 09:00 și 13:30). La **Momentul imprimării automate după tipul de plată** alegeți pentru fiecare canal de plată: **Imprimați imediat**, **Următoarea oră de prag** sau **Nu imprimați automat**. ### Apăsați pe Salvați setările [#klik-op-instellingen-opslaan] Setările se aplică imediat pentru întreaga organizație. ## Imprimare automată la plată [#automatisch-afdrukken-bij-betaling] Dacă vreți ca o factură plătită să ajungă pe hârtie fără intervenție, activați **Imprimare automată a facturii la plată**. Pentru fiecare canal de plată stabiliți cu momentul de imprimare de mai sus dacă se întâmplă imediat sau la următoarea oră limită. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - La fiecare imprimare, Tillor pune o comandă în [coada de imprimare](/printer/printwachtrij), pe care connectorul o predă imprimantei. - Facturile plătite ajung automat la imprimanta A4 și eventual la imprimanta de bonuri, dacă ați activat acest lucru. - Dacă alegeți pentru un canal o oră limită, Tillor grupează comenzile până la acel moment. Dacă în ziua respectivă nu există niciun moment de imprimare, nu există nici moment limită. - Încercați cu o factură, vezi [Imprimarea documentelor](/printer/documenten-afdrukken). ## Probleme? [#problemen] Opțiunile apar doar dacă **Imprimare PDF** este activată și există un connector activ pentru organizația dumneavoastră. Verificați ambele. Imprimanta este oprită, nu are conexiune la rețea sau adresa IP nu mai este corectă. Verificați adresa la Setări > Imprimare și dacă connectorul este online. Reumpleți imprimanta și reîncercați comanda din coada de imprimare. Connectorul nu a primit răspuns de la imprimantă. Verificați dacă connectorul rulează și dacă imprimanta este accesibilă. Vedeți în coada de imprimare dacă comanda a fost reîncercată. Verificați la **Momentul imprimării automate după tipul de plată** dacă acel canal este pe **Următoarea oră de prag**. Atunci bonul așteaptă până la momentul ales la **Program de prag de imprimare**. Dacă ați pus imprimarea în pauză, vedeți în [coada de imprimare](/printer/printwachtrij). Verificați **Lățimea hârtiei pentru bonuri**: 80 mm sau 58 mm. ## Vezi și [#zie-ook] # Gestionarea cozii de imprimare (/ro-RO/printer/printwachtrij) În coada de imprimare vedeți ce comenzi de imprimare așteaptă, sunt în curs sau au eșuat. Aici puneți imprimarea în pauză, împingeți comenzile mai departe și rezolvați comenzile care nu au reușit. Lista se reîmprospătează singură de îndată ce o comandă își schimbă starea. Înainte de a începe: imprimantele sunt configurate, vezi [Configurarea imprimantelor](/printer/printers-instellen). ## Vizualizarea cozii [#de-wachtrij-bekijken] Mergeți la Administrare > Coadă de imprimare. Listele sunt: - **În coadă, programate și în procesare**: comenzi care sunt încă în curs de procesare. O comandă cu starea **Programat pentru mai târziu** așteaptă ora **Programat** și apoi se imprimă singură, cu excepția cazului în care imprimarea este în pauză. - **Eșuat**: comenzi care au eșuat definitiv, cu motivul la **Ultima eroare**. - **Toate lucrările de imprimare**. ## Punerea imprimării în pauză [#het-afdrukken-pauzeren] ### Alegeți Întrerupeți imprimarea [#kies-afdrukken-pauzeren] Apăsați pe **Întrerupeți imprimarea** și alegeți o durată: 15 minute, 1 oră, 4 ore, 6 ore, 1 zi sau **Până când reactivăm**. ### Reluați când sunteți gata [#hervat-wanneer-je-klaar-bent] Apăsați pe **Reluați imprimarea**. Altfel, se reia singură după durata aleasă. În timpul pauzei așteaptă atât comenzile directe, cât și cele programate. Comenzile noi rămân în coadă. Lângă pictograma pauzei se vede până când durează. Puteți seta pauza și la **Pauză tipărire până la** în Setări > Imprimare. ## Împingerea sau remedierea comenzilor [#opdrachten-doorzetten-of-herstellen] Apăsați în bara de instrumente a listei pe **Procesați coada**. Comenzile programate sunt atunci procesate imediat. Butonul este gri cât timp imprimarea este în pauză, cu sfatul **Reluați imprimarea pentru a procesa coada**. Deschideți meniul cu cele trei puncte de pe rând și alegeți **Reîncercați** pentru a o trimite încă o dată, sau **Anulați**. O comandă anulată primește starea **Anulat** și nu se mai imprimă. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - O comandă eșuată este reîncercată de Tillor singur după 10 secunde, apoi după 5 minute și apoi după 15 minute. Dacă nici atunci nu reușește, ajunge pe **Eșuat**. - Erorile pe care o nouă încercare nu le rezolvă nu sunt reîncercate de Tillor: hârtie, toner sau cerneală epuizate, o imprimantă offline sau în pauză ori o coadă a imprimantei dezactivată. Acestea ajung imediat pe **Eșuat**. - În fiecare luni dimineață, Tillor pregătește încă o dată toate comenzile care sunt pe **Eșuat**. - O comandă care rămâne pe **Eșuat** nu face nimic până o reîncercați sau o anulați dumneavoastră. ## Probleme? [#problemen] Porniți imprimanta, verificați conexiunea la rețea și dacă connectorul este online. Apoi alegeți **Reîncercați**. Reumpleți imprimanta și alegeți **Reîncercați**. Imprimanta însăși este în pauză, de exemplu din cauza unei blocări a hârtiei. Remediați la imprimantă și încercați din nou. Comanda a fost trimisă la imprimantă, dar nu a fost finalizată. Verificați dacă a ieșit deja ceva înainte de a reîncerca, altfel va ieși dublu. Coada de pe imprimanta însăși este oprită. Porniți-o la imprimantă și încercați din nou. Imprimarea este în pauză. Alegeți **Reluați imprimarea**. Coada nu a putut fi procesată. Încercați încă o dată. Dacă nu reușește, verificați dacă connectorul este online. Încercați din nou sau anulați comanda și imprimați documentul din nou de pe factură. ## Vezi și [#zie-ook] # Asocierea acțiunilor la un produs (/ro-RO/producten/acties-instellen) Cu acțiunile automatizați ce se întâmplă după înregistrarea sau plata unei facturi: reîncărcarea unei etichete NFC, prelungirea unei ocupări, imprimarea unui bon sau crearea unei metode de acces. Un produs poate avea mai multe acțiuni în același timp. Înainte de a începe: produsul există deja. Vezi [Crearea unui produs](/producten/product-aanmaken). O schemă a ceea ce face Tillor și când găsiți la [Cum se leagă toate acestea?](/producten#hoe-hangt-dit-samen). ### Deschideți produsul [#open-het-product] Mergeți la Administrare > Produse și deschideți produsul. ### Bifați acțiunile [#vink-de-acties-aan] Căutați în dreapta cardul **Acțiuni de linie de factură**. Bifați acțiunile dorite. La unele acțiuni apar apoi câmpuri suplimentare. Ce face fiecare acțiune și ce câmpuri îi aparțin citiți la [Acțiuni de produs](/producten/productacties). Lăsați toate căsuțele nebifate pentru un tarif obișnuit, fără urmărire. ### Salvați [#sla-op] Apăsați pe **Salvați** în partea de jos a cardului **Linii de factură suplimentare**. Acțiunile se află acum pe produs și sunt preluate la liniile de factură noi. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] Când alegeți produsul pe o linie de factură, Tillor preia acțiunile cu valorile setate pe acea linie. Ce acțiune face ce și când depinde de tip. Unele acțiuni se execută la înregistrarea facturii, majoritatea la plată. | Moment | Acțiuni | |--------|--------| | La înregistrare | **Prelungiți perioada de ocupare** (modifică **Facturat până la**), **Solicitați date de contact** (înregistrarea este posibilă abia după completarea câmpurilor obligatorii), crearea unei rezervări la **Perioadă** cu **Cere parcela** | | La plată | **Reîncărcați eticheta NFC**, **Perioadă**, **Prelungiți perioada de ocupare** (modifică **Plătit până la**), **Prelungiți metoda de acces**, **Creați metodă de acces**, **Imprimare termică** și **Imprimare A4** | | Fără efect secundar | **Consum contor** (stabilește tariful), **Afișează alertă** (afișează un text) | | Blochează înregistrarea | **Împiedicați înregistrarea** | În lista de produse vedeți în coloana **Acțiune** ce acțiuni are un produs. O modificare a acțiunilor unui produs se aplică liniilor de factură pe care le adăugați după aceea. ## Probleme? [#problemen] Câmpurile suplimentare apar abia după ce bifați acțiunea corespunzătoare. **Înregistrare sosire la rezervare** și **Înregistrează sosirea la plată** le vedeți doar dacă **Cere parcela** este activată. Verificați dacă acțiunea este completată pe linia de factură însăși. La **Creați metodă de acces** trebuie, de exemplu, să fie ales un tip. Fără tip, Tillor nu creează nimic, iar la o linie care nu este opțională nu puteți înregistra factura. ## Vezi și [#zie-ook] # Setarea liniilor de factură suplimentare (/ro-RO/producten/bundel-instellen) Unele produse sunt mai mult decât o singură linie pe o factură: Taxa de staționare cu suplimente, o explicație, închirierea contorului sau etichete NFC. Pentru asta setați pe produsul principal un pachet de linii suplimentare. Dacă cineva alege acel produs ca linie principală pe o factură ciornă, Tillor adaugă liniile copil sub linia principală, în ordinea pe care o setați. ```mermaid flowchart TD hoofd[Linie principală: produs cu pachet] --> stap1[Pasul 1 din pachet] stap1 --> kind1[Linie copil pe factură] hoofd --> stap2[Pasul 2 din pachet] stap2 --> kind2[Linie copil pe factură] ``` ## Crearea sau editarea unui pachet [#een-bundel-aanmaken-of-bewerken] ### Deschideți produsul principal [#open-het-hoofdproduct] Mergeți la Administrare > Produse și deschideți produsul, de exemplu Taxa de staționare. ### Porniți pachetul [#start-de-bundel] Căutați cardul **Linii de factură suplimentare** sub **General**. Dacă produsul nu are încă pachet, apăsați pe **Configurați pachetul**. ### Adăugați pași [#voeg-stappen-toe] Apăsați pe **Pas de produs** pentru o linie cu un produs și o sumă sau pe **Pas de informații** pentru o linie cu text. Completați câmpurile fiecărui pas. Ce face fiecare câmp găsiți la [Pașii pachetului](/producten/bundel-velden). ### Puneți pașii în ordinea corectă [#zet-de-stappen-in-de-juiste-volgorde] Cu săgețile **Mutați pasul în sus** și **Mutați pasul în jos** stabiliți ordinea pe factură. **Eliminați pasul** scoate un pas. ### Salvați [#sla-op] Apăsați jos pe card pe **Salvați**. **Salvați** sub **Linii de factură suplimentare** salvează întreaga pagină a produsului, inclusiv modificările din **General** și **Acțiuni de linie de factură**. Fiecare pas de produs trebuie să aibă un produs, iar fiecare pas de informații un text. Altfel, Tillor nu păstrează pachetul. Cu **Eliminați întregul pachet** dezactivați pachetul. Un pachet poate avea cel mult 40 de pași. ## Exemplu: un pachet Taxa de staționare [#voorbeeld-een-staangeld-bundel] Un pachet tipic pentru Taxa de staționare are cinci pași. Pașii cu o formulă lipesc formula din [Pașii pachetului](/producten/bundel-velden#voorbeelden) în câmpul **Formulă**. ### Explicație [#toelichting] Un **Pas de informații** cu textul „Taxele turistice, comunale și provinciale incluse”. ### Primul NFC inclus [#eerste-nfc-inbegrepen] Un **Pas de produs** cu produsul-supliment NFC și o formulă care returnează prima etichetă NFC activă a clientului cu cantitatea 0 și prețul 0. Activați **Înmulțiți cu cantitatea rândului ancoră** și **O dată per factură**, alegeți la **Stilul liniei** **INFO** și completați la **Zile suplimentare după sfârșitul liniei principale (metode de acces)**, de exemplu, `20`. ### Etichete NFC suplimentare [#extra-nfc-tags] Același pas de produs cu o formulă care returnează a doua, a treia etc. etichetă NFC activă la tariful produsului, cu aceleași opțiuni de scalare și prelungire. Activați și aici **O dată per factură**. ### Închirierea contorului [#meterhuur] Un **Pas de produs** cu produsul de închiriere a contorului și o formulă care alege din `{meters}` contoarele care contează, de exemplu doar contoarele de electricitate ICY cu supply activat, și returnează pentru fiecare contor o linie cu numele contorului în descriere. ### Câini [#honden] Un **Pas de produs** cu produsul pentru câini și o formulă care citește numărul de câini dintr-un câmp propriu al clientului și returnează o linie cu acel număr sau nicio linie dacă nu sunt câini. ## Prelungirea NFC prin pachet [#nfc-verlengen-via-de-bundel] Pentru Taxa de staționare cu etichete NFC, trei lucruri merg împreună: 1. Pe produsul principal se află acțiunea **Prelungiți perioada de ocupare**, iar pe linia de factură este ales un teren. 2. În pachet se află cel puțin un pas cu **Zile suplimentare după sfârșitul liniei principale (metode de acces)** completat, de exemplu pașii NFC din exemplul de mai sus. 3. Pe produsul principal se află acțiunea **Prelungiți metoda de acces** cu tipurile dorite, stările și eventual o zi a săptămânii și o oră de încheiere. La plata unei linii dintr-un astfel de pas, Tillor setează valabilitatea metodelor de acces ale clientului la data de încheiere a liniei principale Taxa de staționare plus zilele suplimentare. Implicit, aceasta durează până la 23:59 în fusul orar al organizației sau până la ziua săptămânii și ora pe care le-ați setat la **Prelungiți metoda de acces**. Dacă linia principală nu are dată de încheiere, Tillor nu prelungește nimic. **Zile suplimentare după sfârșitul liniei principale (metode de acces)** funcționează doar dacă produsul are **Prelungiți perioada de ocupare** ca acțiune. Dacă sub câmp apare mesajul că acest lucru este necesar, bifați în dreapta la **Acțiuni de linie de factură** **Prelungiți perioada de ocupare**. ## Ce se întâmplă pe o factură ciornă? [#wat-gebeurt-er-op-een-conceptfactuur] - Liniile copil apar sub linia principală abia după ce ați ales un teren la **Prelungiți perioada de ocupare**. - Tillor reconstruiește liniile copil dacă modificați pe linia principală produsul, cantitatea sau terenul. În alte cazuri, liniile copil modificate manual rămân. Dacă eliminați, de exemplu, o linie de contor, aceasta nu revine singură. - În editorul de facturi vedeți o previzualizare a liniilor copil, inclusiv efectul **O dată per factură**, astfel încât să corespundă cu ce rămâne după salvare. - O linie principală o mutați cu săgețile doar ca bloc întreg. Liniile copil le mutați doar în cadrul pachetului lor. Dacă ștergeți linia principală, dispar și liniile copil. - Pe PDF, liniile copil obișnuite primesc adesea un **↳** înaintea descrierii. Liniile de informații apar ca linii gri fără sume. - Pașii fără produs ales sunt omiși de Tillor. Un produs care între timp a fost șters sau lipsește nu generează deci nicio linie. ## Probleme? [#problemen] La un produs principal cu **Prelungiți perioada de ocupare** trebuie să alegeți mai întâi un teren pe linia principală. Pentru prelungirea NFC la plată, linia principală are nevoie în plus de o dată de încheiere. Dacă pe o factură există două sau mai multe linii principale cu un pachet, fiecare linie principală primește liniile pachetului. Activați **O dată per factură** la pașii care trebuie să apară o singură dată. Pasul aparține atunci doar primei linii principale în ordinea facturii. Verificați dacă fiecare pas de produs are un **Produs** și fiecare pas de informații un **Textul liniei de informații**. ## Vezi și [#zie-ook] # JSON pentru pachet (/ro-RO/producten/bundel-json) Cardul **Linii de factură suplimentare** salvează un pachet ca JSON pe produs, sub cheia `invoiceBundle`. Pentru importuri folosiți aceeași structură. Pentru utilizarea obișnuită nu aveți nevoie de această pagină: câmpurile și explicațiile lor se află la [Pașii pachetului](/producten/bundel-velden). ## Structură [#structuur] | Câmp | Semnificație | |------|-----------| | `invoiceBundle.version` | Întotdeauna `1` | | `invoiceBundle.steps` | Lista pașilor, cel mult 40. Ordinea este ordinea liniilor secundare de pe factură | Fiecare pas este un pas de produs sau un pas de informare. ### Pas de produs [#productstap] | Câmp | Semnificație | |------|-----------| | `productId` | Un produs existent în organizația dumneavoastră. Obligatoriu | | `quantity` | Număr mai mare decât 0, implicit `1`. Cantitatea liniei fără formulă sau dacă formula returnează `true` | | `quantityScale` | Opțional. `"anchor_line_quantity"` înmulțește fiecare cantitate calculată cu cantitatea liniei principale | | `description` | Opțional. Text pentru linia de factură în locul numelui produsului; o formulă poate da fiecărei linii propriul `description` | | `style` | Opțional. `DEFAULT` sau `INFO` | | `billOncePerInvoice` | Opțional. `true` păstrează pasul, atunci când pe o factură sunt mai multe linii principale, doar la prima linie principală | | `extendAccessMethod` | Opțional. `{ "daysAfterPeriodEnd": }`, consultați [Prelungirea NFC](#nfc-verlenging) | | `formula` | Opțional. TypeScript care stabilește ce linii produce pasul, consultați [Formula](#formule) | ### Pas de informare [#inforestap] ```json { "stepKind": "info", "description": "Inclusief toeristen-, gemeente- en provincietaksen" } ``` `description` este obligatoriu, iar un pas de informare nu are `productId`. Cu `style` (`DEFAULT` sau `INFO`) alegeți stilul liniei, implicit este `INFO`. O `formula` care returnează `false` omite linia de informare. ## Formula [#formule] `formula` este TypeScript care, la salvarea unei facturi, returnează `true` (o linie cu `quantity`), `false` (nicio linie), un număr (cantitatea) sau o listă de linii `{ "quantity", "description", "unitPrice", "accessMethodValue" }`. Ce câmpuri și liste puteți citi și ce face fiecare formă se află la [Formula pe pas](/producten/bundel-velden#formule-per-stap). O formulă care nu se compilează este refuzată la salvarea produsului. În JSON, formula este un singur șir de caractere, cu `\n` pentru sfârșiturile de rând. ```json "formula": "return {customer.customFields.exemptFromSurcharges} !== true;" ``` ## Prelungirea NFC [#nfc-verlenging] Are sens doar dacă produsul principal are ca acțiune **Prelungiți perioada de ocupare**. ```json "extendAccessMethod": { "daysAfterPeriodEnd": 20 } ``` La plata unei linii dintr-un astfel de pas, Tillor setează valabilitatea metodelor de acces ale clientului la data de sfârșit a liniei principale plus `daysAfterPeriodEnd` zile calendaristice. Implicit, valabilitatea durează până la 23:59 în fusul orar al organizației sau până la ziua din săptămână și ora din **Prelungiți metoda de acces** de pe produsul principal. Tot acolo stabiliți ce tipuri și ce stări se iau în calcul. Fără dată de sfârșit pe linia principală nu se întâmplă nimic. Cu **Nu scurtați la prelungire** activat, Tillor sare peste metodele a căror valabilitate se află deja la sau după noua dată. Un `accessMethodValue` pe linie indică metoda acelei linii; prelungirea în sine urmează setările produsului principal. După o prelungire reușită, pe cronologia facturii apare o linie care trimite la plată. ## Exemplu: explicație, supliment NFC, închiriere contor și câini [#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})` }];" } ] } } ``` Verificați că toate valorile `productId` de la pașii de produs există în catalogul dumneavoastră. Pașii cu un produs necunoscut sunt săriți de Tillor. ## Vezi și [#zie-ook] # Pașii pachetului (/ro-RO/producten/bundel-velden) Această pagină descrie câmpurile din cardul **Linii de factură suplimentare** de pe pagina produsului. Cum construiți un pachet găsiți la [Configurarea liniilor de factură suplimentare](/producten/bundel-instellen). ## Pas de produs [#productstap] Un pas de produs este transformat de Tillor în zero, una sau mai multe linii de factură cu acel produs. Fără formulă, rezultatul este o singură linie cu cantitatea setată; cu o [formulă](#formule-per-stap) stabiliți dumneavoastră dacă apar linii, câte și care. | Câmp | Ce face | |------|--------------| | **Produs** | Produsul care apare pe linia secundară, de exemplu un supliment NFC sau închirierea unui contor. Obligatoriu | | **Cantitate** | Cantitatea liniei dacă pasul nu are formulă sau dacă formula returnează `true`. Mai mare decât 0 | | **Înmulțiți cu cantitatea rândului ancoră** | Înmulțește fiecare cantitate calculată cu cantitatea liniei principale, de exemplu 0,5 pentru o jumătate de an de taxă de staționare. Rezultatul este rotunjit la două zecimale. Liniile care ajung astfel la 0 sunt omise de Tillor; o linie pe care formula însăși o returnează cu cantitatea 0 rămâne | | **Descriere (opțional)** | Înlocuiește numele produsului pe linia de factură. O formulă care returnează linii poate da fiecărei linii propria descriere | | **Stilul liniei** | **Implicit (produs)**, **DEFAULT** sau **INFO**. Cu **INFO**, linia secundară devine o explicație gri în PDF și în editor | | **O dată per factură** | Relevant doar dacă pe aceeași factură există două sau mai multe linii principale cu un pachet. Pasul aparține atunci doar primei linii principale în ordinea facturii | | **Zile suplimentare după sfârșitul liniei principale (metode de acces)** | Are sens doar dacă produsul principal are ca acțiune **Prelungiți perioada de ocupare**. La plata unei linii din acest pas, Tillor prelungește metodele de acces ale clientului până la data de sfârșit a liniei principale plus acest număr de zile; tipurile și stările provin din **Prelungiți metoda de acces** de pe produsul principal, consultați [Prelungirea NFC prin pachet](/producten/bundel-instellen#nfc-verlengen-via-de-bundel) | | **Formulă** | Opțional. TypeScript care stabilește dacă pasul apare pe factură, cu ce cantitate sau care sunt exact liniile, consultați [Formula pe pas](#formule-per-stap) | ## Pas de informare [#inforestap] Un pas de informare este doar text, fără produs și fără sumă. Tillor îl afișează ca linie de explicație. | Câmp | Ce face | |------|--------------| | **Textul liniei de informații** | Textul vizibil, de exemplu „Inclusief toeristen-, gemeente- en provincietaksen". Obligatoriu | | **Stilul liniei** | Implicit **INFO**. Puteți alege **DEFAULT** dacă doriți să afișați linia ca o linie obișnuită | | **Formulă** | Opțional. Dacă formula returnează `false`, linia de informare este omisă | Dacă un pas de informare se află sub o linie principală, PDF-ul pune automat **↳** în fața textului. ## Formula pe pas [#formule-per-stap] Fiecare pas poate avea o **Formulă**: TypeScript, la fel ca [formula de tarif](/terreinen#tariefformule), pe care Tillor o execută la salvarea unei facturi cu acest pachet. Astfel, un pas poate depinde de client, de ocupare, de parcelă, de contoare sau de metodele de acces, de exemplu printr-un [câmp personalizat](/eigen-velden) în care păstrați o excepție. ### Ce returnează formula [#wat-de-formule-teruggeeft] | Valoare returnată | Efect | |---------------------|--------| | `true` | O linie cu **Cantitate** setată | | `false` sau `null` | Nicio linie | | Un număr mai mare decât 0 | O linie cu acel număr drept cantitate | | O listă de linii | Exact acele linii, în acea ordine. O listă goală înseamnă nicio linie | O linie dintr-o astfel de listă este un obiect cu aceste câmpuri: | Câmp | Semnificație | |------|-----------| | `quantity` | Obligatoriu. Cantitatea, 0 sau mai mult. O linie cu 0 rămâne, chiar și cu **Înmulțiți cu cantitatea rândului ancoră** | | `description` | Opțional. Descrierea acestei linii; altfel **Descriere** a pasului, altfel numele produsului | | `unitPrice` | Opțional. Prețul unitar cu TVA inclus, ca tariful produsului; altfel tariful produsului. `0` creează o linie gratuită | | `accessMethodValue` | Opțional. Valoarea metodei de acces la care se referă această linie (UID-ul etichetei NFC), pentru prelungirea la plată | ### Ce poate citi formula [#wat-de-formule-kan-lezen] Câmpurile se citesc cu acolade, ca în automatizări. Meniul **Variabilă** de lângă câmp arată tot ce este disponibil, inclusiv câmpurile dumneavoastră personalizate. | Variabilă | Ce este | |------------|-----------| | `{customer.…}` | Clientul de pe factură, de exemplu `{customer.createdAt}` sau `{customer.customFields.meterhuurVrijgesteld}` | | `{occupation.…}` | Ocuparea liniei principale. Dacă produsul principal nu are acțiunea **Prelungiți perioada de ocupare**, este singura ocupare a clientului; goală (`null`) dacă clientul ocupă mai multe parcele | | `{terrain.…}` | Parcela acelei ocupări | | `{anchor.…}` | Linia principală: `{anchor.quantity}` (de exemplu 0,5 pentru o jumătate de an), `{anchor.terrainId}`, `{anchor.occupationId}` și `{anchor.endDate}` | | `{meters}` | Lista contoarelor din domeniu: pe parcela liniei principale la **Prelungiți perioada de ocupare**, altfel pe toate parcelele ocupate de client. Fiecare contor are `name`, `provider` (de exemplu `ICY`), `type` (de exemplu `ELECTRICITY`, `GAS`), metadatele furnizorului său (de exemplu `icyMetadata.switchState` pentru alimentare pornită), `terrain` și `customFields` | | `{accessMethods}` | Lista metodelor de acces ale clientului, cele mai vechi primele, de orice tip și orice stare. Fiecare metodă are `type` (de exemplu `NFC`), `status` (de exemplu `ACTIVE`), `value`, o `label` ușor de citit (numele cunoscut al etichetei NFC, altfel valoarea) și `customFields` | Listele `{meters}` și `{accessMethods}` sunt încărcate de Tillor doar dacă formula le folosește. ### Exemple [#voorbeelden] Săriți peste un pas pentru clienții scutiți: ```ts if ({customer.customFields.exemptFromSurcharges} === true) return false; return true; ``` O linie pentru fiecare contor de electricitate ICY cu alimentare pornită și, pentru clienții din 2026 încoace, și cu alimentare oprită: ```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}` })); ``` Prima etichetă NFC gratuită, ca explicație, fiecare următoare la tariful produsului (doi pași cu același produs sau un singur pas care returnează ambele feluri de 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}`, })); ``` O linie cu numărul de câini dintr-un câmp personalizat al clientului, nicio linie fără câini: ```ts const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0)); return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }]; ``` Cu **Inserează exemplu** de sub câmp primiți un punct de plecare cu aceste forme în comentariu. ### Erori [#fouten] O formulă care nu se compilează nu poate fi salvată; mesajul de sub câmp spune ce este greșit. Dacă o formulă se blochează la salvarea unei facturi sau returnează altceva decât `true`, `false`, un număr sau linii valide, salvarea eșuează cu numele pasului în mesajul de eroare, astfel încât o formulă defectă să nu adauge sau să omită niciodată în tăcere o linie. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/producten) Un produs este un tarif sau un serviciu pe care îl puneți pe o linie de factură: o noapte pe o parcelă, un abonament lunar, o etichetă NFC sau un kWh de curent. Fiecare produs are un preț cu TVA inclus. Puteți să îi atașați și acțiuni pe care Tillor le execută automat, cum ar fi prelungirea unei ocupări sau tipărirea unui bon. Utilizatorii cu dreptul **Editați produsele** pot crea și modifica produse. Găsiți toate produsele la Administrare > Produse. - Prețul este întotdeauna cu TVA inclus. Alegeți 0%, 6%, 9%, 12% sau 21%. - O modificare a prețului, a contului contabil sau a acțiunilor se aplică liniilor pe care le adăugați după aceea. Facturile existente nu se schimbă. - Un preț nou îl puteți planifica începând de azi sau dintr-o zi ulterioară, nu pentru trecut. - Un produs dezactivat nu mai poate fi ales pe facturi, dar rămâne pe facturile existente. - Un produs șters nu mai poate fi recuperat. Este mai bine să îl dezactivați. - Pentru fiecare combinație de tip de client și tip de contor există un singur produs cu acțiunea **Consum contor**. - O **Afișează alertă** poate conține cel mult 4000 de caractere. - Pentru fiecare imprimantă setați cel mult 10 copii la imprimarea automată. - La **Prelungiți metoda de acces** adăugați cel mult 3660 de zile după data de sfârșit. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Un produs nu face nimic cât timp nu se află pe o factură. Dacă produsul are acțiuni, Tillor le preia pe linia de factură. Înregistrarea și plata pornesc acele acțiuni, iar rezultatul ajunge astfel la ocupare, la etichetă sau la imprimantă. ```mermaid flowchart TD P[Produs cu acțiuni] --> R[Linie de factură pe o factură ciornă] R -- Înregistrare --> G[Factură înregistrată] G --> G1[Ocupare: Facturat până la avansează] G --> G2[Rezervare creată la Cere parcela] G --> G3[Înregistrare blocată sau date de contact solicitate] G -- Plată --> B[Factură plătită] B --> B1[Ocupare: Plătit până la avansează] B --> B2[Etichetă NFC reîncărcată] B --> B3[Metodă de acces creată sau prelungită] B --> B4[Bon sau A4 tipărit] ``` Un exemplu cu **Prelungiți perioada de ocupare**: facturați chiria lunară unui client. La înregistrare, ocuparea apare ca facturată până la sfârșitul lunii. De îndată ce clientul plătește, **Plătit până la** avansează odată cu ea. Astfel vedeți pe ocupare ce este deja facturat și ce este deja plătit. Mai multe despre aceasta găsiți la [Ocupări](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs). O factură de credit inversează acest lucru: înregistrarea readuce **Facturat până la** la începutul liniei, plata readuce **Plătit până la**. Consultați [Transfer intern](/betalingsverwerking/interne-overboeking) pentru cazul în care o factură de credit este compensată doar cu factura inițială. ## Ce vedeți în listă [#wat-je-in-de-lijst-ziet] | Coloană | Conținut | |-------|--------| | **Nume** și **Descriere** | Numele și explicația așa cum le-ați completat la produs | | **Info** | Tipul de client și tipul de contor, doar la produsele cu acțiunea **Consum contor** | | **Acțiune** | Acțiunile aflate pe produs. La mai multe acțiuni, coloana afișează un rezumat | | **Preț (cu TVA)** | Prețul pe unitate | | **% TVA** | Cota de TVA | | **Cont contabil** | Numărul contului contabil, dacă l-ați completat | În rând găsiți o pictogramă cu creion pentru a deschide produsul și o pictogramă cu coș de gunoi pentru a-l șterge. Ambele sunt dezactivate dacă nu aveți dreptul **Editați produsele**. ### Căutare și filtrare [#zoeken-en-filteren] Tastați în bara de căutare pentru a filtra imediat lista. În plus, puteți filtra după **TVA**, **Tip de client**, **Tip de contor**, **Tip de acțiune**, **Stare** (Activ sau Dezactivat) și **Conturi**. Cu **Resetați** ștergeți filtrele dintr-o dată. ## Vezi și [#zie-ook] ## Termeni [#begrippen] - **Produs**: un preț și o descriere care pot apărea pe o linie de factură. - **Acțiune**: ceva ce Tillor face automat atunci când o linie de factură cu acest produs este înregistrată sau plătită. - **Pachet**: o serie de linii de factură suplimentare pe care Tillor le pune sub o linie principală, de exemplu suplimente la taxa de staționare. - **Linie principală și linie secundară**: linia principală este linia cu produsul pachetului, liniile secundare sunt cele pe care Tillor le adaugă dedesubt. - **Facturat până la** și **Plătit până la**: până când o ocupare este facturată, respectiv plătită. Consultați [Ocupare](/begrippen#bezetting). - **Cont contabil**: numărul de cont din contabilitatea dumneavoastră pe care se înregistrează un produs. # Planificarea unei modificări de preț (/ro-RO/producten/prijzen-plannen) Dacă prețul unui produs se schimbă începând cu o anumită zi, îl programați din timp. În acea zi, Tillor modifică el însuși prețul produsului. Facturile existente își păstrează prețurile. ## Programarea unui preț [#een-prijs-plannen] ### Deschideți produsul [#open-het-product] Mergeți la Administrare > Produse și deschideți produsul. În partea de jos a paginii se află cardul **Prețuri programate**. ### Alegeți data [#kies-de-datum] La **Începând cu** alegeți ziua în care intră în vigoare noul preț. Poate fi și azi, dar nu o zi din trecut. ### Completați prețul [#vul-de-prijs-in] Tastați **Preț nou (cu TVA)**. La **Cota TVA** lăsați **Cota TVA actuală** sau alegeți o altă cotă care se aplică din acea zi. Puteți alege și un [regim fără TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), cum ar fi **Taxare inversă (servicii UE)**; produsul este atunci, din acea zi, la 0% sub acel regim. ### Programați prețul [#plan-de-prijs] Faceți clic pe **Programați prețul**. Prețul apare în listă cu starea Programat. Dacă alegeți azi ca dată, noul preț se aplică imediat. Pentru o dată ulterioară, prețul se aplică de la începutul acelei zile. Tillor calculează cu fusul orar al organizației dumneavoastră. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] Produsul primește noul preț și, eventual, noua cotă de TVA. Rândul din listă primește starea Aplicat. Tillor trimite un e-mail la adresa de asistență a organizației dumneavoastră sau, dacă lipsește, la adresa generală de e-mail. Notificarea se numește **Preț de produs programat aplicat** și arată prețul vechi și pe cel nou. Consultați și [Notificări](/notificaties). Facturile care există deja nu se schimbă. Doar liniile pe care le adăugați după aceea primesc noul preț. ## Modificarea sau eliminarea unui preț programat [#een-geplande-prijs-wijzigen-of-verwijderen] - Dacă programați din nou un preț pentru aceeași zi în timp ce mai există un preț programat, cel nou îl înlocuiește pe cel vechi. - Faceți clic pe pictograma coșului de gunoi de lângă un preț programat și confirmați cu **Eliminați prețul programat**. Produsul își păstrează în acea dată prețul actual. - Un preț cu starea Aplicat rămâne ca istoric și nu poate fi eliminat. ## Calculatorul de TVA [#de-btw-calculator] Lângă câmpul de preț, atât la **Preț nou (cu TVA)**, cât și la **Preț (cu TVA)** în **General**, se află o mică pictogramă de calculator. Cu ea deschideți **Calculator TVA**. În calculator puteți: - să completați suma **Fără TVA** sau **Cu TVA**. Cealaltă sumă și TVA-ul sunt calculate imediat. - să alegeți o altă **Cotă TVA**. Prețul cu TVA este atunci recalculat pornind de la suma fără TVA. - să completați la **Modifică prețul cu %** un procent, de exemplu 5 pentru cinci procente în plus sau -5 pentru cinci procente în minus, și să faceți clic pe **Aplicați**. Faceți clic pe **Folosește acest preț** pentru a pune prețul și cota de TVA în formular. După aceea trebuie să salvați sau să programați prețul. ## Probleme? [#problemen] Un preț se poate aplica doar de azi încolo. Dacă doriți să modificați un preț retroactiv, modificați facturile înseși. Pentru aceasta aveți nevoie de dreptul **Editați produsele**. ## Vezi și [#zie-ook] # Crearea unui produs (/ro-RO/producten/product-aanmaken) Un produs nou este disponibil imediat pe facturi. Acțiunile și liniile de factură suplimentare le setați apoi pe pagina produsului. ### Deschideți fereastra de dialog [#open-het-dialoogvenster] Mergeți la Administrare > Produse și faceți clic în dreapta sus pe **Produs nou**. ### Completați datele de bază [#vul-de-basisgegevens-in] | Câmp | Ce completați | |------|---------------| | **Nume** (obligatoriu) | Numele așa cum apare pe facturi | | **Descriere** | O scurtă explicație (opțional) | | **Preț (cu TVA)** | Suma pe unitate, cu TVA inclus | | **% TVA** | Alegeți dintre 0%, 6%, 9%, 12% sau 21%, ori un regim fără TVA, cum ar fi **Taxare inversă (servicii UE)**. Consultați [TVA cu taxare inversă și alte regimuri](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) | | **Cont contabil** | Numărul contului contabil pentru contabilitatea dumneavoastră (opțional) | | **Supraveghează soldul clientului în acest cont** | Pentru garanții: refuză facturile care ar aduce soldul clientului sub zero. Consultați [Supravegherea soldului clientului](#het-saldo-van-de-klant-bewaken) | ### Creați produsul [#maak-het-product-aan] Faceți clic pe **Creați**. Tillor deschide pagina produsului, unde puteți adăuga acțiuni și linii de factură suplimentare. Prețul este întotdeauna cu TVA inclus. Tillor calculează suma TVA cu procentul ales și o afișează separat pe factură. ## Numărul contului contabil [#grootboeknummer] Cu numărul contului contabil legați un produs de un cont din contabilitatea dumneavoastră. Numărul este folosit la exportul către software-ul de contabilitate. Lăsați câmpul gol dacă nu doriți să legați produsul de un cont propriu. O modificare a numărului contului contabil se aplică liniilor de factură noi. Facturile înregistrate nu se schimbă. ## Supravegherea soldului clientului [#het-saldo-van-de-klant-bewaken] Pentru garanții bifați **Supraveghează soldul clientului în acest cont**. Tillor adună atunci, pentru fiecare client, toate liniile de factură înregistrate pe acel cont contabil și refuză orice factură care ar aduce acel sold sub zero. Astfel nu puteți returna din greșeală o garanție de două ori. Această opțiune necesită un număr de cont contabil. Pe factură vedeți sub linie soldul clientului în acel cont și ce devine după această factură. Ciornele nu se iau în calcul. Nici nu puteți readuce la ciornă o factură de garanție înregistrată, nici nu o puteți muta la alt client, dacă soldul ar ajunge astfel sub zero. Pe fila **Facturare** a unui client, sub **Facturi**, se află tabelul **Conturi**: fiecare cont contabil pe care s-a înregistrat ceva pentru acel client sau pe care există un [sold inițial](#beginsaldi-van-voor-tillor), cu soldul. Și un cont care are net zero rămâne vizibil. Un cont contabil supravegheat pe care clientul nu a înregistrat încă nimic nu apare acolo. Dacă cel puțin un produs supraveghează un cont contabil, filtrul **Protecție** este implicit pe **Activat** și vedeți doar conturile contabile supravegheate. Ștergeți filtrul pentru a vedea și celelalte conturi, cum ar fi conturile dumneavoastră de venituri. Fără produse supravegheate, filtrul este oprit și vedeți imediat toate conturile. Cu filtrul **Sold** păstrați doar conturile care nu sunt la zero. Un scut de lângă număr arată care conturi sunt supravegheate. Deschideți un cont și vedeți facturile înregistrate cu o linie pe acel cont contabil, de la cea mai veche la cea mai nouă, cu suma și **Sold curent**: soldul după acea factură. Dacă pe cont există mai mult de 100 de facturi, vedeți ultimele 100. Soldul curent le include totuși și pe cele mai vechi. Cu dreptul **Ignorarea soldului contului** puteți totuși înregistra. Indicați atunci un motiv, care ajunge în cronologia facturii. Fără acest drept, **Înregistrați** rămâne gri cât timp soldul ar ajunge sub zero. ## Solduri inițiale de dinainte de Tillor [#beginsaldi-van-voor-tillor] O garanție pe care clientul a plătit-o înainte să începeți cu Tillor nu se află pe o factură din Tillor. Puneți o astfel de sumă ca **sold inițial** pe contul clientului. Aceasta contează în sold și în supraveghere, așa că returnați acea garanție mai târziu pur și simplu, fără motiv. Un sold inițial nu este o factură: nu primește număr și nici TVA, și nu ajunge în contabilitatea dumneavoastră, pentru că vechea contabilitate îl are deja. **Un client:** deschideți clientul, fila **Facturare**, cardul **Conturi**, și faceți clic pe **Sold inițial**. Completați contul (de ex. 428002), suma, data vechiului sold și o referință, de exemplu documentul din vechiul sistem. O sumă negativă este o sumă pe care clientul o datorează încă. Deschideți contul și vedeți soldul inițial la începutul soldului curent, cu butoane pentru a-l modifica sau a-l șterge. Sub sold apare cât din el este sold inițial. **Toți clienții odată:** mergeți la Administrare > Facturi și faceți clic pe **Import solduri inițiale**. Lipiți rândurile dintr-o foaie de calcul sau alegeți un fișier CSV, cu un rând de antet și coloanele client (numărul de client din Tillor), cont, sumă, dată, referință și, eventual, notă. Faceți clic pe **Verificare**: vedeți care rânduri sunt noi, care sunt actualizate de Tillor și ce clienți nu au fost găsiți, plus totalul pe cont. Comparați acel total cu balanța vechii dumneavoastră contabilități și apoi faceți clic pe **Import**. Un rând cu o referință pe care clientul o are deja pe acel cont actualizează acel sold inițial în loc să îl adauge de două ori, deci puteți relua liniștit un import. Un sold inițial care a fost deja returnat nu mai poate fi, în mod normal, șters sau redus: soldul ar ajunge atunci sub zero. Dacă aveți dreptul **Ignorarea soldului contului**, Tillor cere în acest caz un motiv și efectuează totuși modificarea, de exemplu pentru a elimina un vechi sold inițial combinat de la un client care și-a primit deja garanția înapoi în Tillor. Același lucru este valabil și pentru un import care aduce un sold sub zero. Fiecare modificare ajunge în cronologia clientului, cu motivul dumneavoastră alături dacă ați ignorat supravegherea. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Produsul apare imediat în listă și îl puteți alege pe facturile ciornă. - Pe pagina produsului setați apoi [acțiuni](/producten/acties-instellen), [linii de factură suplimentare](/producten/bundel-instellen) și [prețuri programate](/producten/prijzen-plannen). ## Probleme? [#problemen] Crearea și modificarea necesită dreptul **Editați produsele**. Rugați un administrator al organizației dumneavoastră să adauge acest drept rolului dumneavoastră. Puteți alege doar dintre 0%, 6%, 9%, 12% și 21%. Alte cote nu le puteți seta. ## Vezi și [#zie-ook] # Editarea sau ștergerea unui produs (/ro-RO/producten/product-bewerken) Pe pagina produsului modificați tot ce ține de un produs. Modificările se aplică liniilor de factură noi. ## Editarea unui produs [#een-product-bewerken] ### Deschideți produsul [#open-het-product] Mergeți la Administrare > Produse și faceți clic pe numele produsului sau pe pictograma cu creion din rând. ### Modificați datele [#pas-de-gegevens-aan] În stânga găsiți cardurile **General** și **Linii de factură suplimentare**. În dreapta se află **Acțiuni de linie de factură** și **Evenimente**. În **General** se află aceleași câmpuri ca la creare, plus opțiunea **Dezactivați produsul**. ### Salvați [#sla-op] Faceți clic în partea de jos a cardului **Linii de factură suplimentare** pe **Salvați**. Acest buton salvează toate modificările de pe pagină, inclusiv cele din **General** și din **Acțiuni de linie de factură**. Butonul devine activ abia după ce ați modificat ceva. Dacă doriți ca un preț nou să se aplice abia de la o dată ulterioară, folosiți cardul **Prețuri programate**. Consultați [Planificarea unei modificări de preț](/producten/prijzen-plannen). La **Evenimente** vedeți o cronologie a modificărilor produsului, cum ar fi prețul, contul contabil și acțiunile. Pentru fiecare modificare apar momentul, utilizatorul și, acolo unde este posibil, diferența dintre înainte și după. ## Dezactivarea unui produs [#een-product-uitschakelen] Bifați **Dezactivați produsul** și salvați. Un produs dezactivat nu mai poate fi ales pe facturi, dar rămâne în listă și pe facturile existente. În listă și pe pagina produsului îl vedeți ca Dezactivat. Astfel păstrați istoricul fără să mai folosiți produsul. ## Ștergerea unui produs [#een-product-verwijderen] ### Alegeți ștergerea [#kies-verwijderen] Faceți clic în listă pe pictograma coșului de gunoi de lângă produs. Pe pagina produsului deschideți meniul cu trei puncte din antet și alegeți **Ștergeți produsul**. ### Confirmați [#bevestig] Faceți clic în fereastra de dialog pe **Eliminați**. Ștergerea nu poate fi anulată. Facturile pe care se află deja produsul rămân neschimbate. Dacă produsul este pas în pachetul altui produs, Tillor sare de acum încolo peste acel pas. Dacă nu doriți decât să nu mai folosiți produsul, este mai bine să îl dezactivați. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Un preț nou, un alt cont contabil sau o altă acțiune se aplică liniilor pe care le adăugați după aceea. Facturile existente rămân așa cum erau. - Un produs dezactivat dispare din lista de alegere de pe facturi, dar rămâne vizibil în lista de produse. - Fiecare modificare apare pe cronologia **Evenimente** a produsului, cu utilizator și moment. ## Probleme? [#problemen] Butonul funcționează abia după ce ați modificat ceva și doar cu dreptul **Editați produsele**. Fiecare pas de produs din pachet trebuie să aibă un produs, iar fiecare pas de informare trebuie să aibă un text. Completați și salvați din nou. Consultați [Configurarea liniilor de factură suplimentare](/producten/bundel-instellen). Pentru fiecare combinație de tip de client și tip de contor poate exista un singur produs cu acțiunea **Consum contor**. Dacă acea combinație se află deja pe un alt produs, salvarea este refuzată. Modificați celălalt produs sau alegeți o altă combinație. ## Vezi și [#zie-ook] # Acțiunile produselor (/ro-RO/producten/productacties) Activați acțiunile pe pagina produsului, în cardul **Acțiuni de linie de factură**. Cum faceți asta găsiți la [Atașarea acțiunilor la un produs](/producten/acties-instellen). Această pagină descrie fiecare acțiune. Cum se leagă acțiunile, la înregistrare și la plată, de ocupări, etichete și imprimante vedeți la [Cum se leagă toate acestea?](/producten#hoe-hangt-dit-samen). ## Reîncărcați eticheta NFC [#nfc-tag-opladen] Când o factură cu acest produs este plătită, Tillor reîncarcă automat o etichetă NFC. Folosiți acest lucru pentru produsele prin care clienții primesc sold sau acces pe o etichetă. Produsul nu are câmpuri suplimentare. ## Perioadă [#periode] Produsul reprezintă un serviciu pe o perioadă de timp, cum ar fi un preț pe zi, un abonament săptămânal sau un tarif lunar. | Câmp | Semnificație | |------|-----------| | **Per unitate** | Numărul de unități pe perioadă, minimum 1 | | **Unitate de perioadă** | **Zi**, **Săptămână** sau **Lună** | | **Prelungiți automat metodele de acces** | La plată, Tillor prelungește toate metodele de acces ale clientului până la data de sfârșit a perioadei | | **Cere parcela** | Pe linia de factură alegeți o parcelă. La înregistrare, Tillor creează o rezervare pentru acea ședere | | **Înregistrare sosire la rezervare** | Doar cu **Cere parcela**. De îndată ce factura este înregistrată, Tillor trece rezervarea pe Cu check-in | | **Înregistrează sosirea la plată** | Doar cu **Cere parcela**. De îndată ce factura este plătită, Tillor trece rezervarea pe Cu check-in | | **Adulți incluși** | Doar cu **Cere parcela**. Numărul de adulți de pe rezervare, implicit 2. Puteți completa de la 0 la 99 | ### Rezervări la Cere parcela [#reserveringen-bij-terrein-vragen] - Rezervarea primește aceeași sosire și plecare ca linia de factură și parcela aleasă ca preferință. Grupul îl modificați apoi pe rezervarea însăși. - Dacă readuceți factura la ciornă și modificați datele sau parcela, Tillor actualizează aceeași rezervare la o nouă înregistrare. - Dacă eliminați parcela sau dezactivați **Cere parcela**, rezervarea este anulată. O rezervare care a făcut deja check-out rămâne. - O notă de credit anulează rezervarea facturii inițiale. - Fără check-in, rezervarea rămâne pe Rezervat. Așa funcționează un avans de rezervare: o parcelă și date în viitor, fără sosire. - Dacă ambele opțiuni de check-in sunt activate, contează înregistrarea. - Dacă factura este deja plătită în momentul în care o înregistrați din nou, Tillor face din nou check-in. Pe cronologia facturii și a rezervării vedeți crearea, modificarea, anularea și check-in-ul, cu o trimitere către cealaltă. ## Prelungiți perioada de ocupare [#bezetting-verlengen] Cu această acțiune, o factură prelungește ocuparea unui client pe o parcelă, de exemplu pentru taxa de staționare. - La **înregistrare**, Tillor modifică **Facturat până la** al ocupării. - La **plată**, Tillor modifică **Plătit până la**. Pe linia de factură alegeți o parcelă. Tillor leagă, la înregistrare și la plată, ocuparea activă a clientului pe acea parcelă. Tillor păstrează pe linie și o copie a acelei ocupări, astfel încât să vedeți ulterior ce ocupare a fost vizată, chiar dacă a fost ștearsă între timp. Cu **Rotunjiți la limita perioadei următoare** pe linia de factură aliniați clienții pe termen la același ciclu, conform **Frecvența chiriei** a ocupării. Dacă alegeți o parcelă pe care clientul nu are încă o ocupare, creați o ofertă. O astfel de linie o puteți înregistra abia după ce clientul ocupă parcela. | Câmp | Semnificație | |------|-----------| | **Data scadenței din începutul ocupării** | La înregistrare, Tillor setează data scadenței la data de început a perioadei de ocupare pe linia taxei de staționare, în locul termenului de plată standard sau al termenului din dialogul de înregistrare. La o nouă înregistrare rămâne data scadenței inițială | Dacă produsul are linii de factură suplimentare, Tillor adaugă linii secundare sub linia principală. Consultați [Configurarea liniilor de factură suplimentare](/producten/bundel-instellen). ## Prelungiți metoda de acces [#toegangsmethode-verlengen] Cu această acțiune, plata unei facturi prelungește valabilitatea metodelor de acces ale clientului. Funcționează în două feluri: - **Împreună cu Perioadă** pe aceeași linie, de exemplu chiria lunară. Tillor prelungește metodele alese până la data de sfârșit a perioadei. - **Printr-un pachet** cu o linie principală de taxă de staționare și pași NFC. Data de sfârșit a liniei principale de taxă de staționare este atunci baza. Setările de mai jos provin de la produsul principal, nu de la produsul de supliment al pasului NFC. Consultați [Prelungirea NFC prin pachet](/producten/bundel-instellen#nfc-verlengen-via-de-bundel). | Câmp | Semnificație | |------|-----------| | **Zile după data de sfârșit** | Zile calendaristice peste data de sfârșit. 0 înseamnă chiar data de sfârșit, maximum 3660. La pachete setați acest lucru pentru fiecare pas NFC | | **Ziua săptămânii** | Opțional. Valabilitatea se încheie la cea mai apropiată apariție a acelei zile a săptămânii în jurul datei țintă. Implicit **Orice zi** | | **Ora** | Opțional. Ora în fusul orar al organizației. Gol înseamnă 23:59 | | **Tipuri de metode de acces** | Alegeți cel puțin un tip dintre NFC, Cod QR, Recunoașterea numărului de înmatriculare și Cod PIN. Vedeți doar tipurile activate pentru organizația dumneavoastră | | **Stări** | Sunt prelungite doar metodele cu una dintre aceste stări: Activ sau Blocare ușoară. Implicit doar **Activ** | | **Nu scurtați la prelungire** | Metodele al căror **Valabil până la** se află deja la sau după noua dată sunt sărite. La anularea printr-o notă de credit, Tillor setează întotdeauna data calculată | Sub câmp se află un rând **Rezultat** care explică în ce moment ajunge valabilitatea, de exemplu „cea mai apropiată marți în jurul datei de sfârșit + 10 zile, la 13:00". Aceasta nu este același lucru cu **Prelungiți automat metodele de acces** de la **Perioadă**. Acel comutator prelungește la plata unui produs cu doar **Perioadă**, fără acțiunea separată **Prelungiți metoda de acces**. ## Creați metodă de acces [#toegangsmethode-aanmaken] La plata facturii, Tillor creează o nouă metodă de acces pentru client. Casierul alege tipul pe linia de factură. Dacă linia are și acțiunea **Perioadă**, perioada devine valabilitatea metodei de acces. | Câmp | Semnificație | |------|-----------| | **Tipuri de metode de acces** | Tipurile dintre care alege casierul: Cod QR, Recunoașterea numărului de înmatriculare sau Cod PIN. Dacă există un singur tip, Tillor îl alege automat | | **Metoda de acces este opțională** | Înregistrarea nu este niciodată blocată de această linie. Fără un tip ales, Tillor nu creează nimic | | **Metodă de acces implicită** | Doar la mai multe tipuri. Acest tip este selectat implicit pe liniile de factură noi, modificabil pe fiecare linie. **Fără implicit (alegeți per linie)** lasă alegerea deschisă | | **Imprimați automat codul QR** | Doar cu Cod QR. Tillor tipărește tichetul de acces QR pe imprimanta de bonuri de îndată ce este creat | | **Conversie automată a codurilor în număr de înmatriculare** | Codurile QR și PIN noi sunt înlocuite cu numărul de înmatriculare detectat dacă sunt folosite la o barieră cu cameră. Modificabil pe fiecare linie | O linie poate fi înregistrată abia după ce a fost ales un tip, cu excepția cazului în care acțiunea este opțională. La Recunoașterea numărului de înmatriculare trebuie completat și numărul de înmatriculare. ## Solicitați date de contact [#contactgegevens-vragen] Pe linia de factură apar câmpuri pentru adresa de e-mail și numărul de telefon. Tillor le cere la înregistrare. | Câmp | Semnificație | |------|-----------| | **Solicitați adresa de e-mail** | Afișează un câmp de e-mail pe linia de factură | | **Adresa de e-mail este obligatorie** | Doar dacă solicitați o adresă de e-mail. Înregistrarea este blocată până când câmpul este completat | | **Solicitați numărul de telefon** | Afișează un câmp de telefon pe linia de factură | | **Numărul de telefon este obligatoriu** | Doar dacă solicitați un număr de telefon. Înregistrarea este blocată până când câmpul este completat | ## Împiedicați înregistrarea [#boeken-blokkeren] Folosiți acest lucru pentru produsele care aparțin doar facturilor ciornă. Dacă o astfel de linie se află pe o factură ciornă, factura nu poate deveni definitivă. Nu există niciun câmp suplimentar. Tillor blochează înregistrarea cât timp linia se află acolo. ## Afișează alertă [#melding-tonen] Afișează o alertă sub linia de factură, de exemplu „Atenție: de folosit doar pentru turiștii de o zi". La înregistrare sau la plată nu se întâmplă nimic. | Câmp | Semnificație | |------|-----------| | **Stilul alertei** | **Informație**, **Avertisment**, **Eroare**, **Reușit** sau **Neutru** | | **Textul alertei** | Textul, cel mult 4000 de caractere. Markdown este acceptat (aldin, liste, linkuri) | Sub text vedeți imediat o previzualizare a alertei. Textul este copiat pe linia de factură. Modificările ulterioare ale produsului nu schimbă facturile existente. ## Consum contor [#meterverbruik] Cu această acțiune, produsul devine tariful pentru consumul contorului. Tillor îl folosește pentru consumul restant și la facturarea automată a citirilor de contor. Alegeți două câmpuri. | Câmp | Opțiuni | |------|--------| | **Tip de client** | **Implicit**, **Rulotă de închiriat pentru lucrători**, **Rulotă tractată pentru lucrători** | | **Tip de contor** | **Electricitate**, **Apă**, **Gaz** | Pentru fiecare combinație de tip de client și tip de contor poate exista un singur produs. În listă, ambele valori apar în coloana **Info**. Dacă un client nu are un produs propriu pentru tipul său de client, Tillor folosește produsul pentru **Implicit** cu același tip de contor. ## Imprimare termică și imprimare A4 [#thermisch-printen-en-a4-printen] Bifați **Imprimare termică** și **Imprimare A4** separat. De îndată ce cel puțin una dintre ele este activată, apare blocul **Imprimare automată**. Acolo setați, pentru fiecare imprimantă, ce se tipărește la plata facturii. | Câmp | Semnificație | |------|-----------| | **Copii imprimare termică** | Numărul de exemplare pe imprimanta termică (imprimanta de casă). 0 oprește acea imprimantă | | **Copii imprimare A4** | Numărul de exemplare pe imprimanta A4. 0 oprește A4 | | **Momentul imprimării** | **Folosiți setările (per tip de plată)** (implicit), **Imprimați imediat** sau **Următoarea oră de prag** | Puteți seta cel mult 10 copii pentru fiecare imprimantă. La **Folosiți setările (per tip de plată)** se aplică setarea organizației dumneavoastră pentru fiecare tip de plată. ## Vezi și [#zie-ook] # Rezervări (/ro-RO/reserveringen) Cu rezervările urmăriți șederile din parcul dumneavoastră: cine vine când, pe ce parcelă și cu câți oaspeți. Dintr-o rezervare efectuați și check-in-ul și check-out-ul. Vedeți toate rezervările pe o cronologie la **Rezervări** și, pentru fiecare client, pe fila **Rezervări**. Începeți cu [Crearea unei rezervări](#een-reservering-aanmaken). - Fiecare rezervare aparține unui client și primește automat un **Număr rezervare** unic. Acest număr nu îl puteți modifica. - Data de check-out trebuie să fie după data de check-in. Aceeași zi sau una anterioară este refuzată de Tillor. - Un număr de înmatriculare este format din litere și cifre, cel mult 10 caractere, fără spații sau cratime. - Check-in-ul și anularea sunt posibile doar din starea **Rezervat**. Anularea nu mai este posibilă după check-in. - O rezervare nu este același lucru cu o ocupare: o rezervare este o înregistrare pentru o ședere, o ocupare leagă un client de o parcelă pentru o perioadă, consultați [Ocupări](/bezettingen). - Notele de la o rezervare sunt interne și nu sunt niciodată partajate cu clientul. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] ```mermaid flowchart LR K[Client] --> R[Rezervare] R -->|Check-in| I[Oaspete pe parcelă] I -->|Check-out| U[Ședere încheiată] R -->|Anulați rezervarea| A[Anulat] R --> F[Facturile clientului] ``` Facturile clientului le găsiți pe profilul clientului, la **Facturare**. ## Cronologia [#de-tijdlijn] Mergeți la **Rezervări** în meniul principal. Cronologia arată rezervările pe parcele, peste un calendar. Cu vizualizarea alegeți ziua, săptămâna, luna, trimestrul sau anul, iar cu **Mergeți la dată** săriți la o dată. - Faceți clic sau trageți pe un spațiu liber pentru a adăuga o rezervare. În dreapta sus se află și **Rezervare nouă**. - Dacă trageți o rezervare pe alte date, Tillor întreabă **Actualizați datele rezervării?** Abia după confirmarea dumneavoastră se modifică rezervarea. - Meniul contextual al unei rezervări conține **Vizualizați rezervarea**, **Copiați linkul** și **Anulați rezervarea**. ## Crearea unei rezervări [#een-reservering-aanmaken] Înainte să începeți: - Aveți nevoie de un client. Dacă acesta nu există încă, îl creați în timpul începerii, consultați [Gestionarea clienților](/klantenbeheer). - Știți ce parcelă dorește oaspetele? Atunci o alegeți. Altfel lăsați câmpul gol. ### Începeți rezervarea [#start-de-reservering] Faceți clic în dreapta sus pe **Rezervare nouă**. Alegeți un client existent sau creați un client nou. Deschideți clientul din **Clienți**, mergeți la fila **Rezervări** și faceți clic pe **Rezervare nouă**. ### Completați formularul [#vul-het-formulier-in] Consultați [Formularul de rezervare](#het-reserveringsformulier) mai jos pentru toate câmpurile. ### Creați rezervarea [#maak-de-reservering-aan] Faceți clic pe **Creați rezervare**. ### Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Rezervarea primește starea Rezervat și un număr de rezervare. - Dacă **E-mail de confirmare automat** este activat, clientul primește o confirmare. - Găsiți rezervarea pe cronologie și pe fila **Rezervări** a clientului. - Dacă doriți ca o automatizare să reacționeze la o rezervare nouă sau modificată, folosiți un declanșator, consultați [Declanșatoare](/automatiseringen/triggers). ## Formularul de rezervare [#het-reserveringsformulier] ### Date și durata șederii [#datums-en-verblijfsduur] - **Check-in**: alegeți data sosirii. - **Check-out**: alegeți data plecării. După data de check-in, selectorul de check-out se deschide de la sine. Data plecării trebuie să fie după data sosirii. - **Număr de nopți**: Tillor îl calculează singur. ### Numere și animale [#aantallen-en-dieren] Indicați numărul de **Adulți** (minimum 1), **Copii**, **Sugari** și **Animale** cu butoanele plus și minus. ### Parcelă [#terrein] - **Parcelă**: alegeți o parcelă dacă oaspetele are o preferință. Lista arată doar parcele rezervabile, fără ocupare activă, care sunt libere în perioada aleasă. Rezervările active care se suprapun pe aceeași parcelă sunt excluse de Tillor. Dacă modificați datele, lista se reîmprospătează. Nicio preferință? Lăsați câmpul gol. - **Includeți parcelele nerezervabile**: afișează și parcelele care nu pot fi rezervate online, de exemplu locurile fixe anuale. Dacă rezervarea se află deja pe o astfel de parcelă, această bifă este activată de la sine. - **Includeți parcelele ocupate**: afișează și parcelele care au deja o ocupare. ### Numere de înmatriculare [#nummerplaten] Tastați un număr de înmatriculare, apăsați **Enter** și repetați pentru fiecare număr. O cruciuliță de pe un număr îl elimină. Numerele de înmatriculare pot conține doar litere și cifre, cel mult 10 caractere. Numerele de înmatriculare de la o rezervare pot fi găsite prin căutare. Accesul la barieră îl stabiliți separat, la client, pe fila **Control acces**, consultați [Control acces](/toegangscontrole). ### Note [#notities] Folosiți câmpul de note pentru observații interne, cum ar fi dorințe speciale sau înțelegeri. ### Preferințe de comunicare [#communicatievoorkeuren] - **E-mail de confirmare automat**: trimite o confirmare după creare. - **Plată online**: permite clientului să plătească rezervarea online. ## Vizualizarea și editarea unei rezervări [#een-reservering-bekijken-en-bewerken] Faceți clic pe o rezervare de pe cronologie sau din profilul clientului pentru a deschide pagina de detalii. - **Detalii rezervare** (stânga): formularul complet. Modificați ce doriți și faceți clic pe **Salvați**. Cu **Anulați** restabiliți valorile inițiale. Lângă titlu se află **Copiați linkul rezervării**, util pentru a lipi un link pe care se poate face clic într-un document. - **Acțiuni rezervare** (dreapta): butoanele de mai jos. - **Comentarii** (dreapta): discuție internă despre această rezervare. - **Activitate** (dreapta): o cronologie cu crearea, check-in-ul, check-out-ul, anularea, inversările și datele modificate, cu moment și utilizator. La o modificare vedeți ce câmpuri au fost schimbate (înainte / după). ## Check-in, check-out și anulare [#inchecken-uitchecken-en-annuleren] Pe pagina de detalii, acțiunile se află la **Acțiuni rezervare**. Fiecare acțiune cere o confirmare. | Acțiune | Posibilă când | Rezultat | |---|---|---| | **Check-in** | Starea Rezervat | Starea Cu check-in | | **Check-out** | Starea Cu check-in | Starea Check-out efectuat | | **Anulați rezervarea** | Doar înainte de check-in | Starea Anulat | | **Anulați anularea** | Doar înainte de check-in | Înapoi la Rezervat | | **Anulați check-in-ul** | La un check-in greșit. Dacă oaspetele a făcut deja check-out, anulați mai întâi check-out-ul | Înapoi la Rezervat | | **Anulați check-out-ul** | La un check-out greșit | Înapoi la Cu check-in | În plus, există **Trimiteți formularul de confirmare clientului (SMS)** și **Creează sarcină**. Cu ultima creați o sarcină din această rezervare. O rezervare anulată nu poate face check-in sau check-out. Anulați mai întâi anularea. ## Probleme? [#problemen] Mesajul este **Rezervarea nu a putut fi creată.** Verificați dacă a fost ales un client și dacă data de check-out este după data de check-in. Aceeași zi sau una anterioară este refuzată. Modificările dumneavoastră nu au fost salvate. Verificați datele (check-out trebuie să fie după check-in), numerele de înmatriculare și numărul de adulți, și faceți din nou clic pe **Salvați**. Rezervarea trebuie să aibă starea Rezervat. Dacă a făcut deja check-in sau check-out ori a fost anulată, check-in-ul nu este posibil. Reîncărcați pagina și vedeți care este acum starea. Dacă a fost anulată, faceți mai întâi **Anulați anularea**. Check-out-ul este posibil doar la o rezervare care a făcut check-in. Dacă oaspetele nu a făcut încă check-in sau a făcut deja check-out, nu funcționează. Anularea este posibilă doar înainte de check-in. Dacă oaspetele a făcut deja check-in, anulați mai întâi **Anulați check-in-ul** și apoi anulați. Lista arată doar parcele rezervabile, fără ocupare, care sunt libere în perioada aleasă. Verificați datele. Bifați **Includeți parcelele nerezervabile** sau **Includeți parcelele ocupate** dacă vă referiți la o astfel de parcelă. Un număr de înmatriculare poate conține doar litere și cifre și poate avea cel mult 10 caractere. Eliminați spațiile și cratimele. ## Termeni [#begrippen] - **Rezervare**: o înregistrare pentru o ședere. Consultați [rezervare](/begrippen#reservering). - **Rezervat, Cu check-in, Check-out efectuat, Anulat**: cele patru stări ale unei rezervări. - **Număr rezervare**: numărul automat cu care regăsiți o rezervare. - **Ocupare**: un client pe o parcelă pentru o perioadă, independent de o rezervare. Consultați [ocupare](/begrippen#bezetting). - **Cronologie**: prezentarea rezervărilor pe parcele, peste un calendar. ## Vezi și [#zie-ook] # Partajarea sarcinilor (/ro-RO/taken/delen) Doriți să arătați sarcinile cuiva care nu lucrează în Tillor sau să le vedeți în propriul calendar? Atunci creați un link de partajare. Există două tipuri. | Tip | Ce este | |---|---| | **Pagină de partajat** | O tablă doar pentru citire cu ce este de făcut. Urmărește sarcinile, deci modificările din Tillor apar și acolo | | **Abonament calendar (ICS)** | Un abonament de calendar pentru, de exemplu, Google Calendar, Outlook sau Calendar Apple | ## Crearea unui link [#een-link-maken] 1. Faceți clic pe pictograma de partajare din dreapta sus pe pagina de sarcini (tooltip **Partajează această vizualizare**). Aceeași pictogramă o găsiți și pe cardul **Sarcini pentru dvs.** din tabloul de bord 2. La **Tipul linkului** alegeți **Pagină de partajat** sau **Abonament calendar (ICS)** 3. La **Conținut** alegeți ce partajați: **Sarcinile mele atribuite** sau una dintre vizualizările dumneavoastră. Dacă deschideți fereastra dintr-o vizualizare, aceasta este deja selectată 4. Dacă doriți, restrângeți conținutul cu **Filtre**: **Stare**, **Prioritate**, **Atribuit către**, **Etichetă**, **Vizualizare**, **Legat de** și **Blocată**. Filtrele sunt salvate pe link și restrâng doar ceea ce arată deja sursa 5. Faceți clic pe **Creează link** La **Linkuri anterioare** găsiți toate linkurile create pentru această sursă. Pentru fiecare link puteți: - **Copiați linkul** - La un link de calendar, **Adaugă în calendar**, care deschide imediat abonamentul în aplicația dumneavoastră de calendar - **Invalidează** (după confirmare). Linkul nu mai funcționează. Celelalte linkuri rămân valabile. Un link invalidat rămâne în listă, cu marcajul **Invalidat** Un link de partajare este privat, dar oricine îl are poate vedea sarcinile, chiar și fără să se autentifice. Partajați-l doar cu persoane care au voie să le vadă și invalidați-l imediat ce nu mai este necesar. ## Pagina de partajat [#de-deelbare-pagina] Pagina arată sarcinile pe grupuri, cu numele, starea, prioritatea, termenul, etichetele și numele colegilor atribuiți la fiecare sarcină. Nu există butoane pentru a modifica ceva. La un grup mare vedeți **[număr] din [total]** sarcini. Implicit apar doar sarcinile deschise, cu excepția cazului în care setați dumneavoastră un filtru de stare sau partajați o vizualizare. Dacă nu este nimic de făcut, vedeți **Momentan nu este nimic de făcut.** ## Calendarul [#de-agenda] În calendar apar sarcinile cu un **Termen** sau un **Memento**. Sarcinile fără dată nu apar. - Mementourile repetitive apar ca o serie și primiți o notificare la fiecare memento - Fără memento, primiți o notificare cu o oră înainte de termen - Sarcinile finalizate rămân vizibile încă două săptămâni, ca finalizate, apoi dispar - La o vizualizare, calendarul urmărește vizualizarea, indiferent cui sunt atribuite sarcinile. Dacă cel care a creat linkul nu mai poate vedea vizualizarea, linkul nu mai funcționează În Google Calendar trebuie să activați și notificările implicite pentru un calendar la care v-ați abonat, altfel notificările nu ajung. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Linkul funcționează imediat și continuă să funcționeze până îl invalidați. Oricine are linkul poate vedea sarcinile, chiar și fără să se autentifice. - O pagină de partajat urmărește sarcinile: modificările din Tillor apar și acolo. - Un abonament de calendar se actualizează singur în aplicația dumneavoastră de calendar și trimite o notificare cu o oră înainte de termen sau la fiecare memento. - Dacă invalidați un link, se oprește doar acel link. Celelalte linkuri rămân valabile, iar linkul invalidat rămâne în listă, cu marcajul **Invalidat**. ## Probleme? [#problemen] Linkul nu a fost creat. Verificați dacă ați ales o sursă la **Conținut** și încercați din nou. Mesajul **Linkurile nu au putut fi încărcate.** înseamnă că lista cu linkuri anterioare nu s-a deschis. Deschideți din nou fereastra. Nu există sarcini care să corespundă sursei și filtrelor. O pagină de partajat arată implicit doar sarcinile deschise. În calendar apar doar sarcinile cu un termen sau un memento. Dacă cel care a creat linkul nu mai poate vedea vizualizarea, nici linkul nu mai funcționează. Activați în Google Calendar și notificările implicite pentru calendarul la care v-ați abonat. Alegeți la link **Invalidează** și confirmați la **Invalidezi acest link?**. Dacă nu reușește, apare **Linkul nu a putut fi invalidat**: încercați din nou. # Filtrare (/ro-RO/taken/filteren) Deasupra sarcinilor se află o bară de căutare, cu butoanele de filtrare alături. Filtrele aparțin vizualizării: dacă le salvați, ele stabilesc ce sarcini arată vizualizarea. La o vizualizare filtrată sunt sarcinile care corespund filtrelor. La o listă sunt sarcinile adăugate manual care corespund și filtrelor. ## Filtre mereu vizibile [#altijd-zichtbare-filters] | Filtru | Ce alegeți | |---|---| | **Stare** | Una sau mai multe stări | | **Prioritate** | Una sau mai multe priorități | | **Atribuit către** | Unul sau mai mulți colegi, sau **Eu** pentru dumneavoastră | | **Etichetă** | Una sau mai multe etichete | | **Vizualizare** | Sarcini care se află într-o altă vizualizare (manuală) | | **Blocat** | **Blocat** sau **Neblocată** | | **Legat de** | Tipul de înregistrare de care este legată sarcina, de exemplu un client, o parcelă, o factură sau o rezervare | | **Text** | Cuvinte pe care numele sau descrierea le conține sau, dimpotrivă, nu le conține, vezi mai jos | | **Termen** | O perioadă, vezi mai jos | La filtrele cu o listă alegeți sus **Includeți** (sarcini cu valorile alese) sau **Excludeți** (sarcini fără acele valori). La **Legat de** alegeți tipul de element: **Client**, **Factură**, **Rezervare**, **Contor**, **Parcelă**, **Comentariu**, **Conversație**, **Apel telefonic**, **Tranzacție bancară** sau **Produs**. ## Filtrarea după text [#filteren-op-tekst] Cu **Text** afișați doar sarcinile al căror nume sau descriere conține sau, dimpotrivă, nu conține o anumită bucată de text. Literele mari și mici nu contează. 1. Faceți clic pe **Text** 2. Alegeți **Conține** sau **Nu conține** 3. Tastați textul în **Text în nume sau descriere**, de exemplu `Verzekering vervallen:` 4. Faceți clic pe **Adaugă** sau apăsați Enter Repetați acest lucru pentru fiecare text pe care doriți să îl adăugați. Fiecare text este un filtru separat, așa că puteți combina **Conține** și **Nu conține**: de exemplu `caravan`, dar nu `Verzekering vervallen:`. Cu X-ul de lângă un text îl eliminați. Pe buton apare textul însuși sau numărul de texte, dacă sunt mai multe. Dacă o sarcină trebuie să corespundă **tuturor** textelor sau **unuia** dintre ele depinde de alegerea de la [Combinarea mai multor filtre](#meerdere-filters-combineren). Dacă doriți să excludeți mai multe texte, lăsați alegerea pe **Toate filtrele**. ## Filtrarea după dată [#filteren-op-datum] **Termen** funcționează cu opțiuni fixe care se mută odată cu ziua sau cu o perioadă proprie. - **Restante**, **Astăzi**, **Mâine**, **Săptămâna aceasta**, **Săptămâna viitoare**, **Luna aceasta** - **Fără dată** (sarcini fără termen) și **Cu dată** - **Interval personalizat**: alegeți în calendar o dată de început și una de sfârșit și faceți clic pe **Aplică intervalul**. Ziua de sfârșit se include integral Dacă faceți din nou clic pe o opțiune aleasă, filtrul dispare. ## Combinarea mai multor filtre [#meerdere-filters-combineren] De îndată ce aveți două sau mai multe filtre, apare un meniu de alegere: - **Toate filtrele** - o sarcină trebuie să se potrivească cu fiecare filtru - **Oricare filtru** - este suficient ca o sarcină să se potrivească cu unul dintre filtre Cu **Ștergeți filtrele** eliminați toate filtrele dintr-o dată. ## Exemple [#voorbeelden] - *Tot ce trebuie făcut astăzi și este încă deschis*: filtrați **Termen** pe **Astăzi** și **Stare** pe tot în afară de **Finalizată** - *Sarcini pentru care trebuie să aștept*: filtrați **Stare** pe **În așteptarea răspunsului** și **Atribuit către** pe **Eu** - *Tot în afară de notificările despre asigurările expirate*: filtrați **Text** pe **Nu conține** `Verzekering vervallen:` - *Tot ce ține de un singur client*: deschideți clientul. Pe fila **Sarcini** din pagina clientului găsiți toate sarcinile legate de acel client ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Filtrele de pe ecranul dumneavoastră restrâng ce vedeți. Abia când le salvați cu **Salvează vizualizarea** ele aparțin vizualizării, iar colegii văd aceeași selecție. - Puteți salva filtre și pe vizualizarea încorporată **Toate**. Ele se aplică atunci tuturor celor din organizația dumneavoastră. Pentru aceasta aveți nevoie de dreptul **Gestionarea etichetelor și a vizualizărilor partajate**. - La o vizualizare filtrată, sarcinile apar și dispar singure, în funcție de cum corespund filtrelor. - Bara de căutare nu este salvată niciodată. ## Probleme? [#problemen] Verificați dacă este activ un filtru, de exemplu un filtru de stare care exclude **Finalizată**, sau **Toate filtrele** când vă referiți la unul dintre filtre. Cu **Ștergeți filtrele** o luați de la capăt. Nu l-ați salvat. Alegeți **Salvează vizualizarea** în bara **Modificări nesalvate**. **Salvează vizualizarea** este inactiv dacă nu aveți dreptul **Gestionarea etichetelor și a vizualizărilor partajate**, deoarece **Toate** se aplică întregii organizații. Cereți-l unui administrator sau creați o vizualizare proprie cu aceleași filtre. Vedeți doar sarcinile pe care aveți voie să le vedeți. O sarcină dintr-o vizualizare personală a unui coleg este invizibilă pentru dumneavoastră. Vezi [Sarcini private](/taken/prive-taken). După ce alegeți o dată de început și una de sfârșit, faceți clic pe **Aplică intervalul**. # Tabel, panou și calendar (/ro-RO/taken/indelingen) Puteți vedea aceleași sarcini în trei moduri. În dreapta sus deschideți **Afișare** pentru a alege: - **Aspect** - **Tabel**, **Panou** sau **Calendar**. Această alegere apare doar la vizualizările salvate, nu la **Toate** - **Grupează după** - cum sunt împărțite sarcinile în grupuri sau coloane - **Sortează după** și **Ordine** - **Crescător** sau **Descrescător** - **Tip** - dacă vizualizarea este o **Listă** sau o **Vizualizare filtrată**, vezi [Vizualizări](/taken/weergaven#twee-soorten-weergaven). Și aceasta apare doar la vizualizările salvate - **Finalizate** - cât timp rămân vizibile sarcinile finalizate Modificările rămân o propunere până le salvați, vezi [Salvarea sau renunțarea la modificări](/taken/weergaven#wijzigingen-opslaan-of-verwerpen). ## Ascunderea sarcinilor finalizate [#voltooide-taken-verbergen] La **Finalizate** în meniul **Afișare** stabiliți cât timp o sarcină finalizată rămâne în vizualizare: | Alegere | Ce vedeți | |---|---| | **Afișează toate** | Toate sarcinile finalizate (implicit) | | **Ascunde** | Nicio sarcină finalizată | | **Ultima zi** | Sarcini finalizate în ultima zi | | **Ultima săptămână** | Sarcini finalizate în ultima săptămână | | **Ultima lună** | Sarcini finalizate în ultima lună | Se numără din momentul în care sarcina a fost trecută pe **Finalizată**. Un comentariu sau un nume nou nu schimbă acest lucru. Dacă redeschideți o sarcină, ea apare imediat din nou în vizualizare. Dacă vizualizarea are deja un filtru de stare care exclude sarcinile finalizate, acel filtru rămâne valabil. ## Gruparea [#groeperen] | Grupare | Rezultat | |---|---| | **Fără grupare** | Toate sarcinile într-o listă | | **Stare** | Un grup pe stare | | **Prioritate** | Un grup pe prioritate | | **Atribuit către** | Un grup pe coleg | | **Etichetă** | Un grup pe etichetă | | **Client** | Un grup pe client | | **Termen** | Grupuri precum **Întârziat**, **Astăzi**, **Săptămâna aceasta**, **Mai târziu** și **Fără termen** | | **Coloane proprii** | Coloane pe care le creați dumneavoastră, doar la vizualizările salvate | O sarcină cu mai mulți colegi sau mai multe etichete apare în grupul fiecăruia dintre ei. ## Sortarea [#sorteren] Puteți sorta după **Manual**, **Termen**, **Prioritate**, **Stare**, **Nume**, **Creat** sau **Actualizat**. La **Manual** stabiliți ordinea dumneavoastră, trăgând cardurile. La celelalte alegeri câmpul stabilește ordinea, iar tragerea într-o coloană nu are efect, cu excepția coloanelor proprii. ## Tabel [#tabel] Tabelul arată un rând pe sarcină. La o grupare primiți un bloc pe grup. La **Coloane** în meniul vizualizării activați sau dezactivați coloane: **Sarcină**, **Stare**, **Prioritate**, **Termen**, **Vizualizări**, **Atribuit către**, **Asociat** și **Etichetă**. Coloana **Asociat** arată toate elementele de care este legată sarcina. Coloana **Sarcină** rămâne mereu vizibilă. La multe sarcini, Tillor încarcă mai întâi o parte. Derulați în jos sau faceți clic pe **Încarcă mai multe** pentru restul. ## Panou [#bord] Panoul arată fiecare grup ca o coloană, în stil kanban. Faceți clic sus pe o coloană pe **Sarcină nouă** pentru a crea acolo o sarcină. Aceasta primește automat valoarea coloanei, de exemplu starea sau colegul atribuit. Trageți un card de sarcină într-o altă coloană și sarcina preia valoarea acelei coloane: - la un panou pe **Stare** se schimbă starea - la **Prioritate** se schimbă prioritatea - la **Atribuit către** se schimbă colegul atribuit - la **Etichetă** și **Client** se schimbă eticheta sau clientul - la **Coloane proprii** sarcina se mută în acea coloană La un panou pe **Termen** nu puteți trage carduri în altă coloană, deoarece ar trebui inventat un termen. Modificați termenul în sarcina însăși. Dacă într-o coloană sunt mai multe sarcini decât se afișează, jos apare **Încă [număr]**. Un card blocat de alte sarcini sau care blochează alte sarcini arată acest lucru, de exemplu **Blocată de 1 sarcină**. ### Coloane proprii [#eigen-kolommen] La **Coloane proprii** creați dumneavoastră coloanele, de exemplu *De planificat*, *Comandat* și *Gata*: 1. Alegeți în **Afișare** la **Grupează după** opțiunea **Coloane proprii** (sau alegeți-o deja la creare) 2. Faceți clic în dreapta panoului pe **Coloană nouă** și dați coloanei un nume 3. Din meniul unei coloane alegeți **Editează** pentru a schimba numele sau **Șterge** 4. Trageți coloanele de titlu pentru a schimba ordinea Coloanele proprii noi pornesc goale. Fiecare sarcină din vizualizare se află atunci mai întâi în **Fără coloană** până o repartizați. La o listă puteți ascunde acele sarcini cu bifa **Arată sarcinile fără coloană**. La o vizualizare filtrată ele rămân vizibile, altfel nu le-ați putea repartiza niciodată. Dacă treceți de la **Coloane proprii** la altă grupare și salvați, coloanele proprii ale acelei vizualizări sunt șterse, împreună cu locul fiecărei sarcini în ele. Acest lucru nu poate fi anulat. Tillor afișează un avertisment în prealabil. ### Atribuirea sarcinilor la o listă [#taken-toewijzen-aan-een-lijst] La un panou al unei liste apare, cât timp există sarcini care nu se află încă în ea, butonul **Atribuie sarcini**. Acesta deschide o coloană suplimentară **Nu este în această vizualizare** cu sarcinile care corespund filtrelor vizualizării, dar nu se află încă în ea. Căutați cu **Filtrează sarcinile...** și trageți o sarcină într-o coloană pentru a o adăuga la vizualizare. Faceți clic din nou pe buton pentru a închide coloana. ## Calendar [#kalender] Calendarul arată o grilă lunară cu sarcinile la **termenul** lor. Săptămâna începe luni, iar zilele urmează fusul orar al organizației dumneavoastră. Sarcinile fără termen nu apar în calendar. - Cu săgețile mergeți la luna anterioară sau următoare, cu **Astăzi** reveniți la luna curentă - Pe zi vedeți cel mult trei sarcini. Faceți clic pe **+încă [număr]** pentru a vedea restul zilei - Faceți clic pe o sarcină pentru a deschide detaliile - Trageți o sarcină în altă zi pentru a muta termenul. Ora rămâne aceeași, se schimbă doar ziua - Sarcinile finalizate sunt tăiate, apar sub sarcinile deschise ale zilei respective și nu pot fi trase Gruparea nu are influență în calendar: toate sarcinile se află în aceeași grilă. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Modificările dumneavoastră din **Afișare** sunt mai întâi o propunere pe ecranul dumneavoastră. Abia după **Salvează vizualizarea** sunt valabile pentru toți cei care văd vizualizarea. - Dacă trageți un card în altă coloană, sarcina însăși se modifică. La un panou pe **Stare** se schimbă starea, iar colegii văd imediat acest lucru. - Tragerea unui card într-un calendar mută termenul în acea zi. Ora rămâne aceeași. ## Probleme? [#problemen] La un panou pe **Termen** nu se poate, deoarece Tillor ar trebui să inventeze un termen. Modificați termenul în sarcină. Sarcinile dintr-un calendar le trageți în altă zi, cu excepția sarcinilor finalizate. Vedeți **Mutarea sarcinii a eșuat**. Cardul revine la locul vechi. Încercați din nou. Acestea apar doar la vizualizările salvate, nu la **Toate**. Calendarul arată sarcinile la termenul lor. O sarcină fără termen nu apare în el. La coloanele proprii noi, toate sarcinile pornesc în **Fără coloană** până le repartizați. Trageți-le în coloana potrivită. Ați trecut la altă grupare și ați salvat. Tillor șterge atunci coloanele proprii, iar acest lucru nu poate fi anulat. Tillor avertizează în prealabil. # Prezentare generală (/ro-RO/taken) Cu sistemul de sarcini urmăriți ce trebuie făcut în parcul dumneavoastră și de către cine. O sarcină poate avea un termen, un memento, unul sau mai mulți colegi sau grupuri atribuite, etichete, atașamente, subsarcini, timp consumat și clienți, parcele, facturi, rezervări, contoare, conversații sau tranzacții bancare asociate. Vedeți sarcinile prin **vizualizări**. O vizualizare este un mod salvat de a privi sarcinile dumneavoastră, de exemplu *Sarcini deschise*, *Sarcinile mele* sau *Întreținere*. Fiecare vizualizare apare ca filă în partea de sus a paginii. ## Unde găsiți sarcinile [#waar-vind-je-taken] - **Sarcini** în meniul lateral: pagina principală cu toate vizualizările dumneavoastră - **Tablou de bord**: cardul **Sarcini pentru dvs.** arată sarcinile care vă sunt atribuite sau vizualizarea dumneavoastră preferată - **Clienți > [client] > Sarcini**: toate sarcinile legate de un client - **Sarcini deschise**: un bloc pe pagina unui client, a unei rezervări, a unei facturi, a unei parcele și a unui contor Sus sunt vizualizările ca file. Dedesubt sunt bara de căutare și filtrele, iar în dreapta butoanele **Afișare**, **Urmărește** și de partajare. Mai jos vedeți sarcinile, aici ca panou pe stare. Treceți cu mouse-ul peste marcajele ℹ pentru explicații. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] O sarcină este un singur lucru, iar vizualizările sunt moduri de a privi sarcinile. Sarcinile apar prin colegi sau prin automatizări. O automatizare poate și aștepta o sarcină. ```mermaid flowchart LR A["Un coleg creează o sarcină
pe pagina de sarcini sau dintr-un client, o factură sau un contor"] --> T["Sarcină"] B["O automatizare creează o sarcină
pasul Creează sarcină, în numele Flux de lucru"] --> T T --> L["Listă
arată doar sarcinile pe care le adăugați dumneavoastră"] T --> G["Vizualizare filtrată
arată fiecare sarcină care corespunde filtrelor"] L --> Z["Vizibilitatea vizualizării
stabilește cine vede sarcina"] T -- "Un coleg alege un buton de pe sarcină" --> W["Automatizarea nu mai așteaptă
și merge mai departe"] T -- "Starea sau atribuirea se schimbă" --> S["O automatizare poate porni de aici"] ``` - Dacă puneți o sarcină într-o vizualizare, sarcina însăși nu se schimbă. Doar vizualizarea o primește în plus. - O vizualizare filtrată nu scoate sarcini din ea: acestea apar sau dispar singure, după cum corespund sau nu filtrelor. - O sarcină creată de o automatizare este o sarcină obișnuită. Dacă are butoane de alegere (pasul **Cere o decizie**), automatizarea așteaptă până când cineva alege un buton. Vezi [Sarcini cu butoane de alegere](/taken/taakdetails#taken-met-keuzeknoppen) și [Sarcini în automatizări](/automatiseringen/acties/taken). ## Începeți rapid [#snel-aan-de-slag] 1. Deschideți **Sarcini** în meniul lateral 2. Faceți clic pe **Vizualizare nouă**. Completați un **Nume** și alegeți la **Vizibilitate**, **Conținut**, **Coloane** și **Începe cu** ce doriți. Apoi faceți clic pe **Vizualizare nouă** jos în dialog 3. Faceți clic sus pe o coloană pe **Sarcină nouă**, dați-i sarcinii un nume și faceți clic pe **Creați** 4. Faceți clic pe o sarcină pentru a deschide detaliile: stare, prioritate, termen, colegi atribuiți și altele 5. Bifați căsuța din stânga unei sarcini imediat ce este gata Fără vizualizări proprii puteți oricând reveni la vizualizarea încorporată **Toate**, care arată toate sarcinile pe care aveți voie să le vedeți. Filtrele salvate pe **Toate** se aplică întregii organizații. ## Stări [#statussen] | Stare | Semnificație | |---|---| | **În așteptare** | Sarcina este planificată, dar nu s-a început încă lucrul la ea | | **În curs** | Se lucrează activ la sarcină | | **În așteptarea răspunsului** | Puteți continua abia după ce altcineva, de exemplu un client sau un furnizor, a făcut ceva sau a răspuns | | **Finalizată** | Sarcina este încheiată | Iată cum arată același fel de sarcină înainte și după bifare. Sus este o sarcină deschisă, dedesubt una finalizată: titlul este tăiat, iar starea este **Finalizată**. O sarcină finalizată coboară în partea de jos a unei liste sau coloane sortate manual. Dacă puneți o sarcină părinte pe **Finalizată**, se finalizează și subsarcinile deschise. Dacă redeschideți apoi sarcina, subsarcinile rămân finalizate. O vizualizare poate ascunde sarcinile finalizate după un timp, vezi [Ascunderea sarcinilor finalizate](/taken/indelingen#voltooide-taken-verbergen). ## Priorități [#prioriteiten] O sarcină are prioritatea **Scăzută**, **Medie**, **Ridicată** sau **Urgentă**. ## Componente [#onderdelen] - Nu există drepturi separate pentru sarcini. Cine lucrează în Tillor poate crea și edita sarcini. Ce sarcini vedeți depinde de vizualizările în care se află. Vezi [Sarcini private](/taken/prive-taken) - O sarcină nouă poate avea până la 50 de subsarcini. Subsarcinile au un singur nivel - Dacă puneți o sarcină pe **Finalizată**, se finalizează și subsarcinile deschise - Cine urmărește o vizualizare primește în fiecare dimineață la 07:00 un rezumat, cu cel mult 15 sarcini pe listă - Un cronometru în curs se oprește după zece minute fără mouse sau tastatură - O etichetă cu un **Termen țintă (zile)** atribuie automat un termen sarcinilor fără termen - O sarcină pe care o ștergeți nu poate fi restaurată ## Noțiuni [#begrippen] - **Sarcină**: o lucrare pe care o urmăriți, cu stare, prioritate, termen și eventual colegi atribuiți - **Vizualizare**: o filă pe pagina de sarcini cu un mod propriu de a arăta sarcinile, vezi [Vizualizări](/taken/weergaven) - **Listă**: o vizualizare care arată doar sarcinile pe care le adăugați dumneavoastră - **Vizualizare filtrată**: o vizualizare care arată fiecare sarcină ce corespunde filtrelor - **Subsarcină**: o parte a unei sarcini, ca listă de verificare - **Blocaj**: o sarcină care trebuie să fie gata înainte ca o altă sarcină să poată începe - **Flux de lucru**: utilizatorul în numele căruia o [automatizare](/begrippen#automatisering) creează sarcini Mai mulți termeni găsiți în [glosar](/begrippen). # Etichete (/ro-RO/taken/labels) Cu etichetele dați sarcinilor o categorie, de exemplu *Întreținere*, *Reclamații* sau *Sezon*. Puteți filtra și grupa după etichete. O etichetă are un nume, o culoare și eventual o descriere. ## Gestionarea etichetelor [#labels-beheren] Mergeți la Setări > Etichete de sarcini. Vedeți această pagină dacă aveți voie să vizualizați sau să editați setările generale ale organizației dumneavoastră. Prezentarea are coloanele **Etichetă**, **Descriere** și **Sarcini** (numărul de sarcini cu acea etichetă). - **Etichetă nouă** creează o etichetă cu un **Nume**, o **Descriere**, o **Culoare** și eventual un **Termen țintă (zile)** - **Editează eticheta** modifică ulterior aceste date - **Șterge eticheta** elimină eticheta și arată în prealabil pe câte sarcini se află. Eticheta dispare de pe toate acele sarcini Puteți crea o etichetă și în timp ce editați o sarcină: scrieți numele în câmpul **Etichete** și alegeți **Creați [nume]**. ## Setarea automată a unui termen [#een-deadline-automatisch-instellen] La o etichetă puteți completa **Termen țintă (zile)**, de exemplu *7*. O sarcină fără termen care primește acea etichetă primește atunci singură un termen: atâtea zile mai târziu, începând din momentul în care sarcina a fost creată sau eticheta a fost adăugată. - Acest lucru se întâmplă la crearea unei sarcini cu eticheta sau dacă adăugați eticheta ulterior - Dacă sarcina are deja un termen, acesta rămâne neschimbat - Dacă o sarcină are mai multe etichete cu țintă, se aplică cel mai mic număr de zile - Dacă lăsați câmpul gol, eticheta nu setează niciun termen Este util pentru etichete precum *Reclamație* (în 2 zile) sau *Urmărire ofertă* (în 7 zile). ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - O etichetă nouă o puteți atribui imediat sarcinilor, în sarcina însăși și în meniul rapid. - O etichetă cu un **Termen țintă (zile)** atribuie automat un termen sarcinilor fără termen din acel moment. - Dacă ștergeți o etichetă, aceasta dispare de pe toate sarcinile pe care se afla. Sarcinile rămân. ## Probleme? [#problemen] Nu aveți voie să vizualizați setările generale ale organizației dumneavoastră. Cereți unui administrator să vă modifice drepturile. Completați un **Nume** (cel mult 50 de caractere) și încercați din nou. La editare și ștergere, mesajele sunt **Eticheta nu a putut fi actualizată** și **Eticheta nu a putut fi ștearsă**. Un termen al etichetei se aplică doar sarcinilor fără termen. Dacă sarcina are deja unul, acesta rămâne. La mai multe etichete cu țintă se aplică cel mai mic număr de zile. # Notificări (/ro-RO/taken/meldingen) Tillor vă ține la curent cu sarcinile prin e-mail și notificări push. ## Mementouri și termene [#herinneringen-en-deadlines] Dacă o sarcină are un **Memento** sau un **Termen**, alegeți în fereastra de detalii la **Notificări** dacă doriți **E-mail** și/sau **Notificare push**. Ambele sunt activate implicit. Dacă le dezactivați pe amândouă, nimeni nu primește o notificare pentru acea sarcină. - Un memento se declanșează la momentul setat, cu titlul *Memento sarcină* - O notificare de termen se declanșează de îndată ce termenul a fost atins și sarcina nu este încă finalizată - Sarcinile finalizate nu mai dau memento sau notificare de termen - Un memento repetitiv se declanșează la fiecare repetare, până când sarcina este finalizată sau programul expiră Notificarea ajunge la colegii atribuiți, inclusiv la membrii unui grup atribuit. Dacă nu este atribuit nimeni, ajunge la cel care a creat sarcina. E-mailul arată o previzualizare a sarcinii, cu starea și un buton pentru a o deschide. ## Atribuire, dezasociere și finalizare [#toewijzen-ontkoppelen-en-voltooien] - Dacă vi se atribuie o sarcină, chiar și printr-un grup din care faceți parte, primiți o notificare (**Sarcină nouă atribuită**). Dacă vă atribuiți singur o sarcină, nu primiți notificare - Dacă cineva vă scoate de pe o sarcină, primiți o notificare că sarcina a fost **neatribuită** (**Sarcină neatribuită**) - Dacă o sarcină este finalizată, colegii atribuiți și cel care a creat-o primesc o notificare, cu excepția celui care a finalizat sarcina. Notificarea este trimisă cu o întârziere de aproximativ un minut. Dacă cineva redeschide sarcina în acest interval, notificarea nu mai este trimisă ## Urmărirea unei vizualizări [#een-weergave-volgen] Cu **Urmărește** (în dreapta sus la o vizualizare salvată) primiți în fiecare dimineață la 07:00 un e-mail cu un rezumat al acelei vizualizări. E-mailul are subiectul *Rezumat zilnic* cu numele vizualizării și conține trei liste: - **Restante** - sarcini deschise al căror termen a trecut - **Scadente azi** - sarcini deschise care trebuie finalizate astăzi - **Modificate de la ultimul rezumat** - sarcini deschise care au fost modificate de la ultimul dumneavoastră rezumat Fiecare listă arată cel mult 15 sarcini, cu termenul alături. Jos se află butonul **Deschide vizualizarea**, care duce direct la vizualizare. - Dacă nu există nimic în cele trei liste, nu primiți e-mail în ziua respectivă - Butonul devine **Urmărită**. Faceți clic pe el pentru a nu mai urmări. Puteți urmări orice vizualizare pe care o puteți vedea, inclusiv vizualizările colegilor - Dacă pierdeți accesul la vizualizare, de exemplu pentru că proprietarul o face vizibilă doar pentru el sau o șterge, nu o mai urmăriți automat - Vedeți doar sarcinile pe care aveți voie să le vedeți Vizualizarea încorporată **Toate** nu o puteți urmări, deoarece nu este o vizualizare salvată. ## Probleme? [#problemen] Verificați în sarcină la **Notificări** dacă **E-mail** sau **Notificare push** este activat. O notificare ajunge la colegii atribuiți sau la cel care a creat sarcina dacă nu este atribuit nimeni. Sarcinile finalizate nu mai dau notificări. Așa este. O notificare **Sarcină nouă atribuită** primiți doar dacă altcineva vă atribuie sarcina. Nu urmăriți vizualizarea (butonul **Urmărește** trebuie să arate **Urmărită**) sau nu există nimic la **Restante**, **Scadente azi** și **Modificate de la ultimul rezumat**. Atunci nu trimitem e-mail în ziua respectivă. Nu mai urmăriți automat vizualizarea și dacă nu mai aveți voie să o vedeți. Modificarea nu a fost salvată. Faceți din nou clic pe **Urmărește**. # Sarcini private (/ro-RO/taken/prive-taken) O sarcină este privată dacă se află doar în vizualizări personale. Nu trebuie să setați nimic pentru asta: vizualizările în care se află o sarcină stabilesc cine o vede. ## Regulile [#de-regels] | Unde se află sarcina | Cine o vede | |---|---| | În nicio vizualizare | Toți utilizatorii organizației | | În cel puțin o vizualizare **Public** | Toți utilizatorii organizației | | Doar în vizualizări personale (**Doar tu** sau **Partajat**) | Cel care a creat sarcina, colegii și grupurile atribuite, precum și proprietarul și persoanele și grupurile alese ale acelor vizualizări | Subsarcinile urmează sarcina părinte. O sarcină pe care nu aveți voie să o vedeți nu apare nicăieri: nici în liste, rezultate de căutare, filtre, tabloul de bord, la un client, în calendar sau în notificări, și nici nu o puteți deschide printr-un link. ## Exemplu [#voorbeeld] Jan creează vizualizarea personală *Ideile mele* cu vizibilitatea **Doar tu**. Adaugă în acea listă sarcina *Solicitare ofertă pentru bariera nouă*. - Doar Jan vede sarcina. Colegii lui nu o văd nicăieri - Jan atribuie sarcina lui Piet. Acum și Piet vede sarcina, chiar dacă nu a văzut niciodată vizualizarea lui Jan - Jan partajează *Ideile mele* cu Els (**Partajat**). Acum și Els vede sarcina - Jan adaugă sarcina în vizualizarea *Întreținere*, care este **Public**. Din acel moment întreaga echipă vede sarcina - Dacă Jan scoate sarcina din *Întreținere* și nu se mai află nicăieri într-o vizualizare publică, ea este din nou privată Dacă Jan nu ar fi pus sarcina în nicio vizualizare, toată lumea ar fi văzut-o. ## Cine stabilește vizibilitatea unei vizualizări [#wie-bepaalt-de-zichtbaarheid-van-een-weergave] Doar proprietarul unei vizualizări personale poate modifica cu cine este partajată vizualizarea sau o poate face **Public**. Un coleg cu care partajați vizualizarea poate edita sarcinile din vizualizare, dar nu poate modifica vizibilitatea și nici nu poate șterge vizualizarea. Vezi [Vizualizări](/taken/weergaven#wie-ziet-een-weergave). Adăugarea unei sarcini private la o vizualizare publică o face vizibilă pentru toată lumea. Tillor cere mai întâi să confirmați cu **Faci această sarcină publică?**. Puteți alege apoi **Păstreaz-o privată** sau **Fă-o publică**. Aceeași întrebare apare dacă scoateți sarcina din ultima ei vizualizare publică. Dacă faceți **Public** o vizualizare personală care conține sarcini, acele sarcini devin vizibile pentru toată lumea fără o întrebare separată. ## Sfaturi [#tips] - Dacă doriți să predați o sarcină privată, atribuiți-o unui coleg sau partajați vizualizarea cu acel coleg - O sarcină contează ca fiind „într-o vizualizare" de îndată ce o adăugați la o listă sau o puneți într-o coloană proprie a vizualizării. Simpla afișare printr-un filtru nu face ca ea să se afle în vizualizare - Notificările despre o sarcină privată, precum un termen, ajung doar la persoanele care au voie să vadă sarcina ## Probleme? [#problemen] Sarcina se află doar în vizualizări personale. Atribuiți-o colegului, partajați vizualizarea cu el sau puneți sarcina într-o vizualizare publică. Adăugați o sarcină privată la o vizualizare publică sau o scoateți din ultima ei vizualizare publică. Alegeți **Păstreaz-o privată** sau **Fă-o publică**. Poate sarcina a fost asociată altei vizualizări sau vizualizarea în care se afla nu mai este vizibilă pentru dumneavoastră. Întrebați persoana care a creat-o sau proprietarul vizualizării. ## Vezi și [#zie-ook] # Detaliile sarcinii (/ro-RO/taken/taakdetails) În fereastra de detalii a unei sarcini înregistrați totul: cine o execută, când trebuie finalizată, cât timp implică și de ce este legată. Faceți clic pe o sarcină pentru a deschide fereastra. În stânga sunt numele, descrierea și părțile precum subsarcinile și comentariile. În dreapta sunt proprietățile, precum starea, prioritatea și termenul. Modificările la o sarcină existentă se salvează imediat. Doar descrierea o salvați singur cu **Salvare**. Puteți deschide o sarcină și direct cu un link. Copiați-l din meniul cu trei puncte din dreapta sus a ferestrei, vezi [Meniul sarcinii](#het-menu-van-de-taak). ## Crearea unei sarcini [#een-taak-aanmaken] Sarcinile se creează în mai multe locuri: în partea de sus a unei coloane dintr-un panou (**Sarcină nouă**), în cardul **Sarcini pentru dvs.** de pe tabloul de bord, pe pagina unui client, sau dintr-o conversație, o factură ori un alt element, vezi [Sarcini pe alte pagini](/taken/taken-op-andere-paginas). 1. Faceți clic pe **Sarcină nouă** 2. Completați un **Nume**. Restul este opțional 3. Adăugați eventual subsarcini la **Adaugă un subtask**: tastați un nume și apăsați Enter. Puteți adăuga până la 50 4. Faceți clic pe **Creați** sau apăsați Cmd ori Ctrl împreună cu Enter În partea de sus a ferestrei apare vizualizarea în care ajunge sarcina. Dacă creați sarcina dintr-o coloană a unui panou, ea primește automat acea vizualizare și coloană. Puteți alege alta sau puteți elimina vizualizarea. Dumneavoastră sunteți completat ca persoană atribuită. Dacă vă eliminați și nu alegeți pe nimeni, sarcina nu are nicio persoană atribuită. Blocajele și timpul consumat se adaugă după ce sarcina a fost creată. ## Proprietăți [#eigenschappen] - **Status** și **Prioritate** - vezi [prezentarea generală](/taken#statussen) - **Atribuit către** - unul sau mai mulți colegi sau [grupuri](/gebruikers/groepen). Căutați cu **Caută persoane sau grupuri...**. Dacă atribuiți un grup, sarcina este valabilă pentru toți cei care fac parte din grup în acel moment - **Clienți** - asociați unul sau mai mulți clienți cu **Adaugă un client** - **Etichete** - vezi [Etichete](/taken/labels). O etichetă care lipsește o creați direct tastând numele și alegând **Creați [nume]** - **Termen** - data limită, cu ora. Dacă termenul a trecut, timpul relativ devine roșu - **Memento** - o dată și o oră la care doriți o notificare, eventual repetată - **Notificări** - imediat ce este setat un memento sau un termen, alegeți dacă doriți un **E-mail** și/sau o **Notificare push**. Ambele sunt activate implicit - **Creată de** - cine a creat sarcina - **Câmpuri personalizate** - câmpuri pe care organizația dumneavoastră le-a adăugat singură la sarcini. Modificările se salvează imediat. Vezi [Câmpuri personalizate](/eigen-velden) - **Vizualizare** - faceți clic în stânga sus pe numele vizualizării pentru a alege în ce liste se află sarcina și în ce coloană. La o vizualizare filtrată alegeți doar o coloană - **Privată** - dacă vedeți o lacăt cu **Privată**, sarcina apare doar în vizualizările personale, vezi [Sarcini private](/taken/prive-taken) O sarcină poate avea și o **Descriere**. Aceasta acceptă Markdown pentru formatare. ## Mementouri repetate [#herhalende-herinneringen] Un memento se poate repeta până când sarcina este finalizată: 1. Setați mai întâi un **Memento** (dată și oră) 2. Faceți clic pe câmpul de repetare de dedesubt (implicit **Nu se repetă**) 3. Alegeți **Zilnic**, **În fiecare zi lucrătoare (lun. – vin.)**, **Săptămânal**, **Lunar**, **Anual** sau **Personalizat…** Cu **Personalizat…** vă creați propriul program: - **Repetă la fiecare** - un număr de zile, săptămâni, luni sau ani - **Se repetă în** - la un program săptămânal, zilele săptămânii în care poate veni mementoul - **Se încheie** - **Niciodată**, **La data** sau **După** un număr de ori Dacă un memento cade într-o zi pe care ați exclus-o, el se mută fără notificare la următoarea zi permisă. Repetarea se oprește de îndată ce sarcina are starea **Finalizat** sau programul se încheie. ## Elemente asociate [#gekoppelde-items] La **Elemente asociate** vedeți de ce este legată sarcina. Puteți asocia mai multe elemente de fiecare tip: parcele, facturi, rezervări, contoare, convorbiri telefonice, tranzacții bancare, produse și conversații din inbox. O sarcină poate fi asociată și unui comentariu. O sarcină despre o tranzacție bancară o creați din meniul tranzacției, la **Tranzacții bancare**, cu **Creează sarcină**. O sarcină despre un produs, de exemplu verificarea contului din registrul mare, o creați pe pagina produsului din meniul **⋯** cu **Creează sarcină**; sarcinile deschise ale produsului apar în partea de sus a acelei pagini. Un element suplimentar îl asociați cu plusul de la **Elemente asociate** (tooltip **Asociază element**). Căutați după un client, o parcelă, un contor, o factură, o rezervare sau un produs. Dacă elementul ales aparține unui client, Tillor întreabă **Asociezi și [client]?**: - **Asociază ambele** - sarcina apare și la client - **Doar acest element** - clientul nu este asociat sarcinii Cu **Dezasociază** eliminați din nou o asociere. Sarcinile asociate care sunt încă deschise apar pe pagina elementului la **Sarcini deschise**. ## Atașamente [#bijlagen] La **Atașamente** adăugați fișiere la sarcină. Faceți clic pe plus sau lipiți un fișier cu Cmd ori Ctrl și V oriunde în fereastră. ## Subsarcini [#subtaken] O sarcină poate avea subsarcini, o listă de verificare în fereastra de detalii. Există un singur nivel: o subsarcină nu poate avea la rândul ei subsarcini. 1. Deschideți sarcina părinte sau completați-le deja în timp ce creați o sarcină 2. La **Adaugă un subtask** tastați un nume și apăsați Enter 3. Bifați o subsarcină pentru a o seta la **Finalizat**. Bifați-o din nou pentru a o readuce 4. Faceți clic pe nume pentru a o redenumi sau pe coșul de gunoi pentru a o șterge 5. Trageți o subsarcină de mâner pentru a schimba ordinea. Cu **Adaugă descriere** puteți da unei subsarcini și o descriere La o sarcină nouă, subsarcinile se creează împreună cu sarcina, în ordinea în care le-ați completat. Subsarcinile nu apar ca un card separat în panouri, în tabele sau în calendar. Pe sarcină vedeți un contor precum **2/5**. Dacă setați sarcina părinte la **Finalizat**, toate subsarcinile deschise sunt finalizate odată cu ea. Invers nu este necesar: puteți finaliza sarcina părinte în timp ce mai există subsarcini deschise. ## Blocaje și dependențe [#blokkades-en-afhankelijkheden] Uneori o sarcină poate începe sau fi finalizată abia după ce alta este gata. În fereastra de detalii înregistrați acest lucru: - **Blocată de** - sarcini care trebuie să fie finalizate mai întâi. Adăugați-le cu **Adaugă sarcină care blochează** - **Blochează alte sarcini** - sarcini care așteaptă această sarcină. Adăugați-le cu **Adaugă sarcină blocată** La fiecare grup vedeți câte sarcini mai sunt deschise (de exemplu **2 încă deschise**). Căutați sarcini cu **Caută sarcini...** și ștergeți o legătură cu **Elimină legătura**. Pe cardul sarcinii, sub nume, apare un rând precum **Blocată de 1 sarcină**. Puteți filtra după sarcini blocate, vezi [Filtrare](/taken/filteren). Un blocaj nu vă oprește. Dacă încercați să bifați o sarcină blocată, Tillor întreabă **Finalizezi o sarcină blocată?** și o finalizează abia dacă alegeți **Finalizează oricum**. Adăugați un blocaj și din meniul cu trei puncte din dreapta sus a ferestrei, cu **Adaugă sarcină care blochează** și **Adaugă sarcină blocată**. ## Timp lucrat [#bestede-tijd] Lângă **Timp lucrat** din fereastra de detalii apare totalul. Faceți clic pe el pentru a înregistra timp. Aveți două moduri: - Un **cronometru**. Faceți clic pe **Pornește**, lucrați la sarcină și faceți clic pe butonul de oprire când ați terminat. Timpul se adaugă la sarcină, cu secundele incluse - **Completare ulterioară**. Introduceți durata, de exemplu **1:30**, **90** (minute), **1u 30m** sau **1.5h**. Toate cele patru înseamnă o oră și jumătate. Adăugați eventual o notă la **Ce ai făcut? (opțional)** și faceți clic pe **Înregistrează** Timpul se înregistrează în ziua de azi. În listă vedeți pentru fiecare înregistrare cine a făcut-o, data, nota și durata. Colegii văd înregistrările celorlalți, dar puteți șterge doar propriile înregistrări, prin coșul de gunoi care apare când treceți cu mouse-ul peste rând. ### Cronometrul [#de-timer] - Un cronometru pornit continuă să meargă când treceți la altă pagină. Apare atunci ca un cartonaș în dreapta jos, cu butoane pentru a întrerupe (**Întrerupe**), a relua (**Reia**), **Check-in** și a opri (**Încheie**). Faceți clic pe numele sarcinii pentru a reveni - Cu **Check-in** salvați porțiunea de până acum, cu o scurtă notă despre ce făceați, iar cronometrul continuă apoi - Puteți urmări timpul doar la o singură sarcină simultan. Cât timp cronometrul dumneavoastră merge, **Pornește** este dezactivat la celelalte sarcini - Dacă timp de zece minute nu folosiți mouse-ul sau tastatura, cronometrul se întrerupe în ultimul moment în care ați fost activ - Colegii văd în fereastra sarcinii că lucrați (**În curs**) sau că sunteți în pauză (**În pauză**). Acel timp se adaugă la total abia după ce a fost salvat ## Comentarii și activitate [#opmerkingen-en-activiteit] În partea de jos a ferestrei se află secțiunea **Comentarii**. Cu **Adăugați un comentariu** scrieți un comentariu. Puteți menționa colegi într-un comentariu, astfel încât să primească o notificare. Dedesubt se află **activitatea**: o cronologie a creării și a modificărilor, cu, la o modificare, ce era înainte și după. ## Meniul sarcinii [#het-menu-van-de-taak] În dreapta sus a ferestrei se află un meniu cu trei puncte. - **Adaugă sarcină care blochează** și **Adaugă sarcină blocată** înregistrează o dependență - **Printează** are trei opțiuni. **Printează (A4)** deschide dialogul de imprimare al browserului cu un pdf al sarcinii. **Trimite la imprimanta A4** și **Trimite la imprimanta termică (POS)** trimit sarcina la imprimanta dumneavoastră, de exemplu o imprimantă de bonuri. Pe acestea două le puteți alege doar dacă organizația dumneavoastră are un [conector](/connector) cu imprimantă, vezi [Imprimantă](/printer) - **Copiază linkul** copiază un link care deschide direct sarcina. Cine deschide linkul trebuie să aibă dreptul să vadă sarcina - **Elimină** se află în partea de jos, vezi [Ștergerea unei sarcini](#een-taak-verwijderen) Documentul tipărit arată numele, starea, prioritatea, termenul și descrierea, iar la **Elemente asociate** clienții, facturile, rezervările, parcelele și contoarele de care este legată sarcina. Dacă sarcina are blocaje, apar și sarcinile care o blochează și sarcinile pe care le blochează ea. Un grup fără elemente este omis. ## Sarcini cu butoane de alegere [#taken-met-keuzeknoppen] Unele sarcini, de exemplu dintr-o [automatizare cu pasul Cere o decizie](/automatiseringen/logica#vraag-om-een-beslissing), cer o decizie. În loc de o bifă, pe sarcină apar butoane, cu deasupra **Alege o acțiune pentru a finaliza această sarcină.** Faceți clic pe un buton și sarcina este finalizată. - Dacă alegerea cere un motiv, Tillor deschide mai întâi o fereastră cu **De ce această alegere?** în care completați o notă - Dacă alegerea cere o confirmare, Tillor afișează mai întâi o fereastră. O alegere făcută nu mai poate fi anulată din sarcină - Apoi, pe sarcină apare ce alegere a fost făcută și de cine - Poate alege cine este atribuit sarcinii și un administrator. Dacă nu este atribuit nimeni, poate alege oricine vede sarcina Iată cum sunt legate sarcina și automatizarea: ```mermaid flowchart TD A["Automatizarea ajunge la pasul
Cere o decizie"] --> B["Tillor creează o sarcină cu butoanele dumneavoastră
iar automatizarea așteaptă"] B --> C{"Un coleg alege un buton"} C -- "O opțiune" --> D["Sarcina are starea Finalizat
automatizarea continuă prin acea opțiune"] C -- "Nimeni nu alege în timpul de așteptare" --> E["Automatizarea continuă prin Expirat
sarcina rămâne"] C -- "Sarcina este ștearsă" --> E ``` O sarcină creată de o automatizare și care poate fi finalizată doar de flux afișează, în loc de o bifă, textul **Finalizată de automatizarea sa**. Atunci nu o puteți finaliza, iar în meniu nu are **Elimină**. ## Schimbarea rapidă a stării și bifarea [#status-snel-wijzigen-en-afvinken] Fără a deschide fereastra, puteți: - Bifa căsuța din stânga numelui sarcinii pentru a seta sarcina la **Finalizat**. Dacă o debifați, revine la **În așteptare** - Face clic pe cele trei puncte de pe cardul sarcinii sau clic dreapta pe card pentru un meniu rapid cu **Editează**, **Status**, **Prioritate**, **Memento**, **Termen**, **Etichete**, **Vizualizări** și **Elimină**. **Etichete** apare doar dacă există etichete, iar **Vizualizări** doar dacă există liste la care adăugați singur sarcini ## Ștergerea unei sarcini [#een-taak-verwijderen] Alegeți **Elimină** în meniul rapid al sarcinii sau în meniul cu trei puncte din fereastra sarcinii și confirmați. Acest lucru nu poate fi anulat, iar eventualele subsarcini dispar odată cu ea. Ștergerea este înregistrată în [jurnalul de activitate](/activiteitenlog). La o sarcină pe care doar o automatizare are voie să o finalizeze, **Elimină** nu apare în meniu. Dacă o astfel de sarcină este totuși ștearsă în alt mod, automatizarea care aștepta finalizarea eșuează. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Modificările la o sarcină existentă sunt salvate imediat. Doar descrierea o salvați singur cu **Salvare**. - Dacă atribuiți sarcina, colegul respectiv (sau membrii grupului) primește o notificare. Vezi [Notificări](/taken/meldingen). - Dacă setați sarcina la Finalizat, subsarcinile deschise sunt de asemenea finalizate, iar colegii atribuiți și autorul primesc o notificare, cu excepția dumneavoastră. Sarcina coboară în partea de jos a unei liste sortate manual. - Un memento sau un termen generează o notificare până când sarcina este finalizată. - O sarcină creată de o [automatizare](/automatiseringen/acties/taken) poate la rândul ei să pornească o automatizare, de exemplu la o schimbare de stare sau când cineva alege un buton. - Ștergerea nu poate fi anulată. Ștergerea este înregistrată în [jurnalul de activitate](/activiteitenlog). ## Probleme? [#problemen] Sarcina așteaptă încă una sau mai multe sarcini nefinalizate (vezi **Blocată de**). Finalizați mai întâi acele sarcini sau alegeți **Finalizează oricum**. La **Finalizată de automatizarea sa** nu puteți finaliza singur sarcina. Automatizarea o finalizează. Dacă sarcina are butoane sub **Alege o acțiune pentru a finaliza această sarcină.**, faceți clic pe un buton. Poate alege cine este atribuit sarcinii și un administrator. Dacă nu este atribuit nimeni, poate alege oricine vede sarcina. La mesajul de eroare **Alegerea nu a putut fi salvată** încercați din nou. Cronometrul dumneavoastră merge deja la o altă sarcină. Puteți urmări timpul doar la o singură sarcină simultan. Opriți mai întâi acel cronometru. După zece minute fără mouse sau tastatură, cronometrul se întrerupe în ultimul moment în care ați fost activ. Folosiți **Reia** pentru a continua. Introduceți o durată pe care Tillor o înțelege, precum **1:30**, **90**, **1u 30m** sau **1.5h**. Dacă tot eșuează, vedeți mesajul **Timpul nu a putut fi înregistrat** și încercați din nou. Puteți șterge doar propriile înregistrări. **Trimite la imprimanta A4** și **Trimite la imprimanta termică (POS)** le puteți alege doar dacă organizația dumneavoastră are un conector cu imprimantă. **Printează (A4)** funcționează întotdeauna. Dacă ceva nu merge, vedeți mesajul **PDF-ul sarcinii nu a putut fi generat**. Modificarea nu a fost salvată. Încercați din nou sau reîmprospătați pagina. La o sarcină pe care doar o automatizare are voie să o finalizeze, **Elimină** nu apare în meniu. În rest, orice coleg care vede sarcina o poate șterge. ## Vezi și [#zie-ook] # Sarcini pe alte pagini (/ro-RO/taken/taken-op-andere-paginas) Sarcinile nu stau izolat. Le creați din elementul despre care sunt și le vedeți acolo. ## Crearea unei sarcini dintr-un alt element [#een-taak-maken-vanuit-een-ander-item] Sarcina este asociată automat elementului. Dacă este implicat un client, îl puteți asocia și pe acesta. Sarcina este atribuită implicit dumneavoastră. | Unde | Buton | |---|---| | Pagina clientului | **Creează sarcină** în meniul de acțiuni al clientului | | Factură | **Creează sarcină** în meniul de acțiuni | | Contor | **Creează sarcină** în meniul de acțiuni | | Rezervare | **Creează sarcină** | | Parcelă | **Creează sarcină** | | Conversație în inbox | **Creează sarcină** | | Convorbire telefonică | **Creează sarcină** | | Comentariu | Pictograma de sarcină de la comentariu (tooltip **Creați o sarcină din acest comentariu**) | | Tranzacție bancară | **Creează sarcină** în meniul de acțiuni al tranzacției, la Administrare > Tranzacții bancare | ## Un memento de urmărire la un comentariu [#een-opvolgherinnering-bij-een-opmerking] La un comentariu există și un ceas pentru a vă reaminti dumneavoastră (sau colegilor menționați) să urmăriți comentariul. Cu el creați o sarcină precum *Urmărește acest comentariu* sau *Verifică dacă [nume] a observat acest lucru*. Dacă ulterior marcați comentariul ca rezolvat, sarcina de urmărire este finalizată automat. ## Sarcini deschise la un element [#openstaande-taken-bij-een-item] Pe pagina unui client, a unei rezervări, a unei facturi, a unei parcele și a unui contor se află un bloc **Sarcini deschise** cu sarcinile care nu sunt încă finalizate și sunt legate de acel element. Dacă nu există sarcini deschise, blocul nu apare. Pe pagina Clienți > [client] > Sarcini se află toate sarcinile clientului. O deschideți din fila **Sarcini** de pe pagina clientului. Sarcinile finalizate sunt restrânse sub **Sarcini finalizate**, cu numărul lor alături. ## Pe tabloul de bord [#op-het-dashboard] Cardul **Sarcini pentru dvs.** arată sarcinile atribuite dumneavoastră. Cu steluța alegeți o vizualizare favorită pe care o doriți să o vedeți acolo în schimb, vezi [Vizualizări](/taken/weergaven#een-favoriete-weergave-voor-het-dashboard). Puteți crea acolo direct o sarcină sau puteți partaja sarcinile. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Sarcina este legată de elementul din care ați creat-o. O vedeți la **Elemente asociate** în sarcină. - Cât timp sarcina nu este finalizată, ea apare în blocul **Sarcini deschise** de pe pagina acelui element și a clientului asociat. - O sarcină de urmărire la un comentariu este finalizată automat când marcați comentariul ca rezolvat. ## Probleme? [#problemen] Pe unele pagini butonul se află în meniul de acțiuni, cum ar fi la un client, o factură sau un contor. Căutați acolo cele trei puncte. Blocul apare doar dacă la element sunt încă legate sarcini nefinalizate. Sarcina nu a fost salvată. Completați un nume și încercați din nou. ## Vezi și [#zie-ook] # Vizualizări (/ro-RO/taken/weergaven) În partea de sus a paginii **Sarcini** se află un rând de file. Fiecare filă este o vizualizare. Prima filă, **Toate**, este încorporată: arată fiecare sarcină și nu o puteți edita, muta sau șterge. Puteți totuși salva pe ea filtre și setări ale vizualizării pentru întreaga organizație. Toate celelalte vizualizări le creați singur. ## Două tipuri de vizualizări [#twee-soorten-weergaven] La creare alegeți tipul de vizualizare la **Conținut**. | Tip | Ce face | |---|---| | **Vizualizare filtrată** | Arată fiecare sarcină care îndeplinește filtrele, ca o căutare salvată. Sarcinile noi care se potrivesc apar automat | | **Listă** | Arată doar sarcinile pe care le adăugați dumneavoastră | O listă este utilă pentru o colecție fixă, de exemplu *Pregătirea sezonului*. O vizualizare filtrată este utilă pentru tot ce îndeplinește o regulă, de exemplu *Toate sarcinile urgente care așteaptă clientul*. Puteți schimba tipul ulterior la **Afișare** (dreapta sus), la **Tip**. Nu se poate face la **Toate**. Dacă transformați o listă într-o vizualizare filtrată, sarcinile pe care le-ați adăugat manual sunt desprinse de ea. Tillor cere mai întâi o confirmare, deoarece acest lucru nu poate fi anulat. ## Crearea unei vizualizări [#een-weergave-aanmaken] 1. Faceți clic pe **Vizualizare nouă**, în dreapta filelor 2. Completați un **Nume** și, eventual, o **Descriere** 3. La **Vizibilitate** alegeți cine vede vizualizarea: **Public**, **Doar tu** sau **Partajat**. La **Partajat** alegeți la **Partajează cu** colegii și grupurile 4. La **Conținut** alegeți o **Vizualizare filtrată** sau o **Listă** 5. La **Coloane** alegeți cum sunt grupate sarcinile: **Coloane proprii**, **Status**, **Atribuit către** sau **Fără grupare** 6. La **Începe cu** alegeți un filtru de pornire: **Toate sarcinile**, **Sarcini deschise** sau **Sarcinile mele** 7. Faceți clic pe **Vizualizare nouă** în partea de jos a dialogului Implicit, vizualizarea este setată la **Public**, **Vizualizare filtrată**, **Status** și **Sarcini deschise**. Dacă alegeți **Fără grupare**, obțineți un tabel. La celelalte alegeri începeți cu un panou. Îl modificați ulterior, vezi [Tabel, panou și calendar](/taken/indelingen). O vizualizare filtrată setată ca tabel arată astfel. Filtrele sunt deasupra tabelului și aici sunt deja salvate. ## Cine vede o vizualizare [#wie-ziet-een-weergave] | Alegere | Cine vede vizualizarea | |---|---| | **Public** | Toți utilizatorii organizației (o vizualizare a organizației) | | **Doar tu** | Doar dumneavoastră (o vizualizare personală). Pe filă apare un lacăt | | **Partajat** | Dumneavoastră și colegii și grupurile pe care le alegeți la **Partajează cu**. Pe filă apare o pictogramă cu mai multe persoane | La **Partajează cu** alegeți persoane și grupuri din aceeași listă. Un [grup](/gebruikers/groepen) contează așa cum este alcătuit în acel moment: cine intră ulterior în grup vede și vizualizarea, iar cine părăsește grupul nu o mai vede. Doar proprietarul unei vizualizări personale poate schimba cu cine este partajată sau o poate face vizibilă pentru toți. Colegii cu care partajați vizualizarea pot lucra în ea, dar nu pot stabili cine o mai vede și nici nu o pot șterge. Dacă setați o vizualizare la **Public**, lista persoanelor și grupurilor alese dispare. Vizibilitatea unei vizualizări stabilește și cine vede sarcinile din acea vizualizare. Citiți [Sarcini private](/taken/prive-taken) înainte de a pune sarcini într-o vizualizare personală. ## Editarea, duplicarea sau ștergerea unei vizualizări [#een-weergave-bewerken-dupliceren-of-verwijderen] Faceți clic dreapta pe fila vizualizării și alegeți: - **Editează** - modificați numele, descrierea, vizibilitatea și coloanele. Filtrele, sortarea și aspectul rămân așa cum au fost salvate. **Conținut** și **Începe cu** le alegeți doar la creare; tipul îl schimbați ulterior la **Afișare** - **Duplică** - creează o copie cu numele *[nume] (copie)* și o deschide imediat - **Elimină** - după confirmare, vizualizarea dispare. Sarcinile în sine rămân și pierd doar această vizualizare Trageți filele pentru a schimba ordinea. Noua ordine este salvată imediat. ## Salvarea sau renunțarea la modificări [#wijzigingen-opslaan-of-verwerpen] Dacă modificați filtrele sau setările vizualizării, acestea apar mai întâi doar pe ecranul dumneavoastră. În dreapta sus apare o bară cu **Modificări nesalvate** și două butoane: - **Salvează vizualizarea** păstrează modificările în vizualizare - **Renunță** readuce totul la versiunea salvată La vizualizarea încorporată **Toate** salvați modificările pentru toți cei din organizația dumneavoastră, la fel ca la o vizualizare publică. Pentru aceasta aveți nevoie de dreptul **Gestionarea etichetelor și a vizualizărilor partajate**. Fără acest drept, la **Toate** puteți doar să folosiți **Renunță**. Bara de căutare (**Căutați sarcini...**) nu este niciodată salvată cu vizualizarea: ea doar restrânge ceea ce vedeți acum. ## O vizualizare favorită pentru tabloul de bord [#een-favoriete-weergave-voor-het-dashboard] Pe tabloul de bord, cardul **Sarcini pentru dvs.** arată implicit sarcinile atribuite dumneavoastră. Puteți asocia în schimb o vizualizare: 1. Faceți clic pe steluță în dreapta sus a cardului 2. Alegeți o vizualizare din listă. Alegeți **Sarcini pentru dvs.** pentru a reveni la propriile sarcini atribuite Puteți avea o singură vizualizare favorită simultan, iar aceasta este valabilă doar pentru dumneavoastră. Dacă vizualizarea a fost ștearsă ulterior sau nu mai este vizibilă pentru dumneavoastră, tabloul de bord arată din nou propriile sarcini. ## Urmărirea unei vizualizări [#een-weergave-volgen] Cu butonul **Urmărește** din dreapta sus primiți în fiecare dimineață un e-mail cu ce necesită atenție în acea vizualizare. Funcționarea este descrisă la [Notificări](/taken/meldingen#een-weergave-volgen). ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Noua vizualizare apare ca filă în partea de sus a paginii de sarcini. O vizualizare filtrată arată imediat toate sarcinile care se potrivesc, iar sarcinile noi care se potrivesc se adaugă automat. - La **Public**, toți utilizatorii organizației dumneavoastră văd vizualizarea. La **Doar tu** o vedeți doar dumneavoastră, iar la **Partajat** dumneavoastră și colegii și grupurile alese. - Dacă ștergeți o vizualizare, sarcinile rămân. Ele pierd doar acea vizualizare. - Dacă transformați o listă într-o vizualizare filtrată, sarcinile pe care le-ați adăugat manual sunt desprinse. - O vizualizare pe care o urmăriți vă trimite în fiecare dimineață un rezumat. Vezi [Notificări](/taken/meldingen#een-weergave-volgen). ## Probleme? [#problemen] Vedeți **Vizualizarea nu a putut fi creată**. Verificați dacă ați completat un **Nume** și încercați din nou. Dacă tot nu merge, verificați dacă conexiunea la internet este bună. La duplicare mesajul este **Vizualizarea nu a putut fi duplicată** și se aplică același lucru. **Toate** este încorporată și arată fiecare sarcină pe care aveți voie să o vedeți. Numele, poziția și vizibilitatea sunt fixe. Puteți totuși salva pe ea filtre și setări ale vizualizării, pentru întreaga organizație. Creați o vizualizare proprie dacă doriți o selecție doar pentru dumneavoastră. Doar proprietarul unei vizualizări personale stabilește cu cine este partajată și o poate face publică sau o poate șterge. Colegii cu care o partajați pot totuși edita sarcini în ea. Ați modificat filtre sau setări ale vizualizării, iar acestea sunt încă doar pe ecranul dumneavoastră. Alegeți **Salvează vizualizarea** pentru a le păstra sau **Renunță** pentru a reveni. La **Toate** aveți nevoie pentru aceasta de dreptul **Gestionarea etichetelor și a vizualizărilor partajate**; fără acest drept puteți doar să renunțați acolo. O listă arată doar sarcinile pe care le adăugați dumneavoastră. Dacă doriți ca tot ce îndeplinește o regulă să apară automat, alegeți la **Tip** o vizualizare filtrată. Atunci Tillor afișează **Vizualizările nu au putut fi reordonate**. Trageți din nou filele. ## Vezi și [#zie-ook] # Parcele (/ro-RO/terreinen) O parcelă este un loc din parcul dumneavoastră: un lot, un chalet, un loc pentru autorulote sau un loc fix. Aici creați parcelele, le dați un tip și un tarif și le asociați contoare. Apoi așezați pe ele clienți cu o [ocupare](/bezettingen) sau o [rezervare](/reserveringen). Le găsiți la Parc > Parcele. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] ```mermaid flowchart LR T[Parcelă] --> M[Contoare] T --> Tar[Tarif calculat] K[Client] -->|ocupare| T Tar --> F[Facturi] M --> V[Consumul clientului] V --> F ``` De o parcelă este legat tot ce aparține acelui loc. Tariful rezultă din suprafața și din câmpurile personalizate ale parcelei. Contoarele de pe parcelă furnizează consumul, iar acest consum merge la clientul cu o ocupare activă. Vezi și [Gestionarea contoarelor](/meterbeheer#hoe-hangt-dit-samen). - Numele este obligatoriu și poate avea cel mult 255 de caractere. - **Rezervabil** este dezactivat implicit la o parcelă nouă. - Suprafața o calculează Tillor de îndată ce desenați parcela pe hartă. Nu o introduceți dumneavoastră. - **Parcele recente** numără parcelele din ultimele 7 zile. - O parcelă are cel mult o ocupare activă simultan. - Tariful calculat este recalculat de îndată ce salvați o parcelă și pentru toate parcelele de îndată ce salvați formula de tarif. - Dacă ștergeți un tip de parcelă, parcelele rămân, dar nu mai au atunci niciun tip. ## Crearea unei parcele noi [#een-nieuw-terrein-aanmaken] Înainte de a începe: dacă aveți nevoie de tipuri de parcelă (precum **Loc** sau **Chalet**) sau de câmpuri personalizate, creați-le mai întâi. Vezi [Tipuri de parcelă](#terreintypes) și [Câmpuri personalizate](/eigen-velden). ### Faceți clic pe Creează un teren nou [#klik-op-nieuw-terrein-aanmaken] Găsiți butonul în dreapta sus la Parc > Parcele. ### Completați datele [#vul-de-gegevens-in] Doar **Nume** este obligatoriu. În rest puteți completa: - **Descriere**, o explicație. - **Tip de parcelă**, sau lăsați **Fără tip**. - **Câmpuri personalizate** pe care organizația dumneavoastră le-a adăugat singură, precum un supliment sau un număr de contor de gaz. - **Rezervabil**, dacă clienții pot rezerva parcela online. - **Locație**, pentru a indica parcela direct pe hartă. ### Faceți clic pe Creați parcela [#klik-op-terrein-aanmaken] Parcela apare în listă. Dacă nu ați desenat locația, o faceți ulterior pe plan, vezi [Hartă](/kaart#terreingrenzen-intekenen). ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Parcela apare în listă și în statisticile din partea de sus: **Total parcele**, **Parcele recente**, **Parcele rezervabile**, **Parcele nerezervabile** și **Suprafață totală** (doar pentru parcelele cu o locație desenată). - Tillor calculează **Tarif calculat** din formula de tarif a organizației dumneavoastră. - Pe pagina de detalii puteți asocia contoare, adăuga comentarii și vedea istoricul. ## Vizualizarea și editarea unei parcele [#een-terrein-bekijken-en-bewerken] Faceți clic pe o parcelă din listă. În partea de sus apar numele, descrierea, suprafața, numărul de contoare, dacă este rezervabilă, **Client** cu o ocupare activă și data creării și a modificării. În formularul **Actualizați parcela** modificați: - **Nume**, **Tip de parcelă**, **Descriere**, **Rezervabil** și **Câmpurile personalizate**. - **Suprafață** și **Tarif calculat** sunt doar de citit. Salvați cu **Actualizați parcela**. Lângă formular se află **Locație**, **Contoare** și **Istoric ocupare**. Dedesubt se află **Comentarii** (vizibile doar pentru colegii dumneavoastră), **Evenimente** cu o prezentare înainte/după pentru fiecare câmp modificat și **Rezervări**. ## Asocierea contoarelor la o parcelă [#meters-aan-een-terrein-hangen] În cardul **Contoare** alegeți **Adăugați contor** și apoi **Atribuiți contor**. În listă apar doar contoarele fără parcelă. Pentru fiecare contor vedeți tipul, un indicator de stare și ultima citire. Cu meniul (...) alegeți **Dezasociați de la parcelă**; această opțiune se află doar aici. Traseul complet către client este descris la [Asocierea unui contor la un client](/meterbeheer/meter-koppelen). ## Tipuri de parcelă [#terreintypes] Cu tipurile de parcelă împărțiți parcelele, de exemplu **Loc**, **Chalet** sau **Parcare de rulote**. Tipul îl vedeți în lista de parcele (coloana **Tip**, cu un filtru), puteți colora harta după el și apare în export. Le gestionați la Asistență > Setări > Tipuri de parcelă. Tabelul **Toate tipurile de parcelă** arată pentru fiecare tip **Nume**, **Culoarea hărții**, **Descriere** și numărul de **Parcele**. Căutați cu **Căutați tipuri de parcelă...**. Cu creionul editați un tip, cu coșul de gunoi îl ștergeți. ### Faceți clic pe Tip de parcelă nou [#klik-op-nieuw-terreintype] ### Completați datele [#vul-de-gegevens-in-1] Dați un **Nume**, eventual o **Descriere**, și alegeți o **Culoarea hărții**. Albastrul este preselectat. ### Faceți clic pe Creați [#klik-op-aanmaken] Un tip îl asociați unei parcele prin câmpul **Tip de parcelă**. Culoarea hărții o vedeți pe plan dacă la **Straturi** setați culorile pe **Tip de parcelă**, vezi [Hartă](/kaart#lagen-en-kleuren). ## Exportul parcelelor [#terreinen-exporteren] Faceți clic pe **Exportați toate parcelele** (dreapta sus) pentru a descărca un fișier Excel. Conține pentru fiecare parcelă datele de bază, tipul de parcelă, câmpurile personalizate și calculul tarifului (subtotal, suplimente și total). Folosiți-l, de exemplu, pentru controlul anual al tarifelor. ## Cum se formează tariful [#hoe-het-tarief-tot-stand-komt] **Tarif calculat** rezultă din formula de tarif a organizației dumneavoastră. Formula calculează cu suprafața și cu câmpurile personalizate ale parcelei. Care sunt acele câmpuri personalizate stabiliți dumneavoastră. Formula standard folosește câmpurile cu cheile `locationSurcharge`, `gasMeterNumber`, `electricityMeterSurcharge` și `staticPrice`. Dacă le-ați creat la Asistență > Setări > Câmpuri personalizate, funcționează astfel: 1. **Suprafață**: suprafața desenată, pe trepte pe m². 2. **Supliment contor de gaz**: se adaugă dacă este completat câmpul cu numărul contorului de gaz. 3. **Supliment amplasare**: suma pe care o introduceți. 4. **Supliment electricitate**: suma pe care o introduceți. 5. **Preț static**: dacă acest câmp este completat, suma respectivă înlocuiește tariful calculat, iar Tillor ignoră formula. Dacă doriți să modificați tariful unui an, ajustați câmpurile personalizate, verificați la **Tarif calculat** dacă este corect și salvați cu **Actualizați parcela**. ### Formula de tarif [#tariefformule] La Setări > Tarif parcelă stabiliți singur cum se calculează tariful. Cine avea deja voie să editeze setările a primit dreptul **Editare formulă tarif parcelă**. Formula este o bucată de TypeScript (un limbaj de programare) care returnează tariful anual în euro sau părți denumite care împreună formează tariful, precum `Subtotaal` și `Toeslag gasmeter`. Fiecare parte primește o coloană proprie în export. - Câmpurile parcelei le citiți cu `{terrain.veld}`, precum `{terrain.surfaceArea}` sau `{terrain.customFields.locationSurcharge}`. Prin butonul **Variabilă** sau tastând `{` alegeți dintre toate câmpurile, inclusiv cele proprii. - În dreapta formulei o încercați imediat pe una dintre parcelele dumneavoastră. O eroare o vedeți acolo cu numărul rândului. O formulă care nu funcționează nu o puteți salva. - Cu **Revino la formula implicită** reveniți la formula cu care a început fiecare organizație. - În automatizări citiți tariful ca `{terrain.calculatedTariff.total}`. Formula rulează izolat: poate calcula doar cu câmpurile parcelei, fără alte date sau internet. O formulă care calculează prea mult timp este întreruptă și nu produce atunci niciun tarif. ## Probleme? [#problemen] Parcela nu a fost salvată. Verificați dacă **Nume** este completat și nu are mai mult de 255 de caractere, apoi încercați din nou. Suprafața provine doar din locația de pe hartă. Desenați parcela prin Parc > Hartă, vezi [Hartă](/kaart#terreingrenzen-intekenen). Parcelele fără locație nu se numără în **Suprafață totală**. Verificați câmpurile personalizate ale parcelei (suplimente și numărul contorului de gaz). Dacă este completat un **Preț static**, acesta înlocuiește tariful calculat. Dacă formula a fost modificată, verificați la Tarif parcelă dacă testul pe această parcelă este corect. Aveți nevoie de dreptul **Editare formulă tarif parcelă**. Cereți-l administratorului dumneavoastră. Acel contor este deja asociat unei alte parcele. Dezasociați-l mai întâi de acolo. O parcelă cu o ocupare activă nu apare în lista de alegere. Încheiați mai întâi ocuparea în curs. ## Noțiuni [#begrippen] - **Parcelă**: un loc din parcul dumneavoastră. Vezi [Noțiuni](/begrippen#terrein). - **Tip de parcelă**: o împărțire precum **Loc** sau **Chalet**, cu o culoare pe hartă. - **Rezervabil**: clienții pot rezerva parcela online. - **Tarif calculat**: tariful pe care Tillor îl calculează din formulă. - **Câmp personalizat**: un câmp pe care organizația dumneavoastră îl adaugă singură. Vezi [Noțiuni](/begrippen#eigen-veld). - **Ocupare**: un client pe o parcelă pentru o perioadă. Vezi [Noțiuni](/begrippen#bezetting). ## Vezi și [#zie-ook] # Control acces (/ro-RO/toegangscontrole) Cu Control acces stabiliți cine poate intra în parcul dumneavoastră și urmăriți cine se află înăuntru. Dați unui client o metodă de acces (număr de înmatriculare, etichetă NFC, cod QR sau cod PIN), comandați barierele de pe ecranul dumneavoastră și vedeți cine a trecut și când, prin ce punct de acces. O metodă de acces o creați pe profilul clientului, vezi [adăugarea unei metode de acces](#een-toegangsmethode-toevoegen). Cifrele din partea de sus numără toate accesările, ultimele 24 de ore, încercările permise și blocate și punctele dumneavoastră de acces active. Dedesubt se află acțiunile rapide, vehiculele din parc, jurnalul de acces și operațiunile controlerelor. - Un vehicul devine **Fantomă** dacă nu a fost văzut la un punct de acces timp de 7 zile, deși figura ca **Înăuntru**. - O metodă de acces QR o creați într-o singură operațiune în până la 100 de exemplare, fiecare cu propriul cod. - Un cod PIN are 4 până la 8 cifre și trebuie să fie unic în organizația dumneavoastră. - Fiecare număr de înmatriculare, fiecare etichetă NFC și fiecare cod QR poate apărea o singură dată în organizația dumneavoastră. - O metodă de acces care nu se încadrează în perioada **De la data** și **Până la data** nu oferă acces. - Un număr de înmatriculare cu starea **Blocare ușoară** este blocat doar în timpul programului recepției. - Un număr de înmatriculare expirat mai poate ieși implicit 2 zile în afara programului (cel mult 30). Vezi [Setări pentru controlul accesului](/gebruikers/instellingen-toegangscontrole). - Un vehicul apare pe profilul clientului printr-un număr de înmatriculare înregistrat sau prin eticheta NFC ori codul QR cu care clientul a intrat. ## Cum se leagă acestea? [#hoe-hangt-dit-samen] O metodă de acces este cheia unui client. Punctul de acces (bariera sau poarta) este ușa. Între ele se află echipamente din parcul dumneavoastră: o cameră care citește numerele de înmatriculare sau o cutie care citește etichete și coduri QR (un controler de acces) și [conectorul](/connector). Conectorul este cutia care leagă Tillor de dispozitivele din parcul dumneavoastră. ```mermaid flowchart TD K[Client] --> M[Metodă de acces
număr de înmatriculare, etichetă NFC, cod QR sau cod PIN] M -->|Tillor trimite lista mai departe| C[Conector în parcul dumneavoastră] C --> L[Cameră sau cititor de carduri
la intrare] L -->|permis| P[Punctul de acces se deschide] L -->|refuzat| W[Punctul de acces rămâne închis] L -->|fiecare încercare este raportată| LOG[Jurnal de acces în Tillor] ``` Ce înseamnă aceasta pentru dumneavoastră: - Dacă modificați sau ștergeți o metodă de acces în Tillor, Tillor transmite aceasta prin conector către echipamente. Rezultatul îl vedeți la **Operațiuni controler**. - Dacă conectorul este offline, metodele de acces noi sau modificate rămân pe **În așteptare** până când se reconectează. - Și o barieră pe care o deschideți din Tillor primește de obicei comanda prin conector. Dacă acesta este offline, bariera nu se deschide. Secțiunea Controlere din meniul principal se referă la altceva: ecranele cu cititor de etichete de la dușuri, uși și puncte de încărcare. Vezi [Controlere](/controllers). Echipamentele de la bariere sunt configurate de suportul Tillor la punerea în funcțiune. ## Comandarea punctelor de acces [#toegangspunten-bedienen] Sub **Acțiuni rapide** există un buton pentru fiecare punct de acces activ. Vedeți acest bloc doar dacă este configurat cel puțin un punct de acces sau un controler de acces. ### Faceți clic pe butonul punctului de acces [#klik-op-de-knop-van-het-toegangspunt] Eticheta este **Deschideți [nume]**. ### Confirmați [#bevestig] Se deschide o fereastră în care vi se cere să confirmați că doriți să deschideți punctul de acces. Faceți clic pe **Da, deschideți [nume]**. Tillor afișează **Punct de acces deschis**. Închiderea este posibilă doar dacă punctul de acces o acceptă. Atunci apare o săgeată în jos lângă butonul de deschidere: alegeți acolo **Închideți [nume]** și confirmați cu **Da, închideți [nume]**. ### Butoane de administrare în Acțiuni rapide [#beheerknoppen-in-snelle-acties] Lângă punctele de acces apar, în funcție de echipamente, butoane pentru întreținere. Folosiți-le doar când ceva nu este în regulă. | Buton | Ce face | Când | |---|---|---| | **Resetați APB** | Șterge memoria celui care a intrat sau a ieșit ultimul, pe tip: **Pentru permise NFC…** sau **Pentru coduri QR…**. | Oamenii nu mai trec pentru că poarta crede că sunt deja înăuntru (sau afară). APB înseamnă anti-passback. | | **Sincronizați jurnalele dispozitivului** | Pune conectorul să preia toate rândurile noi de la controlerele de acces. | Trecerile recente lipsesc din jurnalul de acces. | | **Resetați cache-ul conectorului** | Conectorul își șterge datele locale și le preia din nou de la Tillor. | Echipamentele se comportă altfel decât metodele de acces din Tillor. | | **Curățați citirile LPR nedorite** | Șterge doar rândurile fantomă sigure din lista de numere de înmatriculare. Numerele înregistrate și cele asociate rămân. | În listă apar numere de înmatriculare care nu aparțin nimănui. | ## Gestionarea metodelor de acces prin profilul clientului [#toegangsmethoden-beheren-via-het-klantprofiel] Metodele de acces le adăugați, le modificați și le ștergeți pe profilul clientului. ### Adăugarea unei metode de acces [#een-toegangsmethode-toevoegen] O metodă de acces aparține unui client și îi dă acestuia acces în parc. Le gestionați pe profilul clientului. Înainte de a începe: - Clientul există în Tillor. - Pentru NFC aveți nevoie de o etichetă care nu aparține încă nimănui. Dacă nu există nicio etichetă liberă, lista afișează **Nu s-au găsit carduri NFC disponibile; toate cardurile sunt deja atribuite.** - Tipul **Cod PIN** apare în listă doar dacă este activat pentru organizația dumneavoastră. ### Deschideți fila Control acces [#open-het-tabblad-toegangscontrole] Mergeți la Clienți > client > Control acces. În partea de sus se află tabelul **Metode de acces** (marcajul **1** din captura de ecran de mai jos). ### Faceți clic pe Adăugați și alegeți tipul [#klik-op-toevoegen-en-kies-het-type] Tipul nu îl mai puteți modifica ulterior. Dacă aveți nevoie de alt tip, adăugați o metodă de acces nouă. ### Completați datele [#vul-de-gegevens-in] Ce completați depinde de tip: La **Număr de înmatriculare** introduceți numărul. Tillor îl transformă în majuscule. Marca, modelul și culoarea sunt opționale. La **Carduri NFC** alegeți din listă o etichetă liberă. Puteți căuta după numărul etichetei. Codul îl creează Tillor singur. Cu **Cantitate** creați într-o singură operațiune până la 100 de metode de acces QR separate, fiecare cu propriul cod. Bifați **Imprimați imediat biletul termic** pentru a trimite fiecare QR nou imediat ca bilet de intrare la imprimanta termică. Adresa imprimantei o setați în setările organizației. Pe bilet apar **Valabil de la** și **Valabil până la** în fusul orar al organizației dumneavoastră. Introduceți 4 până la 8 cifre sau faceți clic pe **Generează**. Codul PIN trebuie să fie unic în organizația dumneavoastră. La un cod PIN lipsește acțiunea **Sincronizați cu sistemul de puncte de acces**. Pentru fiecare tip puteți completa în plus: | Câmp | Semnificație | |---|---| | **De la data**, **Până la data** | Perioada în care funcționează metoda de acces. Gol înseamnă fără limită. | | **Stare** | **Activ**, **Inactiv**, **Blocat** sau **Blocare ușoară** (vezi [stări](#statussen-van-toegangsmethoden)). | | **Conversie automată în număr de înmatriculare** | Doar la cod QR și cod PIN. Dacă cineva folosește codul la o poartă cu cameră, Tillor înlocuiește codul cu numărul de înmatriculare citit. Implicit dezactivat. | | **Nu prelungi automat** | Data de sfârșit rămâne neschimbată dacă se plătește o factură cu prelungire automată. | | **Note** | Notițe interne. | Apoi faceți clic pe **Adăugați** pentru a salva. #### Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Metoda de acces apare în tabel, iar Tillor o trimite prin conector către echipamente. Urmăriți aceasta la **Operațiuni controler**, cu starea În așteptare, Se procesează, Finalizat sau Eșuat. - O metodă de acces modificată sau ștearsă este transmisă în același mod. - Fiecare încercare de a intra apare în jurnalul de acces, inclusiv cele refuzate. - Un vehicul este asociat clientului printr-un număr de înmatriculare înregistrat sau prin faptul că clientul a intrat cu o etichetă NFC ori un cod QR în timp ce camera a citit și numărul de înmatriculare. Aceasta din urmă funcționează și dacă numărul de înmatriculare nu este înregistrat. #### Editarea, trimiterea sau ștergerea unei metode de acces [#een-toegangsmethode-bewerken-versturen-of-verwijderen] Faceți clic pe cele trei puncte din dreapta metodei de acces. | Acțiune | Pentru ce | |---|---| | **Editați** | Modificarea perioadei, a stării sau a datelor vehiculului. | | **Sincronizați cu sistemul de puncte de acces** | Retrimiterea către echipamente. Tillor afișează **Sincronizare solicitată**. Nu la un cod PIN. | | **Trimiteți notificare** | Trimite clientului linkul personal către QR prin e-mail, SMS sau WhatsApp (fereastra **Trimiteți codul QR**). | | **Copiați URL-ul personal** | Copiază linkul către permisul clientului, vezi [Portofel digital](#digitale-wallet-qr-code). | | **Descărcați codul QR**, **Imprimați bilet termic** | Doar la un cod QR. | | **Ștergere** | Elimină metoda de acces. Aceasta nu poate fi anulată. Cu bifele din tabel ștergeți mai multe deodată. | #### Stările metodelor de acces [#statussen-van-toegangsmethoden] | Stare | Semnificație | |---|---| | Activ | Oferă acces, atât timp cât perioada este corectă. | | Inactiv | Nu oferă acces. Funcționează ca Blocat, cu un nume mai clar. | | Blocat | Nu oferă acces. | | Blocare ușoară | La un număr de înmatriculare, blocat doar în timpul programului recepției. În afara acestuia, vehiculul poate intra și ieși în continuare. | ## Portofel digital (cod QR) [#digitale-wallet-qr-code] La o metodă de acces QR copiați un link personal pentru oaspete. Acesta deschide pagina **Permis de acces** cu codul QR. Dacă Apple Wallet sau Google Wallet sunt configurate pentru mediul dumneavoastră, apar și butoane pentru salvarea permisului. ### Copiați linkul [#kopieer-de-link] Deschideți cele trei puncte de la metoda de acces QR și faceți clic pe **Copiați URL-ul personal**. Tillor afișează **Link copiat**. ### Trimiteți linkul oaspetelui [#stuur-de-link-naar-de-gast] Oaspetele vede codul QR, valabilitatea și, dacă sunt disponibile, **Adăugați în Apple Wallet** și **Adăugați în Google Wallet**. Permisul de portofel folosește același cod QR, aceeași valabilitate și aceeași stare ca în Tillor. Pe un iPhone cu iOS 27, permisul apare ca Poster Generic, opțional cu un fundal propriu și un cod QR pătrat. iPhone-urile mai vechi afișează aspectul clasic. Pe iOS 27, pe permis există și scurtături: **Indicații de orientare** deschide Apple Maps către locația punctului de acces (sau către mijlocul hărții parcului), iar dacă ați setat un site web la datele companiei, apare și un buton către acel site. Fundalul și locația le setați la **Setări**, vezi [Organizație](/gebruikers/organisaties). Pe un iPhone, permisul poate apărea pe ecranul de blocare când oaspetele se află în apropiere. Pe Android, oaspetele salvează permisul în Google Wallet. ### Vizualizarea locului unde este salvat permisul [#zien-waar-de-pas-is-opgeslagen] Dacă un oaspete a adăugat permisul, lângă valoarea QR apare o mică pictogramă de portofel, cu un număr dacă sunt mai multe dispozitive. Țineți mouse-ul deasupra pentru a vedea: - dacă permisul se află în **Apple Wallet pe iPhone** sau **Google Wallet pe Android** și pe câte dispozitive - când permisul a fost **Ultima adăugare** și **Permis actualizat**, iar la Apple și **Ultima sincronizare** - dacă permisul a fost **Emis prin** un **Angajat** sau un **Link personal** Google nu anunță când un oaspete șterge permisul. La Google Wallet, permisul rămâne deci afișat ca salvat. ### Retrimiterea unui permis de portofel [#een-wallet-pas-opnieuw-versturen] Dacă un permis QR se modifică, de exemplu valabilitatea, Tillor trimite singur actualizarea către portofele. Dacă totuși apare o versiune veche, alegeți **Sincronizează permisul Wallet** din meniu. Tillor afișează câte dispozitive au primit actualizarea. Dacă permisul nu este încă înregistrat nicăieri, vedeți **Niciun dispozitiv înregistrat pentru actualizări.** Elementul de meniu apare abia după ce permisul a fost adăugat într-un portofel. ## Vehicule în parc [#voertuigen-in-het-park] Tabelul **Vehicule în parc** ține evidența, pe număr de înmatriculare, dacă un vehicul este înăuntru. O citire la o intrare pune vehiculul pe **Înăuntru**, o citire la o ieșire pe **A plecat**. Fiecare rând arată numărul de înmatriculare, starea, clientul, momentul intrării, ultimul moment în care vehiculul a fost văzut la un punct de acces și acel punct de acces. Implicit, tabelul arată vehiculele care sunt **Înăuntru** sau **Fantomă**. Prin filtre afișați și vehiculele plecate, filtrați după punct de acces sau căutați după număr de înmatriculare ori nume de client. | Stare | Semnificație | |---|---| | Înăuntru | A intrat printr-o intrare și nu a plecat încă. | | Fantomă | Figura ca Înăuntru, dar nu a mai fost văzut la un punct de acces de 7 zile. | | A plecat | A ieșit printr-o ieșire. | Un vehicul fantomă apare de obicei pentru că la ieșire camera nu a citit numărul de înmatriculare sau l-a citit greșit la intrare. Dacă numărul este văzut din nou ulterior la o intrare, vehiculul apare din nou ca **Înăuntru**. ### Ocuparea parcului [#parkbezetting] Cardul **Ocuparea parcului** arată câte vehicule sunt înăuntru: **În prezent înăuntru**, **Vârf** în perioada aleasă și numărul de **Intrări** și **Ieșiri**. Primul grafic arată evoluția, pe oră până la o săptămână și pe zi la o perioadă mai lungă. **Ore populare** arată, pe fiecare oră a zilei, numărul mediu de vehicule și de sosiri. Astfel vedeți, de exemplu, când este suficient de aglomerat pentru a deschide restaurantul. Cu selectorul de perioadă din dreapta sus alegeți astăzi, 7 zile, 30 de zile, 90 de zile, tot sau un interval propriu. ## Jurnal de acces [#toegangslogboek] Jurnalul de acces arată fiecare încercare de a intra, cu data, metoda de acces, clientul (dacă este cunoscut), punctul de acces și starea. Filtrați și căutați după număr de înmatriculare sau valoare (la NFC și după eticheta cardului), interval de date, stare, tipul metodei de acces, punct de acces sau client. Cu **Exportați** din dreapta barei de instrumente descărcați jurnalul ca fișier Excel. | Stare | Semnificație | |---|---| | Permis | Accesul a fost acordat. | | Blocat | Accesul a fost refuzat. | | Inactiv | Metoda de acces este inactivă. | | Expirat | Metoda de acces a expirat. | | Invalid | Metoda de acces este invalidă. | | Refuzat | Accesul a fost refuzat activ. | | Blocare ușoară | Accesul este blocat ușor. | | Eroare dispozitiv | A existat o problemă cu dispozitivul. | | Fără mașină | Nu a fost detectată nicio mașină. | | APB - Direcție nepotrivită | Poarta blochează trecerea pentru că direcția nu este corectă (anti-passback). | | Necunoscut | Starea nu a putut fi determinată. | | Mesaj de sistem | Un mesaj de la sistemul însuși. | ## Istoric stare punct de acces [#hekstatusgeschiedenis] Sub jurnalul de acces se află și **Istoric stare punct de acces**: când un punct de acces a fost **Deschis**, **Închis** sau **În mișcare**, cu **Sursă** mesajului. Dacă poziția nu este cunoscută, apare **Necunoscut**. Filtrați după stare sau punct de acces. Dacă lista este goală, nu au fost primite încă mesaje de poziție. ## Operațiuni controler [#controller-operaties] Dedesubt se află **Operațiuni controler**. Acestea sunt comenzile pe care Tillor le trimite către controlerele de acces, precum **Creați**, **Actualizați**, **Ștergere** și **Sincronizați**. Astfel vedeți când a ajuns un permis sau un cod QR la punctul de acces. O comandă are starea În așteptare, Se procesează, Finalizat sau Eșuat. Cu pictograma ochi din dreapta rândului deschideți detaliile. ## Probleme? [#problemen] Blocul apare doar dacă este configurat un punct de acces sau un controler de acces. Dacă nu apare nimic, suportul Tillor nu a asociat încă echipamentele. Punctul de acces nu a răspuns. De obicei conectorul este offline sau dispozitivul nu este accesibil. Verificați conectorul, vezi [Conectorul nu este conectat](/connector#problemen), și încercați din nou. Fiecare număr de înmatriculare, fiecare etichetă NFC și fiecare cod QR poate apărea o singură dată în organizația dumneavoastră. La un număr de înmatriculare, Tillor spune la ce client există deja. Ștergeți sau modificați mai întâi acea metodă de acces. Verificați în jurnalul de acces ce stare a primit încercarea. **Expirat** sau **Inactiv**: verificați **De la data**, **Până la data** și **Stare** ale metodei de acces. **Blocare ușoară**: numărul de înmatriculare este blocat în timpul programului recepției. **Eroare dispozitiv** sau **Fără mașină**: camera nu a citit nimic, verificați echipamentele. Dacă metoda de acces este corectă, dar poarta tot refuză, verificați la **Operațiuni controler** dacă ultima modificare este **Finalizat**. Verificați la **Operațiuni controler** dacă comanda este Finalizat. Dacă este pe **În așteptare**, conectorul este probabil offline. Dacă este pe **Eșuat**, alegeți **Sincronizați cu sistemul de puncte de acces** la metoda de acces. Poarta crede că sunt deja înăuntru (sau afară). Faceți clic pe **Resetați APB** în Acțiuni rapide și alegeți **Pentru permise NFC…** sau **Pentru coduri QR…**. Confirmați cu **Resetați**. În listă apar doar etichetele care nu aparțin încă nimănui. Eliminați mai întâi eticheta de la celălalt client, vezi [Gestionarea etichetelor](/nfc/nfc-tags#wat-kun-je-met-een-tag-doen). Vehiculul nu a mai fost văzut de 7 zile. De obicei a plecat fără ca camera să îl vadă. Devine din nou **Înăuntru** de la sine dacă numărul de înmatriculare este citit din nou la o intrare. ## Termeni [#begrippen] - **Metodă de acces**: cheia unui client, un număr de înmatriculare, o etichetă NFC, un cod QR sau un cod PIN. - **Punct de acces**: bariera, poarta sau ușa care se deschide. - **Controler de acces**: cutia de la punctul de acces care citește etichete și coduri QR. - **Conector**: cutia din parcul dumneavoastră care leagă Tillor de echipamente. Vezi [Conector](/connector). - **APB (anti-passback)**: regula că nu puteți trece de două ori în aceeași direcție printr-o poartă. - **Vehicul fantomă**: un vehicul care figurează ca înăuntru, dar nu a mai fost văzut de 7 zile. Mai multe explicații găsiți în [lista de termeni](/begrippen). ## Vezi și [#zie-ook] # Vreme (/ro-RO/weer) Pe pagina **Vreme** vedeți, pentru fiecare zi, vremea de la locația parcului dumneavoastră, astfel încât să puteți compara un vârf de consum sau de aglomerație cu vremea. Tillor folosește aceste date și la contoare și la rezervări. - Vremea este legată de centrul hărții organizației dumneavoastră. Dacă acesta este setat greșit, vremea afișată nu va corespunde. - Tillor preia vremea în fiecare noapte și completează zilele lipsă din trecut. - Implicit vedeți ultimele 14 zile. - O zi marcată **Arhivat** este definitivă. O zi marcată **Prognoză** se mai poate modifica. ## Deschiderea paginii [#de-pagina-openen] Mergeți la Parc > Vreme. Sub **Prognoză zilnică** apare locația, de exemplu **Centrul hărții: 50.8503, 4.3517**. Acesta este centrul hărții parcului dumneavoastră. Îl setați la Setări > Hartă. Dacă îl mutați, vremea urmează noua locație. Vezi [Hartă](/kaart). Vedeți: - un card mare pentru cea mai recentă zi, cu temperatura, condițiile, temperatura maximă și minimă și cantitatea de ploaie. Lângă zi apare **Arhivat** pentru o zi deja definitivă sau **Prognoză** pentru o zi care se mai poate actualiza - dedesubt, un card pentru fiecare zi, cu condițiile, de exemplu **Senin**, **Parțial noros**, **Înnorat**, **Ceață**, **Burniță**, **Ploaie**, **Averse**, **Zăpadă** sau **Furtună**, temperatura maximă și minimă și ploaia în mm. Ziua de azi are un chenar colorat - **Nu există date pentru această zi** în dreptul unei zile pentru care Tillor nu are nimic ## Alegerea altei perioade [#een-andere-periode-kiezen] Implicit vedeți ultimele 14 zile. Faceți clic în dreapta sus pe **Selectați o perioadă** pentru a alege altă perioadă: **Astăzi**, **Ieri**, **Ultimele 7 zile**, **Ultima lună**, **Ultimele 3 luni**, **Toate** sau un **Interval personalizat** în calendar. Confirmați un interval propriu cu **Aplicați**. ## Încă nu există date meteo [#nog-geen-weergegevens] Dacă apare **Nu există încă date meteo**, vremea nu a fost preluată încă. Tillor o preia în fiecare noapte pentru centrul hărții organizației dumneavoastră și completează și zilele lipsă din trecut. Încercați o altă perioadă sau reveniți a doua zi. Verificați și dacă centrul hărții este corect. ## Unde mai vedeți vremea [#waar-zie-je-het-weer-nog-meer] - Pe pagina contorului, la **Consum și tendințe**: la o zi de vârf apare temperatura, iar la un consum crescut apare un rezumat al ultimelor 7 zile. Vezi [Gestionarea contoarelor](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen). - Pe cronologia rezervărilor și în graficele vehiculelor din parc, la vremea din ziua respectivă. ## Probleme? [#problemen] Vremea nu a fost preluată încă. Încercați o altă perioadă sau reveniți a doua zi și verificați dacă centrul hărții este corect. Centrul hărții este setat în alt loc. Mutați-l la Setări > Hartă, vezi [Hartă](/kaart#kaartstandaard-instellen). Vremea urmează noua locație. Tillor nu are nimic pentru ziua respectivă. Datele se completează de la sine când devin disponibile. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/api-referentie) Această referință este generată direct din API-ul Tillor. Fiecare endpoint are propria pagină, cu parametri, corpul cererii, răspunsurile posibile și exemple de cod. În bara laterală, endpoint-urile sunt grupate pe subiecte. ## Trimiterea unei cereri [#een-request-versturen] Fiecare cerere are nevoie de cheia dumneavoastră API în antetul `x-api-key`. Endpoint-urile de sub `/orgs/{organizationId}` funcționează în cadrul unei singure organizații. ```http GET https://api.tillor.eu/orgs/org_abc123/customers x-api-key: tkn_xxx ``` Creați o cheie API în aplicație, la contul dumneavoastră. Cum funcționează, ce limite de rată (rate limits) se aplică și cum păstrați cheile în siguranță citiți la [API HTTP](/ontwikkelaars/http). ## Cine poate apela un endpoint [#wie-mag-een-endpoint-aanroepen] Fiecare pagină de endpoint arată sus, la **Acces**, cine îl poate apela. Pentru majoritatea endpointurilor este un membru al organizației cu o anumită permisiune, de exemplu `customers:read`. O cheie API lucrează cu permisiunile persoanei care a creat-o; dacă cheia are scopuri, permisiunea trebuie să fie și printre ele. Altfel API-ul răspunde cu `403`. Specificația conține aceeași informație pentru fiecare endpoint în `x-tillor-access`, cu `access` (cine) și `permissions` (una este suficientă). ## Încercarea în playground [#uitproberen-in-de-playground] Pe fiecare pagină de endpoint puteți trimite cererea imediat. Dacă sunteți autentificat în Tillor în același browser, playground-ul folosește sesiunea dumneavoastră și nu aveți nevoie de cheie API. Altfel, introduceți cheia API la **Authorization**. Modificați parametrii și faceți clic pe **Send**. Playground-ul comunică cu API-ul real al organizației dumneavoastră: un `POST`, `PUT` sau `DELETE` modifică deci date reale. Încercați endpoint-urile de scriere pe o organizație de test, nu pe parcul dumneavoastră în funcțiune. ## Descărcarea specificației [#specificatie-downloaden] Specificația completă este disponibilă ca OpenAPI 3.1 la [tillor.eu/api/openapi.json](https://tillor.eu/api/openapi.json). Importați-o în Postman sau Insomnia sau generați un client cu ea. ## Vezi și [#zie-ook] # Gestionarea unui controler (/ro-RO/controllers/controller-beheren) Pe pagina unui controler îi modificați datele și efectuați lucrări de întreținere. Setări precum ACL, rețea și actualizări se află separat, la [Setările controlerului](/controllers/settings). Înainte de a începe: - Controlerul este aprobat, vezi [Asocierea unui controler](/controllers/controller-koppelen). ## Modificarea numelui, tipului și grupului [#naam-type-en-groep-wijzigen] ### Deschideți controlerul [#open-de-controller] Mergeți la Controlere > Prezentare generală și faceți clic pe controler. ### Modificați formularul [#pas-het-formulier-aan] La **Setări controler** alegeți **Nume**, **Tip** (**Duș**, **Acces** sau **Stație de încărcare**) și **Grup**. ### Faceți clic pe Salvare [#klik-op-opslaan] Tillor afișează **Controler actualizat** și trimite setările către controler. ## Repornirea unui controler [#een-controller-herstarten] Dacă un controler nu răspunde corect, reporniți-l din Tillor. Deschideți meniul de acțiuni (cele trei puncte) și alegeți **Reporniți controlerul**. Faceți clic pe pictograma de repornire din rândul controlerului. Ecranul afișează **Repornire** (Opnieuw opstarten), iar apoi controlerul se conectează din nou. Meniul de acțiuni conține și **Vizualizați jurnalele în Grafana**. Aceasta deschide jurnalele controlerului într-un alt program, destinat suportului. Pe pagina controlerului, jurnalele recente se află în cardul **Consolă**. ## Actualizarea la o versiune nouă [#bijwerken-naar-een-nieuwe-versie] Dacă lângă numărul versiunii apare o săgeată în sus, este disponibil un firmware (software) mai nou. Treceți cu mouse-ul peste ea pentru a vedea versiunea (**Actualizare disponibilă**) și faceți clic pentru a porni actualizarea. Tillor afișează **Actualizarea OTA a fost pornită**. Când controlerele se actualizează singure, citiți la [Actualizări firmware](/controllers/updates). ## Ștergerea unui controler [#een-controller-verwijderen] În meniul de acțiuni alegeți **Ștergeți controlerul** și confirmați la **Ștergeți controlerul**. Controlerul dispare din listă. Ulterior poate solicita din nou adopția. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - După o repornire, controlerul se conectează din nou la Tillor. Durează puțin. - După actualizare, controlerul repornește singur. Lăsați alimentarea pornită cât timp ecranul afișează **Actualizare** cu un procent. - Un controler șters nu mai oferă acces. ## Probleme? [#problemen] Controlerul nu a putut fi repornit, de obicei pentru că este offline. Verificați alimentarea și rețeaua, vezi [Probleme de conexiune](/controllers/troubleshooting/verbinding). Actualizarea nu a putut fi pornită. Verificați dacă controlerul este online și dacă **Omiteți actualizările OTA** este pe **Nu**, vezi [Actualizări firmware](/controllers/updates). Formularul nu a putut fi salvat. Încercați din nou și verificați dacă numele este completat. ## Vezi și [#zie-ook] # Asocierea unui controler (/ro-RO/controllers/controller-koppelen) Un controler nou funcționează pentru organizația dumneavoastră abia după ce l-ați aprobat. Aceasta se numește adopție: spuneți în Tillor că această cutie aparține parcului dumneavoastră. Apoi îi puteți atribui un tip și un grup, vezi [Gestionarea unui controler](/controllers/controller-beheren). Înainte de a începe: - Aveți alimentare și o rețea (cablu sau wifi) în locul unde va fi montat controlerul. - Dacă folosiți wifi, aveți la îndemână numele rețelei și parola. - Deschideți Tillor, de preferință, în aceeași rețea cu controlerul. Altfel, uneori nu veți vedea cererea acestuia. ## Conectarea și aprobarea controlerului [#de-controller-aansluiten-en-goedkeuren] ### Conectați controlerul [#sluit-de-controller-aan] Conectați alimentarea. Ecranul afișează **Se conectează...** și apoi ce mai lipsește. ### Dați-i o rețea [#geef-hem-een-netwerk] Conectați cablul de rețea. Controlerul se conectează singur, nu trebuie să setați nimic. Atingeți pe ecran **Configurare Wi-Fi**, alegeți rețeaua, tastați parola și confirmați. Ecranul afișează **Conectat**. Vezi [Configurarea wifi pe ecran](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). ### Deschideți Controlere în Tillor [#open-controllers-in-tillor] Mergeți la Controlere > Prezentare generală. De îndată ce controlerul are conexiune, apare în listă cu mesajul **Așteaptă aprobare**. Ecranul controlerului afișează **Activați controlerul** împreună cu numărul dispozitivului. Acest număr este eFuse ID, numărul de serie al cutiei. Verificați dacă este același cu cel din listă. ### Faceți clic pe Aprobați [#klik-op-goedkeuren] Faceți clic pe bifă (**Aprobați**) din rând. Tillor afișează **Aprobat**, iar controlerul este adăugat organizației dumneavoastră. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Ecranul controlerului afișează **Scanați codul QR** și **Scanați eticheta**. Este gata de utilizare. - Tillor trimite automat către controler datele de conectare și setările. Nu trebuie să completați nimic. - Prima scanare creează eticheta în Tillor, dacă nu exista deja. - Cu cruciulița (**Respingeți**) respingeți o cerere. Atunci controlerul nu primește acces la organizația dumneavoastră. - Dacă scoateți din uz sau înlocuiți un controler, ștergeți-l, vezi [Gestionarea unui controler](/controllers/controller-beheren#een-controller-verwijderen). Ulterior poate face din nou o cerere. ## Probleme? [#problemen] Ecranul trebuie să afișeze **Activați controlerul** înainte ca acesta să apară. Dacă încă scrie **Configurare wifi** sau **Se conectează...**, nu este încă online. Deschideți Tillor și din aceeași rețea cu controlerul și reîmprospătați pagina. Mai mulți pași găsiți la [Controlerul nu apare în Tillor](/controllers/troubleshooting/verbinding#controller-verschijnt-niet-in-tillor). Adopția nu a putut fi aprobată. Încercați din nou. Dacă eroarea persistă, verificați dacă ceasul controlerului este corect și contactați suportul. Vezi [Adopția a eșuat](/controllers/troubleshooting/verbinding#adoptie-mislukt-of-credentials-worden-geweigerd). Așteptați 1 până la 2 minute. Dacă rămâne așa, verificați cablul sau semnalul wifi. Vezi [Ecranul rămâne pe Se conectează...](/controllers/troubleshooting/verbinding#scherm-blijft-op-verbinden). ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/controllers) Un controler este o cutie mică, cu un ecran tactil rotund, amplasată în parcul dumneavoastră, la un duș, o ușă sau un punct de încărcare. Un oaspete apropie de el o etichetă NFC sau scanează codul QR de pe ecran, iar Tillor decide dacă este permis. Aici citiți ce face un controler și cum se leagă de clienți și de sold. Un controler nou îl puneți în funcțiune prin [Asocierea unui controler](/controllers/controller-koppelen). Controlerele se află în meniul principal, la **Controlere**. Barierele și controlerele de acces de la poarta dumneavoastră nu fac parte din acestea, vezi [Control acces](/toegangscontrole). - Un controler se anunță la Tillor la fiecare 15 secunde. După aproximativ 35 de secunde fără contact, Tillor îl afișează ca offline. - După 5 minute fără contact, echipa Tillor primește o notificare. - Un controler reține cel mult 8 rețele wifi. - Controlul accesului prin controler (ACL) este implicit dezactivat. Activați **ACL activat** la [setări](/controllers/settings) pentru a face verificarea etichetelor. - Implicit, controlerul verifică zilnic dacă există o versiune nouă de software. O actualizare pornește doar în fereastra de actualizare, dacă ați setat una. - Implicit, așteaptă 1000 de milisecunde (1 secundă) răspunsul Tillor înainte de a trece mai departe, la setarea **Timeout ACL API**. - La o scurtă întrerupere, plata cu o etichetă funcționează în continuare. Plata prin codul QR nu funcționează atunci pentru scurt timp. ## Cum se leagă acestea? [#hoe-hangt-dit-samen] Controlerul nu decide singur cine are voie să treacă. Citește eticheta și întreabă Tillor. Acolo se află al cărui client este eticheta, pentru ce grupuri de acces este valabilă și ce sold are. ```mermaid flowchart TD G[Oaspete apropie eticheta de ecran] --> C[Controler] C -->|întreabă dacă este permis| T[Tillor] T --> K[Clientul etichetei] T --> A[Grupuri de acces și sold] T -->|permite sau refuză| C C -->|afișează rezultatul| G T --> TR[Tranzacție în istoricul etichetei] ``` - Fiecare controler are un **Tip** (**Duș**, **Acces** sau **Stație de încărcare**) și, opțional, un **Grup**. Ce etichete au voie aici stabiliți prin grupurile de acces ale etichetei, vezi [Gestionarea etichetelor](/nfc/nfc-tags). - Dacă controlerul nu poate contacta Tillor pentru scurt timp, cu **Local întâi** folosește datele pe care le-a reținut singur, vezi [Setări](/controllers/settings). - O etichetă care nu există încă în Tillor este creată imediat ce este apropiată pentru prima dată de un controler. ## Ce vedeți în Tillor? [#wat-zie-je-in-tillor] - **Prezentarea generală a controlerelor**: toate controlerele cu versiunea, tipul, grupul, utilizarea și momentul când au fost **Văzut ultima dată**. Controlerele care așteaptă să fie asociate apar cu **Așteaptă aprobare**. - **Detaliile controlerului**: stare, rețea, cât de solicitat este controlerul, rețelele wifi, evenimentele și cardul **Consolă** cu jurnalele. - **Gestionare**: repornire, actualizare și ștergere, vezi [Gestionarea unui controler](/controllers/controller-beheren). ## Părți componente [#onderdelen] ## Termeni [#begrippen] - **Controler**: cutia cu ecran și cititor de etichete. - **Etichetă (tag)**: cardul, brățara sau breloc-ul unui oaspete. Vezi [NFC](/nfc). - **Adopție**: asociați un controler nou cu organizația dumneavoastră. - **ACL**: lista care stabilește dacă o etichetă are voie. Vezi [glosarul](/controllers/lexicon). - **Firmware**: software-ul din cutie. Mai multe explicații găsiți în [lista de termeni](/begrippen). # Glosar (/ro-RO/controllers/lexicon) O prezentare a termenilor pe care îi întâlniți când lucrați cu controlere. Fiecare termen are o explicație și, într-un citat, ce înțelegem prin el în limbaj obișnuit. ## A [#a] ## C [#c] ## E [#e] ## F [#f] ## N [#n] ## O [#o] ## R [#r] ## S [#s] ## T [#t] ## U [#u] # Setările controlerului (/ro-RO/controllers/settings) Aceasta este o pagină de referință pentru setările unui controler. Le găsiți la Controlere > Prezentare generală > [numele controlerului], în formularul de sub antet. Faceți clic pe **Salvare** pentru a aplica modificările. Tillor trimite apoi setările către controler. Numele, tipul și grupul le modificați la [Gestionarea unui controler](/controllers/controller-beheren). ## Configurare ACL [#acl-configuratie] ACL (Access Control List) stabilește cum verifică controlerul accesul. *Cu alte cuvinte: cum verifică cutia dacă un card are voie.* | Setare | Semnificație | | ---------- | --------- | | **ACL activat** | Setați pe **Da** pentru a folosi controlul accesului prin controler. Pe **Nu**, cardurile sunt scanate, dar nu sunt validate. Implicit este pe **Nu**. | | **Prioritate ACL** | **Local întâi**: controlerul verifică mai întâi propria memorie, apoi Tillor. *Util când internetul cade pentru scurt timp.* **API întâi**: întreabă întotdeauna direct Tillor. Implicit **Local întâi**. | | **Timeout ACL API** | Cât timp (în milisecunde) așteaptă controlerul răspunsul Tillor înainte de a trece mai departe. Implicit 1000 ms (1 secundă). | Alegeți **Local întâi** dacă doriți ca controlerul să funcționeze și la întreruperi temporare de internet. Controlerul salvează local drepturile de acces. ## Configurare internet [#internetconfiguratie] | Setare | Semnificație | | ---------- | --------- | | **Conexiune de rețea principală** | **Wifi** sau **Ethernet** (cablu de rețea). Aceasta este conexiunea pe care controlerul o încearcă prima. Implicit **Wifi**. | | **Rețele wifi** | Lista rețelelor wifi pe care le cunoaște controlerul, cu un maxim de 8. Vezi [Configurarea rețelelor wifi](/controllers/wifi-netwerken). | ## Configurare actualizări [#updateconfiguratie] Vezi [Actualizări firmware](/controllers/updates) pentru o explicație detaliată despre frecvența actualizărilor, fereastra de actualizare și omiterea actualizărilor OTA. | Setare | Semnificație | | ---------- | --------- | | **Frecvență actualizare** | Cât de des verifică cutia dacă există o versiune nouă: **Oră**, **Zilnic** sau **Săptămânal**. | | **Perioadă actualizare de la/până la** | *Când are voie cutia să se actualizeze?* De exemplu 02:00-04:00 = doar noaptea. | | **Omiteți actualizările OTA** | Setați pe **Da** dacă cutia nu mai are voie să preia actualizări. *Util temporar, dar în mod normal lăsați pe Nu.* | ## Comanda releului [#relais-aansturing] Releul este un comutator din cutie. *Cu el puteți, de exemplu, deschide sau închide un punct de acces.* | Setare | Semnificație | | ---------- | --------- | | **Tip releu** | Momentan este acceptat doar **Intern**. | | **Port releu** | Numărul portului releului. Implicit 1. | ## Vezi și [#zie-ook] # Mesaje pe ecran (/ro-RO/controllers/troubleshooting/scherm) Controlerul are un ecran tactil rotund. Acesta afișează în limbaj obișnuit ce face controlerul: un titlu, o linie de explicație sub el și un chenar colorat. *Nu mai trebuie să rețineți culori: scrie chiar acolo.* Mai jos găsiți fiecare mesaj și ce faceți în legătură cu el. ## Gata de utilizare [#klaar-voor-gebruik] | Pe ecran | Semnificație | | ------------- | --------- | | **Scanați codul QR** și **Scanați eticheta**, cu **De plată** și o sumă | Controlerul este gata. Oaspetele apropie o etichetă de ecran sau scanează codul QR cu telefonul. | | Cod QR gri și tăiat | Controlerul nu are temporar conexiune cu Tillor. Plata cu o etichetă rămâne posibilă, plata online prin codul QR nu funcționează pentru scurt timp. | ## Scanarea unei etichete [#een-tag-scannen] O etichetă NFC o scanați apropiindu-o scurt de ecran, ca la plata contactless. | Pe ecran | Semnificație | | ------------- | --------- | | **Un moment** - Se procesează plata | Eticheta a fost citită, controlerul întreabă Tillor dacă este permis. Mai țineți puțin eticheta lângă ecran. | | **Plată reușită!** cu suma debitată și soldul | Plătit. Dușul sau aparatul pornește. | | **Bun venit** cu numele oaspetelui | Acces acordat, la o ușă sau o facilitate fără plată. | Dacă o etichetă este refuzată, motivul apare pe ecran: | Pe ecran | Ce se întâmplă | Ce faceți | | ------------- | --------------------- | ---------- | | **Etichetă nerecunoscută** - Această etichetă nu aparține acestui loc | Eticheta nu este a parcului dumneavoastră. | Dați oaspetelui o etichetă a parcului. | | **Etichetă nerecunoscută** - Aceasta nu este o etichetă validă | Controlerul nu poate citi acest tip de etichetă. | Folosiți o etichetă primită prin Tillor. | | **Scanare eșuată** - Eticheta nu a fost citită corect | Eticheta a fost retrasă prea repede. | Apropiați din nou eticheta de ecran, ceva mai mult timp. | | **Plată refuzată** - Fără acces | Eticheta nu are voie să folosească acest controler. | Verificați în Tillor grupul de acces al etichetei. | | **Plată refuzată** - Etichetă neasociată | Eticheta nu este încă legată de un client. | Asociați eticheta unui client în Tillor. | | **Plată refuzată** - Sold insuficient | Pe etichetă este prea puțin. Soldul este afișat alături. | Realimentați eticheta la recepție. | | **Serverul nu este accesibil** | Plata nu a putut fi procesată. | Încercați din nou mai târziu; vezi [Probleme de conexiune](/controllers/troubleshooting/verbinding). | | **Actualizarea etichetei a eșuat** | Soldul nu a putut fi salvat pe etichetă. | Apropiați din nou eticheta de ecran și lăsați-o acolo până dispare mesajul. | Dacă lăsați eticheta lipită de ecran, nu are niciun efect: fiecare prezentare contează ca o singură scanare. Dacă vreți să scanați din nou, retrageți eticheta și apropiați-o din nou de ecran. ## Pornire și conectare [#opstarten-en-verbinden] | Pe ecran | Chenar | Semnificație | Ce faceți | | ------------- | ---- | --------- | ---------- | | **Se conectează...** | Albastru | Controlerul pornește și caută conexiune la internet și la Tillor. | Așteptați 1-2 minute. | | **Configurare wifi** - Alegeți o rețea wifi pe ecran | Violet | Controlerul nu are încă o rețea. | Atingeți **Configurare Wi-Fi** și alegeți rețeaua; vezi [Configurarea wifi pe ecran](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). | | **Configurare wifi** - Datele wifi au fost refuzate | Violet | Parola nu (mai) este corectă. | Introduceți din nou parola pe ecran. | | **Activați controlerul** - Activați dispozitivul … în Tillor | Violet | Controlerul așteaptă adopția. | În Tillor mergeți la **Controlere** și faceți clic pe **Aprobați** (✓). | | **Conexiune întreruptă** - se reîncearcă | Roșu | Conexiunea la internet a dispărut. Controlerul încearcă singur din nou. | Vezi [Probleme de conexiune](/controllers/troubleshooting/verbinding#verbinding-verbroken). | | **Conexiune întreruptă** - Offline prea mult timp | Roșu | Controlerul este fără conexiune de prea mult timp. Plățile sunt oprite până revine conexiunea. | Restabiliți conexiunea de rețea. | ## Actualizări și repornire [#updates-en-herstarten] | Pe ecran | Chenar | Semnificație | | ------------- | ---- | --------- | | **Actualizare** cu un procent | Chihlimbar | O actualizare de firmware este descărcată și instalată. Lăsați alimentarea pornită. | | **Repornire** | Galben | Controlerul repornește, după o actualizare sau pentru că ați făcut clic în Tillor pe **Reporniți controlerul**. | ## Defecțiuni [#storingen] | Pe ecran | Semnificație | Ce faceți | | ------------- | --------- | ---------- | | **Cititorul de etichete nu este disponibil** | Cititorul de etichete nu pornește. Controlerul încearcă singur să-l repare. | Așteptați un minut. Dacă mesajul rămâne, [reporniți controlerul](/controllers/controller-beheren#een-controller-herstarten). | | **Fără conexiune** - Se conectează la controler | Ecranul nu primește semnal de la restul controlerului. | Reporniți controlerul. Dacă rămâne așa, contactați suportul Tillor. | | Ecranul rămâne negru | Controlerul nu are alimentare. | Verificați sursa de alimentare și cablurile. | ## Vezi și [#zie-ook] # Probleme de conexiune (/ro-RO/controllers/troubleshooting/verbinding) Dacă controlerul nu se conectează corect, ecranul său arată unde se blochează. Mai jos găsiți, pentru fiecare mesaj, ce se întâmplă și ce aveți de făcut. Toate mesajele sunt la [Mesaje pe ecran](/controllers/troubleshooting/scherm). ## Configurarea wifi pe ecran [#wifi-instellen-op-het-scherm] Dacă pe ecran apare **Configurare wifi**, controlerul nu are încă o rețea. Cu un cablu de rețea (Ethernet) nu aveți nimic de făcut; pentru wifi configurați rețeaua chiar pe controler: 1. Atingeți **Configurare Wi-Fi** 2. Alegeți rețeaua din listă. Lângă fiecare rețea apare intensitatea semnalului: verde este bun, portocaliu este mediu, roșu este slab 3. Introduceți parola pe tastatura de pe ecran și confirmați 4. Ecranul afișează **Conectat** - wifi este configurat Dacă rețeaua dumneavoastră nu apare în listă, atingeți căutarea din nou. Dacă doriți să schimbați rețeaua mai târziu, țineți degetul apăsat pe ecran cât timp controlerul este în așteptare sau modificați-o la [setările](/controllers/settings#internetconfiguratie) din Tillor. | Mesaj | Soluție | | ------- | --------- | | **Conectarea a eșuat** - Verificați parola | Introduceți parola din nou; atenție la majuscule. | | **Conectarea a eșuat** - Rețeaua nu a fost găsită | Mutați controlerul mai aproape de punctul de acces sau alegeți altă rețea. | | **Conectarea a eșuat** - Căutarea rețelelor a eșuat | Atingeți căutarea din nou. Dacă rămâne la fel, reporniți controlerul. | | **Configurare wifi** - Datele wifi au fost refuzate | Parola salvată nu mai este corectă. Introduceți-o din nou pe ecran. | ## Activarea controlerului [#controller-activeren] **Semnificație:** Controlerul așteaptă adopția - nu este încă asociat cu Tillor. *Cutia este pregătită, dar nu știe încă cărei organizații îi aparține.* Pe ecran apare **Activați controlerul** împreună cu numărul dispozitivului. **Soluție:** 1. În Tillor mergeți la **Controlere** 2. Căutați rândul **Așteaptă aprobare** cu același număr (eFuse ID) 3. Faceți clic pe **Aprobați** (✓) pentru a asocia controlerul organizației dumneavoastră ## Conexiune întreruptă [#verbinding-verbroken] **Semnificație:** Conexiunea la internet a dispărut. Controlerul încearcă automat să se reconecteze. *Cutia a pierdut legătura cu Tillor și încearcă să o recapete.* Cât timp întreruperea este scurtă, oaspeții pot continua să plătească cu eticheta; codul QR este atunci gri și tăiat. Dacă apare **Offline prea mult timp**, plățile sunt dezactivate până revine conexiunea. În Tillor, controlerul apare ca offline după aproximativ 35 de secunde fără contact. După 5 minute, echipa Tillor primește o notificare. **Cauze posibile:** - **Wifi a căzut** - verificați dacă rețeaua wifi este accesibilă - **Defecțiune de internet** - controlerul nu poate ajunge la Tillor - **Tillor este temporar inaccesibil** **Soluție:** - Așteptați câteva minute - controlerul încearcă singur să se reconecteze - Verificați dacă celelalte dispozitive din aceeași rețea au internet - Verificați [setările wifi](/controllers/settings) ale controlerului (numele rețelei, parola) - Asigurați-vă că controlerul se află în raza punctului de acces wifi sau folosiți un cablu de rețea ## Ecranul rămâne pe Se conectează... [#scherm-blijft-op-verbinden] **Semnificație:** Controlerul încă pornește sau se conectează. Sub titlu apare pasul la care se află, de exemplu *Se stabilește conexiunea la internet* sau *Se verifică actualizările*. **Soluție:** - Așteptați 1-2 minute - la pornire durează puțin - Dacă rămâne pe *Se stabilește conexiunea la internet*: verificați cablul de rețea sau [configurați din nou wifi](#wifi-instellen-op-het-scherm) - Verificați dacă semnalul wifi este suficient de puternic ## Controlerul nu apare în Tillor [#controller-verschijnt-niet-in-tillor] **Semnificație:** Controlerul nu este încă vizibil pentru adopție. **Cauze posibile:** - Controlerul nu are conexiune la internet (nu poate ajunge la Tillor) - Controlerul încă pornește - Deschideți Tillor dintr-o altă rețea decât cea la care este conectat controlerul - cererile de adopție nu sunt uneori vizibile în acest caz **Soluție:** 1. Verificați dacă controlerul are alimentare și ecranul este aprins 2. Vedeți ce afișează ecranul: la **Configurare wifi** sau **Se conectează...** controlerul nu este încă online 3. Așteptați până când ecranul afișează **Activați controlerul** și rândul **Așteaptă aprobare** apare în listă - poate dura puțin 4. Deschideți Tillor din aceeași rețea cu controlerul sau contactați asistența 5. Reîmprospătați pagina Controlere din Tillor (cererile noi apar și automat) ## Adopția a eșuat sau credențialele sunt refuzate [#adoptie-mislukt-of-credentials-worden-geweigerd] Adopția înseamnă asocierea controlerului cu organizația dumneavoastră; credențialele sunt datele de conectare care îi aparțin. **Semnificație:** Asocierea cu Tillor nu a reușit. *Cutia nu a putut fi asociată organizației dumneavoastră.* **Soluție:** - Verificați dacă ceasul controlerului este corect (o abatere mare de timp poate bloca asocierea) - După un flash de firmware sau o cheie nouă, controlerul trebuie aprobat din nou - Încercați din nou adopția cu **Aprobați** (✓) - Contactați asistența dacă problema persistă - ea are acces la jurnale ## Actualizarea OTA se blochează sau eșuează [#ota-update-blijft-hangen-of-faalt] O actualizare OTA este o actualizare de firmware prin internet. În timpul unei actualizări, ecranul afișează **Actualizare** cu un procent. **Semnificație:** Actualizarea de firmware nu s-a încheiat. *Cutia a încercat să instaleze software nou, dar nu a mers bine.* **Soluție:** - Așteptați până când [fereastra de actualizare](/controllers/updates) este activă - actualizările au loc doar în acea fereastră - Verificați dacă controlerul are o conexiune stabilă la internet - Activați temporar [Omiteți actualizările OTA](/controllers/updates#ota-updates-overslaan) dacă doriți mai întâi să stabilizați controlerul ## Vezi și [#zie-ook] # Actualizări firmware (/ro-RO/controllers/updates) Un controler preia singur software nou prin internet, la fel ca telefonul dumneavoastră. Acest software se numește firmware. Dumneavoastră stabiliți **când** și **cât de des** are voie să facă asta. Implicit verifică zilnic dacă există ceva nou. Dacă doriți să porniți imediat o actualizare, o faceți de pe pagina controlerului, vezi [Gestionarea unui controler](/controllers/controller-beheren#bijwerken-naar-een-nieuwe-versie). ## Frecvența actualizărilor [#updatefrequentie] Controlerul verifică periodic dacă este disponibilă o versiune nouă de firmware: | Opțiune | Semnificație | | ----- | --------- | | **Orar** | Verifică actualizările în fiecare oră. | | **Zilnic** | Verifică o dată pe zi (implicit). | | **Săptămânal** | Verifică o dată pe săptămână. | După verificare, o actualizare se execută doar dacă există o versiune mai nouă. Dacă ați setat o fereastră de actualizare, ora curentă trebuie să se încadreze și ea în acea fereastră. *Adică: cutia verifică dacă există ceva nou, dar instalează doar în intervalele stabilite de dumneavoastră.* ## Fereastra de actualizare [#updatevenster] Fereastra de actualizare este intervalul de timp în care controlerul are voie să se actualizeze. Dacă ați completat **Perioada de actualizare de la** și **Perioada de actualizare până la**, actualizările se execută doar în acele ore. *Pe scurt: dumneavoastră alegeți când are voie cutia să se actualizeze - de exemplu doar noaptea.* **Exemplu:** Dacă setați **Perioada de actualizare de la** pe 02:00 și **Perioada de actualizare până la** pe 04:00, o actualizare are loc doar între orele 02:00 și 04:00. Astfel evitați ca controlerul să repornească în mijlocul zilei, în orele de vârf. ### Configurare [#instellen] 1. Mergeți la Controlere > Prezentare generală > [numele controlerului] 2. Derulați până la **Configurare actualizări** 3. Alegeți **Frecvența actualizărilor** (Orar, Zilnic sau Săptămânal) 4. Completați **Perioada de actualizare de la** (de ex. 02:00) 5. Completați **Perioada de actualizare până la** (de ex. 04:00) 6. Faceți clic pe **Salvare** ## Omiterea actualizărilor OTA [#ota-updates-overslaan] OTA înseamnă Over-The-Air: actualizări prin internet. Dacă setați **Omiteți actualizările OTA** pe **Da**, controlerul nu mai instalează firmware nou. Controlerul rămâne pe versiunea curentă. *Cu alte cuvinte: cutia nu se mai actualizează singură prin OTA.* **Când se folosește?** - Temporar, dacă nu doriți modificări într-o perioadă aglomerată - Pentru controlere de test sau de demonstrație care trebuie să rămână pe o versiune fixă Lăsați **Omiteți actualizările OTA** în mod normal pe **Nu**. Actualizările conțin adesea îmbunătățiri și remedieri de securitate. ## Ce se întâmplă în timpul unei actualizări? [#wat-gebeurt-er-tijdens-een-update] 1. Controlerul detectează o versiune nouă de firmware 2. Firmware-ul este descărcat 3. Ecranul afișează **Actualizare** cu un procent - controlerul se actualizează 4. Controlerul repornește automat; ecranul afișează **Repornire** 5. După repornire, versiunea nouă este activă ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - O actualizare pornește doar dacă există o versiune mai nouă și ora se încadrează în fereastra de actualizare. - În timpul actualizării și al repornirii, ecranul afișează **Actualizare** și **Repornire**. De aceea, planificați fereastra noaptea. - Dacă setați **Omiteți actualizările OTA** pe **Da**, controlerul rămâne pe versiunea curentă până când o schimbați înapoi. ## Probleme? [#problemen] Verificați dacă **Omiteți actualizările OTA** este pe **Nu** și dacă ora se încadrează în fereastra de actualizare. Verificați și conexiunea la internet a controlerului. Mai multe detalii la [Actualizarea OTA se blochează sau eșuează](/controllers/troubleshooting/verbinding#ota-update-blijft-hangen-of-faalt). Lăsați alimentarea pornită și așteptați câteva minute. Dacă rămâne la fel, reporniți controlerul și contactați asistența. Actualizarea nu a putut fi pornită. Verificați dacă controlerul este online și încercați din nou. ## Vezi și [#zie-ook] # Configurarea rețelelor wifi (/ro-RO/controllers/wifi-netwerken) Un controler poate cunoaște mai multe rețele wifi și trece singur la cea mai bună. Este util dacă parcul dumneavoastră are puncte de acces proprii în mai multe locuri. Le configurați pe pagina controlerului. Dacă controlerul nu are încă nicio rețea, configurați wifi mai bine pe ecranul acestuia, vezi [Configurarea wifi pe ecran](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). Înainte de a începe: - Controlerul este aprobat, vezi [Asocierea unui controler](/controllers/controller-koppelen). - Cunoașteți pentru fiecare rețea numele (SSID) și parola. O rețea deschisă nu are parolă. ## Adăugarea rețelelor [#netwerken-toevoegen] ### Deschideți controlerul [#open-de-controller] Mergeți la Controlere > Prezentare generală și faceți clic pe controler. Derulați până la **Rețele Wi-Fi**. ### Adăugați o rețea [#voeg-een-netwerk-toe] Faceți clic pe **Adaugă rețea** și completați **Numele rețelei (SSID)** și **Parola**. Lăsați parola goală pentru o rețea deschisă. Repetați pentru fiecare rețea. ### Puneți-le în ordine [#zet-ze-in-volgorde] Trageți un rând de mânerul din stânga. Ordinea este prioritatea: controlerul încearcă rețelele aflate în raza sa de sus în jos. ### Faceți clic pe Salvare [#klik-op-opslaan] Butonul **Salvare** se află în partea de jos a formularului. Tillor trimite apoi lista către controler. O rețea o eliminați cu butonul minus (**Elimină rețeaua**). ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Controlerul verifică fiecare rețea separat. Dacă prima rețea dispare sau parola nu este corectă, o folosește pe următoarea. - Pe pagina de detalii, sub **Rețele Wi-Fi cunoscute, în ordinea priorității** vedeți cum merge fiecare rețea: | Stare | Semnificație | |---|---| | Conectat | Controlerul folosește acum această rețea. | | Verificată | Rețeaua funcționează, dar controlerul folosește acum o altă rețea. | | Încă neverificată | Controlerul nu a putut testa încă această rețea. | | Eșuată | Rețeaua nu funcționează. Motivul este afișat alături, de exemplu parolă greșită, rețea negăsită sau fără acces la internet. | - Pentru fiecare rețea se afișează dacă este **în rază** sau **în afara razei**, uneori cu intensitatea semnalului în dBm. Rețelele introduse pe ecran au mențiunea **adăugată pe afișaj**. - Dacă lista este goală, în Tillor nu sunt configurate rețele. Rețelele adăugate de cineva pe ecran rămân salvate pe controler. - Controlerele mai vechi, care cunosc o singură rețea, afișează în schimb un singur mesaj despre ultima modificare, precum **Modificarea Wi-Fi nu a fost încă confirmată** sau **Date Wi-Fi respinse**. Controlerul rămâne atunci conectat la rețeaua anterioară. ## Probleme? [#problemen] Un controler reține cel mult 8 rețele. Tillor spune asta cu **Un controler reține până la 8 rețele.** Eliminați mai întâi o rețea de care nu mai aveți nevoie. Un rând nu are nume de rețea. Completați numele sau eliminați rândul. Fiecare nume de rețea poate apărea o singură dată. Eliminați rândul dublat. Citiți motivul de lângă rețea. Verificați numele și parola. Controlerul încearcă din nou singur, iar celelalte rețele continuă să funcționeze. ## Vezi și [#zie-ook] # Manualul Tillor (/ro-RO) Explicații pe sarcini pentru recepție, administrație și serviciul tehnic. Căutați ce doriți să faceți sau începeți de la rolul dumneavoastră. }> - [Căutarea sau crearea unui client](/klantenbeheer) - [Crearea unei rezervări](/reserveringen) - [Check-in pentru un oaspete cu o ocupare](/bezettingen#een-bezetting-aanmaken) - [Răspunsul la mesaje în inbox](/inbox) }> - [Crearea și înregistrarea unei facturi](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken) - [Înregistrarea unei plăți](/facturen/betalingen-registreren) - [Prelungirea unei ocupări prin factură](/bezettingen#facturatie-bezetting-verlengen) - [Rapoarte de plăți către contabilitate](/boekhouden/betalingsrapporten) }> - [Deschiderea sau închiderea unui punct de acces](/toegangscontrole#toegangspunten-bedienen) - [Asocierea unui contor cu o parcelă](/meterbeheer/meter-koppelen) - [Ce înseamnă mesajul de pe ecran?](/controllers/troubleshooting/scherm) - [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten) }> - [Crearea unei chei API](/ontwikkelaars/http) - [Primirea webhook-urilor](/ontwikkelaars/webhooks) - [Evenimente în timp real prin SSE](/ontwikkelaars/sse) - [Conectarea instrumentelor AI prin MCP](/ontwikkelaars/mcp) } /> } /> } /> } /> } /> } /> # Trimiterea unei comenzi către o tabletă (/ro-RO/mobiele-app/acties-op-afstand) În dreapta paginii dispozitivului se află panoul **Acțiuni la distanță**, indiferent ce filă aveți deschisă. De acolo trimiteți o comandă către dispozitiv și solicitați o captură de ecran. Ce raportează dispozitivul însuși citiți la [Diagnosticare și istoric](/mobiele-app/diagnose-en-geschiedenis). Înainte de a începe: - Dispozitivul trebuie să fie conectat. O comandă circulă prin conexiunea live cu aplicația. Dacă dispozitivul este offline, panoul spune **Dispozitivul este offline: comenzile ajung abia după ce se reconectează.** Tillor raportează totuși că a trimis comanda, dar tableta nu o vede. - **Repornește dispozitivul** funcționează doar dacă Tillor este proprietarul tabletei. Vezi [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten). ## Trimiterea unei comenzi [#een-opdracht-versturen] ### Deschideți dispozitivul [#open-het-toestel] Mergeți la Setări > Tablete și chioșcuri și faceți clic pe rândul dispozitivului. ### Alegeți comanda [#kies-de-opdracht] În panoul **Acțiuni la distanță**, faceți clic pe comandă. Primiți mesajul **Trimis către dispozitiv** sau **Dispozitivul nu a putut fi contactat** dacă nu a putut fi trimisă. Comenzile: - **Afișează numele pe ecran** arată numele dispozitivului pe tot ecranul pentru scurt timp. Util când sunt două tablete una lângă alta și vreți să știți pe care o aveți deschisă. - **Redați sunetul de test** redă sunetul de notificare, la volumul din fila **Bonuri și sunet**. - **Activați ecranul** scoate dispozitivul din odihna de noapte sau din **Treceți ecranul în repaus**. - **Treceți ecranul în repaus** înnegrește ecranul, inclusiv în afara odihnei de noapte. - **Somn de 30 de secunde** face la fel și apoi trezește ecranul singur. Astfel verificați dacă ecranul pornește din nou, fără să așteptați până dimineața. - **Repornește dispozitivul** repornește tableta. Pe o tabletă a cărei proprietar nu este Tillor, butonul rămâne gri. - **Instalați actualizarea** instalează o actualizare a aplicației care este deja pregătită. - **Repornește aplicația** repornește doar aplicația Tillor, nu tableta. ## Solicitarea unei capturi de ecran [#een-schermafbeelding-opvragen] ### Faceți clic pe Solicitați o captură de ecran [#klik-op-schermafbeelding-opvragen] În blocul **Captură de ecran**, aceasta trimite cererea către tabletă. ### Așteptați imaginea [#wacht-op-het-beeld] Tillor așteaptă puțin timp și reîmprospătează imaginea imediat ce tableta a încărcat-o. Sub fotografie apare când a fost realizată. Imaginea arată ce afișează aplicația în acel moment: ecranul de start, prezentarea, bonul sau ecranul de repaus. Nu este video live. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Tableta execută comanda imediat. Fiecare comandă, cu excepția celor de repaus, trezește și ecranul. - Fiecare comandă ajunge în [istoricul dispozitivului](/mobiele-app/diagnose-en-geschiedenis#geschiedenis). - O captură de ecran rămâne în panou până când solicitați una nouă. ## Probleme? [#problemen] Comanda nu a ajuns la dispozitiv. De obicei este offline. Așteptați până când starea devine din nou **Conectat** și trimiteți comanda din nou. Tillor nu este proprietarul tabletei. Configurați-o mai întâi așa cum este descris la [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten). Până atunci puteți folosi doar **Repornește aplicația**. Dispozitivul este offline sau aplicația este prea veche. În ultimul caz, Tillor spune asta dinainte: **Aplicația de pe acest dispozitiv este prea veche pentru capturi de ecran.** Instalați o versiune mai nouă. Cât timp nu ați solicitat încă nicio imagine, apare **Nu a fost solicitată încă nicio captură de ecran.** Trezirea la distanță reușește doar dacă aplicația se află și în excepția de baterie. Vezi [Baterie](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). ## Vezi și [#zie-ook] # Diagnosticare și istoric (/ro-RO/mobiele-app/diagnose-en-geschiedenis) Sub panoul **Acțiuni la distanță** se află două blocuri care vă ajută să verificați o tabletă: **Diagnosticare** (ce a raportat dispozitivul ultima dată) și **Istoric** (jurnalul). Puteți trimite o comandă din același panou, vezi [Trimiterea unei comenzi către o tabletă](/mobiele-app/acties-op-afstand). ## Diagnosticare [#diagnose] **Diagnosticare** este ultimul mesaj al dispozitivului, nu o măsurătoare live. O liniuță înseamnă că aplicația nu a trimis acea informație. | Informație | Semnificație | |---|---| | **Văzut ultima dată** | Când a avut dispozitivul ultimul contact | | **Conexiune** | Wifi sau mobil | | **Ecran** | **Pornit** sau **În repaus** | | **Spațiu liber** | Spațiul liber de pe tabletă, în GB | | **Limba dispozitivului** și **Fus orar** | Limba și fusul orar din Android sau iOS. Aceasta nu este limba pe care ați ales-o pentru aplicație în fila **Dispozitiv** | | **Versiune build**, **Versiune runtime** | Ce versiune a aplicației se află pe tabletă | | **Ultima actualizare a aplicației** și **Ultima verificare a actualizărilor** | Când a fost aplicația actualizată sau verificată ultima dată | | **Eroare de actualizare** | Apare dacă ultima verificare sau instalare a eșuat | | **Înregistrat** | Când a apărut acest dispozitiv pentru prima dată în listă | ## Istoric [#geschiedenis] **Istoric** arată pentru fiecare dispozitiv: - când s-a conectat dispozitivul - când ați trimis dumneavoastră setări sau o comandă - când a fost actualizată aplicația - când dispozitivul a trecut offline și când a revenit online Jurnalul se reîmprospătează singur. **Încă nu există evenimente.** înseamnă că nu a fost înregistrat încă nimic. ## Alerte [#meldingen] O alertă de offline sau de baterie vine doar dacă **Alerte** din fila **Dispozitiv** este pornit și nu în timpul odihnei de noapte. - Alertă de offline: dispozitivul nu a raportat nimic timp de 10 minute. - Alertă de baterie: sub 15% fără încărcător. Tillor nu o retrimite până când dispozitivul a fost conectat din nou la încărcător sau s-a încărcat vizibil. Alerta merge către persoanele care administrează setările. Vezi [Notificări](/notificaties). ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/mobiele-app) Aplicația Tillor rulează pe o tabletă, un chioșc sau un telefon din parcul dumneavoastră, pentru **iOS** și **Android**. Oaspeții și colegii văd în ea ecranul de start, bonurile și cererile de semnare. Din Tillor, în browser, trimiteți setări și comenzi către aceste dispozitive. O tabletă care trebuie să rămână chioșc o configurați prin [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten). Aplicația nu înlocuiește Tillor în browser. Gestionarea rezervărilor, crearea facturilor sau înregistrarea plăților se fac în browser. ## Cum se leagă toate acestea? [#hoe-hangt-dit-samen] Un dispozitiv apare singur în Tillor de îndată ce cineva deschide aplicația și se autentifică. Ce setați apoi în Tillor ajunge la dispozitiv prin conexiunea live. Invers, dispozitivul se anunță regulat la Tillor, astfel încât vedeți dacă este încă conectat. ```mermaid flowchart LR A[Cineva deschide aplicația
și se autentifică] --> B[Dispozitivul apare în
Setări > Tablete și chioșcuri] B --> C[Alegeți setările
și faceți clic pe Salvează și trimite] C --> D[Tableta le aplică] E[Trimiteți un bon,
un PDF sau o cerere de semnare] --> D D --> F[Dispozitivul raportează înapoi bateria,
conexiunea și versiunea] F --> B ``` Dacă un dispozitiv este offline, setările și comenzile ajung abia când se reconectează. Vezi [Tablete și chioșcuri](/mobiele-app/tablets-en-kiosken). - Un dispozitiv nou apare în listă în decurs de un minut după ce cineva s-a autentificat. - Tillor raportează un dispozitiv ca offline după 10 minute fără mesaj. Asta se întâmplă doar dacă **Alerte** este pornit și nu în timpul odihnei de noapte. - Alerta de baterie vine sub 15% fără încărcător. - O prezentare are cel mult 20 de fotografii. Puteți pune șase butoane suplimentare pe ecranul de start. - Nu există o parolă separată pentru aplicație. Vă autentificați ca în browser, cu Microsoft, Google sau Apple. ## Instalarea aplicației și autentificarea [#de-app-installeren-en-inloggen] Organizația dumneavoastră distribuie fișierul de instalare sau linkul (build intern, TestFlight sau magazinul de aplicații, în funcție de modul de lansare). Dacă nu aveți încă acces, cereți-l administratorului dumneavoastră sau asistenței Tillor. 1. Deschideți aplicația după instalare. 2. Autentificați-vă cu **Microsoft**, **Google** sau **Apple**. Este același cont ca în browser, vezi [Autentificare](/inloggen). 3. Alegeți organizația dacă aveți mai multe. ## Ce poate aplicația [#wat-de-app-kan] - **Afișarea PDF-urilor și a imaginilor**: direct pe ecranul de start, de îndată ce Tillor trimite un document către dispozitiv. - **Scanarea cardurilor preplătite**: citirea unui card NFC și vizualizarea datelor cardului și ale clientului. - **Auzirea plăților**: un semnal sonor la o factură plătită. - **Chioșc**: menținerea ecranului aprins, reglarea luminozității și afișarea siglei organizației dumneavoastră. ## Ce vede Tillor de la dispozitiv [#wat-tillor-van-het-toestel-ziet] Aplicația trimite regulat către Tillor numele, modelul, sistemul de operare, versiunea aplicației, bateria și conexiunea de rețea (wifi sau mobil). Vedeți acestea în lista de dispozitive și pe pagina dispozitivului. La **Cont** > **Sesiuni active** găsiți aceleași dispozitive ca sesiuni de aplicație, cu **Metadate aplicație**. Tot acolo încheiați o sesiune. ## Probleme? [#problemen] Verificați wifi sau rețeaua mobilă și dacă sunteți autentificat la organizația corectă. Actualizați aplicația la cea mai recentă versiune. Dacă nu ajută, deconectați-vă și autentificați-vă din nou. Dacă problema persistă, contactați administratorul dumneavoastră. Deschideți aplicația, autentificați-vă și alegeți organizația corectă. Dispozitivul apare în decurs de un minut la **Setări** > **Tablete și chioșcuri**. Dacă vedeți acolo **Încă niciun dispozitiv**, înseamnă că niciun dispozitiv nu s-a conectat încă. ## Termeni [#begrippen] - **Tabletă**: o tabletă cu aplicația Tillor, de exemplu la recepție. - **Chioșc**: o tabletă blocată pe aplicația Tillor, astfel încât oaspeții să nu poată ieși din ea. - **Dispozitiv**: orice instalare a aplicației care apare în Tillor, indiferent de tip. - **Odihna de noapte**: orele în care ecranul se stinge sau devine negru. - **Blocarea ecranului**: un model sau un cod PIN pe tableta însăși, altceva decât blocarea chioșcului. Mai multe explicații găsiți în [lista de termeni](/begrippen). ## Vezi și [#zie-ook] # Configurarea unui chioșc (/ro-RO/mobiele-app/kiosk-inrichten) Cu un chioșc blocați o tabletă Android pe aplicația Tillor. Oaspeții văd ecranul de start, o prezentare sau un bon și nu ajung în setările Android. După o pană de curent, tableta pornește din nou în Tillor. Această pagină parcurge configurarea unică. Comutatoarele pe care le setați după aceea se află la [Setările dispozitivului](/mobiele-app/toestelinstellingen#kiosk). Fără pașii de mai jos puteți activa **Blochează aplicația**, dar atunci Android folosește doar fixarea ecranului. Aceasta cere o confirmare pe tabletă și un oaspete o poate părăsi. Starea din fila **Chioșc** spune atunci **Fixarea ecranului. Această tabletă nu este un chioșc configurat.** Blocarea completă se aplică abia când Tillor este proprietarul dispozitivului. În fila **Chioșc** citiți asta ca **Chioșc configurat: blocarea este completă.** Aceasta funcționează pe Android. Pe iOS puteți folosi aplicația ca chioșc pentru bonuri și ecranul de start, dar nu o puteți seta ca proprietar al dispozitivului. Butoanele de sub **Administrare Android** rămân atunci închise, cu mesajul **Disponibil după ce această tabletă este configurată ca chioșc.** ## Înainte de a începe [#voor-je-begint] Aveți nevoie de un computer cu `adb`. Este un program gratuit de la Google cu care controlați o tabletă Android printr-un cablu USB. Este o treabă unică pentru fiecare tabletă, destinată celor cu oarecare cunoștințe tehnice. Dacă nu reușiți, cereți ajutor asistenței Tillor. Înainte de a începe: - Readuceți tableta la setările din fabrică sau folosiți o tabletă pe care nu se află încă un cont Google suplimentar. Android refuză o aplicație ca proprietar de îndată ce pe dispozitiv există deja un cont. - Aplicația Tillor trebuie să fie instalată și autentificată la organizația dumneavoastră. - În setările Android, activați **Depanare USB** (Opțiuni pentru dezvoltatori). - Conectați tableta la computer cu un cablu. `adb devices` trebuie să arate tableta ca `device`, nu ca `unauthorized`. ## Tillor ca proprietar al tabletei [#tillor-als-eigenaar-van-de-tablet] Proprietarul unui dispozitiv Android are voie să facă lucruri pe care o aplicație obișnuită nu le poate face, precum blocarea reală a tabletei. Acordați-i lui Tillor acest rol cu această comandă pe computer: ```bash adb shell dpm set-device-owner eu.tillor.app/expo.modules.tillorkiosk.KioskAdminReceiver ``` Dacă are succes, Android răspunde că proprietarul a fost setat. Dacă eșuează cu un mesaj despre conturi, ștergeți conturile sau începeți din nou de la o resetare din fabrică. Această comandă o puteți seta o singură dată. Un alt proprietar cere din nou o resetare. Apoi, în Tillor, deschideți **Setări** > **Tablete și chioșcuri**, setați tipul pe **Chioșc** și salvați. În fila **Chioșc**, secțiunea **Dispozitiv chioșc** trebuie să fie acum verde. Celelalte două secțiuni urmează de îndată ce ați trimis **Aplicația ca ecran de pornire** și **Elimină blocarea ecranului**. Explicația acestor secțiuni se află la [Chioșc](/mobiele-app/toestelinstellingen#kiosk). ## Baterie: să nu lăsați aplicația să adoarmă [#batterij-de-app-niet-laten-inslapen] Android, și mai ales Xiaomi cu HyperOS, întrerupe conexiunea unei aplicații care, potrivit sistemului, "doarme". Chioșcul cade atunci offline în toiul nopții, chiar dacă ecranul ar trebui oricum să fie stins de odihna de noapte. Dacă Tillor este proprietar, aplicația cere singură să dezactiveze optimizarea bateriei. Pe majoritatea tabletelor este o fereastră în care atingeți **Permiteți**. Pe Xiaomi, HyperOS deschide în schimb pagina bateriei pentru Tillor: alegeți acolo **Fără restricții**. Dacă omiteți pasul, aplicația cere din nou după următoarea repornire, iar conexiunea rămâne nesigură noaptea. Nicio aplicație nu poate seta singură această excepție, nici măcar ca proprietar al dispozitivului. Rămâne deci o atingere pe tabletă sau comanda de mai jos. Dacă fereastra nu apare, setați excepția în timpul configurării, de pe computer: ```bash adb shell dumpsys deviceidle whitelist +eu.tillor.app ``` După aceea, aplicația trebuie să rămână în comunicare cu Tillor în fundal, chiar și cu ecranul stins. ## Eliminarea blocării ecranului [#schermvergrendeling-weghalen] Un model sau un cod PIN pe tabletă înseamnă că Android așteaptă pe ecranul de blocare după fiecare repornire. Chioșcul rămâne atunci negru până trece cineva pe acolo. Secțiunea **Blocarea ecranului** avertizează în acest sens: **Este setat un model sau un cod PIN.** 1. Deschideți fila **Chioșc**. 2. Sub **Administrare Android**, setați **Elimină blocarea ecranului** pe **Pornit**. 3. Alegeți **Salvează și trimite**. Tableta nu o cere singură. Blocarea dispare data următoare când cineva introduce modelul sau codul PIN, de exemplu după o repornire. După aceea, o repornire se încheie în Tillor. Dacă nu doriți să așteptați, eliminați modelul chiar dumneavoastră în setările Android ale tabletei. Secțiunea devine **Fără model sau PIN: o repornire se termină în Tillor.** Cât timp Tillor este ecranul de start, HyperOS comută navigarea de la gesturi la butoane. Tillor ascunde acea bară până când cineva atinge de trei ori ecranul de start. Dacă alegeți **Deblochează temporar** în aplicație, reveniți la ecranul de start al Xiaomi. Dacă doriți acolo din nou gesturi, setați-le în setările Android. ## Ce activați după aceea [#wat-je-daarna-aanzet] Pentru o tabletă într-o carcasă la recepție sau la intrare, acesta este un set utilizabil. Totul se află în fila **Chioșc**, dacă nu se menționează altfel. | Setare | Poziție | De ce | | --- | --- | --- | | **Aplicația ca ecran de pornire** | Pornit | Butonul home deschide Tillor. Ceasul și bateria rămân vizibile. | | **Blochează aplicația** | Pornit | Oaspeții nu pot părăsi aplicația. | | **Ascunde interfața sistemului** | Pornit | Fără notificări, fără aplicații recente, fără meniul de pornire/oprire. | | **Protejează dispozitivul** | Pornit | Fără resetare din fabrică, fără mod sigur, fără transfer USB, fără dezinstalare. | | **Rămâne pornit la încărcare** | Pornit | Ecranul rămâne aprins în timpul programului cât timp încărcătorul este conectat. Odihna de noapte are prioritate. | | **Oră automată** | Pornit | Odihna de noapte urmează ceasul organizației, nu un ceas decalat al tabletei. | | **Orientarea ecranului** | Portret sau peisaj | La **Ecran și repaus**, potrivit carcasei. **Standard** înseamnă rotire automată. | **Blochează volumul** menține volumul din fila **Bonuri și sunet**, astfel încât un oaspete să nu poată folosi butoanele de pe lateral. Salvați și verificați cele trei secțiuni din partea de sus a filei **Chioșc**. Verde înseamnă că tableta raportează așa. Un avertisment înseamnă că acel pas nu a reușit încă. ## O versiune nouă a aplicației prin USB [#een-nieuwe-app-versie-over-usb] **Protejează dispozitivul** dezactivează depanarea USB și transferul de fișiere. **Blochează aplicația** menține tableta în aplicație, astfel încât o fereastră de instalare nu poate fi confirmată. Înainte de a instala un build prin cablu: 1. Setați **Blochează aplicația** pe **Oprit**. 2. Setați **Protejează dispozitivul** pe **Oprit**. 3. Alegeți **Salvează și trimite** și așteptați până când tableta eliberează blocarea. 4. Instalați versiunea nouă. Pe Xiaomi, HyperOS cere pe tabletă confirmarea instalării prin USB: atingeți **Instalați**. 5. Setați din nou ambele setări pe **Pornit** și salvați din nou. Dacă lăsați **Protejează dispozitivul** pornit, `adb` nu mai vede tableta. Excepția de baterie și proprietatea se păstrează la o actualizare obișnuită. La o resetare din fabrică nu: atunci începeți din nou de la comanda `dpm`. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - După o repornire sau o pană de curent, tableta pornește din nou în Tillor, pe ecranul de start. - Oaspeții nu pot părăsi aplicația și nu văd notificări sau aplicații recente. - Cele trei secțiuni din partea de sus a filei **Chioșc** arată ce raportează tableta însăși. După o modificare poate dura puțin până când secțiunile devin verzi, pentru că tableta se anunță la fiecare 30 până la 60 de secunde. - O actualizare obișnuită a aplicației păstrează proprietatea și excepția de baterie. O resetare din fabrică nu. ## Probleme? [#problemen] Android refuză un proprietar de îndată ce pe tabletă există un cont. Ștergeți conturile sau începeți din nou de la o resetare din fabrică. Confirmați pe tabletă fereastra care cere permisiunea pentru computer și verificați dacă **Depanare USB** este activată. Dacă **Protejează dispozitivul** este pornit, `adb` nu mai vede tableta: dezactivați-l ca la actualizarea prin USB de mai sus. Tillor nu este încă proprietarul tabletei, deci Android folosește doar fixarea ecranului. Executați comanda de proprietar și apoi alegeți **Salvează și trimite**. Alături apare mesajul **Disponibil după ce această tabletă este configurată ca chioșc.** Configurați tableta ca mai sus sau folosiți o tabletă Android: pe iOS nu este posibil. Pe tabletă există un model sau un cod PIN. Activați **Elimină blocarea ecranului** și introduceți o dată modelul sau codul PIN sau eliminați blocarea în setările Android. Android a lăsat aplicația să adoarmă. Dezactivați optimizarea bateriei pentru Tillor, ca la titlul Baterie de mai sus. ## Vezi și [#zie-ook] # Configurarea odihnei de noapte pentru ecran (/ro-RO/mobiele-app/nachtrust-instellen) O tabletă care rămâne aprinsă toată noaptea consumă curent și poate să-și "ardă" ecranul. Cu odihna de noapte, ecranul se stinge sau devine negru în orele în care parcul este închis. Celelalte opțiuni de ecran, precum diminuarea luminozității, se află la [Setările dispozitivului](/mobiele-app/toestelinstellingen#scherm-en-slaap). Înainte de a începe: - Dacă doriți ca ecranul să se stingă cu adevărat și să poată fi trezit la distanță, configurați mai întâi tableta ca chioșc și puneți aplicația în excepția de baterie. Vezi [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten). - Dacă alegeți programul de funcționare al organizației dumneavoastră, completați-l mai întâi. Vezi [Organizație](/gebruikers/organisaties#openingsuren). ## Configurarea odihnei de noapte [#de-nachtrust-instellen] ### Deschideți fila Ecran și repaus [#open-het-tabblad-scherm-en-slaap] Deschideți dispozitivul prin Setări > Tablete și chioșcuri și faceți clic pe secțiunea **Ecran și repaus**. Căutați grupul **Odihna de noapte**. ### Alegeți Modul de noapte [#kies-de-nachtstand] Alegeți **Ore fixe** și completați **De la** și **Până la**. Un program care trece de miezul nopții, precum 22:00 până la 07:00, este permis. Ecranul urmează programul de funcționare al organizației dumneavoastră. Îl modificați într-un singur loc și toate dispozitivele îl urmează. Cu **Oprit**, Tillor nu planifică niciun repaus. ### Alegeți Stilul de somn [#kies-de-slaapstijl] **Voal negru** pune un strat negru peste imagine, iar o atingere îl trezește imediat. **Ecran stins** stinge cu adevărat panoul. ### Faceți clic pe Salvează și trimite [#klik-op-opslaan-en-versturen] În dreapta sus a grupului apare când urmează următorul repaus. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - În timpul odihnei de noapte, ecranul se stinge sau devine negru, chiar dacă **Menține ecranul pornit** este activat. Odihna de noapte are prioritate. - Atingerea trezește ecranul pentru scurt timp. - La sfârșitul programului, ecranul revine la normal. - În timpul odihnei de noapte, Tillor nu trimite alerta că dispozitivul este offline. - Dacă doriți să treziți sau să adormiți ecranul în afara programului, folosiți [Acțiuni la distanță](/mobiele-app/acties-op-afstand). ## Probleme? [#problemen] **Ecran stins** funcționează complet pe o tabletă configurată ca chioșc. Trezirea la distanță reușește doar dacă aplicația se află și în excepția de baterie. Vezi [Baterie](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). Un ceas decalat pe tabletă mută programul. În fila **Chioșc**, activați **Oră automată**, astfel încât tableta să urmeze ceasul organizației. Android lasă aplicația să adoarmă. Dezactivați optimizarea bateriei pentru Tillor, vezi [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). ## Vezi și [#zie-ook] # Configurarea ecranului de start și a unei prezentări (/ro-RO/mobiele-app/startscherm-en-diavoorstelling) Ecranul de start este ceea ce văd oaspeții când pe ecran nu este niciun bon: un text de bun venit, sigla dumneavoastră, butoane și eventual o prezentare cu afișe sau fotografii ale parcului. Aici o configurați. Fiecare setare în parte, cu limitele ei, se află la [Setările dispozitivului](/mobiele-app/toestelinstellingen#startscherm). Înainte de a începe: - Dispozitivul apare în Setări > Tablete și chioșcuri, vezi [Gestionarea unei tablete sau a unui chioșc](/mobiele-app/tablets-en-kiosken). - Fotografiile sunt fișiere JPEG, PNG sau WebP sau un link `https` către o imagine. ## Modificarea textului de bun venit [#de-welkomsttekst-aanpassen] ### Deschideți fila Ecran de start [#open-het-tabblad-startscherm] Deschideți dispozitivul și faceți clic pe secțiunea **Ecran de start**. Câmpurile **Titlu de întâmpinare** (cel mult 60 de caractere) și **Subtitlu de întâmpinare** (cel mult 120) se află în partea de sus. ### Completați textul și trimiteți [#vul-de-tekst-in-en-verstuur] Lăsați un câmp gol dacă aplicația poate păstra textul ei. Faceți clic pe **Salvează și trimite**. ## Adăugarea unei prezentări [#een-diavoorstelling-toevoegen] ### Deschideți fila Prezentare și butoane [#open-het-tabblad-diavoorstelling-en-knoppen] Faceți clic pe acea secțiune. La **Afișare** alegeți cum apar fotografiile. ### Alegeți afișarea [#kies-de-weergave] Fotografiile se schimbă în spatele siglei și al butoanelor, în locul fundalului organizației dumneavoastră. Oaspeții pot atinge în același timp butoanele. Fotografiile preiau întregul ecran de îndată ce nimeni nu atinge ecranul. O atingere readuce ecranul de start. Cât durează așteptarea stabiliți la **Pornire după**. ### Adăugați fotografii [#voeg-fotos-toe] Faceți clic pe **Încărcați o fotografie** sau lipiți o adresă `https` prin **Adăugați un link**. Puteți adăuga până la 20 de fotografii. Eventual, adăugați la o fotografie o legendă de cel mult 80 de caractere. ### Stabiliți durata [#stel-de-timing-in] **Timp per fotografie** variază de la 3 la 600 de secunde. **Pornire după** de la 10 la 3600 de secunde. La **Încadrare** alegeți **Umpleți ecranul** (marginile sunt tăiate) sau **Afișați întreaga fotografie** (cu margini negre). ### Faceți clic pe Salvează și trimite [#klik-op-opslaan-en-versturen] Tableta afișează prezentarea de îndată ce a primit setările. ## Adăugarea de butoane suplimentare [#extra-knoppen-toevoegen] Butoanele suplimentare sunt scurtături pe ecranul de start, de exemplu către o hartă sau către rețeaua pentru oaspeți. Puteți avea șase. ### Faceți clic pe Adaugă buton [#klik-op-knop-toevoegen] Apare un rând gol. ### Completați butonul [#vul-de-knop-in] Dați un text, o scurtă descriere și o adresă web (doar `https`). Alegeți o pictogramă din rând și, la **Când se afișează**, dacă butonul este mereu vizibil sau abia după o atingere. ### Faceți clic pe Salvează și trimite [#klik-op-opslaan-en-versturen-1] Pictograma coș de gunoi șterge un buton. **Lasă dispozitivul să decidă** elimină lista din Tillor, astfel încât tableta să-și folosească propriile butoane. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Tableta modifică ecranul de start de îndată ce primește setările. O tabletă offline face asta când se reconectează. - Dacă ați setat **Buton preplătit** sau **Buton setări** pe **După o atingere**, butonul dispare după numărul de secunde pe care l-ați completat la **Ascunde după**. - Un bon, un document sau o cerere de semnare pe care Tillor le trimite către tabletă apar peste ecranul de start și apoi dispar. ## Probleme? [#problemen] Fișierul nu este JPEG, PNG sau WebP sau încărcarea a fost întreruptă. Încercați altă fotografie sau folosiți **Adăugați un link** cu adresa imaginii. Butoanele apar abia când **Afișare** nu este pe **Dezactivat**. Dacă lista are 20 de fotografii, eliminați mai întâi una cu **Eliminați fotografia**. La **Pe tot ecranul la inactivitate**, pornește abia după numărul de secunde de la **Pornire după**, fără nicio atingere. Valoarea implicită pentru o prezentare nouă este de 60 de secunde. Verificați și dacă tableta a primit deja noile setări. Adresa trebuie să înceapă cu `https`. Verificați dacă linkul funcționează într-un browser. ## Vezi și [#zie-ook] # Gestionarea unei tablete sau a unui chioșc (/ro-RO/mobiele-app/tablets-en-kiosken) Fiecare tabletă, chioșc sau telefon pe care cineva deschide aplicația Tillor și alege o organizație apare în Tillor. De acolo vedeți dacă dispozitivul este încă conectat și îi trimiteți ecranul de pornire, sunetul și blocarea chioșcului. Ce puteți seta se găsește, pe file, la [Setările dispozitivului](/mobiele-app/toestelinstellingen). Înainte de a începe: - Dispozitivul trebuie să aibă aplicația Tillor, iar cineva trebuie să fie autentificat la organizația dumneavoastră. Dacă nu este cazul, vedeți **Încă niciun dispozitiv**. - Trimiterea setărilor este permisă doar cu permisiunea **Editați setările**. ## Trimiterea setărilor către un dispozitiv [#instellingen-naar-een-toestel-sturen] ### Deschideți lista [#open-de-lijst] Mergeți la Setări > Tablete și chioșcuri. Fiecare rând este o instalare a aplicației. Vedeți numele, tipul (**Tabletă**, **Chioșc** sau **Telefon**), modelul, versiunea aplicației, procentul bateriei și dacă dispozitivul este conectat. **Văzut ultima dată** înseamnă că aplicația nu a mai raportat nimic de ceva timp. ### Deschideți dispozitivul [#open-het-toestel] Faceți clic pe rândul dispozitivului. Sus se află numele și starea. Dedesubt sunt un câmp de căutare și un rând de dale, câte una pentru fiecare filă. Pe o dală este afișat câte setări provin din Tillor. **Totul rămâne pe dispozitiv** înseamnă că pe acea filă nu ați fixat încă nimic. În dreapta rămâne panoul **Acțiuni la distanță**, vezi [Acțiuni la distanță](/mobiele-app/acties-op-afstand). ### Modificați setările [#pas-de-instellingen-aan] Alegeți o filă și modificați ce doriți. Aproape fiecare comutator are trei poziții: **Dispozitiv**, **Pornit** și **Oprit**. **Dispozitiv** păstrează alegerea făcută chiar pe tabletă. **Pornit** și **Oprit** suprascriu acea alegere de îndată ce salvați. Sub descriere se vede ce face aplicația dacă nimeni nu a ales nimic, de exemplu **Implicit: Pornit**. ### Faceți clic pe Salvează și trimite [#klik-op-opslaan-en-versturen] Nimic nu ajunge la dispozitiv cât timp nu faceți clic aici. Cât timp există ceva modificat, în bară apare **Modificări netrimise**, iar fila are un punct verde. **Renunță la modificări** readuce formularul la ce se află acum pe dispozitiv. Înainte și după o modificare pe care nu ați trimis-o încă: ## La fel pentru toate dispozitivele [#hetzelfde-voor-alle-toestellen] Dacă aveți mai multe dispozitive de același tip, nu trebuie să le setați pe fiecare separat. Faceți clic pe **Salvează și trimite**. Doar acest dispozitiv primește setările. Faceți clic pe **Aplică tuturor chioșcurilor** (sau **tabletelor**, sau **telefoanelor**, în funcție de tip). Tillor copiază setările acestui dispozitiv pe celelalte dispozitive de același tip și le trimite imediat, cu mesajul **Setări copiate pe celelalte dispozitive**. Numele, tipul și alertele rămân ale fiecărui dispozitiv în parte. Limba se copiază totuși. ## Căutare în toate filele [#zoeken-over-alle-tabbladen] Nu știți pe ce filă se află o setare? Câmpul **Caută setări** caută în toate filele deodată. Dalele rămân, iar dedesubt apare o listă de rezultate, grupate pe file. O căutare precum `luminozitate` arată regulile de luminozitate din **Ecran și repaus**, iar dedesubt alte file care conțin și ele cuvântul. **Deschide fila** închide căutarea și deschide acea filă, ca să vedeți și restul grupului. Dacă nu găsiți nimic, apare **Nicio setare nu corespunde cu** termenul căutat. ## Uitarea unui dispozitiv [#een-toestel-vergeten] Meniul cu trei puncte din dreapta sus pe pagina dispozitivului conține **Uită dispozitivul**. Folosiți-l pentru o tabletă care nu mai este în uz. ## Ce se întâmplă apoi? [#wat-gebeurt-er-daarna] - Tillor afișează **Setări trimise**. Tableta le aplică imediat dacă este conectată. Dacă este offline, le primește de îndată ce stabilește din nou legătura cu Tillor. Aplicația se anunță la fiecare 30 până la 60 de secunde. - Pe pagina dispozitivului și în listă se vede dacă dispozitivul este conectat. Dispozitivul raportează înapoi și bateria, versiunea aplicației și conexiunea, vezi [Diagnosticare și istoric](/mobiele-app/diagnose-en-geschiedenis). - Fiecare modificare ajunge în istoricul dispozitivului și în [jurnalul de activitate](/activiteitenlog) al organizației dumneavoastră. - Un dispozitiv uitat dispare din listă, iar setările trimise dispar odată cu el. Dacă aplicația rulează în continuare pe el și cineva este autentificat, revine în mai puțin de un minut, fără acele setări. Trebuie atunci să le setați din nou. - Dacă activați **Alerte** pe fila **Dispozitiv**, persoanele care gestionează setările primesc un mesaj când dispozitivul este offline de 10 minute sau când bateria scade sub 15% fără încărcător. ## Probleme? [#problemen] Nicio tabletă nu s-a înregistrat încă. Deschideți aplicația Tillor pe tabletă, autentificați-vă și alegeți organizația potrivită. Dispozitivul apare în mai puțin de un minut. Salvarea nu a reușit, adesea din cauza unei conexiuni instabile sau pentru că nu aveți permisiunea **Editați setările**. Încercați din nou. Dacă tot nu merge, cereți permisiunea administratorului. **Aplică tuturor chioșcurilor** nu a reușit. Faceți clic încă o dată. Dacă nu merge, salvați dispozitivul cu **Salvează și trimite** și deschideți celelalte dispozitive pe rând. Verificați dacă dispozitivul este **Conectat**. Dacă este offline, aplică setările de îndată ce stabilește din nou legătura. Dacă comutatorul este pe **Dispozitiv**, decide tableta însăși. Alegeți **Pornit** sau **Oprit** pentru a o suprascrie. Aplicația rulează în continuare și cineva este autentificat, deci se înregistrează din nou. Deconectați-vă de pe tabletă dacă vreți cu adevărat să scăpați de dispozitiv. Sub **Cont** > **Sesiuni active** puteți încheia sesiunea aplicației. **Cod pentru setări** de pe fila **Ecran de start** trebuie să aibă între 4 și 6 cifre sau să fie gol. Abia atunci puteți salva. ## Vezi și [#zie-ook] # Setările dispozitivului (/ro-RO/mobiele-app/toestelinstellingen) Aici găsiți toate setările unui dispozitiv, pe file, cu valorile lor implicite și limitele. Sunt șase, fiecare o dală deasupra formularelor. Cum ajungeți acolo, cum funcționează căutarea și când pleacă ceva către dispozitiv se află la [Gestionarea unei tablete sau a unui chioșc](/mobiele-app/tablets-en-kiosken). Pas cu pas, ecranul de start se află la [Setarea ecranului de start și a unei prezentări de fotografii](/mobiele-app/startscherm-en-diavoorstelling), iar repausul de noapte la [Setarea unui repaus de noapte pentru ecran](/mobiele-app/nachtrust-instellen). Fiecare regulă are o pictogramă, o scurtă explicație și, acolo unde are sens, valoarea implicită a aplicației. Alegeți **Dispozitiv** (sau lăsați un număr gol pe **Implicit**) dacă tableta își poate păstra propria alegere. **Pornit** și **Oprit** suprascriu acea alegere. Regulile care funcționează doar pe un chioșc configurat afișează un avertisment cât timp tableta nu este încă configurată astfel: **Disponibil după ce această tabletă este configurată ca chioșc.** Pașii se află la [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten). ## Ecran de start [#startscherm] Textul de întâmpinare, fundalul și butoanele pe care le văd oaspeții când pe ecran nu este afișat niciun bon. ### Text de întâmpinare [#welkomsttekst] **Titlu de întâmpinare** (maximum 60 de caractere) și **Subtitlu de întâmpinare** (maximum 120) se află în partea de sus a ecranului de start. Lăsați un câmp gol dacă aplicația își poate păstra propriul text. ### Aspect [#uiterlijk] **Aspect** (marcajul **1**): - **Fotografie de fundal** afișează fundalul organizației în spatele siglei. Implicit pornit. - **Întunecarea fundalului** este un procent de la 0 la 90. Implicit 45, astfel încât sigla și butoanele rămân lizibile pe o fotografie deschisă. - **Stilul siglei** este **Siluetă albă** (implicit) sau **Color, pe un card**. ### Butoane [#knoppen] **Butoane** (marcajul **2**): - **Buton preplătit** deschide soldul, încărcarea și plata cu un card NFC. Implicit pornit. - **Buton setări** afișează un buton către setările de pe dispozitivul însuși. Dacă este oprit, ajungeți la ele atingând de trei ori ecranul de start. - **Când se afișează** este **Întotdeauna** sau **După o atingere**. La **După o atingere** completați **Ascunde după**, în secunde. După aceea butonul dispare din nou până când cineva atinge ecranul. - **Cod pentru setări** are 4 până la 6 cifre. Dispozitivul cere acest cod înainte să se deschidă propriile setări. Gol înseamnă fără cod. Altceva decât 4 până la 6 cifre nu se poate salva. ## Prezentare și butoane [#diavoorstelling-en-knoppen] Fotografii pe care ecranul de start le alternează și butoane suplimentare către o pagină web. ### Prezentare de fotografii [#diavoorstelling] **Afișare** (marcajul **1**) are trei poziții: - **Oprit** nu afișează fotografii. - **Ca fundal** alternează fotografiile în spatele siglei și al butoanelor, în locul fundalului organizației. - **Pe tot ecranul la inactivitate** preia întregul ecran de îndată ce nimeni nu atinge ecranul. De îndată ce afișarea nu este pe **Oprit**, puteți adăuga până la 20 de fotografii. **Încărcați o fotografie** acceptă JPEG, PNG sau WebP. **Adăugați un link** lipește o adresă `https` a unei imagini. Pentru fiecare fotografie puteți seta o legendă de maximum 80 de caractere. - **Timp per fotografie** este cât timp rămâne fiecare fotografie, de la 3 la 600 de secunde. O prezentare nouă începe la 10. - **Pornire după** se aplică doar la pe tot ecranul: secunde fără atingere înainte să pornească prezentarea, de la 10 la 3600. O prezentare nouă începe la 60. - **Încadrare**: **Umpleți ecranul** taie marginile, **Afișați întreaga fotografie** păstrează fotografia întreagă, cu margini negre. O prezentare nouă începe pe **Afișați întreaga fotografie**. O atingere pe o prezentare pe tot ecranul readuce ecranul de start. ### Butoane suplimentare [#extra-knoppen] **Butoane suplimentare** (marcajul **2**) sunt scurtături pe ecranul de start, de exemplu o hartă sau rețeaua pentru oaspeți. Puteți avea șase. Pentru fiecare buton completați textul de pe buton, o scurtă descriere, adresa web și o pictogramă. Pictograma o alegeți din rând: hartă, site web, informații, calendar, mâncare și băutură, wifi, telefon sau bilete. **Când se afișează** funcționează la fel ca la butonul preplătit: întotdeauna sau abia după o atingere, apoi din nou ascuns. **Adaugă buton** creează un rând gol. Pictograma coșului de gunoi șterge acel buton. **Lasă dispozitivul să decidă** aruncă lista din Tillor, astfel încât tableta folosește propriile butoane. Cât timp nu ați salvat încă butoane, apare și această frază: nu sunt setate butoane din Tillor. ## Ecran și repaus [#scherm-en-slaap] Luminozitatea, orientarea, culorile și când se stinge ecranul noaptea. ### Luminozitate [#helderheid] Dacă nu găsiți o setare, încercați `luminozitate` în câmpul de căutare, vezi [Căutare în toate filele](/mobiele-app/tablets-en-kiosken#zoeken-over-alle-tabbladen). - **Mod chioșc** menține ecranul pornit, cu bonuri, semnare și reglarea luminozității. Implicit pornit pe o tabletă sau un chioșc, oprit pe un telefon. - **Menține ecranul pornit** împiedică adormirea ecranului. Implicit pornit, pe un telefon oprit. - **Diminuează la inactivitate** trece la luminozitate maximă la o atingere și apoi diminuează. Implicit pornit, pe un telefon oprit. - **Diminuează după** este numărul de secunde fără atingere, de la 5 la 3600. Implicit 15. - **Luminozitate diminuată** este procentul în acea stare diminuată, de la 0 la 100. Implicit 0,5%. Repausul de noapte de mai jos are prioritate față de **Menține ecranul pornit**: în orele de repaus, ecranul se stinge sau se înnegrește oricum. ### Afișare [#weergave] - **Orientarea ecranului** este **Rotire automată** (implicit), **Portret** sau **Peisaj**. Fixați un chioșc într-o carcasă, altfel imaginea se rotește când cineva ține tableta înclinat. - **Afișare** este **Urmează dispozitivul**, **Deschis** sau **Închis**. ### Repaus de noapte [#nachtrust] **Mod de noapte** (marcajul **1**) are trei poziții: - **Oprit** nu programează repaus. - **Ore fixe** folosește **De la** și **Până la**. Un program care trece peste miezul nopții, cum ar fi 22:00 până la 07:00, este permis. Ecranul se stinge în acel interval, chiar dacă în restul zilei trebuie să rămână pornit. O atingere îl trezește pentru scurt timp. - **Când organizația este închisă** urmează orele de deschidere ale organizației. În dreapta sus a grupului se vede când urmează următorul repaus. **Stil de somn**: - **Voal negru** așază un voal negru peste imagine. Ecranul rămâne sensibil la atingere, deci o atingere îl trezește imediat. - **Ecran stins** oprește cu adevărat panoul. Se trezește la sfârșitul programului sau cu **Activați ecranul** de la [Acțiuni la distanță](/mobiele-app/acties-op-afstand). Funcționează complet pe o tabletă configurată ca chioșc. Trezirea la distanță reușește doar dacă aplicația se află și în excepția pentru baterie, vezi [Baterie](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). ## Bonuri și sunet [#kassabonnen-en-geluid] Ce face tableta când Tillor trimite un document și ce sunete redă. ### Bonuri și documente [#kassabonnen-en-documenten] Marcajul **1**: - **Afișează bonuri și documente** afișează pe acest dispozitiv PDF-uri, imagini și cereri de semnare. Implicit pornit, pe un telefon oprit. Opriți-l pe o tabletă care trebuie să fie doar un ecran de start și nu are voie să afișeze bonuri. - **Șterge după** este numărul de secunde cât rămâne un bon înainte ca dispozitivul să-l scoată singur, de la 5 la 900. Lăsați gol pentru a aștepta până când Tillor șterge ecranul. ### Sunet [#geluid] Marcajul **2**. Tot ce urmează este implicit pornit, volumul la 100%. - **Sunet la pornire** se redă când aplicația pornește sau repornește. - **Sunet pentru bonuri și documente** se redă când sosește un bon, o imagine sau o cerere de semnare. - **Sunet pentru plăți online** se redă când o factură este plătită online sau printr-un transfer automat. - **Sunet la baterie descărcată** redă un avertisment când bateria este aproape goală și încărcătorul nu este conectat. - **Volum sonor** este de la 0 la 100. Pe un chioșc îl puteți fixa cu **Blochează volumul** pe fila **Chioșc**. **Redați sunetul de test** se află la [Acțiuni la distanță](/mobiele-app/acties-op-afstand), nu pe această filă. ## Chioșc [#kiosk] Util doar pe Android. Configurarea (proprietarul dispozitivului, bateria, USB) se află la [Configurarea unui chioșc](/mobiele-app/kiosk-inrichten). Pe această filă setați apoi comutatoarele. ### Stare [#status] Trei dale (marcajul **1**) arată ce a spus tableta la ultimul ei raport. Nu sunt setări. - **Dispozitiv chioșc** este verde la **Chioșc configurat: blocarea este completă.** Un avertisment înseamnă fixarea ecranului (aplicația nu este proprietarul) sau că aplicația nu este deloc blocată. O liniuță înseamnă că această versiune a aplicației nu transmite încă starea. - **Ecran de start** este verde dacă Tillor este ecranul de start. Altfel se arată că Tillor nu este încă, sau că aplicația nu a raportat încă. - **Blocarea ecranului** avertizează dacă pe tabletă este setat un model sau un cod PIN. După o repornire, dispozitivul așteaptă atunci pe ecranul de blocare. Verde înseamnă că o repornire se termină în Tillor. ### Blocare [#vergrendeling] Marcajul **2**. Implicit aceste trei sunt oprite, până când le porniți dumneavoastră. - **Aplicația ca ecran de pornire** face din Tillor ecranul de start. Ceasul și bateria rămân vizibile. Doar Android și doar cu o versiune a aplicației care poate face asta. - **Blochează aplicația** ține tableta în aplicația Tillor. Pe un chioșc configurat, un oaspete nu poate ieși. Fără această configurare, Android revine la fixarea ecranului: cineva de la tabletă trebuie să confirme, iar ecranul se poate părăsi. - **Ascunde interfața sistemului** elimină notificările, aplicațiile recente și meniul de pornire/oprire. Ceasul și bateria rămân. Funcționează abia după ce tableta este configurată ca chioșc. ### Administrare Android [#android-beheer] Tot ce se află în acest grup (marcajul **1**) se aplică doar unui chioșc configurat. Pe alt dispozitiv vedeți avertismentul la fiecare regulă, iar butoanele sunt oprite. Implicit comutatoarele sunt oprite. Cele două numere sunt goale: tableta își păstrează atunci propria luminozitate și propria stingere a ecranului. - **Protejează dispozitivul** blochează resetarea la setările din fabrică, modul sigur, utilizatorii noi, transferul prin USB, dezinstalarea și oprirea forțată. Opriți-l înainte să instalați o actualizare prin USB. - **Elimină blocarea ecranului** șterge modelul sau codul PIN. Intră în vigoare de îndată ce acel model sau cod PIN a fost introdus încă o dată. - **Rămâne pornit la încărcare** ține ecranul pornit în timpul orelor de deschidere cât timp încărcătorul este conectat. Repausul de noapte îl stinge oricum. - **Blochează volumul** fixează volumul de la **Sunet**. - **Actualizări în timpul somnului** instalează actualizările de sistem în timp ce ecranul doarme și le amână cât timp tableta este folosită. - **Oră automată** cere data, ora și fusul orar automate, astfel încât repausul să urmeze orele de deschidere. - **Luminozitatea ecranului** este o luminozitate fixă a tabletei însăși, de la 1 la 100, cu luminozitatea automată oprită. Dacă o lăsați goală, se păstrează setarea tabletei. - **Stingerea ecranului** este numărul de secunde (15 până la 3600) după care Android stinge ecranul dacă aplicația nu îl ține pornit. Dacă o lăsați goală, se păstrează setarea tabletei. ## Dispozitiv [#toestel] Nume, tip, limbă și alerte. **Aplică tuturor chioșcurilor** copiază limba pe celelalte dispozitive de același tip și lasă neschimbate numele, tipul și alertele. Marcajul **1**: - **Nume** este ce vedeți în listă și pe dispozitiv, de exemplu `Zelfbedieningskiosk`. Maximum 80 de caractere. - **Tip** este **Tabletă**, **Chioșc** sau **Telefon**. Tipul determină textul de la **Aplică tuturor …** și câteva valori implicite: pe un telefon, modul chioșc, bonurile, menținerea ecranului pornit și diminuarea încep oprite. - **Limbă** este singura listă care se închide, pentru că există mai multe opțiuni decât încap pe un rând de butoane. **Implicit** urmează limba tabletei. Altfel alegeți o limbă a aplicației Tillor. Numele sunt scrise în limba respectivă. - **Alerte** anunță persoanele care gestionează setările dacă acest dispozitiv este offline de 10 minute sau dacă bateria scade sub 15% fără încărcător. În timpul repausului de noapte nu se trimite nicio alertă de offline. Implicit oprit. Limba de aici este limba aplicației de pe tabletă. Limba sistemului Android o vedeți la **Diagnosticare**, ca **Limba dispozitivului**. # Automatizări (/ro-RO/ontwikkelaars/automatiseringen) Automatizările lasă Tillor să execute singur acțiuni, cum ar fi crearea de sarcini sau apelarea sistemului dumneavoastră. Explicația pentru utilizatori se află la [Automatizări](/automatiseringen). Această pagină descrie ce vede un integrator: mesajul pasului **Trimite webhook**, **Cererea API** către un URL propriu sau către API-ul Tillor și cum este construit un flux dacă îl gestionați prin API. ## Trimite webhook [#webhook-versturen] Pasul **Trimite webhook** livrează un mesaj propriu către unul dintre [webhook-urile](/ontwikkelaars/webhooks) organizației. Este aceeași livrare ca la evenimentele webhook obișnuite, cu aceeași semnătură. ### Mesajul [#het-bericht] Pasul face un `POST` cu `Content-Type: application/json` și aceste anteturi: | Antet | Conținut | |---|---| | `X-Webhook-Event-ID` | Un ID unic pentru această livrare. La reîncercări valoarea rămâne aceeași, deci puteți elimina dublurile pe baza ei | | `X-Webhook-Signature` | `sha256=`, HMAC-SHA256 al corpului cu secretul de semnare al webhook-ului | Corpul are același plic ca payload-ul webhook: ```json { "event": "automation.invoice_unpaid", "data": { "invoice": "2026-0042", "amountOutstanding": 125.5 }, "timestamp": 1735689600000, "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d", "triggeredBy": null } ``` | Câmp | Descriere | |---|---| | `event` | **Numele evenimentului** pe care l-ați completat în pas. Orice text este permis, numele nu trebuie să se afle în lista de chei de eveniment | | `data` | **Payload**-ul din pas, după completarea variabilelor, ca JSON | | `timestamp` | Timpul Unix în milisecunde al livrării | | `traceId` | Un UUID aleatoriu pentru fiecare livrare. Spre deosebire de evenimentele din sistem, acesta nu este un id de urmărire al unei acțiuni Tillor | | `triggeredBy` | Întotdeauna `null` | Nu există `spanId`. Webhook-ul nu trebuie să fie abonat la o cheie de eveniment: un mesaj dintr-o automatizare este livrat întotdeauna la endpoint-ul ales, cât timp acesta există și este activat. Cum verificați semnătura se află la [Verificarea semnăturii](/ontwikkelaars/webhooks#handtekening-verifiëren). ### Încercări și rezultat [#pogingen-en-uitkomst] Tillor face în cadrul pasului până la 5 încercări, cu 1, 2, 4 și 8 secunde de așteptare între ele. O încercare contează ca reușită la un status 2xx. Și o țintă blocată, de exemplu o adresă internă, contează ca încercare eșuată. - Dacă una dintre încercări reușește, fluxul continuă prin ieșirea **Reușit** - Dacă toate cinci eșuează, fluxul continuă prin **Eșuat**. Mesajul este apoi încercat din nou în fundal conform programului de la [Comportamentul livrării și reîncercări](/ontwikkelaars/webhooks#leveringsgedrag-en-retries). Dacă o încercare ulterioară reușește, aceasta nu mai apare în execuție, deoarece aceasta și-a continuat deja drumul Dacă webhook-ul nu mai există sau este dezactivat, pasul nu trece prin **Eșuat**. Execuția se oprește atunci cu statusul **Eșuat**. ## Cerere API către un URL propriu [#api-verzoek-naar-een-eigen-url] Cu **Cerere API** și **Trimite către** pe **URL personalizat**, o automatizare trimite o cerere HTTP către serverul dumneavoastră. | Element | Comportament | |---|---| | Metodă | `GET`, `POST`, `PUT`, `PATCH` sau `DELETE` | | URL | Trebuie să înceapă cu `https://`. Variabilele sunt completate codificate | | Corp | JSON. Nu se trimite la `GET` și `DELETE`. Cu corp, Tillor setează `Content-Type: application/json` | | Anteturi | La alegere liberă. Valorile pot conține variabile. `Host`, `Content-Length`, `Transfer-Encoding` și `Connection` sunt ignorate | | Țintă | Adresele private și interne sunt refuzate, chiar dacă un nume de domeniu obișnuit trimite către ele | | Redirecționări | Nu sunt urmate. Un răspuns 3xx contează ca eșuat | | Timp limită | 15 secunde | Spre deosebire de **Trimite webhook**, Tillor nu semnează această cerere. Dacă doriți să verificați că o cerere vine de la automatizarea dumneavoastră, puneți un secret într-un antet și verificați-l pe partea dumneavoastră. Antetele sunt stocate criptat, deci o cheie sau un token din ele este în siguranță. Un răspuns cu status 2xx continuă prin **Reușit**, orice alt status prin **Eșuat**. Dacă serverul nu poate fi atins sau depășește timpul limită, execuția se oprește cu statusul **Eșuat**. ## Cerere API către API-ul Tillor [#api-verzoek-naar-de-tillor-api] Cu **Trimite către** pe **Tillor API**, automatizarea apelează API-ul propriei organizații. Indicați doar o cale, de exemplu `/tasks`, iar Tillor o plasează după `/api/orgs/{orgId}`. Referința API se află la [OpenAPI](https://tillor.eu/api/openapi.json). - **Identitate**: cererea este executată ca utilizatorul Flux de lucru al organizației. Acesta are toate permisiunile în acea organizație și nicăieri altundeva. Modificările apar deci pe numele **Flux de lucru** - **Nu este nevoie de cheie**: Tillor face apelul singur, fără cheie API și fără a trece prin internet - **Cale**: trebuie să înceapă cu un singur `/`. `//`, `..` și `\` nu sunt permise. Un șir de interogare este permis, de exemplu `/tasks?terrainId=…&limit=1`. Variabilele din cale sunt completate codificate - **Blocat**: căile `/automations` și `/automation-runs` sunt refuzate, chiar și cu un șir de interogare, litere mari, un `/` final sau codificare procentuală. O automatizare nu poate gestiona automatizări - **Corp**: JSON, pentru `POST`, `PUT` și `PATCH`. La `GET` și `DELETE` nu se trimite - **Meniu de alegere**: în editor se află **Alege un endpoint API**, cu operațiunile din specificația OpenAPI. Operațiunile interne nu apar acolo. Dacă alegeți una, Tillor completează metoda, calea și un corp de exemplu - **Eșec**: un răspuns 2xx continuă prin **Reușit**. Un status de eroare, inclusiv un 404 pentru o cale care nu există, trece prin **Eșuat** ### Răspunsul în pașii următori [#het-antwoord-in-latere-stappen] După cerere sunt disponibile aceste variabile: | Variabilă | Conținut | |---|---| | `{response.status}` | Codul de status HTTP | | `{response.body}` | Primele 4000 de caractere ale răspunsului, ca text | | `{response.data}` | Răspunsul ca JSON. `null` dacă nu este JSON sau dacă este mai lung de 100.000 de caractere. Listele le adresați cu un index, de exemplu `{response.data.items.0.id}` | O a doua cerere API din același flux înlocuiește `response`. Variabilele funcționează ca la [Variabile și șabloane](/automatiseringen/variabelen). ## Structura unui flux [#de-opbouw-van-een-flow] Puteți crea și modifica automatizări și prin API. Operațiunile se află în [OpenAPI](https://tillor.eu/api/openapi.json) sub eticheta `automations`. Citirea cere permisiunea `automations:read`, crearea și modificarea `automations:write` (sau toate permisiunile). Utilizatorul Flux de lucru însuși nu le poate apela niciodată. Poate fi mai practic să construiți un flux în editor și să-l citiți ca exemplu. O automatizare nouă este întotdeauna dezactivată. Activarea prin `enabled` nu reușește cât timp fluxul are probleme deschise, iar un flux activat nu poate fi salvat cu probleme. `definition` constă din pași (`nodes`), linii (`edges`) și, opțional, observații (`notes`). Maximum 100 de pași, 200 de linii și 50 de observații. ```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 } ] } ``` O observație (`notes`) este o explicație pe canvas. Nu este niciodată executată și nu are linii. `text` are maximum 2000 de caractere, `width` și `height` sunt în pixeli. O linie are un `sourceHandle`: ieșirea pasului din care pornește. | Pas (`type`) | Ieșiri (`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`-ul fiecărei ramuri, 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` | Fiecare acțiune, cu excepția `webhookSend` și `httpRequest`, primește o ieșire suplimentară `error` de îndată ce `continueOnError` din `config` este `true`. Fără această setare, o acțiune eșuată oprește execuția. Cu această setare, fluxul continuă prin `error`, cu `{error.message}` și `{error.step}` ca variabile pentru pașii următori. Ieșirea `skipped` se folosește când un pas nu a avut nimic de făcut, iar `out` este atunci ieșirea obișnuită. La `forEach`, ieșirea `each` pornește pentru fiecare element o execuție proprie pentru pașii următori, iar ieșirea `done` este continuarea obișnuită a fluxului însuși. O ieșire poate duce către mai mulți pași. Execuția continuă singură cu prima linie și pornește pentru fiecare altă linie o execuție proprie cu aceleași date, care rulează în paralel (ca ieșirea `each` a lui `forEach`). Liniile care formează un ciclu sunt refuzate în editor. Un flux are exact un `trigger`. ### Setări pe pas [#instellingen-per-stap] Câmpurile de sub `config` sunt câmpurile din editor. Câmpurile de text acceptă variabile între acolade. | Pas | Câmpuri în `config` | |---|---| | `trigger` | `source` (`event`, `webhook`, `invoiceOverdue`, `dateReached`, `daily` sau `cron`), `webhookVersion` (la `webhook`: text, măriți-l pentru a înlocui adresa), `eventKey`, `date` (la `dateReached`: o cale `record.veld` către o coloană `DateTime` a unui model pe care un eveniment îl trimite complet, cum ar fi `reservation.checkIn` sau `contact.birthday`, sau către o cheie de dată declarată într-o coloană JSON, cum ar fi `document.userMetadata.insuranceExpiryDate`; nume vechi precum `reservationCheckIn` continuă să funcționeze), `dateOffset` (`{ "amount", "unit" }`), `dateDirection` (`before` sau `after`), `dateTime` (`exact`: ora din dată, sau `fixed`: ziua calendaristică a datei în fusul orar al organizației, cu `dateHour` și `dateMinute`, text precum `"9"` și `"0"`; decalajul se numără pe ceas, deci și peste trecerea la ora de vară și de iarnă), `repeatYearly` (boolean: contează doar ziua și luna, în fiecare an), `hour` și `minute` (text, de exemplu `"8"` și `"0"`, minutul de la 0 la 59), `cron` (cinci câmpuri; ziua săptămânii poate fi `1#2` sau `1L`, un al șaselea câmp `W2:2026-10-05` repetă la fiecare două săptămâni), `conditions`, `oncePerRecord` (boolean) | | `condition` | `conditions` | | `switch` | `field` (o cale de variabilă fără acolade), `cases`: o listă de `{ "id", "key", "value" }` cu `key` ca nume al ramurii și `value` ca valoare cu care câmpul trebuie să fie egal. Maximum 8 ramuri | | `delay` | `mode` (`duration` sau `untilDate`), `duration` și `offset` ca `{ "amount", "unit" }` cu `unit` fiind `seconds`, `minutes`, `hours`, `days` sau `weeks`, `dateField` (cale de variabilă), `direction` (`before` sau `after`) | | `taskCreate` | `title`, `description`, `assigneeIds`, `labelIds`, `assignActor`, `priority` (`LOW`, `MEDIUM`, `HIGH` sau `URGENT`), `viewId`, `laneId`, `subtasks` (una pe rând), `dueIn` (`{ "amount", "unit" }`), `linkRecords` | | `taskSetStatus` | `taskId`, `status` (`PENDING`, `IN_PROGRESS`, `WAITING` sau `COMPLETED`) | | `taskFind` | `title` (titlu exact), `linkedToRecords`, `onlyOpen`, `onlyTopLevel` (boolean) | | `documentFind` | `customerId` (șablon), `documentType` (`INSURANCE_POLICY`, `INSURANCE_PAYMENT_PROOF`, `IDENTITY_CARD`, `SEPA_MANDATE`, `OTHER` sau gol), `onlyActive`, `onlyValid` (boolean). Rezultatul se află sub `foundDocument` | | `documentUpdate` | `documentId` (șablon), `documentType` (gol păstrează tipul), `status` (`ACTIVE`, `ARCHIVED` sau gol) | | `taskSetPriority` | `taskId`, `mode` (`raise`, `lower` sau `set`), `priority` (la `set`), `maxPriority` (la `raise`) | | `taskUpdate` | `taskId`, `title`, `assigneeIds`, `assignActor`, `assigneeMode` (`add` sau `replace`), `labelIds`, `dueIn` (`{ "amount", "unit" }` cu `unit` fiind `minutes`, `hours`, `days` sau `weeks`) | | `invoiceReminderSend`, `invoiceSend`, `invoiceBook` | `invoiceId` | | `invoicePrint` | `invoiceId`, `printer` (`a4`, `pos` sau `tablet`) | | `paymentLinkCreate` | `invoiceId`, `method` (`any`, `BANCONTACT`, `IDEAL`, `CREDITCARD` sau `PAYCONIQ`) | | `mandateRequest` | `customerId`, `mode` (`request` sau `reminder`) | | `mandateCollect` | `invoiceId`, `delayDays` (text, implicit `"0"`, cel mult 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` sau `task`), `taskId` (la `task`) | | `inboxReply` | `threadId`, `body`, `keepAssistant` | | `inboxTag` | `threadId`, `tagIds`, `archive` | | `customerUpdate` | `customerId`, `status` (`keep`, `DEFAULT`, `PREFERRED`, `VIP`, `WARNING` sau `BLACKLISTED`), `notes` | | `reservationSetStatus` | `reservationId`, `action` (`checkIn`, `checkOut` sau `cancel`) | | `accessMethodCreate` | `customerId`, `type` (`QR_CODE`, `LPR`, `PIN_CODE` sau `NFC`), `value`, `periodFrom`, `periodTo` (variabile cu o dată, gol înseamnă fără limită) | | `accessMethodUpdate` | `scope` (`one` sau `customer`), `accessMethodId` (la `one`), `customerId` (la `customer`), `status` (`keep`, `ACTIVE`, `SOFT_BLOCKED`, `BLOCKED` sau `INACTIVE`), `periodTo` | | `accessMethodSendQr` | `accessMethodId`, `sendEmail`, `sendSms`, `sendWhatsApp`, `print` (`none`, `label` sau `thermal`) | | `accessPointControl` | `accessPointId`, `action` (`open` sau `close`) | | `meterSwitch` | `target` (`terrain` sau `meter`), `terrainId` (la `terrain`), `meterId` (la `meter`), `state` (`on` sau `off`) | | `nfcTagUpdate` | `customerId`, `action` (`block`, `unblock`, `topUp` sau `lowBalance`), `amount` (la `topUp`, în euro per tag) | | `deviceCommand` | `deviceId`, `command` (`wake`, `sleep`, `reload`, `identify`, `testSound` sau `playSound`), `url` (la `playSound`: calea unui sunet încărcat, așa cum o completează editorul, sau un link https către un fișier mp3, wav sau m4a) | | `deviceDisplay` | `kind` (`pdf` sau `image`), `url` (link https). Apare pe fiecare tabletă setată ca display, cum ar fi un PDF de factură | | `controllerRelay` | `target` (`controller` sau `event`: controllerul evenimentului `controller:input:changed` care a pornit fluxul), `controllerId` (la `controller`), `relay` (text `"1"` până la `"6"`), `action` (`pulse`, `on` sau `off`), `durationSeconds` (la `pulse`, text, de la 0.001 la 3600 cu zecimale precum `"0.5"`; releul se deschide singur la loc) | | `controllerCommand` | `target` și `controllerId` ca la `controllerRelay`, `command` (`reboot`, `rebootExtension`, `otaUpdate`, `forceOtaUpdate`, `extensionOtaUpdate` sau `refreshSettings`) | | `deviceSlideshow` | `scope` (`displays` sau `device`), `mode` (`screensaver` sau `background`), `source` (`feed` sau `urls`). La `feed`: `itemsPath`, `imageField`, opțional câmpuri de filtrare și sortare | | `openingHours`, `waitUntilOpen`, `waitUntilClosed` | Fără câmpuri | | `throttle` | `window` (`{ "amount", "unit" }` cu `unit` fiind `minutes`, `hours`, `days` sau `weeks`), `key` (gol înseamnă per înregistrare care a pornit fluxul) | | `recordLookup` | `model` (`Customer`, `Reservation`, `Occupation`, `Invoice`, `Payment`, `Terrain`, `Task`, `Document`, `AccessMethod`, `NfcTag`, `Meter`, `InboxThread` sau `InboxMessage`), `recordId`. Rezultatul se află sub `found` plus modelul, cum ar fi `foundCustomer` | | `forEach` | `source` (`customerAccessMethods`, `customerNfcTags`, `customerOpenInvoices`, `customerUpcomingReservations`, `customerOccupations`, `customerDocuments` (doar `ACTIVE`) sau `terrainMeters`), `parentId` (id-ul clientului sau al terenului). Cel mult 100 de elemente, elementul se află sub `item` | | `waitUntil` | `conditions`, `interval` și `timeout` (`{ "amount", "unit" }` cu `unit` fiind `minutes`, `hours`, `days` sau `weeks`; intervalul este de cel puțin 5 minute) | | `waitForEvent` | `eventKey`, `sameRecord` (boolean), `timeout` (`{ "amount", "unit" }`) | | `approval` | `title`, `description`, `assigneeIds`, `timeout` (`{ "amount", "unit" }`). Sarcina se află sub `approvalTask.id` | | Fiecare acțiune, cu excepția `webhookSend` și `httpRequest` | `continueOnError` (boolean) | | `webhookSend` | `webhookId`, `event`, `payload` (JSON ca text) | | `httpRequest` | `target` (`tillor` sau `custom`), `method`, `path` (la `tillor`), `url` (la `custom`), `headers` (listă de `{ "id", "key", "value" }`), `body` (JSON ca text) | `conditions` are forma `{ "match": "all" sau "any", "rules": [...] }`. Fiecare regulă este `{ "id", "field", "operator", "value", "values" }`. `operator` este `is`, `isNot`, `contains`, `greaterThan`, `lessThan`, `isOneOf`, `isEmpty` sau `isNotEmpty`. `values` îl folosiți doar la `isOneOf`. O listă goală de reguli lasă totul să treacă. ## Pornirea unei automatizări cu un webhook [#een-automatisering-starten-met-een-webhook] O automatizare cu trigger `webhook` pornește la un `POST` către propria adresă: ```bash curl -X POST "https://tillor.eu/api/orgs/org_abc123/automation-hooks/aut_xxx/?bron=website" \ -H "Content-Type: application/json" \ -d '{"email":"jan@voorbeeld.nl","aankomst":"2026-07-14"}' ``` - Adresa completă se află în editor la trigger, sau prin `GET /automations/{id}/webhook-url` (cu `automations:read`). Tokenul este secretul; un antet pentru autentificare nu este necesar - Corpul JSON devine variabila `body`, șirul de interogare `query`, iar momentul `receivedAt` - Răspuns `200` cu `{ "accepted": true }` de îndată ce execuția a pornit. O adresă greșită, înlocuită sau dezactivată dă `404`, un corp de peste 100 KB dă `400` - Multe apeluri la scurt timp unul după altul nu sunt refuzate: fiecare apel valid pornește o execuție. Folosiți **Ignoră repetările** la trigger dacă același apel poate sosi de două ori, vezi [Ignoră repetările](/automatiseringen/triggers#herhalingen-negeren) O automatizare nu își poate apela propriul webhook printr-o **Cerere API** către API-ul Tillor. ## Alegerea unei decizii prin API [#een-beslissing-kiezen-via-de-api] Sarcina unui pas **Cere o decizie** are câte o acțiune pentru fiecare opțiune pe care ați setat-o în pas. Preluați sarcina pentru a vedea `actions` cu `id`-ul lor și alegeți una cu `POST /tasks/{id}/actions/{actionId}/choose`. Dacă opțiunea cere o notă, trimiteți-o ca `{ "note": "..." }`. Alegerea este definitivă: finalizează sarcina și continuă automatizarea pe ieșirea acelei opțiuni. Colegii desemnați (și printr-un grup) și administratorii pot alege. Vezi [OpenAPI](https://tillor.eu/api/openapi.json) pentru detalii. ## Citiți mai departe [#meer-lezen] - [Webhook-uri](/ontwikkelaars/webhooks) pentru semnătură, reîncercări și lista de evenimente - [API HTTP](/ontwikkelaars/http) pentru autentificare și contextul organizației - [Variabile și șabloane](/automatiseringen/variabelen) pentru explicația destinată utilizatorilor # Event-index (/ro-RO/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 ```json { "event": "accessLogEntry:coupled", "data": { "nfcQrEntryId": "cm4k7x2pq0001abcd1234efgh", "lprEntryId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `accessLogEntry:processed` [#accesslogentry-processed] Toegangslogregel verwerkt. - **Permissie:** `access-control:read` - **Levering:** SSE + webhook ```json { "event": "accessLogEntry:processed", "data": { "organizationId": "cm4k7x2pq0001abcd1234efgh" } } ``` ## accessMethod [#accessmethod] ### `accessMethod:created` [#accessmethod-created] Toegangsmethode aangemaakt. - **Permissie:** `access-control:read` - **Levering:** SSE + webhook ```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" } } ``` ### `accessMethod:deleted` [#accessmethod-deleted] Toegangsmethode verwijderd. - **Permissie:** `access-control:read` - **Levering:** SSE + webhook ```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" } } ``` ### `accessMethod:updated` [#accessmethod-updated] Toegangsmethode gewijzigd. - **Permissie:** `access-control:read` - **Levering:** SSE + webhook ```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" } } ``` ## 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 ```json { "event": "accessMethodOperation:updated", "data": { "operationId": "cm4k7x2pq0001abcd1234efgh", "status": "Voorbeeld" } } ``` ## accessPoint [#accesspoint] ### `accessPoint:created` [#accesspoint-created] Toegangspunt aangemaakt. - **Permissie:** `access-control:read` - **Levering:** SSE + webhook ```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" } } ``` ### `accessPoint:deleted` [#accesspoint-deleted] Toegangspunt verwijderd. - **Permissie:** `access-control:read` - **Levering:** SSE + webhook ```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" } } ``` ### `accessPoint:openTooLong` [#accesspoint-opentoolong] Toegangspunt te lang open. - **Permissie:** `access-control:access-point-open:alert` - **Levering:** SSE + webhook ```json { "event": "accessPoint:openTooLong", "data": { "accessPointId": "cm4k7x2pq0001abcd1234efgh", "accessPointName": "Voorbeeld", "openSince": "2026-01-15T09:30:00.000Z", "afterMinutes": 12.5 } } ``` ### `accessPoint:physicalStateChanged` [#accesspoint-physicalstatechanged] - **Permissie:** `access-control:read` - **Levering:** SSE, geen webhook ```json { "event": "accessPoint:physicalStateChanged", "data": { "accessPointId": "cm4k7x2pq0001abcd1234efgh", "state": "OPEN", "previousState": "OPEN", "changedAt": "2026-01-15T09:30:00.000Z" } } ``` ### `accessPoint:updated` [#accesspoint-updated] Toegangspunt gewijzigd. - **Permissie:** `access-control:read` - **Levering:** SSE + webhook ```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" } } ``` ## bankAccountTransaction [#bankaccounttransaction] ### `bankAccountTransaction:imported` [#bankaccounttransaction-imported] Banktransactie geïmporteerd. - **Permissie:** `bank-transactions:read` of `bank-transactions:sync` - **Levering:** SSE + webhook ```json { "event": "bankAccountTransaction:imported", "data": { "transactionsProcessed": 12.5, "accountsProcessed": 12.5 } } ``` ## call [#call] ### `call:created` [#call-created] Telefoongesprek gestart. - **Permissie:** `calls:read` - **Levering:** SSE + webhook ```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" } } ``` ### `call:updated` [#call-updated] Telefoongesprek gewijzigd. - **Permissie:** `calls:read` - **Levering:** SSE + webhook ```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" } } ``` ## comment [#comment] ### `comment:created` [#comment-created] Opmerking toegevoegd. - **Permissie:** `comments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `comment:deleted` [#comment-deleted] Opmerking verwijderd. - **Permissie:** `comments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `comment:mentioned` [#comment-mentioned] Iemand genoemd in een opmerking. - **Permissie:** `comments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `comment:pinned` [#comment-pinned] Opmerking vastgezet. - **Permissie:** `comments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `comment:resolved` [#comment-resolved] Opmerking opgelost. - **Permissie:** `comments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `comment:unresolved` [#comment-unresolved] Opmerking heropend. - **Permissie:** `comments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `comment:updated` [#comment-updated] Opmerking bewerkt. - **Permissie:** `comments:read` - **Levering:** SSE + webhook ```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" } } ``` ## controller [#controller] ### `controller:adoption:approved` [#controller-adoption-approved] Adoptie van besturingseenheid goedgekeurd. - **Permissie:** `controllers:read` - **Levering:** SSE + webhook ```json { "event": "controller:adoption:approved", "data": { "adoptionId": "cm4k7x2pq0001abcd1234efgh", "controllerId": "cm4k7x2pq0001abcd1234efgh", "efuseId": "cm4k7x2pq0001abcd1234efgh", "organizationId": "cm4k7x2pq0001abcd1234efgh", "takeover": false } } ``` ### `controller:adoption:rejected` [#controller-adoption-rejected] Adoptie van besturingseenheid afgewezen. - **Permissie:** `controllers:read` - **Levering:** SSE + webhook ```json { "event": "controller:adoption:rejected", "data": { "adoptionId": "cm4k7x2pq0001abcd1234efgh", "efuseId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `controller:adoption:requested` [#controller-adoption-requested] Besturingseenheid vraagt om adoptie. - **Permissie:** `controllers:read` - **Levering:** SSE + webhook ```json { "event": "controller:adoption:requested", "data": { "adoptionId": "cm4k7x2pq0001abcd1234efgh", "efuseId": "cm4k7x2pq0001abcd1234efgh", "requestedFromIp": "Voorbeeld", "isNew": false } } ``` ### `controller:created` [#controller-created] Besturingseenheid aangemaakt. - **Permissie:** `controllers:read` - **Levering:** SSE + webhook ```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" } } ``` ### `controller:deleted` [#controller-deleted] Besturingseenheid verwijderd. - **Permissie:** `controllers:read` - **Levering:** SSE + webhook ```json { "event": "controller:deleted", "data": { "id": "cm4k7x2pq0001abcd1234efgh", "efuseId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `controller:input:changed` [#controller-input-changed] Ingang van controller veranderd. - **Permissie:** `controllers:read` - **Levering:** SSE + webhook ```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 } } ``` ### `controller:io:changed` [#controller-io-changed] - **Permissie:** `controllers:read` - **Levering:** SSE (`?channel=controller-io`), geen webhook ```json { "event": "controller:io:changed", "data": { "controllerId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `controller:logs:submitted` [#controller-logs-submitted] - **Permissie:** `controllers:logs` - **Levering:** SSE (`?channel=controller-logs`), geen webhook ```json { "event": "controller:logs:submitted", "data": { "controllerId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `controller:updated` [#controller-updated] Besturingseenheid gewijzigd. - **Permissie:** `controllers:read` - **Levering:** SSE + webhook ```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" } } ``` ## 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 ```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" } } ``` ### `customer:contact:deleted` [#customer-contact-deleted] Contactpersoon verwijderd bij een klant. - **Permissie:** `customers:read` - **Levering:** SSE + webhook ```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" } } ``` ### `customer:contact:updated` [#customer-contact-updated] Contactpersoon van klant gewijzigd. - **Permissie:** `customers:read` - **Levering:** SSE + webhook ```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" } } ``` ### `customer:created` [#customer-created] Klant aangemaakt. - **Permissie:** `customers:read` - **Levering:** SSE + webhook ```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 } } ``` ### `customer:deleted` [#customer-deleted] Klant verwijderd. - **Permissie:** `customers:read` - **Levering:** SSE + webhook ```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 } } ``` ### `customer:updated` [#customer-updated] Klant gewijzigd. - **Permissie:** `customers:read` - **Levering:** SSE + webhook ```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 } } ``` ## 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 ```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": {} } } ``` ### `document:deleted` [#document-deleted] Document verwijderd. - **Permissie:** `documents:read` - **Levering:** SSE + webhook ```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": {} } } ``` ### `document:updated` [#document-updated] Document gewijzigd. - **Permissie:** `documents:read` - **Levering:** SSE + webhook ```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": {} } } ``` ## event-log [#event-log] ### `event-log:created` [#event-log-created] Gebeurtenis gelogd. - **Permissie:** `audit-logs:read` - **Levering:** SSE + webhook ```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" } } ``` ## 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 ```json { "event": "identityDocumentScan:deleted", "data": { "scanId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `identityDocumentScan:linked` [#identitydocumentscan-linked] ID-scan gekoppeld aan een klant. - **Permissie:** `identity-document-scans:read` - **Levering:** SSE + webhook ```json { "event": "identityDocumentScan:linked", "data": { "scanId": "cm4k7x2pq0001abcd1234efgh", "customerId": "cm4k7x2pq0001abcd1234efgh", "contactId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `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 ```json { "event": "identityDocumentScan:unlinked", "data": { "scanId": "cm4k7x2pq0001abcd1234efgh" } } ``` ## 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 ```json { "event": "img:to-tablet", "data": { "imageUrl": "https://example.com" } } ``` ## inbox [#inbox] ### `inbox:message-created` [#inbox-message-created] Bericht ontvangen in de inbox. - **Permissie:** `inbox:read` - **Levering:** SSE + webhook ```json { "event": "inbox:message-created", "data": { "threadId": "cm4k7x2pq0001abcd1234efgh", "messageId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `inbox:participant-reaction` [#inbox-participant-reaction] Reactie op een inboxbericht. - **Permissie:** `inbox:read` - **Levering:** SSE + webhook ```json { "event": "inbox:participant-reaction", "data": { "threadId": "cm4k7x2pq0001abcd1234efgh", "emoji": "Voorbeeld" } } ``` ### `inbox:thread-updated` [#inbox-thread-updated] Inboxgesprek gewijzigd. - **Permissie:** `inbox:read` - **Levering:** SSE + webhook ```json { "event": "inbox:thread-updated", "data": { "threadId": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `inbox:typing-changed` [#inbox-typing-changed] - **Permissie:** `inbox:read` - **Levering:** SSE, geen webhook ```json { "event": "inbox:typing-changed", "data": { "threadId": "cm4k7x2pq0001abcd1234efgh", "participantTyping": false, "staffTyping": false } } ``` ### `inbox:urgent-handoff` [#inbox-urgent-handoff] Dringende overdracht door de assistent. - **Permissie:** `inbox:read` - **Levering:** SSE + webhook ```json { "event": "inbox:urgent-handoff", "data": { "threadId": "cm4k7x2pq0001abcd1234efgh" } } ``` ## integration-alarm [#integration-alarm] ### `integration-alarm:created` [#integration-alarm-created] Meteralarm afgegaan. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } } ``` ### `integration-alarm:resolved` [#integration-alarm-resolved] Meteralarm opgelost. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } } ``` ## invoice [#invoice] ### `invoice:created` [#invoice-created] Factuur aangemaakt. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```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" } } ``` ### `invoice:deleted` [#invoice-deleted] Factuur verwijderd. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```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" } } ``` ### `invoice:moved-to-customer` [#invoice-moved-to-customer] Factuur naar een andere klant verplaatst. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```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" } } ``` ### `invoice:paid` [#invoice-paid] Factuur betaald. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```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" } } } ``` ### `invoice:updated` [#invoice-updated] Factuur gewijzigd. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```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" } } ``` ## ledgerOpeningBalance [#ledgeropeningbalance] ### `ledgerOpeningBalance:created` [#ledgeropeningbalance-created] Beginsaldo toegevoegd. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```json { "event": "ledgerOpeningBalance:created", "data": { "id": "cm4k7x2pq0001abcd1234efgh", "customerId": "cm4k7x2pq0001abcd1234efgh", "ledger": 12.5 } } ``` ### `ledgerOpeningBalance:deleted` [#ledgeropeningbalance-deleted] Beginsaldo verwijderd. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```json { "event": "ledgerOpeningBalance:deleted", "data": { "id": "cm4k7x2pq0001abcd1234efgh", "customerId": "cm4k7x2pq0001abcd1234efgh", "ledger": 12.5 } } ``` ### `ledgerOpeningBalance:updated` [#ledgeropeningbalance-updated] Beginsaldo gewijzigd. - **Permissie:** `invoices:read` - **Levering:** SSE + webhook ```json { "event": "ledgerOpeningBalance:updated", "data": { "id": "cm4k7x2pq0001abcd1234efgh", "customerId": "cm4k7x2pq0001abcd1234efgh", "ledger": 12.5 } } ``` ## mandate-agreement [#mandate-agreement] ### `mandate-agreement:activated` [#mandate-agreement-activated] Mandaat actief. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `mandate-agreement:expired` [#mandate-agreement-expired] Mandaataanvraag verlopen. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `mandate-agreement:failed` [#mandate-agreement-failed] Mandaat geweigerd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `mandate-agreement:signed` [#mandate-agreement-signed] Mandaat ondertekend. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `mandate-agreement:updated` [#mandate-agreement-updated] Mandaataanvraag gewijzigd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ## mandate [#mandate] ### `mandate:created` [#mandate-created] Mandaat aangemaakt. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `mandate:deleted` [#mandate-deleted] Mandaat verwijderd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `mandate:updated` [#mandate-updated] Mandaat gewijzigd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ## 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 ```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" } } } ``` ### `meterAnomaly:resolved` [#meteranomaly-resolved] Meterafwijking opgelost. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } } ``` ## meterConsumptionBatch [#meterconsumptionbatch] ### `meterConsumptionBatch:created` [#meterconsumptionbatch-created] Verbruiksperiode gestart. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } ``` ### `meterConsumptionBatch:updated` [#meterconsumptionbatch-updated] Verbruiksperiode gewijzigd. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } ``` ## meterReading [#meterreading] ### `meterReading:created` [#meterreading-created] Meterstand ingevoerd. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } ``` ### `meterReading:deleted` [#meterreading-deleted] Meterstand verwijderd. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } ``` ### `meterReading:synced` [#meterreading-synced] Meterstand gesynchroniseerd. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } ``` ### `meterReading:updated` [#meterreading-updated] Meterstand gewijzigd. - **Permissie:** `meters:read` - **Levering:** SSE + webhook ```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" } } ``` ## nativeDevice [#nativedevice] ### `nativeDevice:command` [#nativedevice-command] - **Permissie:** `native-devices:read` - **Levering:** SSE, geen webhook ```json { "event": "nativeDevice:command", "data": { "installationId": "cm4k7x2pq0001abcd1234efgh", "url": "https://example.com" } } ``` ### `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 ```json { "event": "nativeDevice:deleted", "data": { "id": "cm4k7x2pq0001abcd1234efgh" } } ``` ## 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 ```json { "event": "nfc-tag-transaction:changed", "data": { "transactionId": "cm4k7x2pq0001abcd1234efgh", "nfcTagId": "cm4k7x2pq0001abcd1234efgh", "status": "PENDING" } } ``` ## nfc-tag [#nfc-tag] ### `nfc-tag:blocked` [#nfc-tag-blocked] NFC-tag geblokkeerd. - **Permissie:** `nfc-tags:read` - **Levering:** SSE + webhook ```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" } } ``` ### `nfc-tag:presented` [#nfc-tag-presented] NFC-tag aangeboden. - **Permissie:** `nfc-tags:read` - **Levering:** SSE + webhook ```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" } } ``` ### `nfc-tag:unblocked` [#nfc-tag-unblocked] NFC-tag gedeblokkeerd. - **Permissie:** `nfc-tags:read` - **Levering:** SSE + webhook ```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" } } ``` ### `nfc-tag:updated` [#nfc-tag-updated] NFC-tag gewijzigd. - **Permissie:** `nfc-tags:read` - **Levering:** SSE + webhook ```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" } } ``` ## notification-delivery [#notification-delivery] ### `notification-delivery:deleted` [#notification-delivery-deleted] Melding verwijderd. - **Permissie:** `notifications:deliveries:read` - **Levering:** SSE + webhook ```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" } } ``` ### `notification-delivery:updated` [#notification-delivery-updated] Status van melding gewijzigd. - **Permissie:** `notifications:deliveries:read` - **Levering:** SSE + webhook ```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" } } ``` ## notificationInbox [#notificationinbox] ### `notificationInbox:created` [#notificationinbox-created] - **Permissie:** elk lid - **Levering:** SSE, geen webhook ```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" } } ``` ### `notificationInbox:read` [#notificationinbox-read] - **Permissie:** elk lid - **Levering:** SSE, geen webhook ```json { "event": "notificationInbox:read", "data": { "readAt": "2026-01-15T09:30:00.000Z" } } ``` ## occupation [#occupation] ### `occupation:ended` [#occupation-ended] Bezetting beëindigd. - **Permissie:** `terrains:read` - **Levering:** SSE + webhook ```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" } } ``` ## organizationSettings [#organizationsettings] ### `organizationSettings:updated` [#organizationsettings-updated] Instellingen gewijzigd. - **Permissie:** `organization:settings:read` of `organization:settings:write` - **Levering:** SSE + webhook ```json { "event": "organizationSettings:updated", "data": { "openingHoursChanged": false } } ``` ## 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 ```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" } } ``` ### `payment-group:created` [#payment-group-created] Betalingsgroep aangemaakt. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `payment-group:deleted` [#payment-group-deleted] Betalingsgroep verwijderd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```json { "event": "payment-group:deleted", "data": { "id": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `payment-group:payments-added` [#payment-group-payments-added] Betalingen toegevoegd aan een groep. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } } ``` ### `payment-group:payments-removed` [#payment-group-payments-removed] Betalingen verwijderd uit een groep. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } } ``` ### `payment-group:unassigned-from-invoice` [#payment-group-unassigned-from-invoice] Betalingsgroep ontkoppeld van een factuur. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `payment-group:updated` [#payment-group-updated] Betalingsgroep gewijzigd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ## payment-report [#payment-report] ### `payment-report:created` [#payment-report-created] Betalingsrapport aangemaakt. - **Permissie:** `payment-reports:read` - **Levering:** SSE + webhook ```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" } } ``` ### `payment-report:updated` [#payment-report-updated] Betalingsrapport gewijzigd. - **Permissie:** `payment-reports:read` - **Levering:** SSE + webhook ```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" } } ``` ## payment [#payment] ### `payment:created` [#payment-created] Betaling aangemaakt. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `payment:deleted` [#payment-deleted] Betaling verwijderd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ### `payment:updated` [#payment-updated] Betaling gewijzigd. - **Permissie:** `payments:read` - **Levering:** SSE + webhook ```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" } } ``` ## 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 ```json { "event": "pdf:to-tablet", "data": { "pdfUrl": "https://example.com" } } ``` ## print-queue-job [#print-queue-job] ### `print-queue-job:updated` [#print-queue-job-updated] Printopdracht gewijzigd. - **Permissie:** `printing:read` - **Levering:** SSE + webhook ```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" } } ``` ## 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 ```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" } } ``` ### `productPriceChange:created` [#productpricechange-created] Productprijs gepland. - **Permissie:** `products:read` - **Levering:** SSE + webhook ```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" } } ``` ### `productPriceChange:deleted` [#productpricechange-deleted] Geplande productprijs verwijderd. - **Permissie:** `products:read` - **Levering:** SSE + webhook ```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" } } ``` ## reservation [#reservation] ### `reservation:created` [#reservation-created] Reservering aangemaakt. - **Permissie:** `reservations:read` - **Levering:** SSE + webhook ```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 } } ``` ### `reservation:updated` [#reservation-updated] Reservering gewijzigd. - **Permissie:** `reservations:read` - **Levering:** SSE + webhook ```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 } } ``` ## 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 ```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" } } ``` ### `signatureRequest:deleted` [#signaturerequest-deleted] Ondertekenverzoek verwijderd. - **Permissie:** `signature-requests:read` - **Levering:** SSE + webhook ```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" } } ``` ### `signatureRequest:updated` [#signaturerequest-updated] Ondertekenverzoek gewijzigd. - **Permissie:** `signature-requests:read` - **Levering:** SSE + webhook ```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" } } ``` ## task-time-tracker [#task-time-tracker] ### `task-time-tracker:changed` [#task-time-tracker-changed] - **Permissie:** `tasks:read` - **Levering:** SSE, geen webhook ```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" } } ``` ## task-view [#task-view] ### `task-view:created` [#task-view-created] Takenweergave aangemaakt. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task-view:deleted` [#task-view-deleted] Takenweergave verwijderd. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task-view:membership-changed` [#task-view-membership-changed] Taken in een weergave gewijzigd. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```json { "event": "task-view:membership-changed", "data": { "id": "cm4k7x2pq0001abcd1234efgh" } } ``` ### `task-view:updated` [#task-view-updated] Takenweergave gewijzigd. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ## task [#task] ### `task:action-chosen` [#task-action-chosen] Taakactie gekozen. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task:assigned` [#task-assigned] Taak toegewezen. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task:created` [#task-created] Taak aangemaakt. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task:deleted` [#task-deleted] Taak verwijderd. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task:status-changed` [#task-status-changed] Taakstatus gewijzigd. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task:unassigned` [#task-unassigned] Taaktoewijzing opgeheven. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ### `task:updated` [#task-updated] Taak gewijzigd. - **Permissie:** `tasks:read` - **Levering:** SSE + webhook ```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" } } ``` ## terrain [#terrain] ### `terrain:updated` [#terrain-updated] Terrein gewijzigd. - **Permissie:** `terrains:read` - **Levering:** SSE + webhook ```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" } } ``` ## vehiclePresence [#vehiclepresence] ### `vehiclePresence:updated` [#vehiclepresence-updated] - **Permissie:** `access-control:read` - **Levering:** SSE, geen webhook ```json { "event": "vehiclePresence:updated", "data": { "id": "cm4k7x2pq0001abcd1234efgh", "plate": "Voorbeeld", "status": "INSIDE", "lastSeenAt": "2026-01-15T09:30:00.000Z" } } ``` # Notificări externe (/ro-RO/ontwikkelaars/externe-notificaties) Trimite sistemul dumneavoastră e-mailuri către clienți (newsletter, confirmare de rezervare, memento)? Înregistrați-le atunci în Tillor. Angajații le văd la client, pe factură și în prezentarea **Notificări**, alături de notificările pe care Tillor le trimite singur. Tillor **nu trimite nimic**: înregistrați un mesaj care a fost deja expediat. Notificările externe poartă în aplicație întotdeauna eticheta **Extern** cu numele sursei dumneavoastră, astfel încât să nu fie niciodată luate drept notificări Tillor. ## Acces [#toegang] Utilizatorul din spatele [cheii API](/ontwikkelaars/http) are nevoie în organizație de una dintre aceste permisiuni. Un administrator le acordă la permisiunile utilizatorilor organizației, în grupul **Notificări** (**Înregistrare notificări externe** și **Gestionare notificări externe ale altora**). | Permisiune | Ce puteți face | |-----------|------------| | `notifications:external:write` | Să înregistrați notificări și să actualizați sau să ștergeți înregistrările **proprii** | | `notifications:external:manage-others` | Să actualizați sau să ștergeți și înregistrările altor utilizatori sau integrări | Proprietatea este legată de utilizatorul cheii API. Folosiți pentru fiecare integrare un utilizator (de serviciu) propriu, astfel încât o integrare să nu poată modifica niciodată notificările alteia. ## Endpoint-uri [#endpoints] Toate căile se află sub `/api/orgs/:orgId`. Scheme exacte: [OpenAPI](https://tillor.eu/api/openapi.json), eticheta `notifications`. | Metodă | Cale | Descriere | |--------|-----|--------------| | POST | `/notifications/external` | Înregistrarea unei notificări | | PATCH | `/notifications/external/{id}` | Actualizarea statusului, a momentelor sau a conținutului | | DELETE | `/notifications/external/{id}` | Ștergere definitivă | | GET | `/notifications?source=EXTERNAL` | Listarea notificărilor înregistrate (filtrați și după `externalSource`, `externalReference`, `customerId`, `invoiceId`) | | GET | `/notifications/{id}` | Preluarea unei notificări | Notificările pe care Tillor le-a trimis singur nu le puteți modifica sau șterge prin aceste endpoint-uri; ele dau `404`. ## Înregistrare [#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 ", "subject": "Je boeking is bevestigd", "htmlBody": "

Dag Jan, ...

", "attachments": [{ "filename": "bevestiging.pdf", "contentType": "application/pdf", "size": 48211 }] } }' ``` Toate câmpurile și limitele se află în [OpenAPI](https://tillor.eu/api/openapi.json). Aceste câmpuri au reguli pe care trebuie să le cunoașteți dinainte: | Câmp | Regulă | |------|-------| | `externalSource` | Numele sistemului dumneavoastră, cu litere mici, cifre, `.`, `_` sau `-` (de ex. `mailchimp`). Angajații văd acest nume la notificare | | `externalReference` | ID-ul dumneavoastră propriu pentru acest mesaj, unic în cadrul `externalSource` | | `name` | Etichetă scurtă pentru angajați (de ex. „Boekingsbevestiging”). Se poate căuta după el | | `customerId` / `invoiceId` | Cel puțin unul dintre ele. Determină unde apare notificarea. Dacă trimiteți doar `invoiceId`, Tillor leagă și clientul acelei facturi. Un ID necunoscut sau o factură a altui client dă `400` | | `status` | `SENT`, `FAILED`, `BOUNCED` sau `COMPLAINED`. Fără `sentAt` la `SENT`, Tillor folosește momentul înregistrării | | `sentAt`, `readAt`, `clickedAt` | ISO 8601 cu fus orar, de ex. `2026-09-19T08:15:00Z`. Alte valori sunt refuzate | | `email.attachments` | Doar metadate (`filename`, `contentType`, `size`). Fișierele în sine nu sunt stocate | ### Reîncercare în siguranță [#veilig-opnieuw-proberen] `POST` este idempotent pe `externalSource` + `externalReference`. Dacă trimiteți din nou aceeași combinație (de exemplu după un timp limită), primiți notificarea **existentă** și nu se modifică nimic. Dacă doriți să ajustați ceva, folosiți `PATCH`. `externalSource`, `externalReference` și `name` sunt stocate necriptat, deoarece se caută după ele. Folosiți un ID tehnic, nu o adresă de e-mail sau un nume. Un `externalReference` cu `@` este refuzat. Destinatarul, subiectul, conținutul și atașamentele sunt, în schimb, stocate criptat. ## Actualizare și ștergere [#bijwerken-en-verwijderen] La `PATCH` trimiteți doar câmpurile care se modifică, de exemplu când un e-mail este returnat ulterior: ```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` șterge definitiv notificarea, inclusiv conținutul. Folosiți-l și pentru a răspunde unei cereri de ștergere (GDPR). Un `PATCH` care nu schimbă nimic nu face nimic: nicio modificare, niciun eveniment. Dacă modificați conținutul (eticheta, destinatarul, expeditorul, subiectul, textul, HTML-ul sau atașamentele) sau ștergeți o notificare, aceasta apare în jurnalul de activitate al clientului sau al facturii, cu utilizatorul care a făcut-o. Actualizările de status, `readAt` sau `clickedAt` nu apar acolo, astfel încât să puteți continua să sincronizați deschiderile și clicurile. ## HTML și confidențialitate [#html-en-privacy] Tillor afișează HTML-ul angajaților așa cum l-a primit clientul, dar îl tratează ca pe un conținut de încredere redusă: - La salvare, scripturile, formularele, iframe-urile, embed-urile și atributele de eveniment (`onclick`, ...) sunt eliminate. Linkurile se deschid într-o filă nouă - Previzualizarea rulează într-un cadru izolat, fără scripturi și fără acces la sesiunea Tillor - Imaginile și fonturile externe **nu se încarcă automat**, astfel încât deschiderea unei notificări să nu activeze un pixel de urmărire. Angajatul poate încărca imaginile pentru fiecare notificare în parte Nu vă bazați deci pe faptul că urmărirea „deschis” din sistemul dumneavoastră se declanșează când un angajat vizualizează notificarea. ## Ce nu face Tillor cu notificările externe [#wat-tillor-niet-doet-met-externe-notificaties] - Nu le trimite (din nou) și nu le reîncearcă automat - Nu preia actualizări de status de la furnizorul dumneavoastră de e-mail: dumneavoastră păstrați statusul la zi cu `PATCH` - Nu le numără în listele **Notificări eșuate**, **Notificări returnate** și **Notificări în așteptare**, nici în contoarele din partea de sus a prezentării notificărilor, deoarece Tillor nu poate verifica statusul dumneavoastră. Ele apar totuși sub **Comunicări recente** ## Webhook-uri și SSE [#webhooks-en-sse] | Eveniment | Când | |-------|--------| | `notification-delivery:updated` | La înregistrare și la fiecare `PATCH` care modifică ceva. Conține notificarea completă | | `notification-delivery:deleted` | La `DELETE`. Conține doar `id`, `source`, `externalSource`, `externalReference`, `customerId` și `invoiceId` | Câmpul `source` este `EXTERNAL` pentru înregistrările dumneavoastră și `INTERNAL` pentru notificările Tillor. Filtrați după el dacă doriți să săriți peste propriile evenimente. Vezi [Webhook-uri](/ontwikkelaars/webhooks) și [SSE](/ontwikkelaars/sse). ## Înrudite [#gerelateerd] - [API HTTP](/ontwikkelaars/http) - Chei API, anteturi și limite de rată - [Webhook-uri](/ontwikkelaars/webhooks) - Primirea evenimentelor prin HTTP POST - [OpenAPI](https://tillor.eu/api/openapi.json) - Scheme complete # API HTTP (/ro-RO/ontwikkelaars/http) API-ul Tillor este un API REST. Autentificați-vă cu o cheie API și trimiteți anteturile corecte la fiecare cerere. Cheile API sunt **pe cont** - o cheie funcționează pentru toate organizațiile la care aveți acces. ## Referința API și OpenAPI [#api-referentie-en-openapi] - **[Referința API](/api-referentie)** - Fiecare endpoint cu parametri și exemple; încercați cererile direct în browser - **[Specificația OpenAPI](https://tillor.eu/api/openapi.json)** - Documentația completă a API-ului în format JSON, pentru generare de cod sau import în Postman/Insomnia --- ## Chei API [#api-sleutels] ### Creare [#aanmaken] Cheile API le creați în aplicația Tillor prin meniul utilizatorului, sub **Cont > Chei API** (marcajul **1** = meniul, marcajul **2** = Chei API în captura de ecran). Le puteți crea și prin API cu o sesiune autentificată (fără cheie API). Vezi [specificația OpenAPI](https://tillor.eu/api/openapi.json) sub eticheta `api-keys` pentru căi și scheme de cerere și de răspuns. Cheia brută este returnată **o singură dată** la creare sau regenerare. Păstrați-o în siguranță; după aceea nu o mai puteți prelua. ### Limitarea permisiunilor [#rechten-beperken] Implicit, o cheie poate tot ce puteți și dumneavoastră, în fiecare organizație din care faceți parte. În fereastra cheii activați **Limitează la permisiunile selectate** și alegeți permisiunile de care are nevoie integrarea, de exemplu doar citirea facturilor. O cheie limitată primește în fiecare organizație intersecția dintre permisiunile ei și calitatea dumneavoastră de membru acolo: o cheie nu poate niciodată mai mult decât dumneavoastră. Un apel în afara permisiunilor alese primește `403 Forbidden`, ca un utilizator fără acea permisiune. O modificare a permisiunilor se aplică în mai puțin de un minut. Prin API: `scopes` (listă de id-uri de permisiuni precum `invoices:read`, sau `null` pentru tot) la crearea și actualizarea unei chei. ### Utilizare [#gebruik] Trimiteți cheia API în antetul `x-api-key`: ```http x-api-key: tkn_xxx ``` Cheile folosesc prefixul `tkn_`. La endpoint-urile organizației, ID-ul organizației se află în cale (`/orgs/org_abc123/...`); un antet separat nu este necesar. ### Limite de rată [#rate-limits] - **Implicit:** 5000 de cereri la 60 de secunde per cheie - La depășire: `429 Too Many Requests` cu `Retry-After` - Fiecare răspuns la o cheie API conține anteturi IETF `RateLimit-*`: ```http RateLimit-Limit: 5000 RateLimit-Remaining: 4999 RateLimit-Reset: 58 RateLimit-Policy: 5000;w=60 ``` `RateLimit-Reset` este numărul de secunde până când fereastra curentă începe din nou. Clienții din browser pot citi aceste anteturi prin CORS (`Access-Control-Expose-Headers`). ### Securitate [#beveiliging] - **Niciodată** nu expuneți cheile API în cod de pe partea clientului sau în depozite publice - Regenerați periodic cheile prin **Regenerați** în aplicație (OpenAPI: `POST /api/api-keys/:id/renew`) - Ștergeți cheile nefolosite cu `DELETE /api/api-keys/:id` --- ## URL de bază și contextul organizației [#base-url-en-organisatie-context] **URL de bază:** `https://tillor.eu` (sau URL-ul instalării dumneavoastră; OpenAPI menționează `{APP_URL}/api`) **Căi pentru organizație:** adăugați ID-ul organizației în cale: ``` /api/orgs/:orgId/... ``` **Exemplu:** ``` GET https://tillor.eu/api/orgs/org_abc123/customers ``` **Antet necesar pentru endpoint-urile organizației:** `x-api-key: tkn_xxx`. ID-ul organizației se află în cale. --- ## Exemplu: 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" ``` --- ## Integrări (marketplace) [#integraties-marketplace] Integrările organizației (înainte „aplicații” în API) folosesc o singură resursă per tip sub `/api/orgs/:orgId/integrations/{integrationType}`. Permisiunile necesare sunt `organization:integrations:read` și `organization:integrations:write` (înlocuiește `organization:apps:*`). | Metodă | Cale | Descriere | |--------|------|-------------| | GET | `/integrations/{integrationType}` | Status (`installed`, `available`) și `settings` cu date ascunse | | POST | `/integrations/{integrationType}` | Instalare (opțional `settings` în corp; OAuth poate returna `redirectUrl`) | | PUT | `/integrations/{integrationType}` | Actualizarea setărilor (`settings` în corp) | | DELETE | `/integrations/{integrationType}` | Dezinstalare | La `GET` și după `PUT`, `settings` conține doar câmpurile **publice**, plus `{ configured: true }` pentru fiecare câmp secret. Parolele, cheile API și tokenurile OAuth nu sunt returnate. Lăsați câmpurile secrete goale la `PUT` pentru a păstra valoarea existentă. Vezi [specificația OpenAPI](https://tillor.eu/api/openapi.json) (eticheta `integrations`) pentru scheme exacte. --- ## Înrudite [#gerelateerd] - [Referința API](/api-referentie) - Fiecare endpoint, de încercat în browser - [OpenAPI](https://tillor.eu/api/openapi.json) - Specificația API (JSON) - [MCP](/ontwikkelaars/mcp) - Conectați Cursor, Claude, ChatGPT sau Gemini prin OAuth - [Notificări externe](/ontwikkelaars/externe-notificaties) - Înregistrați e-mailurile trimise de sistemul dumneavoastră - [Webhook-uri](/ontwikkelaars/webhooks) - Primiți evenimente prin HTTP POST - [Webhook de intrare al unei automatizări](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - Porniți o automatizare cu un POST, fără cheie API - [SSE](/ontwikkelaars/sse) - Transmiteți evenimente prin Server-Sent Events - [Exemple](/ontwikkelaars/voorbeelden) - Exemple de cod și de payload # Prezentare generală (/ro-RO/ontwikkelaars) API-ul Tillor oferă acces programatic la datele organizației dumneavoastră. Folosiți chei API pentru autentificare, webhook-uri pentru evenimente de ieșire, SSE sau MQTT pentru streaming în timp real, sau MCP pentru a conecta la Tillor instrumente AI precum Cursor, Claude, ChatGPT și Gemini. ## Ce puteți construi? [#wat-kun-je-bouwen] - **Integrări** - Conectați Tillor la propriile sisteme prin API-ul REST - **Webhook-uri** - Primiți mesaje HTTP POST când au loc evenimente (factură plătită, client creat etc.) - **Pornirea automatizărilor** - Porniți o automatizare din propriul sistem cu un POST către [webhook-ul ei de intrare](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - **Dashboard-uri în timp real** - Transmiteți evenimente prin SSE sau MQTT pentru actualizări live în aplicația dumneavoastră - **Instrumente AI** - Lăsați Cursor, Claude, ChatGPT sau Gemini să apeleze API-ul prin [MCP](/ontwikkelaars/mcp) (`https://mcp.tillor.dev`) ## Start rapid [#snel-aan-de-slag] 1. **Creați o cheie API** în Tillor sub *Cont > Chei API* 2. **Trimiteți cheia** în antetul `x-api-key` la fiecare cerere 3. **Puneți ID-ul organizației în cale** la endpoint-urile organizației: `/orgs/org_abc123/...` Webhook-urile și SSE livrează exact aceleași evenimente. Diferența: webhook-urile trimit HTTP POST către URL-ul dumneavoastră; SSE este o conexiune lungă pe care primiți evenimente. **Linkuri utile:** [Referința API](/api-referentie) - [OpenAPI](https://tillor.eu/api/openapi.json) **Domeniu:** cheile API sunt pe cont (toate organizațiile); webhook-urile sunt pe organizație. Puteți folosi acest site și ca text pentru instrumente AI: [`/llms.txt`](/llms.txt) (index), [`/llms-full.txt`](/llms-full.txt) (toate paginile la un loc) și, pentru fiecare pagină, adăugând `.mdx` după cale (de exemplu [`/ontwikkelaars/http.mdx`](/ontwikkelaars/http.mdx)). **Întreabă AI (local)** din aspectul documentației încarcă acel export complet (`/llms-full.txt`) în AI-ul încorporat în Chrome, astfel încât să nu fie nevoie să vă aflați pe o anumită pagină. ## Vezi și [#zie-ook] # MCP (/ro-RO/ontwikkelaars/mcp) Prin MCP (Model Context Protocol), instrumente precum Cursor, Claude, ChatGPT și Gemini pot apela API-ul Tillor în numele dumneavoastră. Vă autentificați o singură dată prin OAuth; în configurație nu trebuie să apară nicio cheie API. **URL:** `https://mcp.tillor.dev` ## Ce puteți face cu el [#wat-je-ermee-kunt] După conectare, în instrumentul AI puteți: 1. să vizualizați categoriile API și endpointurile (din specificația OpenAPI) 2. să apelați endpointuri cu drepturile dumneavoastră în organizația aleasă Totul trece prin același API REST ca [API-ul HTTP](/ontwikkelaars/http). Ce aveți voie să faceți depinde de contul dumneavoastră Tillor și de permisiunile din organizația respectivă. Conectarea prin OAuth cere permisiunea **Autorizare aplicații OAuth** (`oauth:consent`) în cel puțin o organizație. Fără această permisiune, consimțământul eșuează, iar tokenurile OAuth existente nu mai funcționează. ## Autentificare [#authenticatie] 1. Instrumentul se conectează la `https://mcp.tillor.dev` fără token 2. Descoperirea și înregistrarea OAuth se desfășoară pe gazda MCP; autentificarea și consimțământul se fac în Tillor 3. Aprobați accesul în browser 4. Apoi instrumentul trimite un token Bearer la fiecare apel MCP Trimiteți organizația ca antet atunci când instrumentul permite acest lucru (Cursor, Gemini CLI): ```http X-Tillor-Org-Id: org_abc123 ``` Fără acest antet (ChatGPT, aplicația Gemini, Claude) transmiteți `organizationId` la `call_api_endpoint`. Rutele de organizație se află sub `/orgs/{organizationId}`; API-ul completează apoi singur antetul. Pentru serverul MCP găzduit folosiți OAuth (Connect / Authorize în instrument). Pentru scripturi și integrări proprii continuați să folosiți [chei API](/ontwikkelaars/http). ## Conectare [#koppelen] Alegeți instrumentul: Sau deschideți [selectorul de instalare](https://install.apicommons.org/?config=eyJuYW1lIjoiVGlsbG9yIiwiZGVzY3JpcHRpb24iOiJUaWxsb3IgUkVTVCBBUEkgdmlhIE9BdXRoIiwicmVtb3RlIjp7InR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudGlsbG9yLmRldi9tY3AiLCJoZWFkZXJzIjp7IlgtVGlsbG9yLU9yZy1JZCI6Ijxvcmdhbml6YXRpb25JZD4ifX19) pentru Cline, Zed, Warp, Codex și restul. ## Instrumente [#tools] | Instrument | Scop | |------|------| | `list_api_categories` | Listează categoriile API | | `list_api_endpoints` | Endpointurile dintr-o categorie, cu schema de intrare | | `get_api_endpoint_schema` | Schema unui singur endpoint, după nume | | `call_api_endpoint` | Apelează un endpoint | Numele endpointurilor nu sunt instrumente separate: folosiți `call_api_endpoint`. Referința REST completă rămâne [OpenAPI](https://tillor.eu/api/openapi.json). MCP este un strat peste aceasta, nu un API de produs separat. ## Legate de acest subiect [#gerelateerd] - [API HTTP](/ontwikkelaars/http) - chei API, antete și base URL - [OpenAPI](https://tillor.eu/api/openapi.json) - specificația completă a API-ului - [Referința API](/api-referentie) - fiecare endpoint, de încercat în browser # Metadate Mollie (/ro-RO/ontwikkelaars/mollie-metadata) Mollie stochează metadate pentru fiecare plată. Tillor citește și scrie câmpuri din spațiul de nume `tillor`. Conectarea în aplicație: [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie). Trei tipuri: 1. **Metadate de legătură** - Tillor le scrie înapoi în Mollie, astfel încât plata să fie ușor de recunoscut 2. **Indicii de ingestie** - le setați dumneavoastră la crearea plății Mollie 3. **Metadate contabile directe** - ocolesc Tillor și merg direct în contabilitate ## Metadate de legătură [#koppelingsmetadata] ```json { "tillor": { "paymentId": "clx123...", "invoiceId": "clx456...", "customerId": "clx789...", "paymentGroupId": "clxgrp..." } } ``` Tillor scrie `paymentId`, `invoiceId`, `customerId` și `paymentGroupId` în Mollie imediat ce o plată este legată de o factură, un client sau un [grup de plăți](/betalingsverwerking/groepen). Metadatele existente care nu provin de la Tillor rămân neschimbate. | Câmp | Descriere | |------|---------------| | `paymentId` | Plata Tillor | | `invoiceId` | Factura Tillor | | `customerId` | Clientul Tillor | | `paymentGroupId` | Grupul de plăți, chiar dacă grupul nu este încă legat de o factură | ## Indiciu de ingestie: `descriptionSuffix` [#ingestie-hint-descriptionsuffix] Îl setați dumneavoastră la crearea plății Mollie. Tillor îl folosește pentru descrierea plății de îndată ce există o legătură cu o factură. ```json { "tillor": { "descriptionSuffix": "Parkeerplaats P1" } } ``` Format în Tillor: `INV/XXXX/XXXX - {suffix}`. ## Indicii de ingestie pentru grupuri de plăți [#ingestie-hints-voor-betalingsgroepen] Utile pentru turele de la casă sau pentru activități: grupați mai multe plăți înainte de a înregistra o factură. ```json { "tillor": { "paymentGroupName": "Yoga sunrise - Lake Como", "paymentGroupExternalId": "act_42" } } ``` Unul dintre cele două câmpuri este suficient. Ambele împreună sunt mai bune dacă eticheta se poate schimba, dar ID-ul rămâne stabil. | Câmp | Descriere | |------|---------------| | `paymentGroupName` | Etichetă vizibilă în Tillor. Se potrivește cu grupurile deschise existente după nume sau devine eticheta unui grup nou | | `paymentGroupExternalId` | Cheie stabilă din sistemul dumneavoastră. Potrivirea se face după ea, nu după nume; eticheta urmează `paymentGroupName` | 1. Tillor caută un grup **deschis** cu acest ID extern (sau, fără ID, cu acest nume). 2. Nicio potrivire? Se creează un grup nou, deschis. Numele este `paymentGroupName`, altfel `paymentGroupExternalId`. 3. Plata intră în grup de îndată ce este **plătită** în Tillor. 4. Grupurile care sunt deja legate de o factură nu se reutilizează. Indiciile nu erau încă pe plata Mollie când Tillor a văzut-o pentru prima dată? Grupul se completează totuși de îndată ce plata este **plătită**, **nu** este legată de o factură și **nu** se află încă într-un grup. Acest lucru se întâmplă la următoarea sincronizare sau la o notificare Mollie primită. Etichetați în prealabil fiecare plată Mollie din sistemul dumneavoastră de casă. Grupul apare în *Administrare > Plăți*, secțiunea *Grupuri de plăți*. O plată grupată nu poate fi legată separat de o factură. Dacă trimiteți atât indicii de grup, cât și `invoiceId`, câștigă grupul. ## Metadate contabile directe (`tillor.bookkeeping`) [#directe-boekhoudmetadata-tillorbookkeeping] Plățile Mollie necunoscute merg implicit în contul de așteptare **499000**. Cu `tillor.bookkeeping`, Tillor le înregistrează pe clientul indicat: ```json { "tillor": { "bookkeeping": { "customerCode": "100001", "documentType": "INV", "department": "a", "fiscalYear": "2026", "documentNumber": "00042" } } } ``` | Câmp | Descriere | |------|---------------| | `customerCode` | Codul clientului în contabilitate - obligatoriu | | `documentType` | De ex. INV, UF | | `department` | Departament | | `fiscalYear` | Anul contabil | | `documentNumber` | Numărul documentului | Dacă `bookkeeping` este prezent, plata **nu** intră ca plată Tillor obișnuită. Metadatele sunt folosite la construirea raportului contabil. ## Vezi și [#zie-ook] # MQTT (/ro-RO/ontwikkelaars/mqtt) Credențialele MQTT oferă integrărilor acces pub/sub în spațiul de nume de topicuri al organizației dumneavoastră. Credențialele le creați în Tillor la **Cont > Dezvoltatori** (per organizație). Accesul la topicuri este limitat la `tillor/{env}/{orgId}/integration` și subtopicurile sale (`{env}` = `prod`, `staging` sau `local`), cu excepția cazului în care o credențială statică are `topicPrefix: null`. Pentru aceleași evenimente în timp real ca la [webhookuri](/ontwikkelaars/webhooks) și [SSE](/ontwikkelaars/sse), folosiți acele canale, nu MQTT. ## Administrare [#beheer] | Metodă | Cale | Descriere | |--------|------|---------------| | POST | `/api/orgs/:orgId/mqtt/credentials` | Generează credențiale JWT (temporare) | | GET | `/api/orgs/:orgId/mqtt/static-credentials` | Preia credențialele statice | | POST | `/api/orgs/:orgId/mqtt/static-credentials` | Creează o credențială statică | | DELETE | `/api/orgs/:orgId/mqtt/static-credentials/:id` | Șterge o credențială statică | Autentificare: `x-api-key`, cu ID-ul organizației în cale (la fel ca la [API-ul HTTP](/ontwikkelaars/http)). Consultați [specificația OpenAPI](https://tillor.eu/api/openapi.json) pentru schemele complete de cerere și răspuns. ## Credențiale [#credentials] Există două variante: ### JWT (temporar) [#jwt-tijdelijk] - **Utilizare:** sesiuni scurte, acces temporar - **Expirare:** implicit 1 oră; configurabilă de la 1 minut la 24 de ore prin `expiresInSeconds` - **Ideal pentru:** teste, conexiuni temporare sau când preluați tokenurile dinamic - **Creare:** în Tillor la **Cont > Dezvoltatori** sau prin `POST /api/orgs/:orgId/mqtt/credentials` cu, opțional, `{ "clientId": "...", "expiresInSeconds": 3600 }` - **Răspuns:** `token` (folosiți-l ca parolă MQTT), `clientId`, `brokerUrl`, `topicPrefix`, `expiresAt` - **Nume de utilizator:** lăsați gol la conectare; autentificarea JWT folosește doar tokenul ca parolă. - **ID client:** folosiți exact `clientId` din răspuns la conectare (inclusiv prefixul de mediu, de ex. `prod-`). O conexiune la broker prin **mqtts** verifică certificatul serverului. Dacă folosiți un certificat CA **privat** (nu lanțul public standard), setați PEM-ul acelui CA în mediul clientului dumneavoastră. ### Credențiale statice [#statische-credentials] - **Utilizare:** integrări de lungă durată, conexiuni mereu active - **Formă:** userName, clientId și password fixe - **Ideal pentru:** integrări de producție care rămân conectate continuu - **Creare:** în Tillor la **Cont > Dezvoltatori** sau prin `POST /api/orgs/:orgId/mqtt/static-credentials` cu, opțional, `{ "name": "mijn-integratie", "topicPrefix": null }` - **Răspuns:** `userName`, `clientId`, `password` (o singură dată), `topicPrefix` (`null` = fără prefix, ACL `#`), opțional `brokerUrl` - **Atenție:** parola este afișată o singură dată în răspuns și nu mai poate fi preluată ulterior --- ## Acces la topicuri [#topic-toegang] Abonările la topicuri sunt **strict limitate**, cu excepția cazului în care `topicPrefix` este `null` (ACL `#`). Implicit puteți publica și vă puteți abona doar la `tillor/{env}/{orgId}/integration` și `tillor/{env}/{orgId}/integration/#`. - **Topicuri permise** - doar `tillor/{env}/{orgId}/integration` și subtopicurile (de ex. `tillor/{env}/{orgId}/integration/connector/access-point-operation`) - **Fără ocolire prin wildcard** - chiar și cu `#` sau `+` primiți acces doar la spațiul de nume al organizației dumneavoastră - **Per organizație** - credențialele sunt per organizație; nu aveți acces la topicurile altor organizații --- ## Legate de acest subiect [#gerelateerd] - [OpenAPI](https://tillor.eu/api/openapi.json) - specificația completă a API-ului - [API HTTP](/ontwikkelaars/http) - API REST și chei API - [Webhookuri](/ontwikkelaars/webhooks) - aceleași evenimente prin HTTP POST - [SSE](/ontwikkelaars/sse) - evenimente în flux prin Server-Sent Events # OAuth-clients (/ro-RO/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] Klik in de sidebar op je naam en kies Account > OAuth-clients. Klik op **OAuth-client aanmaken**. 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. Kies wie zich mag aanmelden. Zie [Beperken wie zich mag aanmelden](#beperken-wie-zich-mag-aanmelden). Sla op. Tillor toont de **Client-ID** en het **Clientgeheim**. Het geheim zie je alleen nu: kopieer het en bewaar het veilig. 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. - 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. ## 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) (/ro-RO/ontwikkelaars/sse) SSE oferă un flux de lungă durată cu aceleași evenimente pe care le primesc [webhookurile](/ontwikkelaars/webhooks). Folosiți SSE când preferați o conexiune persistentă în locul apelurilor HTTP inverse. ## Endpoint [#endpoint] ``` GET /api/orgs/:orgId/realtime/subscribe ``` ## Autentificare [#authenticatie] SSE folosește aceeași autentificare ca celelalte endpointuri API: - **x-api-key** - cheia dumneavoastră API ID-ul organizației se află în calea URL-ului. ## Filtrarea evenimentelor [#event-filtering] Folosiți parametrul de interogare `events` pentru a filtra după tipul evenimentului: ``` GET /api/orgs/:orgId/realtime/subscribe?events=invoice:created&events=invoice:paid ``` Folosiți `events=*` pentru a primi toate evenimentele (la fel ca omiterea parametrului). Consultați [Indexul de evenimente](/ontwikkelaars/events) pentru toate evenimentele, permisiunea pentru fiecare eveniment și un exemplu de payload. Câteva evenimente se află pe un canal propriu (jurnalele controlerelor și I/O al controlerelor). Le primiți doar cu `?channel=controller-logs` sau `?channel=controller-io`; Indexul de evenimente menționează canalul. Tillor livrează doar evenimentele pentru care membrul autentificat al organizației are permisiune. Fără `bank-transactions:read` (sau sync) nu primiți, de exemplu, evenimente `bankAccountTransaction:*`, nici dacă nu trimiteți niciun filtru `events`. Datele asociate dintr-un alt domeniu urmează aceleași reguli ca API-ul: fără `customers:read`, un `reservation:updated` sosește cu `customer: null`, iar fără `payments:read`, un `invoice:paid` cu `payment: null`. O listă devine atunci `[]`. --- ## Formatul evenimentului [#event-formaat] Payloadul are aceeași structură ca [livrările webhook](/ontwikkelaars/webhooks#webhook-payload): | Câmp | Tip | Descriere | |-------|------|--------------| | `event` | string | Cheia evenimentului (de ex. `invoice:created`) | | `data` | object | Payload specific evenimentului | | `timestamp` | number | Timestamp Unix (ms) la care a fost emis evenimentul | | `traceId` | string | ID-ul de trace OpenTelemetry al acțiunii Tillor care a declanșat acest eveniment (la fel ca la [webhookuri](/ontwikkelaars/webhooks#webhook-payload)) | | `spanId` | string (opțional) | Span în cadrul acelui trace | În fluxul SSE, acest obiect JSON se află pe linia `data:`; cheia evenimentului se află și pe linia `event:`. Consultați [exemplele SSE](/ontwikkelaars/voorbeelden/sse) pentru un exemplu la nivel de rețea. --- ## Exemplu: 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); } } } ``` --- ## Exemplu: 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" ``` --- ## Reconectare [#herverbinding] Dacă se pierde conexiunea, reconectați-vă cu același URL și aceleași antete. Fluxul nu acceptă reluarea; după reconectare primiți doar evenimente noi. --- ## Legate de acest subiect [#gerelateerd] - [OpenAPI](https://tillor.eu/api/openapi.json) - specificația completă a API-ului - [API HTTP](/ontwikkelaars/http) - chei API și autentificare - [Webhookuri](/ontwikkelaars/webhooks) - aceleași evenimente prin HTTP POST - [Exemple](/ontwikkelaars/voorbeelden) - exemple de cod și de payload # Exemple HTTP (/ro-RO/ontwikkelaars/voorbeelden/http) Program de funcționare și sărbători legale pentru un site public: [API Program de funcționare](/ontwikkelaars/voorbeelden/opening-hours). ## Cerere API cu 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" ``` ## Crearea unei chei 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"}' ``` ## Crearea unui webhook [#webhook-aanmaken] ```bash curl -X POST "https://tillor.eu/api/orgs/org_abc123/webhooks" \ -H "x-api-key: tkn_xxx" \ -H "Content-Type: application/json" \ -d '{ "url": "https://jouw-server.com/webhooks/tillor", "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"], "enabled": true }' ``` # Prezentare generală (/ro-RO/ontwikkelaars/voorbeelden) Exemple gata de folosit, ca punct de plecare. Fiecare exemplu folosește substituenții `org_abc123` și `tkn_xxx`; înlocuiți-i cu ID-ul propriei organizații și cu cheia dumneavoastră API. # API Program de funcționare (/ro-RO/ontwikkelaars/voorbeelden/opening-hours) Folosiți API-ul de program de funcționare **rezolvat** dacă afișați pe un site public programul sezonier (de exemplu **Vară** / **Iarnă**) sau **sărbătorile legale** următoare. Tillor aplică deja excepțiile, perioadele sezoniere și programul săptămânal obișnuit și adaugă sărbătorile legale din intervalul cerut. Nu trebuie să implementați din nou acest lucru. **Permisiune:** `organization:settings:read` sau `organization:settings:write` Apelați Tillor doar de pe un server (Next.js Route Handler, Server Component sau backend). Puneți cheia în variabile de mediu. Nu o trimiteți niciodată către browser. Autentificare: consultați [API-ul HTTP](/ontwikkelaars/http). Încercați endpointul în [Referința API](/api-referentie) sau prin [OpenAPI](https://tillor.eu/api/openapi.json) (tag `organization-settings`). ## Endpoint [#endpoint] ``` GET https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours ``` Antete: ```http x-api-key: tkn_xxx ``` Înlocuiți `org_abc123` cu ID-ul organizației dumneavoastră. ### Parametri de interogare [#queryparameters] Folosiți **fie** `date`, **fie** `from`/`to`. Nu le combinați. | Parametru | Semnificație | |-----------|-----------| | *(niciunul)* | Astăzi, în fusul orar al organizației | | `date` | O singură zi calendaristică (`YYYY-MM-DD`) | | `from` | Ziua de început (inclusiv). Fără `to`: doar acea zi | | `to` | Ziua de sfârșit (inclusiv). Necesită `from`. Maximum **366** de zile | | `languageIsoCode` | Limba pentru numele sărbătorilor (`NL`, `FR`, …). Implicit: limba organizației | ## Răspuns [#response] Fiecare element este o zi calendaristică, deja rezolvată: | Câmp | Semnificație | |-------|-----------| | `timeZone` | Fusul orar IANA al organizației | | `from` / `to` | Intervalul cerut | | `holidays` | Sărbători legale care se suprapun cu `from`–`to` | | `items[].date` | Ziua calendaristică `YYYY-MM-DD` | | `items[].weekday` | `monday` … `sunday` | | `items[].source` | `exception`, `period` sau `regular` | | `items[].periodLabel` | Doar la `source: "period"`: eticheta din Tillor, de exemplu `"Zomer"` sau `"Winter"` | | `items[].holiday` | Doar dacă acea zi este sărbătoare legală: `{ id, name, startDate, endDate }` | | `items[].blocks` | Intervale orare în minute de la miezul nopții | | `items[].closed` | `true` dacă `blocks` este gol | Prioritate: **excepție** (sărbătoare sau interval personalizat) → ultima **perioadă sezonieră** potrivită → programul săptămânal **obișnuit**. Etichetele sezoniere provin din *Setări > Program de funcționare*. Perioadele pot trece peste schimbarea anului (de exemplu de la 1 noiembrie până la 31 martie). Zilele din afara oricărei perioade revin la programul săptămânal obișnuit (`source: "regular"`, fără `periodLabel`). ### Din minute în oră de ceas [#minuten-naar-kloktijd] `startMinutes` / `endMinutes` sunt minute de la 00:00. | Minute | Ora | |--------:|------| | 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")}`; } ``` ## Exemple [#voorbeelden] ### Zi dintr-o perioadă sezonieră [#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, program de vară. ### Zi în afara perioadelor sezoniere [#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. ### Interval peste limita unei perioade [#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` | ## Sărbători legale următoare [#komende-feestdagen] Sărbătorile legale se află în același răspuns: `holidays` pentru o listă (nume + date), `items[].holiday` dacă acea zi calendaristică este o sărbătoare. Orele rămân programul rezolvat; o sărbătoare fără excepție completată în Tillor urmează programul sezonier sau săptămânal (`source` nu este atunci `"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 } ] } ``` Exemplul `items` de mai sus este prescurtat; răspunsul real conține fiecare zi din interval. Vacanțele școlare nu sunt incluse în acest endpoint; ele rămân la `GET /holidays?kind=school`. ## Next.js (server) [#nextjs-server] Pentru un widget săptămânal sau „deschis acum” pe un site public: ```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 { 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; } ``` `holidays` este lista pentru un bloc „sărbători următoare”. `items[].holiday` este util într-un calendar săptămânal. `items[].periodLabel` este textul sezonier (de exemplu `"Zomer"` sau `"Winter"`). Un cache de 1 oră este de obicei suficient. ## Invalidarea cache-ului (webhook) [#cache-ongeldig-maken-webhook] La fiecare modificare a setărilor organizației, Tillor trimite `organizationSettings:updated` (webhook și SSE). Abonați-vă la el și preluați din nou programul de funcționare. Payloadul este intenționat mic (fără IP-uri de imprimantă sau programul complet): ```json { "event": "organizationSettings:updated", "data": { "openingHoursChanged": true }, "timestamp": 1787829600000 } ``` `openingHoursChanged` este `true` dacă se schimbă programul de funcționare, fusul orar sau țara implicită - adică ceea ce influențează `GET .../opening-hours`. La `false` puteți păstra cache-ul programului de funcționare. Exemplu de Route Handler 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 }); } ``` Crearea unui webhook: consultați [Webhookuri](/ontwikkelaars/webhooks). Cheia evenimentului: `organizationSettings:updated` (permisiune `organization:settings:read` sau `organization:settings:write`). ## Programul complet (opțional) [#volledig-rooster-optioneel] Necesar doar dacă doriți să afișați singur calendarul sezonier (etichete + `fromMonth`/`untilDay`), fără rezolvare pe zile: ``` GET https://tillor.eu/api/orgs/org_abc123/organization-settings ``` Citiți `openingHoursSchedule.periods` (etichete precum `"Zomer"`) și `openingHoursSchedule.weekdays` (program obișnuit). Pentru site-ul propriu-zis, `GET .../opening-hours` rămâne sursa cea mai simplă. ## MCP [#mcp] În Cursor sau Claude: endpointul `organizationSettings_listOpeningHours` (categoria `organizationSettings`), argumente `organizationId`, opțional `date` sau `from`/`to`, opțional `languageIsoCode`. ## Legate de acest subiect [#gerelateerd] - [API HTTP](/ontwikkelaars/http) - autentificare și antete - [Exemple HTTP](/ontwikkelaars/voorbeelden/http) - exemple cURL generale - [Webhookuri](/ontwikkelaars/webhooks) - `organizationSettings:updated` pentru revalidarea cache-ului - [Setările organizației](/gebruikers/organisaties) - configurarea programului de funcționare în Tillor # Exemple SSE (/ro-RO/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); } } } ``` ## Mesaj SSE [#sse-bericht] Un mesaj SSE (`text/event-stream`) arată astfel: ``` 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} ``` Linia SSE `event` este `message`. Interpretați linia `data` ca JSON: conține evenimentul Tillor (`event`), payloadul (`data`) și `timestamp` (ms). Primiți același obiect JSON și prin [webhookuri](/ontwikkelaars/webhooks). # Exemple webhook (/ro-RO/ontwikkelaars/voorbeelden/webhooks) Aceleași evenimente ca la [SSE](/ontwikkelaars/voorbeelden/sse). Structura payloadului este identică. ## Structura de înveliș [#wrapper-structuur] ```json { "event": "entity:action", "data": {}, "timestamp": 1735689600000, "traceId": "4bf92f3577b34da6a3ce929d0e0e4736", "spanId": "00f067aa0ba902b7" } ``` `traceId` aparține acțiunii Tillor care a declanșat evenimentul (de ex. un apel API sau o prelucrare internă), nu unei reîncercări ulterioare a webhookului. ## Exemplu de POST webhook [#webhook-post-voorbeeld] O cerere POST webhook completă arată astfel: ```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" } ``` ## Payloaduri de evenimente [#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 } ``` Consultați [API Program de funcționare](/ontwikkelaars/voorbeelden/opening-hours) pentru revalidarea cache-ului pe un site public. ## Enumerări [#enums] | Entitate | Enumerare | Valori | |--------|------|---------| | Customer | `customerType` | `STANDARD`, `WORKER_RENTAL_CARAVAN`, `WORKER_TOWING_CARAVAN` | | Invoice | `status` | `DRAFT`, `BOOKED` | | Invoice | `paymentStatus` | `UNPAID`, `PARTIALLY_PAID`, `PENDING`, `PAID` | | Payment | `status` | `PENDING`, `AUTHORIZED`, `PAID`, `CANCELED`, `FAILED`, `EXPIRED`, `REFUNDED`, `PARTIALLY_REFUNDED`, `CHARGED_BACK` | | Payment | `method` | `UNKNOWN`, `BANCONTACT`, `IDEAL`, `CREDITCARD`, `CASH`, … (lista completă în 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` | # Webhookuri (/ro-RO/ontwikkelaars/webhooks) Webhookurile primesc evenimente în timp real prin HTTP POST la un URL configurat de dumneavoastră. Aceleași evenimente sunt disponibile și prin [SSE](/ontwikkelaars/sse). Webhookurile sunt configurate **per organizație** - fiecare organizație are propriile webhookuri. ## Administrare [#beheer] Consultați [specificația OpenAPI](https://tillor.eu/api/openapi.json) pentru schemele complete de cerere și răspuns. | Metodă | Cale | Descriere | |--------|------|-------------| | GET | `/api/orgs/:orgId/webhooks` | Preia webhookurile | | GET | `/api/orgs/:orgId/webhooks/delivery-stats` | Preia statisticile de livrare | | POST | `/api/orgs/:orgId/webhooks/retry-deliveries` | Reîncearcă livrările. Body: `mode` (`failed` sau `force`) și opțional `id` pentru un singur webhook. `failed`: doar livrările eșuate definitiv, imediat. `force`: livrările în așteptare și cele eșuate definitiv, în fundal, ignorând timpii de așteptare. | | GET | `/api/orgs/:orgId/webhooks/:id` | Preia un webhook după ID | | POST | `/api/orgs/:orgId/webhooks` | Creează un webhook | | PATCH | `/api/orgs/:orgId/webhooks/:id` | Actualizează un webhook | | DELETE | `/api/orgs/:orgId/webhooks/:id` | Șterge un webhook | ## Crearea unui webhook [#webhook-aanmaken] ```http POST /api/orgs/org_abc123/webhooks Content-Type: application/json x-api-key: tkn_xxx ``` ```json { "url": "https://jouw-server.com/webhooks/tillor", "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"], "enabled": true } ``` - **url** - endpoint HTTPS care acceptă cereri POST - **subscribedEventKeys** - listă de chei de evenimente sau `["*"]` pentru toate evenimentele. Lista completă o găsiți în Tillor la **Meniul de profil → Dezvoltatori**, la **Adăugați webhook** → **Evenimente abonate**. Câteva evenimente apar atât de des încât nu le puteți alege și nici nu ajung prin `*`, precum starea fizică a barierelor, tastarea în inbox, jurnalele controlerelor și prezența vehiculelor. Ele nu se află în lista de mai jos. Ce evenimente puteți alege depinde și de permisiunile dumneavoastră. - **enabled** - `true` pentru a activa livrarea Puteți alege doar evenimente pentru care membrul organizației are permisiunea corespunzătoare (de ex. tranzacții bancare pentru `bankAccountTransaction:*`). Wildcardul `*` este disponibil doar pentru membrii cu acces complet (`*`). La o combinație nevalidă, API-ul returnează o eroare. Un webhook transmite payloadul complet, cu datele asociate (precum clientul la o rezervare). De aceea trebuie să aveți voie să citiți și acele domenii pentru a crea un webhook, pentru a-i modifica URL-ul sau evenimentele ori pentru a-l reactiva. --- ## Payloadul webhook [#webhook-payload] Fiecare livrare webhook este un POST cu: **Antete:** - `Content-Type: application/json` - `X-Webhook-Event-ID` - ID unic și stabil pentru această livrare logică (aceeași valoare la reîncercări) - `X-Webhook-Signature` - semnătură HMAC-SHA256 a body-ului, format `sha256=` (consultați [Verificarea semnăturii](#handtekening-verifiëren)) **Body:** ```json { "event": "invoice:created", "data": {}, "timestamp": 1735689600000, "traceId": "4bf92f3577b34da6a3ce929d0e0e4736", "spanId": "00f067aa0ba902b7", "triggeredBy": { "id": "usr_63x8jp68is", "name": "Niels" } } ``` | Câmp | Tip | Descriere | |-------|------|--------------| | `event` | string | Cheia evenimentului (de ex. `invoice:created`) | | `data` | object | Payload specific evenimentului | | `timestamp` | number | Timestamp Unix (ms) la care a fost emis evenimentul | | `traceId` | string | ID-ul de trace OpenTelemetry al acțiunii Tillor care a declanșat acest eveniment. Comunicați-l suportului; nu este secret. | | `spanId` | string (opțional) | Span în cadrul acelui trace | | `triggeredBy` | object \| null | Utilizatorul care a efectuat acțiunea (`id`, `name`). `null` la acțiuni de sistem (cron, sincronizare bancară, …) | Consultați [Exemple](/ontwikkelaars/voorbeelden) pentru exemple complete de payload. --- ## Verificarea semnăturii [#handtekening-verifiëren] Fiecare webhook are propriul **secret de semnare** (64 de caractere hex, vizibil în tabelul de webhookuri prin **Afișați secretul de semnare** la *Meniul de profil → Dezvoltatori*). Tillor semnează fiecare POST cu acest secret, astfel încât să puteți verifica faptul că cererea vine cu adevărat de la Tillor și că body-ul nu a fost modificat. **Cum semnează Tillor:** 1. Calculează `HMAC-SHA256(signingSecret, raw_request_body)` (hex cu litere mici). 2. Trimite rezultatul ca `X-Webhook-Signature: sha256=`. **Cum verificați dumneavoastră:** 1. Citiți body-ul **brut** al cererii (înainte de parsarea JSON - altfel hash-ul nu se potrivește). 2. Calculați singur `HMAC-SHA256(signingSecret, raw_body)` în hex. 3. Comparați cu valoarea de după `sha256=` din antetul `X-Webhook-Signature`, printr-o comparație **în timp constant**. ```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); } ``` Secretul de semnare îl puteți afișa în Tillor prin **Afișați secretul de semnare** în tabelul de webhookuri. Păstrați-l ca secret (variabilă de mediu, vault) și nu îl înregistrați niciodată în jurnale. Bănuiți o scurgere? Ștergeți webhookul și creați unul nou; astfel primiți un secret nou. --- ## Comportamentul de livrare și reîncercări [#leveringsgedrag-en-retries] - Răspundeți cu un **status 2xx** pentru a confirma succesul. - La o livrare eșuată (non-2xx, eroare de rețea sau destinație blocată), Tillor reîncearcă automat livrarea, cu pauze din ce în ce mai lungi. Fiecare încercare reutilizează același payload, aceeași semnătură și același ID de eveniment (idempotent). | Încercarea | Timp de așteptare de la încercarea anterioară | |---|---| | 1 | imediat | | 2 | 1 secundă | | 3 | 2 secunde | | 4 | 4 secunde | | 5 | 8 secunde | | 6 | 5 minute | | 7 | 30 de minute | | 8 | 2 ore | | 9 | 6 ore | | 10 | 24 de ore | - Dacă una dintre încercări reușește (2xx) → livrarea este încheiată. - Dacă nici încercarea 10 (după 24 de ore) nu reușește → livrarea este **marcată definitiv ca eșuată** și nu mai este reîncercată. - Dacă webhookul este între timp **dezactivat**, Tillor nu mai reîncearcă. ```mermaid flowchart TD A[Eveniment emis] --> B[Livrare la endpointul dumneavoastră] B -- 2xx --> Z[Încheiat] B -- eșuat --> C[Reîncercat
1s, 2s, 4s, 8s,
5m, 30m, 2h, 6h, 24h] C -- 2xx --> Z C -- toate încercările eșuate --> F[Eșuat definitiv] ``` Fiecare reîncercare reutilizează același `X-Webhook-Event-ID` și aceeași `X-Webhook-Signature`. Deduplicați pe partea dumneavoastră după acel antet, astfel încât o reîncercare reușită după un 200 lent să nu provoace o prelucrare dublă. ### Notificări în caz de erori persistente [#meldingen-bij-aanhoudende-fouten] Dacă livrările către un endpoint webhook continuă să eșueze, Tillor trimite **cel mult două notificări per incident** (per endpoint): 1. **După 5 minute de erori persistente** - e-mail către adresa de e-mail a organizației (`supportEmail`, altfel `email`) și către membrii organizației cu drepturi de a modifica setările organizației, plus push (dacă este activat) pentru acești membri. E-mailul menționează de când eșuează livrările. Datele din e-mail folosesc **fusul orar** din *Setări > General* (implicit `Europe/Brussels`). 2. **La eșecul definitiv** - aceiași destinatari primesc o singură notificare atunci când primul eveniment din acel incident este marcat definitiv ca eșuat după toate încercările. **Nu** primiți o notificare pentru fiecare eveniment eșuat. Imediat ce toate livrările eșuate pentru un endpoint sunt rezolvate (livrate cu succes), un incident următor pornește din nou cu aceleași reguli. La **Meniul de profil → Dezvoltatori**, tabelul de webhookuri afișează pentru fiecare endpoint o stare compactă a livrărilor (numărul celor care așteaptă reîncercarea și al celor eșuate definitiv). Faceți clic pe pictograma **ℹ** pentru detalii, inclusiv mesajul de eroare complet și payloadul ultimei încercări. - **Reîncercați livrările eșuate** (↻): doar livrările eșuate definitiv pentru acel webhook. - **Forțați reîncercarea** (⚡): toate livrările în așteptare și cele eșuate definitiv pentru acel webhook, indiferent de timpii de așteptare planificați. Tillor pornește acest lucru în fundal, astfel încât cozile mari (de ex. mii de evenimente) să fie prelucrate în siguranță. - **Forțați reîncercarea tuturor**, în dreapta sus, lângă **Adăugați webhook**: același lucru pentru toate webhookurile activate din organizație. --- ## Tipuri de evenimente [#event-types] Cheile evenimentelor folosesc formatul `entity:action` sau `entity:subresource:action`. Lista completă, cu permisiunea pentru fiecare eveniment și un exemplu de payload, se află în [Indexul de evenimente](/ontwikkelaars/events). Pagina este generată din cod și este deci mereu completă. Aceleași chei se află în Tillor la [Meniul de profil → Dezvoltatori](https://tillor.eu/orgs/org_abc123/developers), la **Adăugați webhook** → **Evenimente abonate**. --- ## Webhookuri vs SSE [#webhooks-vs-sse] | Caz de utilizare | Recomandare | |----------|------------| | Integrare pe partea de server | **Webhookuri** - serverul dumneavoastră primește POST-uri | | Jurnalizare simplă | **Webhookuri** - configurare minimă | | Panou în timp real, actualizări live în aplicație | [SSE](/ontwikkelaars/sse) - o singură conexiune, latență mică. | | Multe tipuri de evenimente, filtrare pe partea de client | [SSE](/ontwikkelaars/sse) - folosiți parametrul de interogare `events` pentru a limita traficul. | --- ## Legate de acest subiect [#gerelateerd] - [OpenAPI](https://tillor.eu/api/openapi.json) - specificația completă a API-ului - [API HTTP](/ontwikkelaars/http) - API REST și chei API - [SSE](/ontwikkelaars/sse) - aceleași evenimente prin Server-Sent Events - [Automatizări](/ontwikkelaars/automatiseringen) - trimiteți mesaje proprii dintr-o automatizare # API Chat pe site-ul web (/ro-RO/ontwikkelaars/website-chat) Widgetul oficial îl instalați în aplicație: consultați [Puneți chatul pe site-ul dumneavoastră](/inbox/website-chat). Opțiunile snippetului se află la [Setările Chatului pe site-ul web](/inbox/website-chat-instellingen). Această pagină este pentru dezvoltatori: SDK-ul widgetului pentru un formular propriu și stratul REST pentru o **interfață de chat proprie**. Consultați [OpenAPI](https://tillor.eu/api/openapi.json), tagul `inbox`. ## SDK-ul widgetului [#widget-sdk] După încărcarea scriptului widgetului, `window.TillorInbox` este disponibil. Cu el transmiteți date de contact de la propriul formular (pagina de contact, detaliu de vânzare, cerere de ofertă). Toate metodele așteaptă până când configurația widgetului este încărcată. | Metodă | Descriere | |---------|--------------| | `ready()` | Promise care se rezolvă imediat ce widgetul este încărcat | | `getVisitor()` | Citește datele de contact salvate din `localStorage` și câmpurile widgetului completate; sincron, fără rețea | | `setVisitor({ name?, firstName?, lastName?, email?, phone?, message?, customFields? }, options?)` | Completează câmpurile chatului fără a trimite | | `open()` | Deschide fereastra de chat | | `close()` | Închide fereastra de chat | | `toggle()` | Deschide sau închide fereastra de chat | | `send({ body, name?, firstName?, lastName?, email?, phone?, message?, customFields?, open?, silent?, markSubmitted?, metadata? })` | Trimite un mesaj cu date de contact | `getVisitor()` returnează acest obiect: | Câmp | Descriere | |-------|--------------| | `visitorId` | ID-ul acestui vizitator în acest browser (`localStorage`) | | `name` | Numele complet (un singur câmp în widget) | | `firstName` / `lastName` | Derivate din `name` (primul cuvânt / restul) | | `email`, `phone` | Date de contact | | `customFields` | Câmpuri suplimentare din setările widgetului | | `message` | Ciorna din câmpul de mesaj | | `detailsSubmitted` | Dacă formularul vizitatorului este considerat completat | Folosiți `getVisitor()` pentru a precompleta un formular propriu din `localStorage` (același browser, chiar și după reîmprospătarea paginii). Opțiuni pentru `setVisitor` (al doilea argument): | Opțiune | Implicit | Explicație | |-------|-----------|--------| | `open` | `false` | Deschide imediat fereastra de chat | | `markSubmitted` | `false` | Ascunde formularul vizitatorului dacă toate câmpurile obligatorii sunt completate | | `onlyEmpty` | `false` | Suprascrie doar câmpurile goale | | `persist` | `false` | Păstrează datele în `localStorage` (același browser, chiar și după o filă nouă) | Opțiuni pentru `send`: | Opțiune | Implicit | Explicație | |-------|-----------|--------| | `open` | `false` | Deschide fereastra de chat înainte de trimitere | | `silent` | `true` dacă `open` este false | Fără sunet, fără mesaj de eroare în widget; folosiți Promise pentru succes sau eroare | | `markSubmitted` | `true` | Datele de contact nu mai trebuie introduse din nou în widget | | `metadata` | - | Indicii opționale pentru Tillie (nevizibile în fereastra de chat); consultați [metadata](#metadata-boekingsformulier) | Cu `open: false` (implicit), butonul de chat rămâne închis. Mesajul ajunge totuși la Tillor; formularul dumneavoastră poate mulțumi sau poate afișa o eroare. Cu `open: true`, fereastra de chat se deschide, iar vizitatorul vede comportamentul normal de trimitere (sunet, bife, eventuale erori ale widgetului). Doriți să folosiți un buton propriu în locul butonului plutitor de chat? Setați `data-launcher="false"` pe snippet și apelați `TillorInbox.open()`. ### `metadata` (formular de rezervare) [#metadata-boekingsformulier] Folosiți `metadata` când aveți un formular propriu pe site și Tillie trebuie să trimită **doar o confirmare**, fără întrebări suplimentare (de exemplu pentru că fila se închide după aceea). | Cheie | Tip | Explicație | |---------|------|--------| | `forceHandover` | `boolean` | Mesaj de confirmare și predare către un coleg, fără întrebări de preluare. Ignoră și pauza AI după un mesaj al echipei (consultați `ignoreAiPause`) | | `ignoreAiPause` | `boolean` | Tillie răspunde și atunci când este în pauză în modul **Automat** după un mesaj al echipei (30 de minute). Util pentru trimiteri silențioase de formulare; combinați cu `forceHandover` sau lăsați Tillie să facă preluarea normal | | `handoverIntent` | `"reservation"` \| `"caravan_rental"` \| `"sale"` \| `"other"` | Opțional: fluxul pentru predare (implicit: dedus automat din mesaj) | | `source` | `string` | Etichetă de integrare opțională pentru echipa dumneavoastră (litere mici, cifre, `-`, `_`; max. 64 de caractere) | ```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", }, }); ``` ### Înlocuirea formularului de contact (trimitere silențioasă) [#contactformulier-vervangen-stille-verzending] Folosiți această variantă când doriți să păstrați formularul de contact existent, dar să faceți ca mesajele să treacă prin Tillor fără a deschide fereastra de chat. ```html
``` Nu trebuie să setați `open` și `silent`: fără `open: true`, fereastra rămâne închisă, iar Tillor tratează apelul ca pe o trimitere silențioasă. ### Conectarea formularului de contact (deschiderea chatului) [#contactformulier-koppelen-chat-openen] Transmiteți câmpurile și deschideți fereastra de chat, astfel încât vizitatorul să vadă conversația: ```html
``` Sau doar completați câmpurile și deschideți fereastra, fără a trimite imediat: ```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 }, ); ``` O pagină de vânzare cu trimitere directă și deschiderea chatului: ```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, }); ``` Sincronizare live în timp ce cineva tastează: ```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, }); }); ``` ### Apelare timpurie (înainte de scriptul widgetului) [#vroeg-aanroepen-vóór-het-widget-script] Dacă apelați o metodă înainte ca scriptul să fie încărcat, puneți apelul în coadă: ```html ``` ## Interfață de chat proprie [#eigen-chat-ui] Dacă construiți o interfață de chat proprie în locul widgetului, folosiți stratul REST de mai jos. Autentificare: antetul `X-Tillor-Inbox-Widget-Key` (valoarea din *Setări > Integrări > Widget de chat site web*). ### Tastare [#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` când vizitatorul tastează; `false` când câmpul este gol sau vizitatorul se oprește (widgetul trimite `false` după aproximativ 4 secunde fără intrare) - `visitorName` / `visitorEmail` / `visitorPhone` sunt opționale - Folosiți același `visitorId` ca la `POST …/inbox/website/messages` și `GET …/inbox/website/messages` ### Timp real (SSE) [#realtime-sse] ```http GET /api/orgs/{orgId}/inbox/website/subscribe?visitorId=vis_… X-Tillor-Inbox-Widget-Key: iwk_xxx Accept: text/event-stream ``` | Eveniment | Când | |-------|---------| | `inbox:website:message-created` | Mesaj nou de la echipă sau de la AI | | `inbox:website:message-updated` | Mesaj al echipei sau al AI modificat sau șters | | `inbox:website:typing-changed` | `data.staffTyping` sau `data.staffOutboundSenderType` se schimbă | Forma payloadului este aceeași ca la [SSE la nivel de organizație](/ontwikkelaars/sse#event-formaat) (`event`, `data`, `timestamp`). Reconectați-vă după o întrerupere; nu există reluare. Widgetul oficial folosește SSE ca strat principal și preia din nou `GET …/messages` la fiecare **5 secunde** ca soluție de rezervă (la fiecare **1 secundă** cu panoul deschis, când SSE se întrerupe temporar). Astfel, răspunsurile sunt marcate ca **livrate** cât timp vizitatorul se află pe pagină. ### Activitatea vizitatorilor [#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` sau `navigation` (la navigare și `url`). Echipa dumneavoastră vede aceste evenimente ca text informativ gri în conversație, consultați [Conversații prin Chat pe site-ul web](/inbox/website-chat-gesprekken). ### Limite [#limieten] `POST …/inbox/website/messages` și `POST …/inbox/website/attachments/upload` răspund cu `429` când un vizitator sau o rețea trimite prea mult. Corpul conține `data.reason` = `INBOX_WIDGET_RATE_LIMITED` și `data.retryAfterSeconds`. Limite per organizație: | Rută | Per vizitator (`visitorId`) | Per rețea (adresă IP) | |------|-----------------------------|-----------------------| | `messages` | 10 pe minut, 200 pe zi | 30 pe minut, 600 pe zi | | `attachments/upload` | 10 pe oră | 50 pe oră | Așteaptă `retryAfterSeconds` înainte să încerci din nou și arată-i vizitatorului un mesaj în loc să reîncerci automat. ## Vezi și [#zie-ook] # Un oaspete la barieră (/ro-RO/praktijk/gast-aan-de-slagboom) Un oaspete ajunge la bariera parcului de recreere Het Meer și trebuie să poată trece fără ajutorul recepției. Acest exemplu îl urmărește pe Jonas Maes de la configurarea metodei sale de acces până la ce se întâmplă când aceasta nu (mai) funcționează. Veți vedea cum colaborează o metodă de acces, un controler și un punct de acces. ```mermaid flowchart LR A[Metodă de acces la client] --> B[Oaspete la punctul de acces] B --> C{Controlerul și Tillor verifică} C -->|valid| D[Permis, bariera se deschide] C -->|expirat sau blocat| E[Refuzat, vizibil în jurnal] ``` Înainte de a începe: - Parcul dumneavoastră are cel puțin un punct de acces conectat la Tillor. Îl găsiți la **Acțiuni rapide** pe pagina **Control acces**, cu un buton **Deschideți [nume punct de acces]**. - Controlerul de la barieră este conectat la organizația dumneavoastră. Un controler nou apare la **Controlere** cu **Așteaptă aprobare** până când faceți clic pe **Aprobați**. Consultați [Controlere](/controllers). - Pentru o etichetă NFC: eticheta trebuie să fie deja în Tillor. Acest lucru se întâmplă automat de îndată ce a fost ținută pentru prima dată în fața unui cititor. ## Traseul pas cu pas [#de-route-stap-voor-stap] ### Adăugați o metodă de acces [#voeg-een-toegangsmethode-toe] Mergeți la Clienți > Jonas Maes > Control acces și faceți clic pe **Adăugați**. Alegeți **Tip** și, dacă doriți, completați **De la data** și **Până la data**. Această perioadă stabilește când funcționează metoda. Alegeți **Recunoașterea numărului de înmatriculare** și completați **Număr de înmatriculare**. Camera de la punctul de acces citește numărul, iar Tillor găsește clientul corespunzător. Alegeți **Cod QR**. Tillor generează singur codul. Copiați din meniul metodei **URL personal** și trimiteți-l lui Jonas. El deschide pagina **Permis de acces** și poate adăuga permisul în Apple Wallet sau Google Wallet, dacă acest lucru este configurat pentru mediul dumneavoastră. Alegeți **NFC** și selectați un card NFC disponibil din listă. Dacă lista este goală, țineți mai întâi eticheta în fața unui cititor. Consultați [Gestionarea etichetelor](/nfc/nfc-tags). Consultați [Control acces](/toegangscontrole). ### Verificați controlerul și punctul de acces [#controleer-controller-en-toegangspunt] Controlerul sau camera de la punctul de acces primește de la Tillor lista metodelor valide. La **Operațiuni controler** pe pagina **Control acces** vedeți când un permis sau un cod QR a fost transmis către punctul de acces. Dacă operațiunea nu apare încă, sincronizarea este încă în curs. ### Urmăriți ce se întâmplă la barieră [#volg-wat-er-aan-de-slagboom-gebeurt] Blocul **Jurnal de acces** afișează fiecare încercare cu data, metoda, clientul, punctul de acces și starea. Un oaspete care intră apare în tabelul **Vehicule în parc** cu starea **Înăuntru**. Dacă pleacă, devine **A plecat**. ### Deschideți singur bariera când este nevoie [#open-de-slagboom-zelf-als-het-nodig-is] La **Acțiuni rapide** faceți clic pe **Deschideți [nume punct de acces]** și confirmați cu **Da, deschideți [nume punct de acces]**. Închiderea este posibilă doar dacă punctul de acces o acceptă. ## Ce se întâmplă la o metodă expirată? [#wat-gebeurt-er-bij-een-verlopen-methode] Dacă **Până la data** a trecut, metoda nu mai oferă acces, iar încercarea apare în jurnal cu starea **Expirat**. Alte stări pe care le puteți întâlni sunt **Blocat**, **Inactiv** și **Refuzat**. Pentru numerele de înmatriculare există o perioadă de grație, astfel încât oaspeții să nu rămână noaptea în fața unei ieșiri închise. Dacă **Permiteți ieșirea numerelor de înmatriculare expirate** este activat (implicit), bariera de ieșire se mai deschide în perioada de grație. Aceasta durează implicit 2 zile și cel mult 30. Funcționează doar în afara programului de funcționare. Dacă recepția este deschisă, personalul rezolvă vehiculul la ghișeu. Un număr de înmatriculare blocat sau inactiv nu primește niciodată perioadă de grație, iar etichetele NFC și codurile QR nu au perioadă de grație. O setați la Asistență > Setări > Control acces, consultați [Setări pentru controlul accesului](/gebruikers/instellingen-toegangscontrole). ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Fiecare încercare rămâne în jurnalul de acces. Puteți filtra după client, stare și punct de acces și puteți exporta în Excel. - Un vehicul care nu a fost văzut la un punct de acces timp de 7 zile primește starea **Fantomă**. Dacă numărul de înmatriculare este văzut din nou la o intrare, starea revine la **Înăuntru**. - Dacă prelungiți **Până la data** a metodei, aceasta funcționează din nou după următoarea sincronizare cu punctul de acces. ## Probleme? [#problemen] Căutați încercarea în jurnalul de acces și citiți starea. **Expirat** înseamnă că **Până la data** a trecut, **Blocat** sau **Inactiv** că metoda este dezactivată. Dacă metoda este în regulă, verificați **Operațiuni controler**. Dacă nu puteți rezolva rapid, deschideți bariera prin **Acțiuni rapide**. Atunci Tillor nu a primit nimic. Verificați dacă controlerul este online și dacă ecranul afișează un mesaj. Consultați [Mesaje pe ecran](/controllers/troubleshooting/scherm) și [Probleme de conexiune](/controllers/troubleshooting/verbinding). Verificați dacă numărul de înmatriculare a fost completat fără spații sau greșeli de tastare. Un număr citit greșit poate lăsa un vehicul și ca **Fantomă**. Eticheta nu este încă cunoscută în Tillor sau este deja legată de un alt client. Țineți-o mai întâi în fața unui cititor sau desprindeți-o de la celălalt client. ## Vezi și [#zie-ook] # Prezentare generală (/ro-RO/praktijk) În majoritatea sarcinilor atingeți mai mult de un modul: un client nou devine o ocupare, un contract, o factură și o plată. Aceste exemple parcurg un asemenea traseu de la început până la sfârșit. Folosesc organizația demo Recreatiepark Het Meer, cu clientul Jonas Maes și terenul 12. Fiecare pas trimite la pagina cu explicația completă. ## Cum se leagă acestea? [#hoe-hangt-dit-samen] ```mermaid flowchart LR K[Client] --> B[Ocupare] T[Teren] --> B M[Contor] --> T B --> V[Consum] K --> O[Cerere de semnătură] B --> F[Factură] V --> F F --> P[Plată] P --> R[Raport de plăți] K --> TM[Metodă de acces] TM --> TP[Punct de acces] B -->|se încheie| A[Automatizare] A --> TK[Sarcină] ``` Citiți exemplele ca pe un traseu: puteți intra în orice punct. Dacă doriți să recitiți termenii, consultați [Noțiuni](/begrippen). ## Noțiuni [#begrippen] - **Ocupare**: un client pe un teren pentru o perioadă mai lungă. Consultați [Ocupare](/begrippen#bezetting). - **Teren**: un loc din parcul dumneavoastră. Consultați [Teren](/begrippen#terrein). - **Cerere de semnătură**: un PDF care se semnează online. Consultați [Cerere de semnătură](/begrippen#ondertekenverzoek). - **Automatizare**: o regulă pe care Tillor o execută singur. Consultați [Automatizare](/begrippen#automatisering). # Înscrierea unui client de sezon (/ro-RO/praktijk/seizoensklant-binnenhalen) Înscrierea unui client de sezon înseamnă în Tillor: creați clientul, îi atribuiți o parcelă, îi dați contractul de închiriere spre semnare, facturați taxa de staționare și vă asigurați că plata ajunge în contabilitatea dumneavoastră. Acest exemplu parcurge traseul pentru Jonas Maes, care închiriază parcela 12 la Recreatiepark Het Meer pentru sezon. Fiecare pas trimite la pagina cu explicația completă. ```mermaid flowchart LR A[Creare client] --> B[Ocupare pe parcela 12] B --> C[Semnarea contractului de închiriere] C --> D[Facturarea taxei de staționare] D --> E[Plată] E --> F[Raport de plăți] ``` Înainte de a începe: - Parcela 12 există și nu are o ocupare activă. Dacă are una, nu apare în lista de alegere de la **Creați ocupare**. - Există un produs cu acțiunea **Prelungiți perioada de ocupare**, adesea Taxă de staționare. Vedeți [Asocierea acțiunilor la un produs](/producten/acties-instellen). - Aveți contractul de închiriere pregătit în format pdf. - Aveți dreptul **Gestionarea cererilor de semnare** pentru a da contractul spre semnare. - Pentru semnarea la distanță, clientul are nevoie de o adresă de e-mail sau de un număr de telefon. Pentru un mandat SEPA este necesară o adresă de e-mail. ## Traseul pas cu pas [#de-route-stap-voor-stap] ### Creați clientul [#maak-de-klant-aan] Mergeți la Clienți > Prezentare generală și faceți clic pe **Creați un client nou**. Dacă în coada de așteptare se află o scanare de identitate, alegeți-o din meniul de selecție: Tillor completează datele din document. În caz contrar, alegeți **Manual** și completați **Prenume**, **Nume**, **Adresă de e-mail** și **Număr de telefon**. După creare ajungeți pe profilul lui Jonas. Completați acolo adresa. Mai multe informații găsiți la [Gestionarea clienților](/klantenbeheer) și [Scanări de identitate](/identiteitsscans). ### Atribuiți-i lui Jonas parcela 12 [#geef-jonas-terrein-12] Pe profilul său, deschideți fila **Prezentare generală**, mergeți la cardul **Ocupări** și faceți clic pe **Creați ocupare**. La **Parcelă** alegeți parcela 12. Dacă este nevoie, completați **Plătit până la**, **Tip** și **Frecvența chiriei**. Prețul provine implicit de la parcelă. Dacă parcela 12 are contoare, puteți completa acum și **Citiri inițiale ale contoarelor**. Vedeți [Ocupări](/bezettingen#een-bezetting-aanmaken). ### Dați contractul de închiriere spre semnare [#laat-het-huurcontract-tekenen] Mergeți la Administrare > Semnături și faceți clic pe **Cere semnături**. Alegeți-l pe Jonas Maes ca **Client**, încărcați contractul, adăugați-l pe Jonas ca semnatar cu **Client: Jonas Maes** și plasați un câmp de semnătură. Dacă doriți, adăugați un angajat ca al doilea semnatar. Faceți clic pe **Trimite**. Jonas primește un e-mail cu un link personal sau un SMS dacă există doar un număr de telefon. El semnează pe propriul dispozitiv și confirmă cu un cod din 6 cifre. Faceți clic pe **Trimite**, deschideți cererea și faceți clic la Jonas pe **Semnează pe tabletă**. Alegeți **Cu cod** sau **Fără cod** dacă i-ați verificat identitatea la recepție. Contractul se deschide pe tabletă, cu numele lui scris cu litere mari. Toate detaliile se află la [Cererea de semnături](/handtekeningen/handtekening-vragen) și [Cum semnează cineva](/handtekeningen/ondertekenen). ### Înregistrați taxa de staționare [#boek-het-staangeld] Reveniți la cardul **Ocupări** de pe profilul lui Jonas, deschideți meniul de la ocupare și alegeți **Prelungiți ocuparea (factură)**. Faceți clic pe **Creați factură ciornă**. Tillor creează o factură ciornă cu produsul care are acțiunea **Prelungiți perioada de ocupare**. Verificați perioada de pe factură și faceți clic pe **Înregistrați factura**. Factura primește un număr de factură și starea Înregistrată. Vedeți [Înregistrarea unei facturi](/facturen/boeken) și [Prelungirea ocupării](/bezettingen#facturatie-bezetting-verlengen). ### Alegeți cum plătește Jonas [#kies-hoe-jonas-betaalt] Înregistrarea nu trimite nimic clientului. Acum alegeți cum intră banii. Faceți clic pe **Trimiteți notificare** și alegeți un canal, de exemplu **E-mail**. Jonas primește butonul **Vizualizați și plătiți online** și finalizează plata, de exemplu cu iDEAL sau Bancontact. Dacă dorește să plătească mai întâi doar o parte, creați un [link pentru o plată parțială](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). Vedeți [Plata online](/betalingsverwerking/online). Solicitați mai întâi un mandat prin Clienți > Jonas Maes > Facturare și **Creați mandat**. De îndată ce starea este Activ, alegeți pe factură, la **Mandat de debit direct**, acel mandat. Tillor încasează apoi suma la două zile după înregistrare sau la două zile după asociere, dacă factura era deja înregistrată. Vedeți [Semnarea unui mandat SEPA](/betalingsverwerking/mandaat) și [Încasarea unei facturi](/betalingsverwerking/incasso). Faceți clic pe **Efectuați o plată** și alegeți **Terminal**, **Numerar** sau **Transfer**. Vedeți [Înregistrarea unei plăți](/betalingsverwerking/betaling-registreren). ### Urmăriți sosirea plății [#zie-de-betaling-binnenkomen] Sub Administrare > Plăți se află plata. O plată online apare imediat ce Mollie o confirmă. Un debit direct are mai întâi starea În curs și după câteva zile devine Plătită. Dacă totul a intrat, factura are starea Plătită. Mai multe informații găsiți la [Regăsirea plăților](/betalingsverwerking/betalingen-bekijken). ### Vedeți plata în raportul de plăți [#zie-de-betaling-in-het-betalingsrapport] Mergeți la Administrare > Rapoarte de plăți. Plățile de astăzi se află în raportul cu starea **Ciornă**. Tillor finalizează raportul la următoarea verificare zilnică, în zilele lucrătoare la 09:00. Dacă legătura cu contabilitatea este activă, Tillor trimite singur raportul mai departe. Vedeți [Rapoarte de plăți](/boekhouden/betalingsrapporten). ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Ocuparea lui Jonas este în curs. Parcela 12 nu mai este disponibilă pentru alți clienți, iar consumul contoarelor de pe parcelă merge către Jonas. - De îndată ce toți au semnat, cererea are starea Finalizată. Pdf-ul semnat, cu paginile de dovadă, se află la **Documente** ale lui. Dacă doriți ca o automatizare să facă ceva în acel moment, de exemplu să creeze o sarcină, folosiți declanșatorul **Cerere de semnătură finalizată**. - La înregistrarea facturii, Tillor setează **Facturat până la** la sfârșitul liniei de factură. După plată, **Plătit până la** se mută înainte. Vedeți [Plătit până la, tip, frecvența chiriei și preț](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs). - În sezonul următor, prelungiți aceeași ocupare din nou cu **Prelungiți ocuparea (factură)**, sau pentru toate ocupările unui client deodată cu **Prelungiți toate**. - Plățile Mollie apar în raportul ciornă ca avans la Mollie, până când se cunoaște plata efectivă. ## Probleme? [#problemen] O parcelă poate fi asociată unui singur client la un moment dat. Dacă există deja o ocupare activă, parcela nu apare în listă. Încheiați mai întâi acea ocupare, vedeți [Încheierea unei ocupări](/bezettingen#een-bezetting-beëindigen). Tillor verifică cererea și spune ce lipsește: un semnatar fără câmp de semnătură, un semnatar fără adresă de e-mail sau număr de telefon sau un titlu gol. Remediați și încercați din nou. Vedeți [Cererea de semnături](/handtekeningen/handtekening-vragen#problemen). Treceți cu mouse-ul peste buton, Tillor arată motivul. Adesea lipsește o dată de început sau de sfârșit pe o linie cu o ocupare sau suma este mai mare decât maximul mandatului asociat. Vedeți [Când înregistrarea nu reușește](/facturen/boeken#problemen). Trebuie să existe cel puțin un produs cu acțiunea **Prelungiți perioada de ocupare**. Fără un astfel de produs, Tillor nu poate construi linia. Creați produsul sau adăugați acțiunea, vedeți [Asocierea acțiunilor la un produs](/producten/acties-instellen). Jonas nu are un mandat cu starea Activ a cărui sumă maximă să fie suficient de mare. Verificați cardul **Mandate** din fila lui **Facturare**. Plata a fost inițiată, dar banii nu au intrat încă definitiv. Este normal la un debit direct. De îndată ce plata este procesată, starea trece la **Plătită**. Vedeți [Stări](/facturen/statussen). ## Vezi și [#zie-ook] # O rulotă fixă se eliberează (/ro-RO/praktijk/stacaravan-komt-vrij) Când un client pleacă dintr-o rulotă fixă, urmează muncă: rulota trebuie verificată, iar garanția trebuie returnată clientului. Acest exemplu arată cum le reunește Tillor. Opriți ocuparea, o automatizare creează o sarcină de verificare, un coleg finalizează sarcina, iar apoi rezolvați garanția. Folosim ca exemplu pe Jonas Maes și parcela 12 de la Recreatiepark Het Meer, acum ca locatar al unei rulote fixe. ```mermaid flowchart LR A[Oprire ocupare] --> B[Automatizare] B --> C[Sarcină de verificare cu subsarcini] C --> D[Colegul finalizează] D --> E[Garanție returnată prin notă de credit] ``` Înainte de a începe: - Parcela 12 are tipul de parcelă **Rulotă fixă**, iar Jonas are o ocupare activă pe ea. Vedeți [Tipuri de parcelă](/terreinen#terreintypes). - Există o automatizare care creează o sarcină la sfârșitul unei ocupări. Cum o construiți găsiți la [Exemplu: verificarea rulotei de închiriat](/automatiseringen/voorbeeld-nalopen). În mediile demo, ea există deja sub numele **Verificarea rulotei de închiriat**, în pauză, până când activați comutatorul **Activ**. - Pentru garanție: produsul de garanție are activată opțiunea **Supraveghează soldul clientului în acest cont**. Vedeți [Supravegherea soldului clientului](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). ## Traseul pas cu pas [#de-route-stap-voor-stap] ### Opriți ocuparea [#stop-de-bezetting] Deschideți profilul lui Jonas, mergeți în fila **Prezentare generală** la cardul **Ocupări**, deschideți meniul de la ocupare și alegeți **Eliminați**. La **Dată** alegeți ziua în care pleacă. Dacă parcela are contoare, completați **Citiri finale ale contoarelor**. Faceți clic pe **Eliminați**. Parcela 12 este apoi din nou liberă pentru o nouă ocupare. Vedeți [Încheierea unei ocupări](/bezettingen#een-bezetting-beëindigen). ### Lăsați automatizarea să creeze sarcina de verificare [#laat-de-automatisering-de-nalooptaak-maken] Nu trebuie să faceți nimic. Automatizarea pornește imediat ce ocuparea se încheie și verifică mai întâi dacă parcela are tipul de parcelă **Rulotă fixă**. Apoi caută dacă există deja o sarcină deschisă **Verificare** pentru această parcelă. - Dacă nu există încă o sarcină deschisă, ea creează o sarcină **Verificare parcela 12** cu cinci subsarcini (**Curățenie**, **Inventar**, **Internet + TV**, **Cadru cod QR** și **Verificare lucrări mici**) și un termen limită de 7 zile. Sarcina ajunge și la colegul care a oprit ocuparea. - Dacă există deja o sarcină deschisă, de exemplu pentru că rulota s-a eliberat de două ori la scurt timp, ea nu creează una a doua. Prioritatea sarcinii existente crește cu o treaptă, până la **Ridicată**. Urmăriți ce a făcut automatizarea la [Teste și execuții](/automatiseringen/testen-en-uitvoeringen). ### Finalizați sarcina [#werk-de-taak-af] Colegul găsește sarcina în cardul **Sarcini pentru dvs.** de pe tabloul de bord, în fila **Sarcini** a lui Jonas sau într-o vizualizare de la **Sarcini**. Sarcina este asociată parcelei 12 și lui Jonas. Deschideți sarcina și bifați fiecare subsarcină de îndată ce este făcută. Lângă sarcină se află un contor precum **2/5**. Dacă toate subsarcinile sunt gata, setați starea la **Finalizată**. Dacă setați sarcina principală la **Finalizată**, subsarcinile deschise sunt finalizate odată cu ea. Dacă ați extins automatizarea cu pasul **Cere o decizie**, de exemplu pentru a decide dacă garanția se returnează integral, pe sarcină apar butoane sub **Alege o acțiune pentru a finaliza această sarcină.** Un singur clic finalizează sarcina. Dacă alegerea cere un motiv, se deschide **De ce această alegere?**. O alegere făcută nu mai poate fi anulată ulterior. Vedeți [Sarcini cu butoane de alegere](/taken/taakdetails#taken-met-keuzeknoppen) și [Cere o decizie](/automatiseringen/logica#vraag-om-een-beslissing). ### Verificați soldul garanției [#controleer-het-saldo-van-de-waarborg] Deschideți profilul lui Jonas și mergeți la fila **Facturare**. În tabelul **Conturi** vedeți soldul pe fiecare cont contabil. Contul contabil al garanției arată ce mai are Jonas de primit. ### Creați nota de credit pentru garanție [#maak-de-creditnota-voor-de-waarborg] Deschideți factura de garanție a lui Jonas, faceți clic pe cele trei puncte din dreapta sus și alegeți **Stornați factura**. Tillor creează o factură ciornă cu aceleași linii, în sume negative. Dacă rețineți o parte, de exemplu pentru daune, modificați suma. Faceți clic pe **Înregistrați factura**. Factura devine o **Notă de credit**. Tillor refuză o factură care ar aduce soldul contului contabil al garanției sub zero. Astfel nu puteți returna o garanție de două ori. Vedeți [Stornarea unei facturi](/facturen/corrigeren#een-factuur-omkeren). ### Compensați suma [#verreken-het-bedrag] Dacă mai există o factură deschisă a lui Jonas, de exemplu pentru ultimul consum, puteți compensa suma cu metoda de plată **Transfer intern**. Vedeți [Crearea unui transfer intern](/betalingsverwerking/interne-overboeking). Tillor înregistrează nota de credit și compensarea. Virarea efectivă a sumei în contul bancar al clientului o faceți prin banca dumneavoastră. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Parcela este din nou liberă. Un client nou poate lua o ocupare pe ea sau poate primi o rezervare. - Perioadele de consum deschise ale lui Jonas sunt închise, cu citirile finale pe care le-ați completat. Consumul până la data de încheiere rămâne păstrat și îl puteți încă factura. Vedeți [Facturarea consumului](/praktijk/verbruik-aanrekenen). - Sarcina și acțiunile asupra ei se află în cronologia sarcinii și pe profilul lui Jonas. Modificările ocupării se află în fila lui **Evenimente**. - Nota de credit ajunge în contabilitate ca orice altă factură. ## Probleme? [#problemen] Verificați trei lucruri. Este activat comutatorul **Activ** al automatizării? Este tipul de parcelă al parcelei 12 **Rulotă fixă**? Vedeți la [Teste și execuții](/automatiseringen/testen-en-uitvoeringen) dacă automatizarea a pornit și unde s-a oprit. Automatizarea caută o sarcină deschisă cu exact același titlu, **Verificare** urmat de numele parcelei, pentru aceeași parcelă, același client sau aceeași rezervare. Dacă titlul nu se potrivește, ea nu găsește sarcina existentă și creează una nouă. O sarcină deschisă primește doar o prioritate mai mare, nu o a doua sarcină. Dacă scrie **Finalizată de automatizarea sa**, doar automatizarea poate finaliza sarcina, iar sarcina nu are **Eliminați**. Vedeți [Detaliile sarcinii](/taken/taakdetails#taken-met-keuzeknoppen). Poate alege cine este alocat sarcinii și un administrator. Dacă nimeni nu este alocat, poate alege oricine vede sarcina. Dacă în loc de butoane apare o bifă, sarcina nu provine dintr-un pas **Cere o decizie**. Soldul contului contabil al garanției ar ajunge sub zero. Verificați tabelul **Conturi** și suma de pe factură. Cu dreptul **Ignorarea soldului contului** puteți înregistra totuși, cu o motivare care apare în cronologia facturii. ## Vezi și [#zie-ook] # Facturarea consumului (/ro-RO/praktijk/verbruik-aanrekenen) Facturarea consumului funcționează în Tillor prin parcelă: un contor aparține unei parcele, un client ajunge pe parcelă printr-o ocupare, iar consumul contorului merge către acel client. Acest exemplu urmărește contorul de electricitate de pe parcela 12 de la Recreatiepark Het Meer, de la asociere până la factura lui Jonas Maes. La sfârșit se explică cum poate Tillor să creeze și să trimită singur această factură. ```mermaid flowchart LR A[Contor] -->|asociere| B[Parcela 12] B --- C[Ocuparea lui Jonas] A -->|citiri| D[Consumul lui Jonas] D --> E[Consum nefacturat] E --> F[Factură] F -.->|automat| G[Factură de utilități în ziua stabilită] ``` Înainte de a începe: - Contorul există deja sub Parc > Contoare și nu este încă asociat unei parcele. Un contor care este deja asociat unei parcele nu apare în lista de alegere. - Jonas are o ocupare activă pe parcela 12. Vedeți [Înscrierea unui client de sezon](/praktijk/seizoensklant-binnenhalen). Fără ocupare, Tillor nu știe cui îi aparține consumul. - Pentru factura automată, Jonas are nevoie de o adresă de e-mail sau de un număr de telefon, iar pentru încasarea automată de un mandat activ. ## Traseul pas cu pas [#de-route-stap-voor-stap] ### Asociați contorul la parcela 12 [#koppel-de-meter-aan-terrein-12] Mergeți la Parc > Terenuri, deschideți parcela 12 și derulați până la cardul **Contoare**. Faceți clic pe **Adăugați contor**, alegeți contorul și faceți clic pe **Atribuiți contor**. Vedeți [Gestionarea contoarelor](/meterbeheer/meter-koppelen) și [Parcele](/terreinen). ### Înregistrați citirea inițială [#leg-de-beginstand-vast] Dacă Jonas este deja înscris pe parcela 12, completați citirea inițială la ocupare. Dacă abia creați ocuparea, completați **Citiri inițiale ale contoarelor**. Dacă lăsați câmpul gol, Tillor preia ultima citire cunoscută. Astfel primul lot de consum pornește imediat de la citirea corectă. Vedeți [Ocupări](/bezettingen#een-bezetting-aanmaken). ### Urmăriți citirile contorului [#volg-de-meterstanden] Contoarele inteligente își transmit singure citirea, de obicei zilnic sau săptămânal. Un contor manual îl citiți și îl introduceți dumneavoastră. Vedeți [Gestionarea contoarelor](/meterbeheer). Consumul îl vedeți în două locuri. Pe pagina contorului, sub Parc > Contoare, se află cardul **Consum** cu consumul deschis și cel decontat pe client. Pe profilul lui Jonas se află cardul **Citiri**, cu toate contoarele de pe parcelele lui. Dacă cineva introduce o citire mai mică decât cea anterioară, Tillor avertizează. Dacă citirea este totuși corectă (contorul a fost înlocuit), Tillor închide perioada în curs și începe una nouă. Vedeți [Loturi de consum](/meterbeheer/consumptie-batches). ### Vedeți ce este nefacturat [#bekijk-wat-openstaat] Mergeți la Clienți > Consum nefacturat. Vedeți pe client suma totală, **Ultima factură de utilități** și numărul de contoare. Jonas apare în listă de îndată ce există consum care nu se află încă pe o factură. ### Creați factura [#maak-de-factuur] Aveți două modalități. Faceți clic la sfârșitul rândului lui Jonas pe pictograma de trimitere. Fereastra **Creați factura** arată suma totală, repartizarea pe tipuri și numărul de contoare. Bifați canalele prin care Tillor trimite factura imediat și faceți clic pe **Creați factura**. Tillor creează factura, o înregistrează și o trimite. Dacă Jonas are un mandat pentru facturile de utilități, acesta este preselectat la **Încasează prin mandat**. Deschideți profilul lui Jonas și faceți clic în cardul **Citiri** pe **Facturați consumul**. Tillor pune pentru fiecare perioadă de consum o linie principală cu dedesubt o linie de informare cu data și citirile contorului. Dacă există deja o factură ciornă potrivită, liniile se adaugă pe ea. Verificați factura, înregistrați-o și trimiteți-o dumneavoastră. Vedeți [Înregistrarea unei facturi](/facturen/boeken) și [Trimiterea unei facturi](/facturen/versturen). ### Lăsați Tillor să o facă singur [#laat-tillor-het-zelf-doen] Deschideți profilul lui Jonas, mergeți la Clienți > Jonas Maes > Facturare și deschideți cardul **Setări de facturare**. Acolo setați: - **Facturare automată a utilităților**: o zi a lunii. Dacă alegeți 31 și luna nu are 31 de zile, factura se emite în ultima zi a lunii. - **Mandat**: mandatul cu care Tillor încasează factura de utilități. Vedeți [Încasarea unei facturi](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen). - **Sumă minimă**: o limită inferioară proprie pentru Jonas. Dacă o lăsați goală, se aplică minimul organizației de sub Asistență > Setări > Facturare. În ziua aleasă, Tillor creează singur factura și o trimite. Dacă suma nefacturată este sub minim, Tillor așteaptă până la următoarea zi de facturare. ## Ce se întâmplă după aceea? [#wat-gebeurt-er-daarna] - Perioadele de consum facturate sunt finalizate. Dacă ocuparea continuă, Tillor începe o perioadă nouă de la citirea finală a celei anterioare, astfel încât să nu apară goluri. - Dacă factura este înregistrată, ea parcurge același drum ca orice altă factură: plată, somație și raport de plăți. Vedeți [Înscrierea unui client de sezon](/praktijk/seizoensklant-binnenhalen). - La încheierea ocupării, Tillor închide perioadele deschise. Consumul până la data de încheiere rămâne păstrat și îl puteți încă factura. - Dacă ștergeți o factură ciornă cu consum, consumul revine în **Consum nefacturat**. Dacă consumul nefacturat de electricitate sau apă este cel puțin dublul a ceea ce consumă Jonas de obicei, Tillor nu creează factura automată. Primiți un e-mail la adresa de asistență a organizației. Verificați citirea contorului și facturați consumul dumneavoastră dacă totul este în ordine. ## Probleme? [#problemen] Lista arată doar contoare fără parcelă. Dacă contorul este deja asociat altei parcele, dezasociați-l mai întâi prin meniul de la contor pe acea parcelă, cu **Dezasociați de la parcelă**. Consumul merge către clientul cu o ocupare activă pe parcelă. Verificați dacă Jonas are o ocupare pe parcela 12 și dacă contorul este asociat parcelei. Lista arată implicit doar clienții fără facturare automată. Setați filtrul **Facturare automată** pe **Cu dată** pentru a vedea clienții cu o zi de facturare automată. Există două motive frecvente. Suma nefacturată este sub minim, caz în care Tillor așteaptă următoarea zi de facturare. Sau consumul este mult peste cel obișnuit, caz în care primiți un e-mail la adresa de asistență, iar factura nu se emite până când cineva o verifică. Vedeți [Gestionarea contoarelor](/meterbeheer/verbruik-factureren#automatisch-factureren). Deschideți perioada în cardul **Citiri** sau **Consum**, faceți clic pe pictograma de avertizare de lângă perioadă și confirmați cu **Da, marchează ca facturat**. Perioada se închide atunci fără factură. Acest lucru poate fi anulat doar pentru perioadele fără legătură cu o factură. ## Vezi și [#zie-ook]