# Resumen (/es-ES/aan-de-slag) En esta página recorre su primer día en Tillor: desde iniciar sesión hasta su primera factura. El orden importa, porque cada parte se apoya en la anterior. Una ocupación, por ejemplo, necesita un cliente y una parcela, así que los crea primero. Si prefiere seguir un ejemplo de la vida real, consulte [Uit de praktijk](/praktijk). Si encuentra una palabra que no conoce, búsquela en [Begrippen](/begrippen). ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Estos son los componentes básicos y lo que necesita cada uno: ```mermaid flowchart LR I[Instellingen] --> T[Terreinen] T --> B[Bezetting] T --> R[Reservering] K[Klanten] --> B K --> R P[Producten] --> F[Factuur] K --> F B --> F R --> F F --> Bet[Betaling] ``` Una factura siempre pertenece a un cliente. Un cliente en una parcela durante un periodo largo se llama ocupación; una estancia con fecha de entrada y de salida se llama reserva. Los productos no son obligatorios, pero hacen que el precio, el IVA y las acciones de la línea de factura sean correctos. - Si tiene más de una organización, elige una después de iniciar sesión. Si le falta alguna, pida a su administrador que le invite. - Los apartados del menú que ve dependen de sus permisos. Si no ve algo, pida el permiso a su administrador. - Sin parcela no puede crear una ocupación. Sin cliente no puede crear una reserva, una ocupación ni una factura. - Los pagos en efectivo, por transferencia y otros pagos manuales funcionan sin vinculación. Para pagar en línea o con terminal de pago, vincule Mollie. - La forma más rápida de encontrar algo es buscar con **Ctrl+K** o **⌘K**. Antes de empezar: - Tiene una cuenta de Microsoft, Google o Apple y su administrador le ha invitado a su organización. Sin invitación no verá ninguna organización. - Tiene los permisos para lo que quiere hacer. Si le faltan, no aparece el apartado del menú o el botón está en gris. ## Configurar su parque [#je-park-inrichten] ### Inicie sesión y elija su organización [#log-in-en-kies-je-organisatie] Inicie sesión con su cuenta de Microsoft, Google o Apple. Si tiene acceso a más de una organización, elija una. Si todavía no tiene acceso, pida a su administrador que le invite. Consulte [Inloggen](/inloggen). ### Revise los ajustes de la organización [#loop-de-organisatie-instellingen-na] Abra Soporte > Ajustes. En **General** compruebe la zona horaria y el país predeterminado, y en **Horario de apertura** introduzca su horario. En **Facturación** encontrará, entre otros, el plazo de vencimiento predeterminado y los tipos de IVA. Invite a sus compañeros en **Usuarios**. Consulte [Organisatie](/gebruikers/organisaties). ### Cree sus parcelas [#maak-je-terreinen-aan] Vaya a Parque > Parcelas y añada sus plazas, como parcelas, chalets y plazas fijas. Sin parcela no puede crear una ocupación, y los contadores se vinculan a una parcela. Consulte [Terreinen](/terreinen). ### Cree sus productos [#maak-je-producten-aan] Vaya a Administración > Productos y cree las tarifas y los servicios que aparecerán en las facturas, como las noches de estancia. Una línea de factura también puede ir sin producto, pero con un producto el precio, el IVA y las posibles acciones quedan bien desde el principio. Consulte [Producten](/producten). ### Añada sus clientes [#voeg-je-klanten-toe] Vaya a Clientes > Resumen y cree un cliente. Las reservas, las ocupaciones y las facturas siempre pertenecen a un cliente. Consulte [Klantenbeheer](/klantenbeheer). ### Cree una reserva o una ocupación [#maak-een-reservering-of-bezetting-aan] Una reserva es para una estancia con fecha de entrada y de salida, y también puede crearla sin una parcela fija. Una ocupación vincula a un cliente con una parcela durante un periodo largo, por ejemplo una plaza anual. Consulte [Reserveringen](/reserveringen) y [Bezettingen](/bezettingen). ### Cree su primera factura [#maak-je-eerste-factuur] Abra el perfil del cliente y cree allí una factura nueva. Añada líneas, contabilice la factura y envíela. Consulte [Facturen](/facturen). ### Vincule los pagos [#koppel-betalingen] Si quiere que los clientes paguen en línea o con terminal de pago, vincule Mollie en Soporte > Ajustes, en **Integraciones**. Los pagos en efectivo, por transferencia y otros pagos manuales funcionan sin vinculación. Consulte [Betalingsverwerking](/betalingsverwerking) y [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie). Si utiliza contadores, barreras o etiquetas NFC, los configura después. Consulte primero [Park](/park) y [Toegangscontrole](/toegangscontrole). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Sus clientes, parcelas y productos están listos, de modo que puede crear reservas, ocupaciones y facturas a diario. - Su primera factura queda como borrador en el cliente. Solo después de **Contabilizar** recibe un número definitivo, y a partir de entonces puede enviarla y hacer que se pague. - Si ha vinculado Mollie, los clientes pueden pagar en línea o con terminal de pago, y el pago vuelve automáticamente a la factura. ## Orientarse [#je-weg-vinden] El menú principal está a la izquierda. Arriba cambia de organización si tiene más de una. Los apartados que ve dependen de sus permisos. | Menú | Para qué sirve | |------|----------------| | **Panel** | Pantalla de inicio con las llegadas y salidas de hoy | | **Reservas** | Estancias y el calendario de reservas | | **Tareas** | Repartir y seguir el trabajo | | **Control de acceso** | Puntos de acceso y registro de accesos | | **Clientes** | **Resumen** y **Consumo pendiente** | | **Parque** | **Mapa**, **Parcelas**, **Contadores**, **Armarios de contadores** y **Tiempo** | | **Comunicaciones** | **Llamadas telefónicas**, **Notificaciones** y **Comentarios** | | **Administración** | **Documentos**, **Firmas**, **Facturas**, **Pagos**, **Transacciones bancarias** (con el permiso para verlas), **Informes de pago**, **Cola de impresión** y **Productos** | Bajo el encabezado **Administrador** están **Automatizaciones** (con el permiso para verlas) y **Controladores**. Abajo, en **Soporte**, encontrará sus avisos, la **Bandeja de entrada** y el **Registro de auditoría** (con los permisos correspondientes), **Ajustes** y **Más recursos** con la documentación. Los apartados que ve dependen de sus permisos. Para buscar use **Buscar** en la cabecera, o **⌘K** (Mac) o **Ctrl+K** (Windows). Así salta directamente a un cliente, una factura, una reserva o una parcela. Consulte [Zoeken](/zoeken). Su propia cuenta, sus sesiones y sus claves API están en su nombre, abajo en el menú. ## ¿Problemas? [#problemen] Su administrador debe invitarle primero. Inicie sesión con la cuenta con la que le ha invitado. Consulte [Inloggen](/inloggen). Solo ve los apartados para los que tiene permisos. Pida a su administrador el permiso, o el rol que lo incluye. No hay ninguna parcela disponible, o el cliente todavía no existe. Cree primero una parcela y un cliente. Una parcela con una ocupación en curso no aparece en la lista de selección. Use **Buscar** en la cabecera, o busque en este manual con la barra de búsqueda de arriba. ## ¿Necesita ayuda? [#hulp-nodig] - Si busca algo en este manual, use la barra de búsqueda de arriba o elija en Tillor **Más recursos > Documentación**. - ¿Tillor no funciona como esperaba? Compruebe primero el [estado del sistema](https://status.tillor.eu) por si hay incidencias o mantenimiento programado. - ¿Le falta acceso a una organización, o quiere cambiar los datos de la empresa en las facturas? Escriba a support@tillor.eu. - ¿Quiere recuperar datos de una copia de seguridad? Consulte [Gegevens en back-ups](/gegevens-backups). ## Conceptos [#begrippen] - **Organización**: su cuenta de Tillor, normalmente su empresa. Consulte [Begrippen](/begrippen#organisatie). - **Parque**: el lugar físico. Consulte [Begrippen](/begrippen#park). - **Cliente**: una persona o empresa en Tillor. Consulte [Begrippen](/begrippen#klant). - **Parcela**: una plaza de su parque. Consulte [Begrippen](/begrippen#terrein). - **Ocupación** y **reserva**: un cliente en una parcela durante un periodo largo, o una estancia con fecha de entrada y de salida. Consulte [Begrippen](/begrippen#bezetting). - **Contabilizar**: dar carácter definitivo a una factura. Consulte [Begrippen](/begrippen#boeken). ## Véase también [#zie-ook] # Conceptos (/es-ES/begrippen) Tillor usa algunas palabras más a menudo de lo que está acostumbrado, y algunas se parecen entre sí. En esta página figura, para cada concepto, qué significa y dónde puede leer más. La lista sigue el orden alfabético de los términos originales en neerlandés. Si busca algo sobre los propios controladores, como ACL o firmware, consulte el [glosario de los controladores](/controllers/lexicon). Una **ocupación** es un cliente que permanece en una parcela durante un periodo largo, como un cliente de temporada. Una **reserva** es una reserva para una sola estancia. Con **contabilizar** Tillor siempre se refiere a dar carácter definitivo a una factura, nunca a reservar una estancia. ### Recordatorio de pago [#aanmaning] Un aviso a un cliente de que una factura contabilizada todavía no está pagada. Lo envía por factura, con el mismo enlace para pagar en línea. Consulte [Een aanmaning versturen](/facturen/versturen#een-aanmaning-versturen). ### Automatización [#automatisering] Una regla que Tillor ejecuta por sí solo: cuando ocurre esto, haz aquello. Por ejemplo, crear una tarea de seguimiento cuando termina una ocupación. Los pasos de una automatización forman juntos un flujo, el dibujo en el lienzo. Consulte [Automatiseringen](/automatiseringen). ### Pago [#betaling] Un importe que un cliente paga o que todavía está en camino, con un método, un estado y normalmente una factura. Los encuentra en Administración > Pagos. Consulte [Betalingen terugvinden](/betalingsverwerking/betalingen-bekijken). ### Grupo de pagos [#betalingsgroep] Un conjunto de pagos bajo un mismo nombre, que luego vincula de una vez a una factura contabilizada. Por ejemplo, todos los pagos con tarjeta de un día. Consulte [Betalingsgroepen](/betalingsverwerking/groepen). ### Informe de pagos [#betalingsrapport] El resumen de todos los pagos de un día natural, pensado para su contabilidad. El informe de hoy es un borrador y pasa a ser definitivo cuando termina el día. Consulte [Betalingsrapporten](/boekhouden/betalingsrapporten). ### Página de evidencia [#bewijspagina] Las páginas al final de un PDF firmado, con el título del documento, quién firmó y cuándo, y dos huellas digitales. Se llaman **Evidencia de la firma** y muestran más adelante que el documento no se ha modificado. Consulte [Bewijs en geldigheid](/handtekeningen/bewijs-en-geldigheid). ### Ocupación [#bezetting] Un cliente que está en una parcela durante un periodo largo. Mientras la ocupación está en curso, Tillor le imputa el consumo de los contadores de esa parcela. Una parcela tiene como máximo un cliente a la vez. Consulte [Bezettingen](/bezettingen). ### Contabilizar [#boeken] Dar carácter definitivo a una factura en borrador. La factura recibe un número de factura y después ya no puede modificarla libremente. En Tillor la palabra no tiene nada que ver con reservar. Consulte [Een factuur boeken](/facturen/boeken). ### Borrador [#concept] Una factura que todavía no está contabilizada. Todavía puede modificar las líneas y aún no ha llegado nada al cliente ni a la contabilidad. Consulte [Statussen van een factuur](/facturen/statussen). ### Conector [#connector] Una pequeña caja en la red de su parque que conecta Tillor con los dispositivos in situ, como impresoras y controladores de acceso. Tillor la entrega preconfigurada y la actualiza por sí mismo. Consulte [Connector](/connector). ### Controlador [#controller] Una caja con pantalla táctil en su parque, junto a una ducha o una puerta. Lee una etiqueta NFC o un código QR, y Tillor decide si el huésped puede pasar. Gestiona los controladores en **Controladores**. Consulte [Controllers](/controllers). ### Nota de abono [#creditnota] Una factura con importes negativos que anula una factura anterior. La aplicación la llama **factura de abono**. La crea con **Rectificar factura**. Consulte [Een factuur omkeren](/facturen/corrigeren#een-factuur-omkeren). ### Campo personalizado (Eigen veld) [#eigen-veld] Un campo que su organización añade por sí misma a un cliente, parcela, ocupación, contador o tarea, además de los campos que trae Tillor. Los gestiona en Ajustes > Campos personalizados. Consulte [Eigen velden](/eigen-velden). ### Factura [#factuur] Lo que cobra a un cliente, con líneas por producto. Una factura nueva siempre es un borrador. La crea en el perfil del cliente y gestiona todas las facturas en Administración > Facturas. Consulte [Facturen](/facturen). ### Evento [#gebeurtenis] Una línea en la cronología de un cliente, factura u otro registro que muestra qué ha ocurrido, quién lo ha hecho y qué ha cambiado. Consulte [Activiteitenlog](/activiteitenlog). ### Usuario [#gebruiker] Una cuenta con acceso a Tillor. En el texto corriente llamamos compañero a otro usuario. Gestiona los usuarios y sus permisos en Ajustes > Usuarios. Consulte [Organisatie](/gebruikers/organisaties). ### Grupo [#groep] Un conjunto fijo de compañeros, por ejemplo **Recepción**. Asigna tareas a un grupo, comparte vistas con un grupo y puede dar o quitar permisos a un grupo. Consulte [Groepen](/gebruikers/groepen). Un grupo de pagos es otra cosa. ### Libro mayor [#grootboek] El número de cuenta de su contabilidad en el que se contabiliza un producto. Lo rellena en el producto y se envía al transferirlo a su contabilidad. Consulte [Het grootboeknummer](/producten/product-aanmaken#grootboeknummer). ### Domiciliación [#incasso] Tillor cobra por sí mismo el importe de una factura de la cuenta bancaria del cliente. Solo es posible con un mandato activo. Consulte [Een factuur incasseren](/betalingsverwerking/incasso). ### Lista de opciones [#keuzelijst] Una lista fija de opciones de la que toma sus valores un campo personalizado de tipo **Opción** u **Opción múltiple**. Crea la lista una vez y la usa en varios campos. Consulte [Keuzelijsten](/eigen-velden/keuzelijsten). ### Kiosco [#kiosk] Una tableta Android que muestra la aplicación de Tillor y se queda ahí, de modo que los huéspedes no puedan acceder a los ajustes del dispositivo. Consulte [Een kiosk inrichten](/mobiele-app/kiosk-inrichten). ### Cliente [#klant] El registro en Tillor de una persona o empresa: datos, facturas, ocupaciones, métodos de acceso y más. La palabra huésped solo la usamos en el texto corriente para quien se aloja en su parque. Consulte [Klantenbeheer](/klantenbeheer). ### Mandato [#mandaat] La autorización de un cliente para cobrar facturas de su cuenta bancaria (un mandato SEPA). El cliente lo firma en el propio Tillor. Consulte [Een SEPA-mandaat laten ondertekenen](/betalingsverwerking/mandaat). ### Contador [#meter] Un aparato de agua, electricidad o gas. Un contador pertenece a una parcela, no a un cliente. El consumo va al cliente que en ese momento tiene una ocupación en la parcela. Consulte [Meterbeheer](/meterbeheer). ### Armario de contadores [#meterkast] Un armario donde hay contadores. En Parque > Armarios de contadores gestiona los armarios y los contadores asignados a ellos. Consulte [Park](/park#meterkasten). ### Etiqueta NFC [#nfc-tag] Una tarjeta, pulsera o llavero que un huésped acerca a un controlador, por ejemplo para la ducha o un punto de acceso. Una etiqueta puede tener saldo. Consulte [NFC](/nfc). ### Notificación [#notificatie] Un mensaje que Tillor envía a un cliente o compañero por correo electrónico, SMS, correo postal, WhatsApp o notificación push. En Comunicaciones > Notificaciones ve si ha llegado. Consulte [Notificaties](/notificaties). ### Solicitud de firma [#ondertekenverzoek] La solicitud para que una o más personas firmen en línea un PDF, como un contrato de alquiler, una tras otra. Las gestiona en Administración > Firmas. Consulte [Handtekeningen](/handtekeningen). ### Consumo pendiente (Openstaand verbruik) [#openstaand-verbruik] Consumo de contadores que todavía no figura en una factura. Lo ve por cliente en Clientes > Consumo pendiente y lo factura con **Facturar consumo**. Consulte [Meterbeheer](/meterbeheer/verbruik-factureren). ### Comentario [#opmerking] Una nota interna en un cliente, factura, reserva u otro registro. Los comentarios nunca son visibles para el cliente. Consulte [Opmerkingen](/notities). ### Organización [#organisatie] Su cuenta de Tillor, es decir, su empresa con sus usuarios, ajustes y datos. El parque es el lugar físico. Consulte [Organisatie](/gebruikers/organisaties). ### Parque [#park] El lugar físico: su camping o parque de vacaciones. En **Parque** encuentra el mapa, las parcelas, los contadores y los armarios de contadores. Consulte [Park](/park). ### Peppol [#peppol] Una red europea con la que envía facturas electrónicas directamente al sistema contable del destinatario, sin PDF. Para facturas belgas a empresas con número de IVA es obligatorio. Consulte [Peppol](/boekhouden/peppol). ### Producto [#product] Una tarifa o servicio que pone en una línea de factura, como una noche, el alquiler de la plaza o un kWh de electricidad. Un producto puede tener acciones que Tillor ejecuta al contabilizar o pagar. Consulte [Producten](/producten). ### Acción de producto [#productactie] Algo que Tillor hace automáticamente cuando se contabiliza o se paga una línea de factura con este producto, como prolongar una ocupación o recargar una etiqueta NFC. Consulte [Productacties](/producten/productacties). ### Permiso [#recht] Lo que un usuario puede hacer en Tillor, por ejemplo editar productos o restaurar facturas. Da permisos por usuario o mediante un grupo. Una denegación mediante un grupo siempre prevalece. Consulte [Rechten bewerken](/gebruikers/organisaties#rechten-bewerken) y [Groepsrechten](/gebruikers/groepen#groepsrechten). ### Reserva [#reservering] Una reserva para una sola estancia en una parcela, con llegada y salida. Una reserva no es lo mismo que una ocupación. Consulte [Reserveringen](/reserveringen). ### Tarea [#taak] Un trabajo para usted o un compañero, con, entre otras cosas, un plazo, subtareas y clientes o parcelas vinculados. Las tareas se ven en vistas. Consulte [Taken](/taken). ### Tableta [#tablet] El dispositivo de la recepción en el que funciona la aplicación de Tillor, por ejemplo para que un cliente firme un contrato o un mandato. Las tabletas, los kioscos y los teléfonos en los que alguien ha iniciado sesión los encuentra en **Ajustes**. Consulte [Tablets en kiosken](/mobiele-app/tablets-en-kiosken). ### Parcela [#terrein] Una plaza de su parque que alquila o en la que planifica estancias, con un nombre y, si procede, contadores. A una parcela vincula contadores, y los clientes llegan a ella mediante una ocupación o una reserva. Consulte [Terreinen](/terreinen). ### Tipo de parcela [#terreintype] Una clasificación de sus parcelas, como **Parcela**, **Chalet** o **Plaza de autocaravana**. Usa el tipo para filtrar la lista, colorear el mapa y en automatizaciones. Consulte [Terreintypes](/terreinen#terreintypes). ### Método de acceso [#toegangsmethode] La forma en que un cliente pasa por un punto de acceso: reconocimiento de matrícula, una etiqueta NFC o un código QR. Los gestiona en el cliente, en la pestaña **Control de acceso**. Consulte [Toegangscontrole](/toegangscontrole). ### Punto de acceso [#toegangspunt] Una barrera, verja o puerta electrónica donde se controla el acceso. Puede abrir y cerrar un punto de acceso desde Tillor y ver en el registro quién ha pasado. Consulte [Toegangscontrole](/toegangscontrole). ### Disparador [#trigger] El inicio de una automatización: el evento, el momento o el mensaje que la pone en marcha. Un disparador puede tener un filtro, de modo que la automatización solo se inicie si algo se cumple. Consulte [Triggers](/automatiseringen/triggers). ### Lote de consumo [#verbruiksbatch] Un periodo de consumo de contador para un cliente y un contador, con una lectura inicial y una final. La aplicación lo llama **periodo de consumo**; en este manual también aparece lote de consumo. Consulte [Consumptiebatches](/meterbeheer/consumptie-batches). ### Vista [#weergave] Una forma guardada de ver sus tareas, por ejemplo **Tareas abiertas** o **Mantenimiento**. Cada vista aparece como pestaña en la parte superior de la página Tareas. Consulte [Weergaven](/taken/weergaven). ### Sello [#zegel] La firma digital de su organización con la que Tillor cierra un PDF firmado. Si después cambia algo en el archivo, un lector de PDF lo avisa. También lleva un sello de tiempo. Consulte [Zegel en tijdstempel](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel). ## Véase también [#zie-ook] # Datos y copias de seguridad (/es-ES/gegevens-backups) Tillor hace copias de seguridad automáticas de los datos de su organización. No tiene que configurar nada y no las ve en Tillor. Si necesita datos del pasado o algo ha salido mal, el soporte de Tillor restaura por usted un estado anterior. Así lo solicita y hasta cuándo puede retroceder. - Las copias de seguridad llegan hasta el primer mes natural pasado, con un archivo por mes. Los detalles están en la tabla de abajo. - No restaura usted mismo: se hace siempre a través del soporte de Tillor. - No puede descargar ni ver una copia de seguridad por su cuenta. Antes de empezar: sepa qué datos necesita y desde qué momento o mes. ## ¿Cuánto tiempo conserva Tillor las copias de seguridad? [#hoe-lang-bewaart-tillor-back-ups] Tillor conserva tres tipos de copias de seguridad a la vez. Juntas le dan un punto de restauración reciente y un historial más largo. | Periodo | Qué puede recuperar | |---------|---------------------| | **Últimas 48 horas** | Una copia cada 4 horas, para restaurar a un momento reciente | | **Últimos 14 días** | Una copia por noche | | **Cada mes natural pasado** | Un archivo mensual por mes, sin eliminación automática | El mes natural en curso solo tiene las copias nocturnas de los últimos 14 días. En cuanto termina un mes, se conserva una copia de ese mes como archivo mensual. Los plazos valen para todas las organizaciones. Si Tillor cambia la política, modificaremos esta página. ## Pedir que se restaure una copia de seguridad [#een-back-up-laten-terugzetten] Restaurar no lo hace usted mismo en Tillor. El soporte de Tillor lo hace con usted, para que sus datos actuales no se sobrescriban por error. ### Reúna lo que quiere recuperar [#verzamel-wat-je-wilt-terughalen] Determine qué datos necesita, como facturas, clientes o reservas. Anote el momento o el periodo al que quiere volver, por ejemplo "ayer sobre las 14:00" o "marzo de 2026". ### Póngase en contacto con el soporte de Tillor [#neem-contact-op-met-tillor-support] Escriba a support@tillor.eu e indique el nombre de su organización, qué datos quiere recuperar y el momento o periodo deseado. ### Acuerde qué se recuperará exactamente [#overleg-wat-er-precies-terugkomt] El soporte de Tillor busca la copia que corresponde a su petición y habla con usted de lo que ocurrirá antes de que empiece la restauración. Restaurar puede devolver los datos a un estado anterior. Todo lo que haya introducido después del momento elegido puede desaparecer. Hable siempre antes de esto con el soporte de Tillor. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El soporte de Tillor busca la copia adecuada y habla con usted de lo que se recupera antes de que empiece la restauración. - Durante la restauración su organización está en modo de mantenimiento y solo los empleados de Tillor pueden acceder. Después todo vuelve a estar disponible. - Los datos que introdujo después del momento elegido pueden haber desaparecido. Por eso consúltelo siempre antes. ## ¿Problemas? [#problemen] No es posible en Tillor. Las copias de seguridad solo están disponibles para el soporte de Tillor. Pida al soporte que busque los datos que necesita. Para meses anteriores, Tillor conserva una copia por mes natural. Por tanto puede volver a un mes, pero no a un día o una hora concretos de ese mes. Para los últimos 14 días es posible por día, y para las últimas 48 horas cada 4 horas. Durante una restauración su organización está en modo de mantenimiento y solo los empleados de Tillor pueden acceder. Acuerde con el soporte de Tillor un momento que le convenga. Escriba al soporte de Tillor con el nombre de los datos y el momento de la eliminación. Mire antes en el [registro de actividad](/activiteitenlog) quién ha cambiado qué y cuándo. ## Véase también [#zie-ook] # Iniciar sesión en Tillor (/es-ES/inloggen) Inicia sesión en Tillor con una cuenta que ya tiene en Microsoft, Google o Apple. Tillor no tiene contraseña propia: su contraseña la gestiona ese proveedor. Después de iniciar sesión elige su organización y llega al panel. Si es su primer día, continúe con [Aan de slag](/aan-de-slag). Antes de empezar: - Necesita una cuenta de Microsoft, Google o Apple. - Un administrador debe haberle invitado antes como usuario con la misma dirección de correo electrónico. Si no ha ocurrido, verá **No se encontraron organizaciones**. ## Iniciar sesión [#inloggen] ### Abra Tillor [#open-tillor] Vaya en su navegador a la aplicación web de Tillor. Si ya ha iniciado sesión, Tillor le lleva enseguida a su organización. ### Elija su método de inicio de sesión [#kies-je-inlogmethode] Haga clic en **Iniciar sesión con Microsoft**, **Iniciar sesión con Google** o **Iniciar sesión con Apple**. El método con el que inició sesión por última vez está marcado con **Último uso**. ### Siga los pasos del proveedor [#volg-de-stappen-van-de-provider] Va a la pantalla de inicio de sesión de Microsoft, Google o Apple. En Microsoft y Google elige usted mismo qué cuenta usar. Después vuelve a Tillor. ### Elija su organización [#kies-je-organisatie] Si tiene acceso a más de una organización, verá una pantalla de selección. Busque su organización en la lista y haga clic en **Abrir**. Si solo tiene una, va directamente al panel. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Llega al panel de su organización. Tillor recuerda su último método de inicio de sesión y lo marca la próxima vez con **Último uso**. - Solo ve los apartados para los que tiene permisos. - Su sesión sigue activa en este dispositivo hasta 30 días sin uso o hasta que cierre sesión usted mismo. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Una persona tiene una cuenta de Tillor. Puede vincular esa cuenta a varios métodos de inicio de sesión. Un administrador le añade como usuario a una organización y le da permisos. Lo que ve después depende de esos permisos. ```mermaid flowchart LR A[Je Microsoft-, Google- of
Apple-account] --> B[Je Tillor-account] B --> C[Een of meer organisaties] C --> D[Jouw rechten
bepalen wat je ziet] ``` - Permanece con la sesión iniciada mientras use Tillor. Tras 30 días sin uso vuelve a iniciar sesión. - Un enlace de verificación de su dirección de correo es válido durante 15 minutos. Como máximo puede pedir un correo nuevo cada dos minutos. - Microsoft siempre está activado como método de inicio de sesión. Google y Apple pueden no estar, según su entorno de Tillor. - No puede desvincular su último método de inicio de sesión. ## Dar acceso a un compañero [#een-collega-toegang-geven] Un administrador con los permisos adecuados invita a los compañeros. ### Abra los usuarios [#open-de-gebruikers] Vaya a Soporte > Ajustes y elija **Usuarios**. ### Invite al compañero [#nodig-de-collega-uit] Haga clic en **Invitar usuario**, introduzca la dirección de correo electrónico y haga clic en **Invitar**. Si ya existe una cuenta de Tillor con esa dirección de correo, el compañero se añade directamente. Si no, recibe una invitación por correo electrónico y pasa a ser miembro en su primer inicio de sesión. Después configura los permisos, consulte [Organisatie](/gebruikers/organisaties). El compañero no verá nada útil hasta que se hayan configurado esos permisos. ## Gestionar su propia cuenta [#je-eigen-account-beheren] Haga clic en su nombre, abajo en el menú, y elija **Cuenta**. Allí encontrará: - **Correo electrónico**: si su dirección de correo está **Verificada** o **No verificado**. Si pone **No verificado**, verá el botón **Verificar dirección de correo**, consulte [Verificar su dirección de correo](#je-e-mailadres-verifiëren). - **Plataformas vinculadas**: vincule Microsoft, Google o Apple a la misma cuenta con **Conectar**, o elimine una vinculación con **Desconectar**. No puede desvincular su último método de inicio de sesión. - **Sesiones activas**: vea en qué dispositivos ha iniciado sesión. Con **Cerrar sesión** termina una sesión, con **Cerrar sesión en todos los demás dispositivos** todas las demás. - Su número de teléfono y el idioma de su cuenta. Permanece con la sesión iniciada mientras use Tillor. Tras 30 días sin uso vuelve a iniciar sesión. Para cerrar sesión elija **Cerrar sesión** en el menú bajo su nombre. ## Verificar su dirección de correo [#je-e-mailadres-verifiëren] Tillor toma su dirección de correo del proveedor con el que inició sesión por primera vez. Google y Apple indican que la dirección es suya. Microsoft normalmente no lo hace, y entonces su dirección aparece en la página **Cuenta** como **No verificado**. Mientras su dirección no esté verificada, Tillor no vincula un segundo método de inicio de sesión a su cuenta al iniciar sesión. Si, por ejemplo, inicia sesión por primera vez con Google y su cuenta se creó con Microsoft, verá el aviso de que la dirección ya pertenece a una cuenta que todavía no está verificada. Verifique su dirección una vez y después funcionará. ### Pida el correo de verificación [#vraag-de-verificatiemail-aan] Si ha iniciado sesión, haga clic en la página **Cuenta** en **Verificar dirección de correo**. Si no ha iniciado sesión y recibió el aviso en la página de inicio de sesión, introduzca allí su dirección de correo y haga clic en **Enviar correo de verificación**. Esa página da siempre la misma confirmación, incluso si no existe ninguna cuenta con esa dirección. ### Abra el correo [#open-de-e-mail] Recibe un correo con el asunto **Verifica tu dirección de correo para Tillor**. Haga clic en **Verificar dirección de correo**. El enlace es válido durante 15 minutos; si ha caducado, simplemente pida uno nuevo. ### Inicie sesión [#log-in] Tras hacer clic vuelve a la página de inicio de sesión o a su página de cuenta. Inicie sesión con el método que prefiera. A partir de ahora Tillor vincula a su cuenta un nuevo método de inicio de sesión con la misma dirección de correo. Como máximo puede pedir un correo de verificación nuevo cada dos minutos. Si no quiere esperar al correo, como usuario con la sesión iniciada también puede vincular enseguida un segundo método en **Cuenta > Plataformas vinculadas**. ## Claves API para vinculaciones [#api-sleutels-voor-koppelingen] Para vinculaciones técnicas gestiona las claves API en la página **Cuenta**. Abra **Desarrolladores** en su menú de perfil y haga clic en **Ir a Claves API**, o vaya a **Cuenta** > **Claves API**. Consulte [Ontwikkelaars](/ontwikkelaars) para la documentación de integración. ## ¿Problemas? [#problemen] Su cuenta existe, pero todavía no está vinculada a una organización. Pida a un administrador de su organización que le invite con la misma dirección de correo que la de su cuenta de Microsoft, Google o Apple. Ya existe una cuenta de Tillor con esta dirección, creada con otro método de inicio de sesión, y esa dirección todavía no está verificada. Debajo del aviso introduzca su dirección de correo y haga clic en **Enviar correo de verificación**, o inicie sesión con el método que usó antes y haga clic en la página **Cuenta** en **Verificar dirección de correo**. Consulte [Verificar su dirección de correo](#je-e-mailadres-verifiëren). Un enlace de verificación funciona 15 minutos. Pida uno nuevo en la página de inicio de sesión o en la página **Cuenta** y use el correo más reciente. Esta cuenta ya está vinculada a otro usuario, o la dirección de correo no coincide con su cuenta actual. Use la misma dirección de correo, o inicie sesión con la cuenta que ya está vinculada y desvincúlela allí primero. El inicio de sesión tardó demasiado o la página estuvo abierta demasiado tiempo. Haga clic de nuevo en su método de inicio de sesión y complete los pasos más rápido. Lo que ve depende de sus permisos. Pida a un administrador que ajuste sus permisos, consulte [Organisatie](/gebruikers/organisaties). Inténtelo una vez más. Si vuelve a fallar, escriba a support@tillor.eu e indique el mensaje. ## Véase también [#zie-ook] # Vraag het Tillie (/es-ES/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] # Novedades (/es-ES/wat-is-nieuw) Tillor recibe una actualización casi cada día. En esta página figuran los cambios que nota como administrador. Omitimos las pequeñas mejoras y correcciones de errores. ## Noviembre de 2026 [#november-2026] ### Tareas [#taken] - Filtra tareas por **Texto**: muestra solo las tareas cuyo nombre o descripción contiene, o justo no contiene, un texto, y añade tantos textos como quieras (por ejemplo **No contiene** `Verzekering vervallen:`). Consulte [Filtrar por texto](/taken/filteren#filteren-op-tekst). - Los filtros y ajustes de la vista integrada **Todas** ya se pueden guardar para toda la organización, con el permiso **Gestionar etiquetas y vistas compartidas**. Consulte [Guardar o descartar cambios](/taken/weergaven#wijzigingen-opslaan-of-verwerpen). ### Búsqueda [#zoeken] - La ventana de búsqueda muestra los resultados por categoría, con la categoría de la mejor coincidencia arriba y las tres mejores coincidencias de cada categoría. Con el botón **Todo** al principio del campo de búsqueda, o con **⌥1** a **⌥9** (**Alt** en Windows), busca en una sola categoría, incluso antes de escribir. Abajo encontrará los atajos de teclado y las categorías sin resultados. Consulte [Búsqueda](/zoeken). ### Manual [#handleiding] - Tillie ahora también puede mirar en tu cuenta: dale acceso de lectura a tu organización y pregunta por tus propios clientes, facturas o contadores. Propone un cambio, que solo se hace cuando lo confirmas. Consulta [Dejar que Tillie mire en tu cuenta](/vraag-het-tillie#tillie-in-je-account-laten-kijken). - Ahora eliges claro u oscuro una sola vez: el manual sigue el tema que elegiste en Tillor, y al revés. - Nuevo: [Pregunta a Tillie](/vraag-het-tillie). Haz una pregunta con tus propias palabras abajo a la derecha y Tillie responde a partir del manual, con las páginas que usó. - El manual ya existe también en otros idiomas: elija su idioma arriba a la derecha. Se abre automáticamente en el idioma que usa en Tillor. Una página que todavía no está traducida muestra el texto en neerlandés. ### Chat del sitio web [#website-chat] - Un visitante puede enviar ahora 10 mensajes por minuto y 200 por día por el chat, y todos los visitantes de una misma red juntos 30 por minuto. Por encima de eso, se le pide al visitante que espere un momento. Así un script no puede inundar tu bandeja de entrada y las respuestas de Tillie. Consulta [¿Problemas?](/inbox/website-chat#problemen). ### Contadores (ICY) [#meters-icy] - Tillor lee ahora ICY mediante la nueva API v2. En Ajustes > Integraciones > ICY introduzca el inicio de sesión de la API v2 y elija el número de su parque en la lista de selección; sin esos datos, los contadores ICY dejan de actualizarse. - Un contador ICY muestra qué **Módulo** hay en la posición (Campère o PRM) y, si ICY lo conoce, el **Número de serie del módulo**. Si ese número de serie cambia en ICY, aparece en la **Actividad** del contador. - La tarjeta **Controladores ICY** en Parque > Contadores muestra por controlador cuándo lo vio ICY por última vez, y cuántos contadores cuelgan de él. Las alarmas que ICY notifica en un controlador también aparecen ahora, y recibe por ellas la misma notificación push que por una alarma de contador. Un controlador con una alarma o que lleva más de una hora sin señal aparece arriba. Un controlador lleva el nombre de su armario de contadores (por ejemplo **MK6**) en lugar del número de ICY. Consulte [ICY-controllers](/meterbeheer/alarmen-en-status#icy-controllers). - Un contador ICY muestra ahora también su **Controlador** y el **Tiempo de desconexión**. Un tiempo de desconexión distinto del módulo aparece en la **Actividad** del contador. - La lista en Parque > Contadores tiene una columna **Módulo** (Campère o PRM), y el archivo de Excel de **Exportar todos los contadores** tiene en la hoja ICY la columna `module`. - En **Amperaje** solo quedan los valores hasta el máximo configurado en ICY para el módulo en esa posición. Antes, Tillor ofrecía en cada contador toda la lista del parque. - Las alarmas de ICY reciben un nombre fijo en su propio idioma, como **Sobrecorriente** o **Corte de corriente**, y los **Avisos** muestran ahora cuántas veces se ha usado ya el límite de conmutación. ### Desarrolladores [#ontwikkelaars] - **No es compatible con versiones anteriores:** en la API y en los eventos, las alarmas se llaman en adelante `integration-alarm`, porque ahora también pueden estar en un controlador ICY. Los eventos `meter-alarm:created` y `meter-alarm:resolved` se han sustituido por [`integration-alarm:created`](/ontwikkelaars/events#integration-alarm-created) y [`integration-alarm:resolved`](/ontwikkelaars/events#integration-alarm-resolved), y las rutas REST `/meter-alarms` por `/integration-alarms`. Los nombres antiguos ya no existen. Los webhooks y las automatizaciones existentes se han convertido automáticamente a los nuevos eventos; adapte en su propio código el nombre del evento y la ruta. El campo `meterId` de una alarma puede estar vacío; entonces `icyControllerId` está rellenado. - Un cliente OAuth se puede limitar ahora a las personas de su organización, y además a grupos y permisos: marque **Solo las personas de (su organización) pueden iniciar sesión** en la ventana del cliente, en Cuenta > Clientes OAuth. Pensado para el inicio de sesión único en un servicio externo. Consulte [Clientes OAuth](/ontwikkelaars/oauth-clients). - Cada endpoint de la [referencia de la API](/api-referentie) muestra ahora en **Acceso** quién puede llamarlo y qué permiso necesita un miembro. Una clave API con scopes también necesita ese permiso entre sus scopes. El [índice de eventos](/ontwikkelaars/events) muestra lo mismo para cada evento. ### Claves API [#api-sleutels] - Ahora puede limitar una clave API a los permisos que necesita una vinculación: active **Limitar a los permisos seleccionados** en la ventana de la clave, en Cuenta > Claves API. Una clave limitada nunca puede más que usted. Consulte [Rechten beperken](/ontwikkelaars/http#rechten-beperken). ### Campos personalizados [#eigen-velden] - Un campo de vinculación a contadores puede limitarse a los contadores de la parcela de la ocupación, y cualquier campo de vinculación a un registro listable puede filtrar sus opciones con TypeScript propio. Tillor rechaza al guardar un registro fuera de esa limitación. Las listas cortas (menos de 50 registros) las muestra la lista de selección enseguida, sin tener que escribir antes 2 caracteres. Consulte [Opties filteren](/eigen-velden/veldtypes#opties-filteren). - El mismo filtro también puede dar a una opción su propia etiqueta y un encabezado en la lista de selección, devolviendo un texto o `{ label, group }` en lugar de `true`. Consulte [Eigen labels](/eigen-velden/veldtypes#eigen-labels). ### Manual [#handleiding-1] - Novedad en el manual: [Begrippen](/begrippen), un glosario de todos los términos de Tillor, y [In de praktijk](/praktijk), cuatro ejemplos desarrollados que siguen un método de trabajo completo a través de los módulos, como captar a un cliente de temporada o cobrar el consumo. - Cada módulo empieza ahora con qué es, qué necesita y qué ocurre después, con un bloque **Conviene saber** y una lista **¿Problemas?** por tarea. También son nuevos [Gebruikers uitnodigen en rechten geven](/gebruikers/gebruikers-en-rechten), un resumen de todos los [tipos de notificación](/communicatie/notificatietypes) y páginas separadas por tarea para [contadores](/meterbeheer), [controladores](/controllers) e [impresoras](/printer). ### Firmas [#handtekeningen] - Los clientes, las personas de contacto y las partes externas pueden ahora firmar un documento también en la tableta de la recepción. Haga clic en su turno en **Firmar en tableta**, con código o sin código si ha comprobado usted mismo la identidad; la tableta muestra su nombre en letras grandes, también en un mandato SEPA. Consulte [Op de tablet aan de receptie](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie). - Con **Enviar**, el editor lo comprueba todo de una vez: un firmante sin campo de firma, o un cliente o persona de contacto sin dirección de correo ni número de móvil, se señala enseguida. Consulte [Ik kan niet versturen](/handtekeningen/handtekening-vragen#problemen). ### Transacciones bancarias [#banktransacties] - Haga clic en el icono (i) de una transacción bancaria para abrir su panel de detalle. Desde el menú de acciones crea una tarea sobre ella o copia un enlace que abre el panel directamente. Consulte [Banktransacties bekijken](/boekhouden/betalingsrapporten/betaalmethodes/ponto#banktransacties-bekijken). ### Productos y facturas [#producten-en-facturen] - La inversión del sujeto pasivo del IVA es ahora una opción en **IVA %**, junto a los tipos: para servicios de la UE y subcontratista, y también entrega intracomunitaria, exportación y exento. La factura recibe la mención legal, al contabilizar se pide un número de IVA donde hace falta, y la línea llega a Admisol en la casilla correcta. Para Odoo, introduzca por régimen el nombre del IVA de Odoo en los [ajustes de exportación](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo#btw-regimes); un precio programado también puede convertir un producto a un régimen. Consulte [Btw verlegd en andere regimes zonder btw](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw). - Registre importes anteriores a Tillor, como antiguas fianzas, como saldo inicial en la cuenta de un cliente: a mano o con una importación para todos los clientes a la vez. Cuentan en el saldo y en el control, pero no son una factura y no van a la contabilidad. Consulte [Beginsaldi van voor Tillor](/producten/product-aanmaken#beginsaldi-van-voor-tillor). - Un paquete de productos es ahora código: cada paso tiene un producto, una cantidad y una **Fórmula** opcional en TypeScript que, al guardar la factura, decide si el paso aparece en ella, con qué cantidad, o exactamente qué líneas (descripción propia, precio, método de acceso). La fórmula lee el cliente, la ocupación, la parcela y la línea principal, incluidos los campos personalizados, además de las listas de contadores y métodos de acceso. Las opciones fijas por contador, etiqueta NFC y perro han desaparecido; lo que hacían figura como fórmula de ejemplo en el manual. Consulte [Formule per stap](/producten/bundel-velden#formule-per-stap). - Controle el saldo de un cliente en un libro mayor, por ejemplo para fianzas. Tillor muestra el saldo en la factura y rechaza una factura que lo deje por debajo de cero. Con un permiso aparte se contabiliza igualmente, con una motivación en la cronología. Consulte [Het saldo van de klant bewaken](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). - En la pestaña **Facturación** de un cliente está la nueva tabla **Cuentas**: el saldo por libro mayor en el que se ha contabilizado algo, con debajo las facturas contabilizadas y la cuenta corriente. Si tiene libros mayores controlados, por defecto ve solo esos; con un filtro los ve todos. Consulte [Het saldo van de klant bewaken](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). ### Facturas y pagos [#facturen-en-betalingen] - Con **Enlace de pago parcial** en el menú de una factura contabilizada crea un enlace de pago para una parte del importe pendiente. Consulte [Een link voor een deelbetaling maken](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). - Un mandato SEPA firmado está sellado, de modo que un lector de PDF muestra cualquier modificación posterior. Consulte [SEPA-mandaat](/betalingsverwerking/mandaat). ### Usuarios y permisos [#gebruikers-en-rechten] - Un grupo puede permitir o denegar permisos a todos sus miembros; una denegación siempre prevalece. En **Editar permisos** ve por permiso si procede directamente o de un grupo. Consulte [Groepsrechten](/gebruikers/groepen#groepsrechten). ### Parque y técnica [#park-en-techniek] - Un controlador puede conocer varias redes wifi, en un orden que usted decide. Consulte [Controller instellingen](/controllers/settings). - En un contador, **Consumo y tendencias** muestra el consumo por hora de un día, con un nuevo selector de periodo. Consulte [Meterbeheer](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen). ### Tareas [#taken-1] - Imprima una tarea en A4 o en una impresora de tickets desde el menú de la tarea; la impresión muestra también los elementos vinculados y los bloqueos. En el mismo menú está **Eliminar**, salvo en las tareas que solo una automatización puede completar. Consulte [Taakdetails](/taken/taakdetails#het-menu-van-de-taak). - Añada subtareas mientras crea una tarea. Consulte [Een taak aanmaken](/taken/taakdetails#een-taak-aanmaken). - Una vista puede ocultar las tareas completadas pasado un día, una semana o un mes. Consulte [Voltooide taken verbergen](/taken/indelingen#voltooide-taken-verbergen). ## Octubre de 2026 [#oktober-2026] ### Parcelas [#terreinen] - La **Tarifa calculada** de una parcela sigue ahora una fórmula que escribe usted mismo por organización en Ajustes > Tarifa de parcela, con las mismas variables `{terrain.…}` que en las automatizaciones. Prueba la fórmula enseguida en una parcela, y cada parte con nombre recibe una columna en la exportación de parcelas. El resultado se guarda en la parcela y sigue cada cambio de la parcela o de la fórmula. Consulte [Tariefformule](/terreinen#tariefformule). ### Firmas [#handtekeningen-1] - Haga que clientes, personas de contacto, compañeros y partes externas firmen en línea un PDF, como un contrato de alquiler, uno tras otro. El PDF firmado con la página de evidencia va a los documentos del cliente. Consulte [Handtekeningen](/handtekeningen). - Un firmante también puede escribir su firma o rúbrica en lugar de dibujarla. Consulte [Zo ondertekent iemand](/handtekeningen/ondertekenen). - En el editor elige en **Campos para** para quién coloca los campos, y con **Firmante** pone un campo colocado a nombre de otra persona. Los campos se colocan tocando o arrastrando. Consulte [Plaats de velden](/handtekeningen/handtekening-vragen). ### Iniciar sesión [#inloggen] - Si su dirección de correo todavía está **No verificado**, la verifica con un clic desde la página **Cuenta** o desde la página de inicio de sesión. Solo entonces Tillor vincula un segundo método de inicio de sesión a su cuenta. Consulte [Je e-mailadres verifiëren](/inloggen#je-e-mailadres-verifiëren). ### Automatizaciones [#automatiseringen] - Con el paso **Ejecutar código** escribe un trozo de TypeScript sobre las variables del flujo, por ejemplo para decidir qué subtareas recibe una tarea. El resultado lo lee en pasos posteriores como `{result}`. Consulte [Code uitvoeren](/automatiseringen/logica#code-uitvoeren). - Un flujo puede **Sincronizar transacciones bancarias** primero y enviar después un recordatorio de pago, de modo que una factura recién pagada no reciba recordatorio. Guarde esa automatización desde la red de la oficina, y Tillor recordará la IP para la vinculación bancaria. Consulte [Banktransacties synchroniseren](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren). - Desactive los recordatorios de pago automáticos para un cliente o para una sola factura. Un flujo de recordatorios omite a los clientes que ya lo tienen activado. Consulte [Automatische herinneringen uitschakelen voor klant](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant). - En **Crear tarea** puede configurar que solo el flujo complete la tarea. Con **Eliminar tarea** quita esa tarea más tarde. Consulte [Taken](/automatiseringen/acties/taken). - En una acción de tarea puede activar **Pedir confirmación**. El compañero confirma entonces primero la elección, y después el flujo continúa. - Construya usted mismo automatizaciones en un lienzo: elija un disparador, añada pasos, condiciones y esperas y vea por ejecución qué ocurrió. Consulte [Automatiseringen](/automatiseringen). - Una automatización puede tener varios disparadores. Tillor bloquea los bucles en los que una automatización se inicia a sí misma una y otra vez. - Ahora se puede esperar hasta un momento fijo, un número de horas o minutos, o hasta que su organización cierre. - Inicie una automatización en una fecha de un registro, con un disparador programado o desde su propio sistema mediante un [webhook entrante](/ontwikkelaars/automatiseringen). - Con el paso **Pedir una decisión** crea usted mismo los botones en la tarea, con color e icono propios, si quiere con una nota obligatoria o una confirmación. Cada botón es una salida del paso. Consulte [Vraag om een beslissing](/automatiseringen/logica#vraag-om-een-beslissing). - El disparador **Se elige una acción de tarea** inicia una automatización cuando alguien elige un botón vinculado en una tarea. En un webhook entrante evita con **Ignorar repeticiones** que la misma llamada inicie el flujo dos veces. Consulte [Triggers](/automatiseringen/triggers). - **Esperar un evento** tiene una salida **Eliminado** para cuando desaparece el registro del flujo. Consulte [Logica](/automatiseringen/logica#wachten-op-een-gebeurtenis). - En el editor prueba con un registro real, pone **Marcos** alrededor de pasos y restaura una versión anterior mediante **Historial**. Consulte [Aan de slag](/automatiseringen/aan-de-slag#de-editor). ### Tareas [#taken-2] - En la lista de tareas ve todos los registros vinculados, y filtra por tipo con **Vinculado a**. Consulte [Filteren](/taken/filteren). - Los correos de tareas muestran una vista previa de la tarea. También encuentra tareas mediante [Zoeken](/zoeken). - Antes de que una tarea privada sea visible para toda la organización, Tillor pregunta si quiere hacerla pública. Consulte [Privétaken](/taken/prive-taken). - Tareas privadas, una vista de calendario y un temporizador que sigue corriendo mientras usted continúa trabajando. Consulte [Taken](/taken). - Comparta una vista como página de solo lectura o como enlace de calendario. Consulte [Taken delen](/taken/delen). - Los estados de espera se han unido en un único estado **Esperando respuesta**. - Asigne una tarea a un grupo, y comparta una vista con grupos de compañeros. Consulte [Wie ziet een weergave](/taken/weergaven#wie-ziet-een-weergave). - Una tarea puede tener botones de elección, si quiere con una nota obligatoria o una confirmación. Consulte [Taken met keuzeknoppen](/taken/taakdetails#taken-met-keuzeknoppen). - Pegue un archivo en la ventana de la tarea para añadirlo como adjunto. Los campos personalizados de las tareas también están en esa ventana. ### Bandeja de entrada [#inbox] - El correo de recordatorio del chat del sitio web abre ahora la conversación también en otro dispositivo o en otro navegador. Consulte [Herinnering per e-mail](/inbox/website-chat-instellingen#herinnering-per-e-mail). ### Notificaciones [#meldingen] - Elija por aviso si Tillor le avisa por correo electrónico o push. Lo configura en **Cuenta** en **Notificaciones**, o para un compañero mediante **Ajustes de notificaciones** en los miembros de la organización. Consulte [Gebruikers](/gebruikers). ### Tabletas y kioscos [#tablets-en-kiosken] - Cada tableta o kiosco tiene su propia página de dispositivo con acciones remotas, diagnóstico, historial y ajustes. Consulte [Tablets en kiosken](/mobiele-app/tablets-en-kiosken). - Bloqueo de kiosco, modo nocturno y notificaciones por dispositivo para tabletas Android. ### Facturas y pagos [#facturen-en-betalingen-1] - En una línea de factura con un periodo, elija la parcela en el mapa. Al contabilizar, Tillor crea la reserva y registra la entrada del huésped, según el producto. Consulte [Facturen](/facturen/aanmaken-en-bewerken#periode-en-terrein-kiezen). - Informes de pago en borrador para el día en curso. Consulte [Betalingsrapporten](/boekhouden/betalingsrapporten). - Si Mollie retiene una reserva de saldo en un pago, Tillor la contabiliza como *Reserva de saldo* en el proveedor Mollie en lugar de en la cuenta de espera, y al liberarla desaparece de allí. Consulte [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#balansreserve). - Los clientes reciben un recordatorio para firmar su mandato SEPA antes de que caduque. ### Clientes y archivos [#klanten-en-bestanden] - Los adjuntos, documentos y correos de Outlook los ve en un único visor de archivos, sin descargar. Los vídeos se pueden reproducir; las subidas pueden pesar hasta 250 MB. - El resumen de clientes muestra las estancias activas y atrasadas. La facturación automática se pausa ante un consumo de agua inusualmente alto. - En una parcela ve el historial de ocupaciones, con un enlace al cliente. ### Campos personalizados [#eigen-velden-1] - Añada usted mismo campos a clientes, parcelas, ocupaciones, contadores, tareas, productos, documentos, reservas y métodos de acceso, en Ajustes > Campos personalizados. Los coloca entre los campos estándar, hace que aparezcan bajo una condición y decide quién los ve o los edita. Consulte [Eigen velden](/eigen-velden). ### Productos [#producten] - Programe un precio nuevo desde una fecha con **Precios programados**; Tillor lo aplica ese día y le envía un correo. La **Calculadora de IVA** convierte un precio o lo ajusta con un porcentaje. Consulte [Een prijswijziging plannen](/producten/prijzen-plannen). ### Clientes [#klanten] - Arriba en un cliente está la tarjeta con los datos más importantes, con comentarios fijados. Se señalan los cumpleaños de clientes y parejas. Consulte [Klantenbeheer](/klantenbeheer). - Una dirección se rellena con **Calle**, **N.º** y **Puerta**, con sugerencias de dirección mientras escribe. Consulte [Klantenbeheer](/klantenbeheer#adres-invullen). ### Control de acceso [#toegangscontrole] - En un pase QR ve en qué wallet está, y con **Sincronizar pase de Wallet** lo deja de nuevo preparado. Consulte [Toegangscontrole](/toegangscontrole). ### Integraciones [#integraties] - Vincule Partoo para enviar automáticamente a su establecimiento su horario de apertura, sus temporadas y sus excepciones. Consulte [Partoo](/integraties/partoo). ## Septiembre de 2026 [#september-2026] ### Pagos [#betalingen] - Los mandatos SEPA los firma en el propio Tillor, a distancia o en la tableta de la recepción. Consulte [SEPA Mandaat](/betalingsverwerking/mandaat). - Una nueva página de pago con elección propia del método de pago, código QR y redirección a la aplicación de Bancontact. Tillor avisa si un método de pago tiene una incidencia. ### Control de acceso [#toegangscontrole-1] - Nuevo método de acceso: código PIN. Un código PIN puede convertirse automáticamente en una matrícula. Consulte [Toegangscontrole](/toegangscontrole#toegangsmethoden-beheren-via-het-klantprofiel). ### Tareas [#taken-3] - Vistas guardadas con un constructor de filtros, compartir con compañeros y un feed de calendario por vista. Consulte [Weergaven](/taken/weergaven). - Dependencias entre tareas, la prioridad **Urgente** y etiquetas que crea en línea. - Vincule una tarea a varios clientes, o a parcelas, contadores, facturas y reservas. ### Parque y comunicación [#park-en-communicatie] - Coloree las parcelas en el mapa por tipo y exporte el mapa como PDF en A4. Consulte [Kaart](/kaart). - Para la telefonía Voys: enrutamiento por cliente y buzón de voz automático. Consulte [Voys Telefonie](/communicatie/providers/voys). - Exporte a Excel el resumen de facturas de un cliente. # Buscar en Tillor (/es-ES/zoeken) Con la búsqueda encuentras de una sola vez un cliente, una factura, una ocupación, una reserva, una llamada telefónica, una parcela, un contador, una tarea o un informe de pago, desde cualquier página. No hace falta ir antes a la sección correcta. El resultado abre directamente la página adecuada. - En **Todos los resultados**, Tillor obtiene como máximo diez coincidencias por categoría y muestra las tres mejores. Elige una categoría para ver hasta cien. - En los clientes, Tillor también encuentra coincidencias con una pequeña errata, de modo que "Jansen" también devuelve "Janssen". - Las notas de las llamadas telefónicas están cifradas y no se buscan. Busca por el número de teléfono. - Las etiquetas NFC y las matrículas no tienen categoría propia. Las encuentras en **Clientes**. ## Buscar y abrir un resultado [#zoeken-en-een-resultaat-openen] ### Abre la ventana de búsqueda [#open-het-zoekvenster] Haz clic en **Buscar** en la cabecera (en una pantalla estrecha, en la lupa), o pulsa **⌘K** (Mac) o **Ctrl+K** (Windows). Con el mismo atajo cierras la ventana de nuevo. ### Escribe tu término de búsqueda [#typ-je-zoekterm] Los resultados aparecen en cuanto dejas de escribir un momento. Se agrupan por categoría, y la categoría con la mejor coincidencia aparece arriba: la primera línea es siempre la mejor coincidencia. Una buena coincidencia en el título pesa más que una coincidencia en la descripción. En cada categoría ves las tres mejores coincidencias, y con **Mostrar … más** abres la categoría entera. Abajo se indica en qué categorías no se ha encontrado nada. ### Limita a una categoría (opcional) [#beperk-tot-één-categorie-optioneel] Si solo quieres buscar en un tipo de datos, elígelo con el botón **Todo** al principio del campo de búsqueda, por ejemplo **Clientes**. Puedes hacerlo antes o después de escribir; luego el campo de búsqueda muestra **Buscar en Clientes…**. También puedes hacer clic en el nombre de una categoría en los resultados. Con el teclado: - **Shift+Tab** abre la lista de categorías. - **⌥1** a **⌥9** (**Alt+1** a **Alt+9** en Windows) elige una categoría directamente, en el orden de esa lista. El número también aparece junto al nombre de cada categoría en los resultados. - **Tab** recorre las categorías que tienen resultados. Para volver a todo: elige **Todo** en la lista o pulsa **Backspace** en un campo de búsqueda vacío. ### Abre el resultado [#open-het-resultaat] Usa las teclas de flecha para elegir y pulsa **Enter**. Con **Ctrl+Enter** (**⌘+Enter** en Mac) el resultado se abre en una pestaña nueva. También puedes hacer clic con el ratón. **Escape** cierra la ventana. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El resultado elegido abre el cliente, la factura u otra página en la misma pestaña. Con **Ctrl+Enter** (**⌘+Enter** en Mac) se abre en una pestaña nueva. - No cambia nada en tus datos: buscar solo lee. - En cada resultado se indica por qué se ha encontrado, por ejemplo **Teléfono:** o **Factura:** con el valor que coincide. ## Qué busca Tillor [#wat-tillor-doorzoekt] | Categoría | Por qué puedes buscar | |-----------|-----------------------| | **Clientes** | Nombre, número de cliente, correo electrónico, teléfono, dirección y localidad, número de IVA, observaciones, personas de contacto (nombre, correo electrónico, teléfono) y métodos de acceso como una tarjeta NFC o una matrícula | | **Facturas** | Número de factura (con o sin prefijo, año y separadores), importe total, el ID del enlace de la factura y las notas (públicas e internas) | | **Ocupaciones** | Nombre de la parcela, nombre y apellidos del cliente y el ID de la ocupación | | **Reservas** | Número de reserva (por ejemplo `RES/2026/0001`, con o sin prefijo y año, o compacto `20260001`), nota, nombre del cliente y el ID del enlace | | **Llamadas telefónicas** | Número entrante y saliente, ID de la llamada y referencia externa | | **Parcelas** | Nombre, descripción, ID y el número de contador de gas de la parcela | | **Contadores** | Nombre, número de serie e ID del contador | | **Tareas** | Título, descripción e ID. Una coincidencia también muestra el cliente o la parcela vinculados | | **Informes de pago** | Número de informe | No hay una categoría aparte para las etiquetas NFC. Las tarjetas NFC y otros valores de acceso pertenecen a **Clientes** y aparecen allí en cuanto coinciden con tu término de búsqueda. ## ¿Cuántos resultados ves? [#hoeveel-resultaten-zie-je] Si hay diez o más coincidencias en una categoría, aparece **10+** junto al nombre de esa categoría. En el resumen ves las tres mejores coincidencias por categoría. Elige la categoría, o haz clic en **Mostrar … más**, para ver hasta cien coincidencias. En reservas y facturas, la tolerancia a erratas funciona sobre todo con números y notas. ## Consejos de búsqueda [#zoektips] - **Matrícula, NFC o código QR**: busca el valor que figura en el cliente. Encontrarás al cliente en **Clientes**. - **Número de factura o de reserva**: escribe el número tal como figura en el documento, o una parte. Para `RES/2026/0042` también funcionan `2026/0042` y `20260042`. - **Importe**: una factura también se encuentra por el importe total, por ejemplo `120,50`. - **Quién está dónde**: busca en **Ocupaciones** por el nombre de la parcela o del cliente. - **Nombres parciales**: en los clientes suele bastar con una parte del nombre. En las reservas ayuda una palabra de la nota. ## ¿Problemas? [#problemen] Revisa la ortografía y prueba con una parte más corta del término. Si has elegido una categoría, Tillor busca solo en ella. Si hay resultados en otra categoría, la ventana lo indica. Elige **Todo** con el botón al principio del campo de búsqueda, o haz clic en **Quitar filtro**. Algo salió mal durante la búsqueda. Haz clic en **Reintentar**. Si sigue fallando, consulta el [estado del sistema](https://status.tillor.eu). Busca el valor exacto tal como figura en el cliente. Encontrarás al cliente en **Clientes**, no en una categoría aparte. Escribe el número tal como figura en el documento, o una parte: para `RES/2026/0042` también funcionan `2026/0042` y `20260042`. Si no, busca por el nombre del cliente. Las notas de las llamadas telefónicas se guardan cifradas y por eso no se pueden buscar. Busca por el número de teléfono. Algunos navegadores o extensiones usan Ctrl+K o ⌘K por su cuenta. En ese caso, haz clic en **Buscar** en la cabecera. ## Véase también [#zie-ook] # Registro de actividad (/es-ES/activiteitenlog) En el registro de actividad ves qué ha cambiado en Tillor, cuándo y quién lo ha hecho. Lo abres en un cliente, una factura, una tarea u otro registro, y de forma centralizada en **Registro de auditoría** si tienes los permisos para ello. Es un rastro de solo lectura que usas para comprobar o demostrar algo. - Una entrada no se puede editar ni eliminar - Una exportación incluye por defecto los últimos 30 días, y como máximo un año - Abrir repetidamente el mismo documento en diez minutos se registra una sola vez - Las horas se muestran en tu zona horaria - También aparecen las acciones de una automatización, de una clave API o del sistema, con el tipo de actor ## Ver el registro de actividad [#activiteitenlog-bekijken] En la app se llama normalmente **Eventos** o **Actividad**, según dónde estés. Quien tiene el permiso *Ver el registro de auditoría* puede además abrir una vista central mediante *Registro de auditoría* en la barra lateral (encima de Ajustes), con filtros por usuario, tipo de evento y fecha. | Dónde | Navegación | Etiqueta en la app | |------|-----------|-----------------| | Cliente (toda la actividad relacionada) | *Clientes > cliente > Eventos* | Eventos | | Factura | *Administración > Facturas > factura* | Eventos | | Reserva | *Clientes > cliente > Reservas > reserva* | Actividad | | Parcela | *Parque > Parcelas > parcela* | Eventos | | Contador | *Parque > Contadores > contador* | Actividad | | Producto | *Administración > Productos > producto* | Eventos | | Tarea | *Tareas > tarea* o *Clientes > cliente > Tareas > tarea* | Actividad | | Etiqueta NFC | *Controladores > Etiquetas NFC > etiqueta* | Actividad | | Tableta, quiosco o teléfono | *Ajustes > Tabletas y quioscos > dispositivo* | Historial | | Organización (central) | *Registro de auditoría* (encima de Ajustes, permiso *Ver el registro de auditoría*) | Registro de auditoría | | Informe de pago | *Administración > Informes de pago > informe* | Registro de eventos | Por cada actividad ves en la línea de tiempo: - **Título** - tipo de evento (p. ej. "Factura contabilizada", "Cliente actualizado") - **Usuario** - compañero que ejecutó la acción (o Tillor en las acciones automáticas) - **Hora** - fecha y hora relativa - **Descripción** - detalles adicionales; a veces con enlaces a facturas u otros registros relacionados - **Antes / después** (a veces) - al crear, modificar o eliminar datos de clientes, contactos, facturas, pagos, mandatos de pago, grupos de pago, documentos, métodos de acceso, puntos de acceso, controladores, parcelas, contadores, lecturas de contador, productos, ocupaciones, tareas o comentarios, además de escanear, asignar o desvincular un documento de identidad y los cambios en ajustes, derechos de miembros, facturación o NFC: qué campos se han modificado. Los códigos PIN de los puntos de acceso y los datos personales de un documento de identidad no se guardan en el registro - **Adjuntos** (a veces) - archivos descargables, por ejemplo en integraciones fallidas - **Inicio / cierre de sesión** - cuándo un compañero inicia o cierra sesión, visible en la vista central del registro de auditoría - **Apps OAuth y consentimiento** - crear, modificar, eliminar o rotar el secreto de apps OAuth, además del consentimiento concedido, denegado o revocado; visible en la vista central del registro de auditoría. Los secretos de cliente no se guardan en el registro - **Administración y seguridad** - cambios en el perfil de la organización (nombre, datos legales, IVA, IBAN, logotipo, modo de mantenimiento), invitaciones y nuevos miembros, claves API personales (crear, modificar, renovar, eliminar), sesiones finalizadas, webhooks, automatizaciones, grupos de compañeros, tipos de parcela, cuadros de contadores, grupos de controladores, integraciones instaladas o eliminadas y la aceptación del contrato de encargado del tratamiento; visible en la vista central del registro de auditoría. Las claves, los secretos de webhook y los ajustes de integración no se guardan; en una integración solo ves qué ajustes se han modificado - **Acceso a datos personales** - quién abrió o descargó un documento, vio o descargó las imágenes o los archivos de un documento de identidad, o abrió el PDF de una factura o lo envió a la tableta. Abrir repetidamente en diez minutos se registra una sola vez; cada descarga de un documento de identidad se registra por separado ## Actividad por registro [#activiteiten-per-record] En las páginas de detalle ves una línea de tiempo con la actividad de ese registro. En la pestaña **Eventos** de un cliente aparecen todas las actividades vinculadas a ese cliente (facturas, pagos, ocupaciones, etc.). En las **reservas** incluye, entre otras cosas, crear, hacer el check-in y el check-out, cancelaciones y reversiones relacionadas, y la actualización de los datos de la reserva. En los **grupos de pago** ves también qué pagos se han añadido a un grupo o retirado de él, y en los **controladores** qué solicitudes de adopción se han aprobado o rechazado. En los **informes de pago** incluye, entre otras cosas, la creación del informe, la finalización de un informe borrador y el envío a la contabilidad. En las **solicitudes de firma** ves cada paso: creada y modificada, enviada, enlace enviado (de nuevo), recordatorio, página de firma abierta, código enviado o introducido incorrectamente, firmada, rechazada, devuelta a borrador, cancelada, caducada y finalizada. Consulta [Prueba y validez](/handtekeningen/bewijs-en-geldigheid). En las **notificaciones externas** ves cuándo un sistema vinculado ha actualizado o eliminado una notificación que él mismo registró. El registro de actividad es de solo lectura. Las entradas no se pueden editar ni eliminar. ## ¿Quién lo hizo? [#wie-heeft-het-gedaan] Cada línea muestra, además del usuario, **qué tipo de actor** ejecutó la acción: un usuario con sesión iniciada, una clave API, una vinculación OAuth, una automatización, el conector de Tillor o el propio sistema. En una clave API o una vinculación OAuth, el id de esa clave o vinculación aparece en los detalles, de modo que si se filtra una clave ves exactamente qué se hizo con ella. Si pone **Desconocido**, Tillor no pudo determinar el actor; eso es deliberadamente distinto de "Sistema". ## Eventos de seguridad [#beveiligingsgebeurtenissen] Los inicios de sesión fallidos, las claves API y los tokens OAuth rechazados, el acceso denegado (permisos que faltan), los límites de solicitudes superados y la apertura de tu organización por parte de un administrador de Tillor también se muestran en el registro de actividad, con la dirección IP y el navegador. Los miembros con el permiso **Alertas de seguridad** reciben cada hora un aviso cuando se han modificado webhooks, claves API o automatizaciones, o cuando se ha denegado el acceso repetidamente. El acceso a tu cuenta que das a [Tillie](/vraag-het-tillie#tillie-in-je-account-laten-kijken) o retiras, y cada cambio que confirmas a través de Tillie, también aparecen aquí. ## Exportar para una auditoría [#exporteren-voor-een-audit] Con **Exportar** en el registro de actividad descargas todas las líneas del periodo elegido (por defecto los últimos 30 días, como máximo un año) como ZIP con el archivo de datos (CSV o JSON Lines), un `manifest.json` con el número de líneas, el periodo, quién exportó y la suma de comprobación SHA-256 del archivo de datos, y un archivo `CHECKSUMS.sha256` que puedes verificar con `sha256sum -c`. La propia exportación también queda registrada, con la misma suma de comprobación. También se registran la apertura del registro de actividad completo y las exportaciones masivas de datos de clientes (lista de clientes, registro de acceso, parcelas, contadores). Todas las horas se almacenan en **UTC** en servidores con sincronización horaria NTP y se muestran en tu zona horaria; la exportación contiene horas ISO 8601 en UTC. ## ¿Para qué usas el registro? [#waarvoor-gebruik-je-de-log] - **Control** - comprobar qué compañero contabilizó una factura o modificó un cliente - **Resolución de problemas** - averiguar cuándo se produjo un error - **Auditorías** - conservar un rastro completo para controles internos o externos ## Véase también [#zie-ook] # Primeros pasos (/es-ES/automatiseringen/aan-de-slag) En esta página construyes tu primera automatización y conoces el editor, la pantalla en la que dibujas los flujos. Necesitas el permiso **Gestionar automatizaciones**, o **Todos los permisos**. Consulta la [Vista general](/automatiseringen) para el contexto. ## La vista general [#het-overzicht] Ve a **Administrador > Automatizaciones**. Ves una lista con una fila por automatización: - el nombre y una etiqueta como **2 problemas** si aún hay algo mal en el flujo (consulta [Problemas y activación](/automatiseringen/problemen)) - la descripción - el disparador elegido, el número de pasos y quién creó la automatización (**por**) - una serie de barritas con las últimas ejecuciones, junto a la hora de la última ejecución o **Aún no se ha ejecutado**. Una barrita roja es una ejecución fallida - un interruptor para activar o desactivar la automatización, y un menú de tres puntos Encima de la lista filtras con **Todas**, **Activadas** y **En pausa**. Si una automatización tiene problemas, aparece además un filtro **Problemas**. Con **Buscar automatizaciones** buscas por nombre o descripción. Haz clic en el nombre para abrir el editor. Con el interruptor activas o desactivas una automatización. No se puede activar mientras haya problemas. El menú **Acciones de la automatización** tiene dos opciones: | Opción | Qué hace | |---|---| | **Duplicar** | Crea una copia con el nombre *[nombre] (copia)*. La copia está en pausa | | **Eliminar** | Elimina la automatización y el historial de ejecuciones. Tillor pide confirmación antes | Las ejecuciones que en ese momento esperan en un retraso se detienen si eliminas la automatización. ## Crear una automatización nueva [#een-nieuwe-automatisering-maken] Haz clic en **Nueva automatización**. Se abre una galería con seis puntos de partida. Cada paso se puede modificar después. | Punto de partida | Qué hace | |---|---| | **Empezar desde cero** | Un flujo vacío con solo un disparador | | **Revisar la parcela tras la salida** | Crea una tarea de control de la parcela cuando termina una ocupación, con prioridad alta y asignada a quien finalizó la ocupación | | **Dar seguimiento a facturas impagadas** | Espera a que pase la fecha de vencimiento, envía un recordatorio de pago y, una semana después, crea una tarea para llamar al cliente si la factura sigue pendiente | | **Enviar reservas a otro sistema** | Por cada reserva nueva envía un payload propio a tu endpoint de webhook y crea una tarea si falla la entrega | | **Revisar un contador que ha dejado de contar** | Crea una tarea para la recepción cuando un contador se queda parado mientras la parcela se ha usado, con subtareas para la revisión in situ | | **Llamar a la Tillor API** | Añade un comentario a cada tarea nueva mediante la Tillor API | En cuanto eliges, Tillor crea la automatización y abre el editor. La automatización está en pausa hasta que la actives. ## El editor [#de-editor] El editor ocupa toda la pantalla y tiene tres partes: a la izquierda la lista de pasos, en el centro el lienzo y a la derecha el panel. El nombre de la automatización está arriba, en la ruta de navegación, y puedes modificarlo ahí directamente. Pasa el cursor por las marcas ℹ para ver una breve explicación de cada parte. **Lista de pasos (izquierda).** Busca un paso con **Buscar pasos**. Arriba está el grupo **Utilidades** con **Comentario** y **Marco** (consulta [Comentarios y marcos](#opmerkingen-en-kaders)). Debajo están los pasos en seis grupos, con **Documentos** en medio: - **Lógica**: el disparador **Cuando ocurra esto** y condiciones, esperas, consultas y recorridos, como **Si / si no**, **Según el valor**, **Retraso**, **¿Abierto ahora?**, **Consultar un registro**, **Para cada** y **Pedir una decisión**. Consulta [Condiciones, interruptores y retrasos](/automatiseringen/logica) - **Tareas**: crear, buscar y actualizar tareas - **Documentos**: buscar y actualizar documentos - **Huéspedes y mensajes**: mensajes a huéspedes y compañeros, comentarios, la bandeja de entrada, clientes y reservas - **Facturas y pagos**: facturas, enlaces de pago, mandatos y consumo - **Acceso y dispositivos**: medios de acceso, barreras, electricidad, etiquetas NFC y tabletas - **Integraciones**: **Enviar webhook** y **Solicitud API** Lo que hace cada acción está en [Acciones](/automatiseringen/acties). Abajo está **Solicitar un paso** por si echas en falta un paso. **Lienzo (centro).** Aquí ves el flujo. Arriba está el disparador, debajo los pasos con líneas entre ellos. Abajo a la izquierda acercas y alejas. **Panel (derecha).** Arriba está el interruptor **Activo**, en caso de problemas un botón como **1 problema**, un botón **Ordenar** que coloca los pasos ordenadamente uno bajo otro (los comentarios se quedan donde están) y un botón **Ocultar panel**. Si ocultas el panel, **Mostrar panel** lo vuelve a mostrar. Debajo eliges una pestaña: | Pestaña | Qué haces en ella | |---|---| | **Configurar** | Modificar el paso seleccionado. Si no seleccionas nada, puedes rellenar una **Descripción** de la automatización | | **Ejecución de prueba** | Probar el flujo, consulta [Pruebas y ejecuciones](/automatiseringen/testen-en-uitvoeringen) | | **Ejecuciones** | Revisar qué hicieron las ejecuciones reales | | **Historial** | Ver y restaurar versiones guardadas anteriores, consulta [Versiones anteriores](#eerdere-versies) | Si has hecho cambios, abajo del panel aparece **Cambios sin guardar** con los botones **Revertir** y **Guardar**. **Revertir** devuelve el flujo a la última versión guardada. Si el panel está oculto, esos botones están arriba a la derecha en el lienzo. Mientras no hayas seleccionado ningún paso, debajo de la descripción aparece quién creó la automatización. Las ejecuciones fallidas se envían por correo a esa persona, como máximo una vez por hora y automatización. En un teléfono el panel está primero oculto, para que el lienzo ocupe toda la pantalla. Toca un paso o **Mostrar panel** para abrirlo. ### Añadir y conectar pasos [#stappen-toevoegen-en-verbinden] Tienes cuatro formas de añadir un paso: - Haz clic en un paso de la lista de la izquierda. Aparece en el centro del lienzo - Arrastra un paso de la lista al lienzo - Haz clic en el signo más bajo una salida que aún no lleva a ningún sitio (**Añadir un paso después de "[salida]"**) y elige un paso. El paso nuevo se conecta de inmediato - Arrastra un paso sobre una línea. Queda entre los dos pasos (**Insertar un paso aquí**) Para conectar pasos entre sí, arrastra desde la salida de un paso a otro paso. Se aplica lo siguiente: - Cada salida lleva a un paso. Si vuelves a conectar una salida, la línea nueva sustituye a la antigua - Se rechaza una línea que formaría un círculo. Si aun así hay un bucle, no puedes activar la automatización. Una ejecución se detiene en cuanto fuera a repetir un paso - Un paso sin línea de entrada nunca se ejecuta. Tillor lo indica como problema (**No está conectado, así que este paso nunca se ejecuta.**) - Un disparador se puede modificar, duplicar y añadir más desde la lista de la izquierda. No puedes eliminar el último disparador. Un disparador no va sobre una línea: inicia una ejecución propia Dale a un paso un nombre propio en el campo **Nombre del paso**. Ayuda cuando tu flujo crece. Con los botones **Duplicar paso** y **Eliminar paso**, arriba en el panel, copias o eliminas el paso seleccionado. ### Comentarios y marcos [#opmerkingen-en-kaders] Con un comentario explicas en el lienzo qué hace una parte del flujo, por ejemplo por qué hay una condición. Un **Marco** es una línea de puntos con un nombre que colocas alrededor de un grupo de pasos. - En el grupo **Utilidades**, haz clic en **Comentario** o **Marco** y escribe tu texto - Arrastra el comentario o el marco hasta los pasos que explican. Selecciónalos para hacerlos más grandes o más pequeños con las esquinas - Elimina un comentario con **Eliminar comentario** o un marco con **Eliminar marco**, o selecciónalos y pulsa Delete - Los comentarios y los marcos nunca se ejecutan y no cuentan para los problemas. Puedes colocar como máximo 50 entre ambos. Se conservan con **Guardar**, igual que los pasos, y Ctrl/Cmd + Z deshace un cambio ### Versiones anteriores [#eerdere-versies] Cada vez que guardas un cambio, Tillor conserva la versión anterior. En la pestaña **Historial** ves las versiones con lo que cambió, por ejemplo **1 paso añadido** o **Disposición o conexiones cambiadas**, y quién o qué hizo el cambio (por ejemplo **A través de la API**). Con **Restaurar** pones una versión en el lienzo. Eso cuenta como cambio sin guardar: guarda para conservar la versión, o deshaz. ### Atajos de teclado [#sneltoetsen] | Tecla | Qué hace | |---|---| | Ctrl/Cmd + S | Guardar | | Ctrl/Cmd + Z | Deshacer | | Ctrl/Cmd + Shift + Z o Ctrl/Cmd + Y | Rehacer | | Ctrl/Cmd + C, Ctrl/Cmd + V | Copiar y pegar los pasos seleccionados | | Ctrl/Cmd + D | Duplicar los pasos seleccionados | | Ctrl/Cmd + A | Seleccionar todo | | Delete o Backspace | Eliminar los pasos o las líneas seleccionados | | Esc | Quitar la selección | ## Guardar y activar [#opslaan-en-inschakelen] Tillor no guarda automáticamente. Haz clic en **Guardar** (o pulsa Ctrl/Cmd + S) para conservar tus cambios. El botón está activo en cuanto algo ha cambiado y el nombre no está vacío. Si la automatización está activada, solo puedes guardar cuando ya no quedan problemas. Un flujo en marcha debe seguir siendo siempre válido. Resuelve los problemas, o pon primero la automatización en pausa. Con el interruptor **Activo** activas la automatización. Eso también guarda el flujo de inmediato. El interruptor no funciona mientras haya problemas, con la explicación **Corrige primero los problemas pendientes**. Después, la automatización se inicia con cada evento que encaje. Puede tardar medio minuto en que un cambio surta efecto en todas partes. Si más tarde modificas un flujo activado, los cambios solo valen para las ejecuciones nuevas. Las ejecuciones que ya están en curso o esperan en un retraso terminan con el flujo tal como era cuando empezaron. ## Tu primera automatización: una tarea tras la salida [#je-eerste-automatisering-een-taak-na-vertrek] Este ejemplo crea una tarea cuando termina una ocupación. 1. Haz clic en **Nueva automatización** y elige **Revisar la parcela tras la salida** 2. Haz clic en el disparador. En **Evento** figura `occupation:ended` 3. Haz clic en el paso **Crear tarea**. Modifica el **Título**, la **Descripción** y la **Prioridad**, o elige en **Añadir al tablero** un tablero y una **Columna** 4. Abre la pestaña **Ejecución de prueba** y haz clic en **Ejecutar prueba**. Ves qué pasos recorrería el flujo 5. Haz clic en **Guardar** y activa **Activo** 6. Finaliza una ocupación y mira en la pestaña **Ejecuciones** qué ha ocurrido ## Solicitar un paso o un evento [#een-stap-of-gebeurtenis-aanvragen] ¿Echas en falta un disparador, una condición o una acción? Haz clic en **Solicitar un paso** bajo la lista de pasos. En la lista de eventos del disparador hay también un enlace **¿Falta un evento? Solicítalo**. 1. En **¿Qué necesitas?** elige uno entre **Un disparador o evento**, **Una condición o filtro**, **Una acción** u **Otra cosa** 2. En **¿Qué debería hacer?** describe qué quieres automatizar. Escribe al menos 10 caracteres, como máximo 1000 3. Haz clic en **Enviar solicitud** Tu solicitud va al equipo de Tillor, junto con tu nombre y el nombre de tu organización. Recibes un aviso de que la solicitud se ha enviado. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una automatización nueva está en pausa. No pasa nada hasta que activas **Activo**. - Tras activarla, la automatización se inicia con cada evento que encaje. Puede tardar medio minuto en que un cambio surta efecto en todas partes. - Cada inicio es una ejecución. Las ves en la pestaña **Ejecuciones**, con el estado **Completada**, **En espera**, **Fallida** o **Cancelada**. - Si una ejecución falla, quien creó la automatización recibe un correo, como máximo uno por hora y automatización. - Si modificas un flujo en marcha, los cambios solo valen para las ejecuciones nuevas. Lo que ya está en curso o en espera termina con el flujo antiguo. - Las tareas y los comentarios que crea la automatización figuran a nombre de **Flujo de trabajo**. Consulta [¿Quién ejecuta una automatización?](/automatiseringen/workflow-gebruiker). ## ¿Problemas? [#problemen] Tillor muestra **Corrige primero los problemas pendientes**. Arriba en el panel, haz clic en el botón con el número de problemas y resuélvelos. Consulta [Problemas y activación](/automatiseringen/problemen). El botón **Guardar** solo está activo cuando algo ha cambiado y el nombre no está vacío. Si la automatización está activada, solo puedes guardar sin problemas. Resuélvelos o ponla primero en pausa. Tillor indica **No está conectado, así que este paso nunca se ejecuta.** Arrastra desde la salida de un paso anterior hasta este paso. Se rechaza una línea que formaría un círculo. Un flujo solo puede avanzar. El menú solo aparece si tienes el permiso **Ver automatizaciones**. Construir y modificar requiere **Gestionar automatizaciones**. Pide a un administrador que ajuste tus permisos. Repasa los puntos de [¿Por qué no se inicia mi automatización?](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet). ## Siguientes pasos [#volgende-stappen] # Documentos (/es-ES/automatiseringen/acties/documenten) Con estas acciones trabajas con los documentos de un cliente, como un justificante de pago del seguro. El tipo y la fecha de vencimiento de un documento figuran en los datos del documento. En un flujo los lees como `{document.userMetadata.documentType}` y `{document.userMetadata.insuranceExpiryDate}`. ## Buscar documento [#document-zoeken] Busca el documento más reciente de un cliente. El paso tiene dos salidas: **Encontrada** y **No encontrada**. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente, por ejemplo `{document.customerId}` o `{customer.id}`. Obligatorio | | **Tipo** | Por ejemplo **Justificante de pago del seguro**. Déjalo vacío para cualquier tipo | | **Omitir documentos archivados** | Activado por defecto | | **Solo documentos que no han caducado** | La fecha de vencimiento debe ser posterior a ahora. Los documentos sin fecha de vencimiento no cuentan. Desactivado por defecto | Si encajan varios documentos, el paso toma el más reciente. Por **Encontrada**, los pasos posteriores pueden usar `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}` y `{foundDocument.userMetadata.insuranceExpiryDate}`. Así compruebas, por ejemplo, ante un seguro caducado si el cliente ya tiene un justificante de pago nuevo y válido: busca con **Tipo** *Justificante de pago del seguro* y **Solo documentos que no han caducado** activado, y continúa solo por **No encontrada**. ## Actualizar documento [#document-bijwerken] Cambia el tipo de un documento, o lo archiva o restaura. Los campos vacíos se quedan como están. | Campo | Qué rellenas | |---|---| | **Documento** | El id del documento. Por defecto `{document.id}`. Obligatorio | | **Nuevo tipo** | Déjalo vacío para conservar el tipo | | **Estado** | **Activo** o **Archivado**. Déjalo vacío para conservar el estado | Un tipo que exige fecha de vencimiento, como **Justificante de pago del seguro**, falla si el documento no tiene fecha de vencimiento. La acción devuelve `{updatedDocument.id}`. # Facturas y pagos (/es-ES/automatiseringen/acties/facturen-en-betalingen) Estos pasos están en el grupo **Facturas y pagos**. Cómo funcionan las salidas lo lees en [Salidas de una acción](/automatiseringen/acties#uitgangen-van-een-actie). ## Enviar recordatorio de pago [#betalingsherinnering-versturen] Envía al cliente el recordatorio de pago de una factura, igual que el botón de recordatorio de la factura. | Campo | Qué rellenas | |---|---| | **Factura** | El id de la factura. Por defecto `{invoice.id}`. Obligatorio | Ten en cuenta que el campo espera el id interno de la factura (`{invoice.id}`) y no el número de factura (`{invoice.displayId}`). El paso falla si: - la factura no está contabilizada - ya no queda nada pendiente, es decir, la factura ya está pagada - el cliente no tiene correo electrónico, teléfono y dirección postal completa La ejecución recibe entonces el estado **Fallida** y el resto del flujo no se ejecuta. Por eso, pon antes del recordatorio un **Si / si no** que compruebe si la factura sigue pendiente, como en la plantilla **Dar seguimiento a facturas impagadas**. El paso también omite una factura si se ha excluido de los recordatorios automáticos, o si el cliente tiene activado **Excluir de los recordatorios automáticos**. ## Sincronizar transacciones bancarias [#banktransacties-synchroniseren] Obtiene nuevas transacciones bancarias y espera a que termine la importación. Pon este paso antes de **Enviar recordatorio de pago**, para que una factura recién pagada no reciba recordatorio. Si Ponto no está vinculado, el paso se omite. Guarda la automatización desde la red de la oficina. Así Tillor recuerda la IP que necesita la conexión bancaria. Sin esa IP, la sincronización no puede iniciarse. ## Desactivar recordatorios automáticos para el cliente [#automatische-herinneringen-uitschakelen-voor-klant] Activa **Excluir de los recordatorios automáticos** en los ajustes de facturación del cliente. Los flujos de recordatorio omiten después todas sus facturas. Un recordatorio manual sigue siendo posible. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente. Obligatorio | ## Desactivar recordatorios automáticos para la factura [#automatische-herinneringen-uitschakelen-voor-factuur] Saca una factura de los flujos de recordatorio de impagos y de los recordatorios automáticos. Los empleados aún pueden enviar un recordatorio manualmente. | Campo | Qué rellenas | |---|---| | **Factura** | El id de la factura. Obligatorio | ## Enviar factura [#factuur-versturen] Envía una factura al cliente, igual que el botón de envío de la factura. | Campo | Qué rellenas | |---|---| | **Factura** | El id de la factura. Por defecto `{invoice.id}`. Obligatorio | El paso falla si la factura no está contabilizada o si el cliente no tiene correo electrónico, teléfono y dirección postal completa. ## Contabilizar factura [#factuur-boeken] Contabiliza una factura borrador, para que reciba su número de factura. | Campo | Qué rellenas | |---|---| | **Factura** | El id de la factura. Por defecto `{invoice.id}`. Obligatorio | Si la factura ya está contabilizada, no ocurre nada y el flujo continúa por **Omitido**. Tras contabilizar, la acción devuelve `{bookedInvoice.displayId}`, el número de factura. Puedes usarlo en un mensaje o una tarea. Combina el paso con **Enviar factura** para contabilizar y enviar una factura borrador de una vez. ## Imprimir factura [#factuur-afdrukken] Imprime una factura, o la muestra en la tableta de la recepción. | Campo | Qué rellenas | |---|---| | **Factura** | El id de la factura. Por defecto `{invoice.id}`. Obligatorio | | **Dónde** | **Impresora A4** (por defecto), **Impresora de tiques** o **Tableta** | Las impresoras se configuran en [Ajustes de impresión](/printer/afdrukinstellingen). Una factura que imprimes por segunda vez con este paso simplemente se vuelve a imprimir. ## Crear enlace de pago [#betaallink-aanmaken] Crea un enlace de pago en línea por el importe que aún está pendiente en una factura. | Campo | Qué rellenas | |---|---| | **Factura** | El id de la factura. Por defecto `{invoice.id}`. Obligatorio | | **Método de pago** | **Que elija el cliente** (por defecto), **Bancontact**, **iDEAL**, **Tarjeta de crédito** o **Payconiq** | El enlace solo existe para una factura contabilizada con algo pendiente. Si la factura no está contabilizada o ya está pagada, el flujo continúa por **Omitido**. Después la acción devuelve `{paymentLink.url}`. Ponlo en un texto, por ejemplo en un mensaje mediante [Enviar mensaje a un huésped](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen). ## Solicitar mandato SEPA [#sepa-mandaat-aanvragen] Envía a un cliente por correo electrónico una solicitud para firmar un mandato SEPA, o un recordatorio de una solicitud que sigue pendiente. Consulta [Mandato](/betalingsverwerking/mandaat) para el mandato en sí. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente. Por defecto `{customer.id}`. Obligatorio | | **Enviar** | **Una nueva solicitud** (por defecto) o **Un recordatorio** | Una nueva solicitud se omite si ya hay una pendiente. Un recordatorio se omite si no hay ninguna solicitud pendiente, o si la solicitud ha caducado. En ambos casos el flujo continúa por **Omitido**. ## Cobrar por domiciliación [#innen-via-domiciliëring] Cobra lo que queda pendiente en una factura con el mandato SEPA activo del cliente. | Campo | Qué rellenas | |---|---| | **Factura** | El id de la factura. Por defecto `{invoice.id}`. Obligatorio | | **Días de espera** | Cuántos días espera Tillor antes de cobrar. Con 0 se cobra de inmediato. El máximo es 7 días, un número mayor pasa a ser 7. Por defecto 0 | El paso cobra todo el importe pendiente. Si la factura no está contabilizada o ya está pagada, o si el cliente no tiene un mandato activo, no ocurre nada y el flujo continúa por **Omitido**. Si el cliente tiene más de un mandato activo, el paso usa el más reciente. ## Facturar consumo [#verbruik-factureren] Factura el consumo de contador pendiente de un cliente, contabiliza la factura y la envía. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente. Por defecto `{occupation.customerId}`. Obligatorio | | **Enviar por correo electrónico** | Activado por defecto | | **Enviar por SMS** | Desactivado por defecto | Si no hay nada pendiente que facturar, no se crea ninguna factura y el flujo continúa por **Omitido**. En caso contrario la acción devuelve `{consumptionInvoice.id}`. Consulta [Gestión de contadores](/meterbeheer) para saber cómo se registra el consumo. ## Borrador de factura de prórroga [#conceptfactuur-voor-verlenging] Crea una factura borrador que prorroga una ocupación, lista para revisar. La factura aún no está contabilizada. Es el mismo tipo de factura que obtienes con **Extender ocupación (factura)** en el perfil del cliente. | Campo | Qué rellenas | |---|---| | **Ocupación** | El id de la ocupación. Por defecto `{occupation.id}`. Obligatorio | | **Añadir consumo pendiente** | Pone el consumo de contador pendiente del cliente en la misma factura. Desactivado por defecto | La acción devuelve `{extendInvoice.id}`. Si quieres contabilizar y enviar la factura de inmediato, usa después **Contabilizar factura** y **Enviar factura** con `{extendInvoice.id}` como factura. # Huéspedes y mensajes (/es-ES/automatiseringen/acties/gasten-en-berichten) Estos pasos están en el grupo **Huéspedes y mensajes**. Cómo funcionan las salidas lo lees en [Salidas de una acción](/automatiseringen/acties#uitgangen-van-een-actie). ## Enviar mensaje a un huésped [#gast-een-bericht-sturen] Envía tu propio texto a un cliente por correo electrónico, SMS o WhatsApp. Úsalo para mensajes que no tienen una plantilla fija de Tillor, como un mensaje de bienvenida el día de la llegada. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente, por ejemplo `{reservation.customerId}`. Obligatorio | | **Asunto** | Solo para correo electrónico. Vacío usa el nombre de tu organización | | **Mensaje** | El texto, sin formato. Las variables se rellenan. Obligatorio | | **Enviar por correo electrónico** | Activado por defecto | | **Enviar por SMS** | Desactivado por defecto | | **Enviar por WhatsApp** | Desactivado por defecto | Ten en cuenta: - Los clientes que no aceptan comunicaciones no reciben nada. El flujo continúa entonces por **Omitido** - Fuera de la ventana de 24 horas de WhatsApp, Tillor envía tu texto como plantilla aprobada. Dentro de esa ventana se envía como mensaje normal - Si el cliente no existe, el paso falla ## Avisar a compañeros [#collegas-verwittigen] Envía a los compañeros una notificación push, un correo electrónico o ambos. | Campo | Qué rellenas | |---|---| | **Compañeros** | Elige uno o más compañeros | | **Avisar también a quien causó el evento** | Avisa también al compañero que causó el evento. Si el sistema causó el evento, no se añade a nadie | | **Título** | El encabezado de la notificación. Obligatorio | | **Texto** | El contenido de la notificación | | **Enviar como notificación push** | Activado por defecto | | **Enviar por correo electrónico** | Desactivado por defecto | El usuario **Flujo de trabajo** nunca recibe una notificación. Si no hay compañeros a los que avisar, el paso no hace nada y el flujo continúa sin más. ## Añadir un comentario [#opmerking-toevoegen] Coloca un [comentario](/notities), a nombre de **Flujo de trabajo**. | Campo | Qué rellenas | |---|---| | **Comentario** | El texto del comentario. Obligatorio | | **En** | **Los registros del evento** (por defecto) o **Una tarea** | | **Tarea** | Solo con **Una tarea**: el id de la tarea, por ejemplo `{createdTask.id}`. Obligatorio | Ten en cuenta: - Menciona a un compañero con `@{triggeredBy.name}({triggeredBy.id})`. Ese compañero recibe entonces una notificación, igual que con un comentario que escribes tú. Eso solo funciona si un compañero causó el evento - Con **Los registros del evento**, el comentario va al cliente, la factura, la reserva, el pago, la parcela, el contador y la tarea a los que se refiere el evento. Si el evento no tiene ninguno de esos registros, el paso falla - La acción devuelve `{createdComment.id}` ## Responder en la bandeja de entrada [#antwoorden-in-de-inbox] Envía una respuesta en una conversación de la bandeja de entrada, por el mismo canal por el que escribió el huésped. | Campo | Qué rellenas | |---|---| | **Conversación** | El id de la conversación. Por defecto `{threadId}`. Obligatorio | | **Respuesta** | El texto, sin formato. Las variables se rellenan. Si supera los 4096 caracteres se recorta. Obligatorio | | **Mantener activo el asistente de IA** | Desactivado por defecto | Ten en cuenta: - `{threadId}` existe en los eventos sobre mensajes de la bandeja de entrada, como `inbox:message-created` - Ese evento vale para cada mensaje nuevo, también para tu propia respuesta. Por eso, comprueba primero que el mensaje vino del huésped; si no, tu respuesta inicia el flujo de nuevo. Pon antes de este paso un [Consultar un registro](/automatiseringen/logica#record-opzoeken) con **Mensaje de la bandeja de entrada** y `{messageId}`, y un **Si / si no** que mire si `foundInboxMessage.direction` es igual a `INBOUND` - Por defecto, tu respuesta silencia al [asistente de IA](/inbox/inbox-ai-assistant) en esa conversación, igual que cuando responde un compañero. Con **Mantener activo el asistente de IA** el asistente sigue conversando. Si la conversación está archivada, el paso falla ## Etiquetar o archivar conversación [#gesprek-taggen-of-archiveren] Pone etiquetas a una conversación de la bandeja de entrada, la archiva, o ambas cosas. | Campo | Qué rellenas | |---|---| | **Conversación** | El id de la conversación. Por defecto `{threadId}`. Obligatorio | | **Añadir etiquetas** | Elige una o más etiquetas. Se suman, las etiquetas existentes se conservan | | **Archivar la conversación** | Desactivado por defecto | ## Actualizar cliente [#klant-bijwerken] Cambia el estado de un cliente o añade una nota. Los demás datos del cliente no cambian. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente, por ejemplo `{invoice.customerId}`. Obligatorio | | **Estado** | **Dejar como está** (por defecto), **Predeterminado**, **Preferido**, **VIP**, **Advertencia** o **Bloqueado** | | **Añadir a las notas** | Texto que va en una línea nueva bajo las notas existentes. Vacío no añade nada | ## Registrar entrada, salida o cancelar [#inchecken-uitchecken-of-annuleren] Pone una reserva en su siguiente estado. | Campo | Qué rellenas | |---|---| | **Reserva** | El id de la reserva. Por defecto `{reservation.id}`. Obligatorio | | **Acción** | **Registrar entrada** (por defecto), **Registrar salida** o **Cancelar** | La reserva debe estar para ello en el estado correcto. **Registrar entrada** y **Cancelar** funcionan con una reserva en estado **Reservada**, **Registrar salida** con una reserva en estado **Entrada registrada**. Si está en otro estado, no ocurre nada y el flujo continúa por **Omitido**. # Vista general (/es-ES/automatiseringen/acties) Las acciones son los pasos que realmente hacen algo. Las encuentras en la lista de pasos, en los grupos **Tareas**, **Documentos**, **Huéspedes y mensajes**, **Facturas y pagos**, **Acceso y dispositivos** e **Integraciones**. Los pasos del grupo **Lógica** dirigen el propio flujo. Están en [Condiciones, interruptores y retrasos](/automatiseringen/logica). Todas las acciones las ejecuta el [usuario **Flujo de trabajo**](/automatiseringen/workflow-gebruiker) de tu organización. | Grupo | Acción | Qué hace | |---|---|---| | Tareas | [Crear tarea](/automatiseringen/acties/taken#taak-aanmaken) | Crea una tarea, opcionalmente con subtareas, en un tablero y vinculada a un cliente, una parcela o una factura | | Tareas | [Definir estado](/automatiseringen/acties/taken#taakstatus-zetten) | Cambia el estado de una tarea existente | | Tareas | [Buscar tarea](/automatiseringen/acties/taken#taak-zoeken) | Busca una tarea por título y continúa por **Encontrada** o **No encontrada** | | Tareas | [Establecer prioridad de tarea](/automatiseringen/acties/taken#taakprioriteit-zetten) | Sube, baja o elige la prioridad de una tarea existente | | Tareas | [Actualizar tarea](/automatiseringen/acties/taken#taak-bijwerken) | Cambia el nombre de una tarea, añade personas o etiquetas o mueve la fecha límite | | Tareas | [Eliminar tarea](/automatiseringen/acties/taken#taak-verwijderen) | Elimina una tarea, por ejemplo la que creó este flujo | | Documentos | [Buscar documento](/automatiseringen/acties/documenten#document-zoeken) | Busca el documento más reciente de un cliente y continúa por **Encontrada** o **No encontrada** | | Documentos | [Actualizar documento](/automatiseringen/acties/documenten#document-bijwerken) | Cambia el tipo de un documento, o lo archiva o restaura | | Huéspedes y mensajes | [Enviar mensaje a un huésped](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen) | Envía un texto propio a un cliente por correo electrónico, SMS o WhatsApp | | Huéspedes y mensajes | [Avisar a compañeros](/automatiseringen/acties/gasten-en-berichten#collegas-verwittigen) | Envía a los compañeros una notificación push o un correo electrónico | | Huéspedes y mensajes | [Añadir un comentario](/automatiseringen/acties/gasten-en-berichten#opmerking-toevoegen) | Coloca un comentario en los registros del evento o en una tarea | | Huéspedes y mensajes | [Responder en la bandeja de entrada](/automatiseringen/acties/gasten-en-berichten#antwoorden-in-de-inbox) | Envía una respuesta en una conversación de la bandeja de entrada | | Huéspedes y mensajes | [Etiquetar o archivar conversación](/automatiseringen/acties/gasten-en-berichten#gesprek-taggen-of-archiveren) | Añade etiquetas a una conversación de la bandeja de entrada o la archiva | | Huéspedes y mensajes | [Actualizar cliente](/automatiseringen/acties/gasten-en-berichten#klant-bijwerken) | Cambia el estado de un cliente o añade una nota | | Huéspedes y mensajes | [Registrar entrada, salida o cancelar](/automatiseringen/acties/gasten-en-berichten#inchecken-uitchecken-of-annuleren) | Pone una reserva en su siguiente estado | | Facturas y pagos | [Enviar recordatorio de pago](/automatiseringen/acties/facturen-en-betalingen#betalingsherinnering-versturen) | Envía al cliente el recordatorio de pago de una factura | | Facturas y pagos | [Sincronizar transacciones bancarias](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren) | Obtiene nuevas transacciones bancarias antes de que el flujo continúe | | Facturas y pagos | [Desactivar recordatorios automáticos para el cliente](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant) | Omite todas las facturas de un cliente en los recordatorios automáticos | | Facturas y pagos | [Desactivar recordatorios automáticos para la factura](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-factuur) | Saca una factura de los flujos de recordatorio automático | | Facturas y pagos | [Enviar factura](/automatiseringen/acties/facturen-en-betalingen#factuur-versturen) | Envía una factura al cliente | | Facturas y pagos | [Contabilizar factura](/automatiseringen/acties/facturen-en-betalingen#factuur-boeken) | Contabiliza una factura borrador | | Facturas y pagos | [Imprimir factura](/automatiseringen/acties/facturen-en-betalingen#factuur-afdrukken) | Imprime una factura o la muestra en una tableta | | Facturas y pagos | [Crear enlace de pago](/automatiseringen/acties/facturen-en-betalingen#betaallink-aanmaken) | Crea un enlace de pago en línea por lo que sigue pendiente | | Facturas y pagos | [Solicitar mandato SEPA](/automatiseringen/acties/facturen-en-betalingen#sepa-mandaat-aanvragen) | Pide a un cliente que firme un mandato, o envía un recordatorio | | Facturas y pagos | [Cobrar por domiciliación](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring) | Cobra lo pendiente con el mandato activo del cliente | | Facturas y pagos | [Facturar consumo](/automatiseringen/acties/facturen-en-betalingen#verbruik-factureren) | Factura el consumo de contador pendiente de un cliente | | Facturas y pagos | [Borrador de factura de prórroga](/automatiseringen/acties/facturen-en-betalingen#conceptfactuur-voor-verlenging) | Crea una factura borrador que prorroga una ocupación | | Acceso y dispositivos | [Crear método de acceso](/automatiseringen/acties/toegang-en-toestellen#toegangsmiddel-aanmaken) | Da acceso a un cliente mediante código QR, matrícula, código PIN o NFC | | Acceso y dispositivos | [Actualizar acceso](/automatiseringen/acties/toegang-en-toestellen#toegang-bijwerken) | Bloquea, desbloquea o prorroga métodos de acceso | | Acceso y dispositivos | [Enviar o imprimir código QR](/automatiseringen/acties/toegang-en-toestellen#qr-code-versturen-of-afdrukken) | Envía un código de acceso QR al cliente o lo imprime | | Acceso y dispositivos | [Abrir o cerrar barrera](/automatiseringen/acties/toegang-en-toestellen#slagboom-openen-of-sluiten) | Abre o cierra una barrera o una verja | | Acceso y dispositivos | [Conmutar corriente](/automatiseringen/acties/toegang-en-toestellen#stroom-schakelen) | Conecta o desconecta la corriente de un contador inteligente | | Acceso y dispositivos | [Actualizar etiquetas NFC](/automatiseringen/acties/toegang-en-toestellen#nfc-tags-bijwerken) | Bloquea, desbloquea o recarga etiquetas NFC de un cliente | | Acceso y dispositivos | [Controlar tableta o quiosco](/automatiseringen/acties/toegang-en-toestellen#tablet-of-kiosk-bedienen) | Despierta una tableta o un quiosco, lo pone en reposo o lo recarga | | Acceso y dispositivos | [Configurar presentación](/automatiseringen/acties/toegang-en-toestellen#diavoorstelling-instellen) | Pone fotos en tabletas y quioscos, desde una lista o una solicitud anterior | | Integraciones | [Enviar webhook](/automatiseringen/acties/integraties#webhook-versturen) | Entrega un mensaje propio a uno de tus endpoints de webhook | | Integraciones | [Solicitud API](/automatiseringen/acties/integraties#api-verzoek) | Llama a la Tillor API o a otro sitio web | En todos los campos de texto puedes usar [variables](/automatiseringen/variabelen), como `{invoice.displayId}`. Arriba a la derecha de cada campo hay un botón **Variable** para insertar una. Los campos en los que se pide un cliente, una factura u otro registro esperan el id interno de ese registro, como `{invoice.id}`. Un número de factura o un nombre no funciona. ## Salidas de una acción [#uitgangen-van-een-actie] Debajo de un paso hay una o más salidas. Conectas cada salida con un paso siguiente. Si dejas una salida sin conectar, la ejecución termina ahí. | Salida | En qué acciones | Cuándo | |---|---|---| | **Siguiente** | La mayoría de las acciones | El paso ha salido bien | | **Hecho** y **Omitido** | Acciones que a veces no tienen nada que hacer | **Hecho** si el paso hizo su trabajo. **Omitido** si no había nada que hacer, por ejemplo porque la factura ya estaba contabilizada. No es un error | | **Encontrada** y **No encontrada** | **Buscar tarea** | Si la tarea existe | | **Encontrada** y **No encontrada** | **Buscar documento** | Si el cliente tiene un documento así | | **Correcto** y **Fallido** | **Enviar webhook** y **Solicitud API** | Si la otra parte aceptó el mensaje | **Hecho** y **Omitido** están en **Enviar mensaje a un huésped**, **Registrar entrada, salida o cancelar**, **Contabilizar factura**, **Crear enlace de pago**, **Solicitar mandato SEPA**, **Cobrar por domiciliación** y **Facturar consumo**. En cada una de ellas, debajo de la acción se indica cuándo se omite un paso. ### Continuar si este paso falla [#doorgaan-als-deze-stap-mislukt] Si una acción sale mal, la ejecución normalmente se detiene con el estado **Fallida**. Si quieres decidir tú qué ocurre entonces, activa abajo, en los ajustes del paso, **Continuar si este paso falla**. Se puede en cualquier acción excepto **Enviar webhook** y **Solicitud API**, que ya tienen su propia salida **Fallido**. El paso recibe entonces una salida adicional **Error**. Si la acción falla, el flujo continúa por **Error** en lugar de detenerse. Los pasos posteriores pueden usar estas variables: | Variable | Contenido | |---|---| | `{error.message}` | El mensaje de error. Puede estar en inglés | | `{error.step}` | El nombre del paso que falló, tal como lo rellenaste en **Nombre del paso** | Algunas cosas que conviene saber: - Si la acción ha salido bien o se ha omitido, no cambia nada y **Error** no se usa - Si dejas **Error** sin conectar, la ejecución termina ahí sin más pasos. La ejecución recibe entonces el estado **Completada**, pero el propio paso aparece en la pestaña **Ejecuciones** con su mensaje de error - Un segundo paso fallido en el mismo flujo sustituye `{error.message}` y `{error.step}` del primero Un ejemplo: deja que **Enviar mensaje a un huésped** continúe si falla y crea por **Error** una tarea con `{error.message}` en la descripción. Así un compañero retoma él mismo la conversación con el huésped. ## Cuando un paso falla [#als-een-stap-mislukt] Hay tres formas en que transcurre un fallo. - **Una salida Fallido.** Ocurre en **Enviar webhook** y **Solicitud API** cuando la otra parte devuelve un error. El flujo continúa por la salida **Fallido**. Conéctala con un paso siguiente, como una tarea para un compañero. Si dejas la salida sin conectar, la ejecución simplemente termina ahí - **Una salida Error.** Si en otra acción activas **Continuar si este paso falla**, el paso recibe una salida **Error** y con `{error.message}` puedes usar el motivo. Consulta [Continuar si este paso falla](#doorgaan-als-deze-stap-mislukt) - **El paso detiene la ejecución.** Si falta un valor después de rellenar las variables, no se puede enviar una factura, un endpoint ya no existe o el JSON no es válido, la ejecución recibe el estado **Fallida**. Los pasos siguientes no se ejecutan y Tillor no reintenta el paso. Esto solo ocurre si no has activado **Continuar si este paso falla** El mensaje de error está en el paso, en la pestaña **Ejecuciones**. Esos mensajes pueden estar en inglés. ¿Quieres que un fallo nunca pase inadvertido? Conecta la salida **Fallido** de una **Solicitud API** o de **Enviar webhook**, o la salida **Error** de otra acción, con un paso [Crear tarea](/automatiseringen/acties/taken#taak-aanmaken). Así un compañero puede retomarlo. ## Grupos [#groepen] # Integraciones (/es-ES/automatiseringen/acties/integraties) Estos pasos están en el grupo **Integraciones**. Una entrega fallida continúa por **Fallido**. Para las demás acciones, lee [Cuando un paso falla](/automatiseringen/acties#als-een-stap-mislukt). ## Enviar webhook [#webhook-versturen] Entrega un mensaje propio a uno de los endpoints de webhook de tu organización. Es útil para avisar a otro sistema, por ejemplo tu sistema de caja o tu sitio web. | Campo | Qué rellenas | |---|---| | **Endpoint** | Elige uno de tus endpoints de webhook. Los reconoces por su dirección. Obligatorio | | **Nombre del evento** | El nombre que acompaña al mensaje para que el destinatario lo reconozca, por ejemplo `automation.invoice_unpaid`. Obligatorio | | **Carga útil** | El contenido del mensaje, como JSON. Las variables se rellenan antes de enviar el mensaje. Obligatorio | Los endpoints los creas y gestionas en el menú del perfil, en **Desarrolladores**. El endpoint debe existir y estar activado. Si no es así, el paso falla y la ejecución se detiene. El mensaje se firma con la clave propia del endpoint, igual que los demás webhooks que recibe el endpoint. Tillor lo intenta varias veces más si tu servidor no responde correctamente. El endpoint no tiene que seguir el nombre de tu evento: el mensaje llega de todos modos. El paso tiene dos salidas: | Salida | Cuándo | |---|---| | **Correcto** | Tu servidor respondió con un estado de éxito | | **Fallido** | La entrega falló tras todos los intentos. Después, el mensaje se sigue intentando en segundo plano, igual que un webhook normal | La plantilla **Enviar reservas a otro sistema** usa **Fallido** para crear una tarea y que alguien se ocupe. Una carga útil puede verse así: ```json { "reservation": "{reservation.displayId}", "checkIn": "{reservation.checkIn}", "adults": {reservation.numberOfAdults}, "customer": { "firstName": "{reservation.customer.firstName}", "email": "{reservation.customer.email}" } } ``` Pon el texto entre comillas y los números sin comillas. Las fechas pasan en JSON como fecha y hora internacionales, por ejemplo `2026-10-05T08:00:00.000Z`. Lee [Variables y plantillas](/automatiseringen/variabelen#hoe-waarden-worden-ingevuld) para los detalles. La parte técnica, como la estructura del mensaje, está en [Desarrolladores > Automatizaciones](/ontwikkelaars/automatiseringen). ## Solicitud a una API [#api-verzoek] Llama a la API de Tillor de tu propia organización, o a otra dirección de internet. Con ello puedes hacer casi todo lo que hace Tillor, y buscar datos para usarlos después. En **Enviar a** eliges entre **Tillor API** y **URL personalizada**. En **Método** eliges **GET** (consultar), **POST** (crear), **PUT** o **PATCH** (modificar) o **DELETE** (eliminar). ### Tillor API [#tillor-api] | Campo | Qué rellenas | |---|---| | **Ruta** | La parte de la dirección que va después de la API de tu organización, por ejemplo `/tasks` o `/tasks/{task.id}`. Debe empezar por `/`. Obligatorio | | **Cuerpo** | Los datos que envías, como JSON. Déjalo vacío si no envías nada | Encima del campo está **Elige un endpoint de la API**. Haz clic y busca en la lista, por ejemplo *tasks*. Al elegir un endpoint, Tillor rellena el método y la ruta. Si el **Cuerpo** aún está vacío, también obtienes un ejemplo de lo que espera el endpoint. Sustituye los nombres entre llaves de la ruta por variables de pasos anteriores. Si hay parámetros de consulta, los ves debajo del campo. La llamada se hace como el usuario **Flujo de trabajo** y nunca puede salir de tu propia organización. Una automatización no puede gestionar automatizaciones, así que se rechazan las llamadas que afecten a automatizaciones o a sus ejecuciones. ### URL personalizada [#eigen-url] | Campo | Qué rellenas | |---|---| | **URL** | La dirección. Debe empezar por `https://`. Obligatorio | | **Cabeceras** | Datos adicionales para el destinatario, por ejemplo una clave. Haz clic en **Añadir cabecera** y rellena el **Nombre** y el **Valor** | | **Cuerpo** | Los datos que envías, como JSON. Déjalo vacío si no envías nada | Se aplican estas reglas: - Las direcciones sin `https://` se rechazan - Las direcciones privadas e internas se rechazan, incluso si un nombre normal apunta a ellas - No se siguen las redirecciones. Si el servidor responde con una redirección, cuenta como **Fallido** - Las cabeceras se guardan cifradas. Por tanto, puedes poner en ellas una clave o un token - Con **GET** y **DELETE** no se envía cuerpo ### Salidas y respuesta [#uitgangen-en-antwoord] La solicitud tiene dos salidas: **Correcto** (el servidor respondió con un estado de éxito) y **Fallido** (el servidor respondió con un estado de error). Si Tillor no llega al servidor, por ejemplo por un tiempo de espera agotado tras 15 segundos o una dirección rechazada, la ejecución se detiene con el estado **Fallida**. Para los pasos posteriores hay tres variables: | Variable | Contenido | |---|---| | `{response.status}` | El código de estado, por ejemplo 200 | | `{response.body}` | La respuesta como texto, recortada a los primeros 4000 caracteres | | `{response.data}` | La respuesta como datos, para que puedas sacar campos de ella con `{response.data.items.0.id}` | Cómo usarlo está en [Usar una respuesta de API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). Un ejemplo completo con una búsqueda está en [Revisión de una caravana de alquiler](/automatiseringen/voorbeeld-nalopen). # Tareas (/es-ES/automatiseringen/acties/taken) Con estos pasos una automatización crea y actualiza tareas para que un compañero se ocupe de algo. Están en el grupo **Tareas**. Cómo funcionan las salidas lo lees en [Salidas de una acción](/automatiseringen/acties#uitgangen-van-een-actie). ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Una tarea de una automatización es una tarea normal: la encuentras en la página de tareas, en las vistas a las que encaja y en el cliente o el registro al que está vinculada. ```mermaid flowchart LR A["Paso Crear tarea"] --> T["Tarea en la página de tareas
a nombre de Flujo de trabajo"] T --> V["Las vistas la muestran
si encaja o está en la lista"] T --> C["Un compañero se ocupa de ella"] C -- "Cambia el estado o la asignación" --> E["Otra automatización puede empezar por ello"] D["Paso Pedir una decisión"] --> T2["Tarea con botones de elección"] T2 -- "Un compañero elige un botón" --> F["La automatización continúa por esa opción"] ``` Más sobre lo que ven y hacen los compañeros está en [Tareas](/taken#hoe-hangt-dit-samen) y [Tareas con botones de elección](/taken/taakdetails#taken-met-keuzeknoppen). ## Crear tarea [#taak-aanmaken] Crea una tarea en el sistema de tareas. La tarea queda a nombre de **Flujo de trabajo**. | Campo | Qué rellenas | |---|---| | **Título** | El nombre de la tarea. Obligatorio | | **Descripción** | Una explicación de la tarea | | **Asignar a** | Elige a uno o más compañeros. Haz clic en un nombre para activarlo o desactivarlo | | **Asignar a grupos** | Elige uno o más [grupos](/gebruikers/groepen). La tarea vale entonces para todos los que estén en el grupo en ese momento | | **Etiquetas** | Elige una o más [etiquetas](/taken/labels) | | **Asignar también a quien causó el evento** | Asigna la tarea también al compañero que causó el evento, por ejemplo quien terminó la ocupación. Si el evento lo causó el sistema, no se añade a nadie | | **Prioridad** | **Baja**, **Media**, **Alta** o **Urgente**. Por defecto **Media** | | **Añadir al tablero** | Elige un tablero en el que aparecerá la tarea, o déjalo vacío | | **Columna** | Elige una columna del tablero anterior. La lista muestra las columnas como *[tablero] · [columna]* | | **Subtareas** | Una subtarea por línea, o exactamente una variable con una lista, como `{result}` de [Ejecutar código](/automatiseringen/logica#code-uitvoeren) | | **Vence después de** | Cuántos minutos, horas, días o semanas después de ejecutar el paso vence la tarea. Con 0 la tarea no tiene fecha límite. Por defecto 1 día | | **Vincular a registros** | Vincula la tarea a los registros de abajo y a su cliente, parcela, factura, reserva o contador. Activado por defecto | | **Vincular a** | Aparece cuando **Vincular a registros** está activado. Elige en qué registros aparece la tarea. De entrada está marcado todo lo que el paso conoce: los registros del disparador y lo que encontró un paso de búsqueda anterior | | **Solo el flujo puede terminarla** | Los compañeros no pueden terminar ni eliminar la tarea. Más adelante pon un paso **Eliminar tarea** o **Definir estado** para terminarla | Ten en cuenta lo siguiente: - Si no eliges a nadie en **Asignar a** ni en **Asignar a grupos** y dejas desactivado **Asignar también a quien causó el evento**, la tarea no tiene ningún compañero asignado. **Flujo de trabajo** nunca se asigna a sí mismo - Las subtareas tienen el mismo título que escribes, ningún compañero asignado y ninguna fecha límite. Las líneas vacías se omiten. Puedes usar variables en las líneas - En **Vincular a** se trata de clientes, parcelas, facturas, reservas y contadores. Con una ocupación que termina, la tarea se vincula por defecto a la parcela, al cliente y a la reserva. Si quitas un registro de la lista, la tarea se queda fuera de él. Los registros que se añadan más tarde al flujo, Tillor no los añade solo una vez que has modificado la lista tú mismo. Si vuelves a elegir todo, el paso vuelve a seguir todos los registros disponibles - Si una tarea está solo en un tablero personal, solo la ven los implicados. Consulta [Tareas privadas](/taken/prive-taken) Para los pasos posteriores, la acción devuelve `{createdTask.id}` y `{createdTask.name}`. Con ello puedes, por ejemplo, definir después el estado. Si no quieres una segunda tarea cuando ya hay una tarea abierta para la misma parcela o el mismo cliente, pon antes un paso [Buscar tarea](#taak-zoeken) y crea la tarea solo por **No encontrada**. El [ejemplo Revisión de una caravana de alquiler](/automatiseringen/voorbeeld-nalopen) lo hace así. Si activas **Solo el flujo puede terminarla**, la tarea muestra **La termina su automatización**. Los compañeros no pueden terminarla ni eliminarla. ## Eliminar tarea [#taak-verwijderen] Elimina una tarea, por ejemplo la tarea que creó este flujo cuando ya no hace falta. | Campo | Qué rellenas | |---|---| | **Tarea** | El id de la tarea. Por defecto `{createdTask.id}`. Obligatorio | Una tarea que ya no existe se omite. El flujo continúa entonces con normalidad. ## Definir estado [#taakstatus-zetten] Cambia el estado de una tarea existente, por ejemplo para terminarla. | Campo | Qué rellenas | |---|---| | **Tarea** | El id de la tarea. Por defecto `{task.id}`. Obligatorio | | **Estado** | **Pendiente**, **En progreso**, **Esperando respuesta** o **Completada**. Por defecto **Completada** | `{task.id}` funciona cuando la automatización empieza con un evento de tarea, como `task:created`. Tras un paso **Crear tarea** usas `{createdTask.id}`. La acción devuelve `{updatedTask.id}` y `{updatedTask.status}`. ## Buscar tarea [#taak-zoeken] Busca una tarea existente por título. El paso tiene dos salidas: **Encontrada** y **No encontrada**. Así puedes actualizar una tarea si ya existe y, si no, crear una nueva. | Campo | Qué rellenas | |---|---| | **Título** | El título que debe tener exactamente la tarea, por ejemplo `Nalopen {occupation.terrain.name}`. Las variables se rellenan primero. Obligatorio | | **Vinculada a los registros del evento** | Solo tareas vinculadas al menos a uno de los mismos registros, como la parcela o el cliente. Activado por defecto | | **Solo tareas no completadas** | Omite las tareas completadas. Activado por defecto | | **Omitir subtareas** | Busca solo tareas principales. Activado por defecto | Si encajan varias tareas, el paso toma la más reciente. Si **Vinculada a los registros del evento** está activado pero el evento no tiene cliente, parcela, factura, reserva ni contador, el flujo sigue por **No encontrada**. Por **Encontrada**, los pasos posteriores pueden usar `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}` y `{foundTask.status}`. ## Definir prioridad de tarea [#taakprioriteit-zetten] Cambia la prioridad de una tarea existente. | Campo | Qué rellenas | |---|---| | **Tarea** | El id de la tarea. Por defecto `{foundTask.id}`. Obligatorio | | **Cambio** | **Un nivel más alto** (por defecto), **Un nivel más bajo** o **A una prioridad fija** | | **Prioridad** | Solo con **A una prioridad fija**: **Baja**, **Media**, **Alta** o **Urgente** | | **Subir hasta** | Solo con **Un nivel más alto**: la prioridad más alta que puede dar el paso. Por defecto **Alta**. Una tarea que ya tiene esa prioridad o una superior se queda como está | El orden es **Baja**, **Media**, **Alta**, **Urgente**. Un nivel más bajo se detiene en **Baja**. Si no cambia nada, el paso se completa con normalidad sin modificar la tarea. La acción devuelve `{updatedTask.id}` y `{updatedTask.priority}`. ## Actualizar tarea [#taak-bijwerken] Modifica una tarea existente. Los campos que dejas vacíos se quedan como están. | Campo | Qué rellenas | |---|---| | **Tarea** | El id de la tarea. Por defecto `{foundTask.id}`. Obligatorio | | **Nuevo título** | El nuevo nombre de la tarea. Vacío deja el título como está | | **Asignados** | Elige a uno o más compañeros | | **Grupos** | Elige uno o más [grupos](/gebruikers/groepen) | | **Asignar también a quien causó el evento** | Añade también al compañero que causó el evento. Si el evento lo causó el sistema, no se añade a nadie | | **Asignación** | **Añadir a los actuales** (por defecto) o **Sustituir a los actuales** | | **Añadir etiquetas** | Elige una o más [etiquetas](/taken/labels). Se suman, las etiquetas existentes se mantienen | | **Vence después de** | Fija la fecha límite a esta cantidad de minutos, horas, días o semanas después de ejecutar el paso. Con 0 la fecha límite se queda como está | Ten en cuenta lo siguiente: - Si eliges **Sustituir a los actuales** y no indicas a nadie, la tarea se queda después sin nadie asignado - Si la tarea ya no existe, el paso falla - La acción devuelve `{updatedTask.id}` # Acceso y dispositivos (/es-ES/automatiseringen/acties/toegang-en-toestellen) Estas acciones afectan al propio parque: quién puede entrar, qué contadores tienen corriente y qué hacen las tabletas. Consulta [Control de acceso](/toegangscontrole) para el contexto de los métodos de acceso. Cómo funcionan las salidas lo lees en [Salidas de una acción](/automatiseringen/acties#uitgangen-van-een-actie). ## Crear método de acceso [#toegangsmiddel-aanmaken] Da acceso a un cliente mediante un código QR, matrícula, código PIN o NFC. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente, por ejemplo `{reservation.customerId}`. Obligatorio | | **Tipo** | **Código QR** (por defecto), **Matrícula**, **Código PIN** o **NFC** | | **Valor** | La matrícula o el número NFC. Déjalo vacío para un código QR o un código PIN, porque Tillor los crea solo | | **Válido desde** | Una variable de fecha, por ejemplo `{reservation.checkIn}`. Vacío significa sin límite | | **Válido hasta** | Una variable de fecha, por ejemplo `{reservation.checkOut}`. Vacío significa sin límite | Con **Matrícula** y **NFC**, **Valor** es obligatorio. La acción devuelve `{createdAccessMethod.id}` y `{createdAccessMethod.value}`. El valor es el código del código QR o del código PIN. Con el id puedes enviar después el código mediante **Enviar o imprimir código QR**. ## Actualizar acceso [#toegang-bijwerken] Bloquea, desbloquea o prolonga un método de acceso, o todos los métodos de acceso de un cliente. | Campo | Qué rellenas | |---|---| | **Cuáles** | **Un método de acceso** (por defecto) o **Todos los de un cliente** | | **Método de acceso** | Solo con **Un método de acceso**: el id, por ejemplo `{createdAccessMethod.id}`. Obligatorio | | **Cliente** | Solo con **Todos los de un cliente**: el id del cliente, por ejemplo `{occupation.customerId}`. Obligatorio | | **Estado** | **Dejar como está** (por defecto), **Activo**, **Bloqueado parcialmente**, **Bloqueado** o **Inactivo** | | **Válido hasta** | Una variable de fecha. Vacío conserva la fecha final actual | Ten en cuenta lo siguiente: - Si dejas **Estado** en **Dejar como está** y **Válido hasta** vacío, el paso no hace nada - Con **Todos los de un cliente**, los métodos de acceso que están en **No renovar automáticamente** conservan su fecha final, como ocurre también cuando un cliente paga una factura. Su estado sí cambia. Con **Un método de acceso**, el paso sí modifica la fecha final, incluso si ese método de acceso está en **No renovar automáticamente** ## Enviar o imprimir código QR [#qr-code-versturen-of-afdrukken] Envía un código de acceso QR al cliente, lo imprime, o ambas cosas. | Campo | Qué rellenas | |---|---| | **Método de acceso** | El id del método de acceso. Por defecto `{createdAccessMethod.id}`. Obligatorio | | **Enviar por correo electrónico** | Activado por defecto | | **Enviar por SMS** | Desactivado por defecto | | **Enviar por WhatsApp** | Desactivado por defecto | | **Imprimir** | **No imprimir** (por defecto), **Impresora de etiquetas** o **Impresora de tiques** | Si desactivas los tres canales y eliges **No imprimir**, el paso no hace nada. ## Abrir o cerrar barrera [#slagboom-openen-of-sluiten] Abre o cierra una barrera o una puerta. | Campo | Qué rellenas | |---|---| | **Punto de acceso** | Elige uno de tus puntos de acceso. Obligatorio | | **Acción** | **Abrir** (por defecto) o **Cerrar** | ## Conmutar corriente [#stroom-schakelen] Enciende o apaga la corriente de un contador inteligente. Por ejemplo, para apagar la corriente cuando termina una ocupación. | Campo | Qué rellenas | |---|---| | **Qué contadores** | **Todos los contadores conmutables de una parcela** (por defecto) o **Un contador** | | **Parcela** | Solo con **Todos los contadores conmutables de una parcela**: el id de la parcela. Por defecto `{occupation.terrainId}`. Obligatorio | | **Contador** | Solo con **Un contador**: elige el contador. Obligatorio | | **Corriente** | **Activada** o **Apagada**. Por defecto **Apagada** | Ten en cuenta lo siguiente: - Con **Todos los contadores conmutables de una parcela**, el paso conmuta solo los contadores que pueden conmutar. Si la parcela no tiene ninguno, no ocurre nada - Si no se consigue conmutar un contador, el paso falla. Con **Un contador** ocurre también cuando el contador no puede conmutar. Los contadores que ya se habían conmutado antes se quedan conmutados ## Actualizar etiquetas NFC [#nfc-tags-bijwerken] Actualiza todas las [etiquetas NFC](/nfc/nfc-tags) de un cliente. | Campo | Qué rellenas | |---|---| | **Cliente** | El id del cliente, por ejemplo `{occupation.customerId}`. La acción vale para cada etiqueta NFC de este cliente. Obligatorio | | **Acción** | **Bloquear** (por defecto), **Desbloquear**, **Recargar** o **Enviar aviso de saldo bajo** | | **Importe** | Solo con **Recargar**: el importe en euros, por etiqueta. Debe ser mayor que 0. Obligatorio | Si el cliente tiene dos etiquetas y escribes 20, cada etiqueta recibe 20 euros más. Sin etiquetas, el paso no hace nada. Con un importe que no es un número mayor que 0, el paso falla. ## Controlar tableta o quiosco [#tablet-of-kiosk-bedienen] Envía un comando a una [tableta o quiosco](/mobiele-app/tablets-en-kiosken). | Campo | Qué rellenas | |---|---| | **Dispositivo** | Elige el dispositivo. Obligatorio | | **Comando** | **Activar** (por defecto), **Suspender**, **Recargar**, **Identificar** o **Reproducir sonido de prueba** | ## Configurar pase de diapositivas [#diavoorstelling-instellen] Configura el pase de diapositivas en cada tableta y quiosco, o en un solo dispositivo. El resto de los ajustes del dispositivo se mantiene. Si el mismo pase de diapositivas ya está configurado, ese dispositivo se omite. Un disparador cada hora, después una [solicitud a una API](/automatiseringen/acties/integraties#api-verzoek) a un feed de actividades y luego este paso: así sustituyes una sincronización aparte. Conecta el paso a la salida **Correcto** de la solicitud. | Campo | Qué rellenas | |---|---| | **Dispositivos** | **Cada tableta y quiosco** (por defecto) o **Un dispositivo** | | **Dispositivo** | Solo con **Un dispositivo**. Obligatorio | | **Modo** | **Salvapantallas** (por defecto, tras un tiempo sin tocar la pantalla) o **Fondo** | | **Segundos por foto** | Cuánto tiempo se queda una foto. Por defecto 10. De 3 a 600 | | **Espera antes de empezar** | Solo con **Salvapantallas**: segundos sin tocar la pantalla. Por defecto 15 | | **Ajuste** | **Llenar** o **Ajustar** | | **Fotos** | **De una petición anterior** (por defecto) o **Direcciones** | | **Direcciones de imagen** | Solo con **Direcciones**: una dirección https por línea. Obligatorio | | **Lista** | Ruta de la lista JSON, sin llaves. Tras una solicitud a una API es `response.data`. Obligatorio | | **Campo de la imagen** | Nombre del campo con la dirección https, por ejemplo `signage_image`. Obligatorio | | **Campo del id** | Hace que la misma foto conserve el mismo id, de modo que una lista sin cambios no envíe un mensaje nuevo al dispositivo | | **Campo del estado** y **Estado** | Solo filas cuyo campo tenga ese valor, por ejemplo `CONFIRMED` | | **Omitir si tiene valor** | Las filas en las que este campo tiene un valor se descartan, por ejemplo `deleted_at` | | **Campo de la fecha** y **Campo de la fecha de fin** | Una fila se mantiene mientras ese momento no haya pasado. Si la fecha de fin está vacía, cuenta la fecha | | **Campo de orden** | Ordena la lista de forma ascendente, por ejemplo por `date` | | **Máximo de fotos** | Por defecto 5, como máximo 20 | Una dirección que no empieza por `https://` no cuenta. Si la lista no es una matriz JSON, el paso falla y se mantiene el pase de diapositivas actual. # Vista general (/es-ES/automatiseringen) Con las automatizaciones haces que Tillor haga algo sin que un compañero tenga que acordarse. Fijas una regla: *cuando ocurra esto, haz aquello*. Algunos ejemplos: - Termina una ocupación en una caravana fija, así que Tillor crea una tarea de revisión con subtareas y la asigna al compañero que detuvo la ocupación - Una factura ha vencido, así que Tillor envía un recordatorio de pago y una semana después crea una tarea para llamar al cliente si la factura sigue abierta - Entra una reserva nueva, así que Tillor envía los datos a tu propio sistema - Cada lunes a las 08:00 Tillor crea una tarea para el control semanal - Entra una reserva nueva, así que Tillor crea un código QR para el huésped y se lo envía por correo electrónico Una automatización la construyes tú mismo en un lienzo, sin código. Eliges un momento de inicio, añades pasos y los unes con líneas. ## En palabras sencillas [#in-gewone-woorden] Una automatización tiene tres tipos de piezas. Solo necesitas conocer los detalles técnicos cuando los necesites. - **El momento de inicio (disparador)** es el "cuando". Ocurre algo en Tillor, como una ocupación que termina, o llega una hora o una fecha determinadas. Consulta [Disparadores](/automatiseringen/triggers) - **La lógica** es el "si". Aquí el flujo mira los datos y elige un camino, o espera hasta que ocurra algo. Un ejemplo: *¿sigue sin pagarse la factura una semana después?* Consulta [Condiciones, selectores y retrasos](/automatiseringen/logica) - **Las acciones** son el "entonces haz". Crear una tarea, enviar un mensaje, contabilizar una factura. Consulta [Acciones](/automatiseringen/acties) Además, las **variables** son los datos del propio momento, como el nombre de la parcela o del cliente. Las pones entre llaves en un texto y Tillor rellena el valor real. Consulta [Variables y plantillas](/automatiseringen/variabelen). ## Quién puede usarlo [#wie-kan-het-gebruiken] Las automatizaciones trabajan con todos los permisos en tu organización. Verlas requiere el permiso **Ver automatizaciones**, y crearlas y modificarlas **Gestionar automatizaciones**. Los administradores con **Todos los permisos** pueden hacer ambas cosas. Consulta [¿Quién puede usar las automatizaciones?](/automatiseringen/veelgestelde-vragen#wie-kan-automatiseringen-gebruiken). Encuentras la página en el menú lateral, en Administrador > Automatizaciones. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Cada automatización consta de pasos que unes en un flujo. Una automatización trabaja junto con las tareas: crea tareas, espera a que un compañero elija un botón o empieza en cuanto cambia una tarea. Consulta [Tareas](/taken#hoe-hangt-dit-samen). Cada vez que una automatización empieza, lo llamamos una ejecución. Una ejecución empieza en el momento de inicio y sigue las líneas hacia abajo. | Pieza | Qué hace | |---|---| | **Cuando ocurra esto** (disparador) | El momento de inicio. Un evento en Tillor, un webhook, una acción de tarea elegida, una factura vencida, una fecha como la llegada de un huésped, una hora fija o un horario propio. Un flujo puede tener varios disparadores. Cada disparador inicia una ejecución propia | | **Solo cuando** | Un filtro sobre el disparador. La automatización solo empieza si los datos cumplen la condición, por ejemplo solo para caravanas fijas | | **Si / si no** | Divide el flujo en **Sí** y **No** según una o más condiciones | | **Según el valor** | Divide el flujo en varias ramas, según el valor de un campo | | **Retraso** y otros pasos de espera | Hacen que el flujo espere, a una hora, una fecha, el horario de apertura, una condición, un evento o una decisión de un compañero | | **¿Abierto ahora?**, **Consultar un registro**, **Para cada** | Comprueban si estás abierto, obtienen un registro o hacen los pasos siguientes por cada elemento de una lista | | **Acciones** | Hacen algo de verdad: tareas, mensajes a huéspedes y compañeros, facturas, pagos y mandatos, acceso, contadores y dispositivos, webhooks y solicitudes a una API | Los pasos con varias salidas, como **Sí** y **No**, **Hecho** y **Omitido** o **Correcto** y **Fallido**, te permiten elegir una continuación distinta para cada resultado. En cada acción también puedes activar una salida **Error**, para que el flujo continúe si el paso falla. ```mermaid flowchart TD A["Cuando ocurra esto
La factura ha vencido"] --> B["Enviar recordatorio de pago"] B --> C["Retraso
7 días"] C --> D{"Si / si no
¿aún sin pagar?"} D -- Sí --> E["Crear tarea
llamar al cliente"] D -- No --> F["Fin"] ``` ## Variables [#variabelen] Los campos de texto de un paso aceptan variables entre llaves, como `{occupation.terrain.name}`. Tillor rellena ahí el nombre de la parcela que corresponde al evento. Así creas mensajes y tareas que son distintos en cada caso. Lee más en [Variables y plantillas](/automatiseringen/variabelen). ## Primeros pasos [#snel-aan-de-slag] 1. Ve a **Administrador > Automatizaciones** y haz clic en **Nueva automatización** 2. Elige una plantilla o **Empezar desde cero** 3. Configura el disparador y los pasos y haz clic en **Guardar** 4. Prueba el flujo en la pestaña **Ejecución de prueba**. Entonces no se envía ni se crea nada de verdad 5. Activa **Activa** cuando estés satisfecho La nueva automatización está en pausa hasta que tú mismo la actives. Una explicación paso a paso está en [Primeros pasos](/automatiseringen/aan-de-slag). - Una nueva automatización está en pausa hasta que tú mismo la actives - Una automatización tiene como máximo 100 pasos. Los comentarios y marcos del lienzo cuentan aparte, como máximo 50 - Un **Según el valor** tiene como máximo 8 ramas, y **Pedir una decisión** como máximo 8 opciones - Los horarios y las fechas se comprueban cada minuto. Un evento inicia al instante - Los cambios pueden tardar medio minuto en aplicarse en todas partes - Una ejecución fallida se envía por correo a quien creó la automatización, como máximo una vez por hora - En la pestaña **Ejecuciones** están las últimas 20 ejecuciones - Un flujo no puede iniciarse a sí mismo ni iniciar otro flujo mediante lo que crea él mismo Una automatización activada envía recordatorios reales y crea tareas reales. Usa la pestaña **Ejecución de prueba** y revisa las primeras ejecuciones en la pestaña **Ejecuciones** antes de estar seguro de que todo es correcto. ## Apartados [#onderdelen] ## Conceptos [#begrippen] - **Automatización**: una regla de "cuando ocurra esto, haz aquello", construida como un flujo - **Flujo**: el lienzo de una automatización, con pasos y líneas - **Disparador**: el momento de inicio de un flujo - **Ejecución**: una vez que una automatización empieza y recorre el flujo - **Acción**: un paso que hace algo de verdad, como crear una tarea - **Variable**: un dato del momento, entre llaves en un texto - **Ejecución de prueba**: un ensayo en el que no se envía ni se crea nada de verdad - **Flujo de trabajo**: el usuario a cuyo nombre trabaja una automatización Más términos están en la [lista de conceptos](/begrippen). # Condiciones, interruptores y retrasos (/es-ES/automatiseringen/logica) Con los pasos del grupo **Lógica** decides hacia qué lado va un flujo y cuándo: el "si" y el "espera un momento". Un ejemplo: *si la factura sigue abierta pasada una semana, crea una tarea*. Estos pasos dirigen las acciones posteriores. Solo [Pedir una decisión](#vraag-om-een-beslissing) crea algo por sí mismo, una tarea. | Paso | Qué hace | Salidas | |---|---|---| | [Si / si no](#als--anders) | Se bifurca según condiciones | **Sí**, **No** | | [Según el valor](#schakel) | Elige una rama según el valor de un campo | Una por rama y **Predeterminado** | | [Retraso](#vertraging) | Espera un tiempo fijo o hasta una fecha | **Siguiente** | | [¿Abierto ahora?](#nu-open) | Comprueba si ahora estás abierto | **Abierto**, **Cerrado** | | [Esperar a la apertura](#wachten-tot-open) | Espera hasta la próxima hora de apertura | **Siguiente** | | [Esperar al cierre](#wachten-tot-gesloten) | Espera hasta la próxima hora de cierre | **Siguiente** | | [Como máximo una vez por periodo](#hoogstens-één-keer-per-periode) | Evita repeticiones | **Continuar**, **Ya ejecutado** | | [Consultar un registro](#record-opzoeken) | Obtiene un registro con su id | **Encontrada**, **No encontrada** | | [Para cada](#voor-elk) | Ejecuta los pasos posteriores por cada elemento de una lista | **Para cada**, **Hecho** | | [Esperar hasta](#wachten-tot) | Espera hasta que se cumplan condiciones | **Cumplido**, **Tiempo agotado** | | [Esperar un evento](#wachten-op-een-gebeurtenis) | Espera hasta que ocurra algo en Tillor | **Recibido**, **Tiempo agotado**, a veces **Eliminado** | | [Pedir una decisión](#vraag-om-een-beslissing) | Deja que un compañero elija entre tus opciones | Una por opción y **Tiempo agotado** | ## Si / si no [#als--anders] Divide el flujo en dos caminos según los datos. Es el mismo principio que el filtro **Solo cuando** del disparador, pero ahora en mitad del flujo. El paso tiene dos salidas: **Sí** (se cumplen las condiciones) y **No** (no se cumplen). 1. Añade un paso **Si / si no** 2. En **Condiciones**, haz clic en **Añadir condición** 3. Elige el campo con el botón **Variable**, o escribe tú mismo la ruta, por ejemplo `invoice.paymentStatus` 4. Elige la comparación (**es**, **no es**, **contiene**, **es mayor que**, **es menor que**, **es uno de**, **está vacío** o **no está vacío**) y rellena el valor 5. Conecta la salida **Sí** y, si quieres, **No** a un paso siguiente Un paso **Si / si no** necesita al menos una condición. Si no, Tillor avisa **Añade una condición.** Con varias condiciones eliges entre **Deben cumplirse todas** y **Basta con que se cumpla una**. Las comparaciones funcionan como se describe en [Solo cuando](/automatiseringen/triggers#alleen-wanneer). No tienes que conectar las dos salidas. Si una salida no lleva a ningún sitio, la ejecución termina ahí. Un flujo que solo hace algo con **Sí** es, por tanto, perfectamente válido. También puedes usar campos de pasos anteriores. Después de una [Solicitud API](/automatiseringen/acties/integraties#api-verzoek) puedes mirar, por ejemplo, `response.status` o `response.data.paymentStatus`. ## Según el valor [#schakel] Elige **Según el valor** cuando necesites más de dos caminos. El paso mira el valor de un campo y elige la rama que le corresponde. 1. En **Campo**, elige el campo que quieres mirar, por ejemplo `occupation.occupationType` 2. En **Ramas**, haz clic en **Añadir rama**. Rellena la **Rama** (el nombre que aparecerá en la salida) e **Igual a** (el valor que debe tener el campo) 3. Repite esto para cada rama 4. Conecta cada salida a un paso siguiente Cada rama tiene su propia salida bajo el paso. Además, siempre hay una salida **Predeterminado**. Se usa cuando ninguna rama encaja. - El campo debe coincidir exactamente con el valor, incluidas las mayúsculas - Si encajan varias ramas, gana la primera de la lista - Una rama sin valor en **Igual a** no cuenta - Puedes configurar como máximo 8 ramas, además de **Predeterminado** - Si el campo está vacío o no existe, el flujo sigue por **Predeterminado** Los valores de los campos de selección están en la notación de Tillor. Una ocupación del tipo caravana de alquiler tiene, por ejemplo, el valor `RENTAL_CARAVAN`, y una factura pagada `PAID`. La lista de **Campo** muestra los campos del evento y de pasos anteriores. Los campos de la respuesta de una solicitud API solo aparecen en la lista cuando Tillor conoce un ejemplo de esa respuesta. Consulta [Usar una respuesta de API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). ## Retraso [#vertraging] Con **Retraso** haces que el flujo espere antes de continuar. Lo usas para cosas como *volver a mirar una semana después*. En **Esperar** eliges una de dos formas. ### Un tiempo fijo [#een-vaste-tijd] Elige **Durante un tiempo fijo** y rellena en **Duración** una cantidad y una unidad: **segundos**, **minutos**, **horas**, **días** o **semanas**. Los segundos no son exactos. El flujo puede continuar unos segundos más tarde. Un retraso de 0 no hace nada, por eso Tillor avisa **Un retraso de 0 no hace nada.** ### Hasta una fecha [#tot-een-datum] Elige **Hasta una fecha** cuando el tiempo de espera dependa de una fecha de los datos, como la fecha de vencimiento de una factura o la fecha de fin de una reserva. | Campo | Qué rellenas | |---|---| | **Fecha** | Un campo con una fecha, por ejemplo `invoice.dueDate`. La lista solo muestra campos que son una fecha | | **Respecto a esa fecha** | **Antes** o **Después** | | **Desfase** | Cuánto tiempo antes o después de esa fecha, en minutos, horas, días o semanas. Con 0 el flujo continúa exactamente en esa fecha | Ejemplos: - **Fecha** `invoice.dueDate`, **Después**, **Desfase** 1 día: el flujo continúa un día después de la fecha de vencimiento - **Fecha** `reservation.checkIn`, **Antes**, **Desfase** 2 días: el flujo continúa dos días antes de la llegada Si ese momento ya está en el pasado, o la fecha está vacía, el flujo continúa de inmediato. ### Qué ocurre durante la espera [#wat-er-tijdens-het-wachten-gebeurt] - La ejecución recibe el estado **En espera**. En la pestaña **Ejecuciones** aparece cuándo continúa (**Continúa …**). Las esperas largas, como semanas, no son un problema - Tras el retraso, Tillor vuelve a leer los datos, de modo que los pasos posteriores vean la situación actual. Consulta más abajo - Si pausas la automatización durante la espera, la ejecución se detiene en cuanto pasa el tiempo de espera. No continúa y recibe el estado **Cancelada**. Si activas la automatización antes de que pase el tiempo de espera, la ejecución continúa con normalidad - Si eliminas la automatización, las ejecuciones en espera se detienen - Si modificas el flujo mientras una ejecución espera, esa ejecución termina con el flujo tal como era cuando se inició ### Los datos se vuelven a leer [#gegevens-worden-opnieuw-gelezen] Una ejecución recuerda los datos del momento del evento, pero vuelve a leer los registros asociados antes de continuar. Son el registro del evento (por ejemplo la factura) y los registros a los que este hace referencia (por ejemplo el cliente). Un ejemplo: una automatización envía un recordatorio de una factura, espera 7 días y luego comprueba con **Si / si no** si `invoice.paymentStatus` no es `PAID`. Si la factura se ha pagado en esa semana, la condición ve la factura pagada y el flujo sigue por **No**. Hay dos excepciones: - Si el registro ya no existe, por ejemplo porque se ha eliminado una ocupación, la ejecución conserva la copia del momento del evento - Los datos que produjo un paso anterior, como la respuesta de una solicitud API, no se vuelven a obtener. Si quieres esos datos actualizados tras un retraso, haz una nueva solicitud API Una [ejecución de prueba](/automatiseringen/testen-en-uitvoeringen) omite los retrasos y trabaja con los datos de ejemplo que rellenas tú. Lo que ocurre tras un retraso real solo lo ves en una ejecución real. ## ¿Abierto ahora? [#nu-open] Comprueba si tu organización está abierta en este momento y divide el flujo en **Abierto** y **Cerrado**. No hay nada que configurar. Tillor usa el horario de **Ajustes > Horario de apertura**, con periodos de temporada, festivos y excepciones. Consulta [Ajustes de la organización](/gebruikers/organisaties#openingsuren). Úsalo, por ejemplo, para enviar otro texto o crear una tarea fuera del horario de apertura. Si prefieres esperar hasta que vuelvas a estar abierto, usa [Esperar a la apertura](#wachten-tot-open). Si quieres esperar hasta que cierres, usa [Esperar al cierre](#wachten-tot-gesloten). ## Esperar a la apertura [#wachten-tot-open] Pausa el flujo hasta la próxima hora de apertura y luego continúa. ¿Tu organización ya está abierta? Entonces el flujo continúa de inmediato. No hay nada que configurar. - La hora de apertura procede de **Ajustes > Horario de apertura**, en la zona horaria de tu organización - Si en el próximo mes no hay ninguna hora de apertura, el flujo continúa de inmediato en lugar de seguir esperando - Durante la espera, la ejecución recibe el estado **En espera**. Lo que ocurre entonces está en [Retraso](#wat-er-tijdens-het-wachten-gebeurt) ## Esperar al cierre [#wachten-tot-gesloten] Pausa el flujo hasta la próxima hora de cierre y luego continúa. ¿Tu organización ya está cerrada? Entonces el flujo continúa de inmediato. No hay nada que configurar. - La hora de cierre procede de **Ajustes > Horario de apertura**, en la zona horaria de tu organización - Los bloques que se suceden, como 9:00–12:00 y 12:00–17:00, cuentan como un solo tramo. El flujo espera hasta el final de ese tramo - Durante la espera, la ejecución recibe el estado **En espera**. Lo que ocurre entonces está en [Retraso](#wat-er-tijdens-het-wachten-gebeurt) ## Como máximo una vez por periodo [#hoogstens-één-keer-per-periode] Deja pasar el flujo solo si no ha pasado por este paso para el mismo registro dentro del periodo. Así no envías a un cliente el mismo recordatorio todos los días. | Campo | Qué rellenas | |---|---| | **Periodo** | Cuánto tiempo cuentan las ejecuciones anteriores, en minutos, horas, días o semanas. Por defecto 1 día | | **Por** | Sobre qué cuentas. Vacío significa por el registro con el que se inició el flujo, como la factura o la reserva. Rellena una variable, por ejemplo `{customer.id}`, para contar por cliente o por parcela | El paso tiene dos salidas: **Continuar** si el flujo no ha pasado por él en el periodo, y **Ya ejecutado** si sí lo ha hecho. Conecta **Ya ejecutado** a otro paso, o déjala vacía para que la ejecución termine ahí. Ten en cuenta lo siguiente: - Solo cuentan las ejecuciones de la misma automatización, y solo si pasaron por este paso a través de **Continuar** - Si no conectas **Eliminado** a nada, Tillor detiene los flujos en espera de ese registro y elimina las tareas que creó el flujo y que solo el flujo podía completar. Si conectas la salida, el flujo continúa por ahí - Si el flujo se inicia sin registro, por ejemplo con **Cada día a una hora**, rellena tú mismo una variable en **Por**. Sin ese valor cada ejecución es nueva y el paso no detiene nada - La ejecución que está en marcha ahora no cuenta Un ejemplo: **Periodo** 7 días y **Por** `{invoice.customerId}` deja pasar como máximo un recordatorio por semana y cliente, aunque ese cliente tenga varias facturas vencidas. ## Consultar un registro [#record-opzoeken] Carga un registro a partir de su id, de modo que los pasos posteriores puedan usar sus campos. Es útil cuando el evento solo aporta un id, como el mensaje de una conversación de la bandeja de entrada. | Campo | Qué rellenas | |---|---| | **Tipo de registro** | **Cliente**, **Reserva**, **Ocupación**, **Factura**, **Pago**, **Parcela**, **Tarea**, **Documento**, **Método de acceso**, **Etiqueta NFC**, **Contador**, **Conversación de la bandeja de entrada** o **Mensaje de la bandeja de entrada**. Por defecto **Mensaje de la bandeja de entrada** | | **ID** | El id del registro, por ejemplo `{messageId}`. Obligatorio | El paso tiene dos salidas: **Encontrada** y **No encontrada**. Si el registro no existe o el id está vacío, el flujo sigue por **No encontrada**. Tras **Encontrada**, los campos del registro están en variables que empiezan por `found` y luego el tipo: `{foundCustomer.firstName}`, `{foundInvoice.displayId}`, `{foundReservation.checkIn}`, `{foundTerrain.name}`, `{foundInboxMessage.direction}`. Los demás tipos se llaman `foundOccupation`, `foundPayment`, `foundTask`, `foundAccessMethod`, `foundNfcTag`, `foundMeter` y `foundInboxThread`. También se incluyen los registros a los que hace referencia, un nivel más abajo, como `{foundReservation.customer.firstName}`. Todo está en la lista detrás del botón **Variable**. Una segunda consulta del mismo tipo sustituye a la primera. Ojo con **Tarea**: usa el mismo nombre `foundTask` que [Buscar tarea](/automatiseringen/acties/taken#taak-zoeken), y gana la última de las dos. Lo mismo vale para **Documento** y `foundDocument` de [Buscar documento](/automatiseringen/acties/documenten#document-zoeken). ## Asignar variables [#variabelen-mappen] Copia valores a nuevos nombres de variable, para que los pasos posteriores puedan usar una única forma. Es útil cuando un mismo flujo se inicia con **Webhook entrante** (`{body.…}`) y con **Factura vencida** (`{invoice.…}`). | Campo | Qué rellenas | |---|---| | **Asignaciones** | Filas con **Variable destino** (p. ej. `invoice`) y **Fuente** (p. ej. `{foundInvoice}` o `{body.invoiceId}`) | El paso tiene una salida: **Siguiente**. Si la fuente es exactamente una variable entre llaves, por ejemplo `{foundInvoice}`, Tillor copia todo el registro (objeto). Si no, Tillor rellena la fuente como texto, como `Factura {foundInvoice.displayId}` en `meta.label`. Prueba típica con webhook: **Webhook entrante** → **Consultar un registro** (Factura, id `{body.invoiceId}`) → **Asignar variables** (`invoice` ← `{foundInvoice}`) → las mismas condiciones y aprobación que con el disparador por programación. ## Ejecutar código [#code-uitvoeren] Ejecuta un trozo de TypeScript sobre las variables del flujo y guarda lo que devuelve como nueva variable. Sirve para lógica que no cabe en campos y condiciones: qué subtareas hacen falta, calcular un importe o una fecha, transformar el cuerpo de un webhook. | Campo | Qué rellenas | |---|---| | **Código** | TypeScript. Las variables se escriben como en los textos, con llaves: `{customer.firstName}` se lee como valor, no se rellena como texto. Termina con `return`. Obligatorio | | **Variable de salida** | El nombre con el que los pasos posteriores leen el resultado, como `result` (entonces `{result}`) o `result.names`. Por defecto `result` | El paso tiene una salida: **Siguiente**. Así funciona: - El código solo ve las variables que menciona. Una variable que el flujo no tiene es `null`; una fecha llega como texto (`2026-07-01T10:00:00.000Z`) - Los formatos y desplazamientos de fecha (`{bedrag|currency}`, `{datum + 1 day}`) no funcionan aquí: calcúlalos en el código - Devuelve una lista, un texto, un número o un objeto. Un objeto se lee después campo a campo: `{result.total}` - El código no puede obtener ni enviar nada: sin internet, sin base de datos. Solo calcula. Si calcula demasiado tiempo (más de 50 ms), se interrumpe - Si el código lanza un error, la ejecución se detiene con ese error y el número de línea. Los ves en la pestaña **Ejecuciones** - A la derecha del código ves enseguida lo que devuelve con el ejemplo; al probar, se ejecuta también Un ejemplo: tras la salida quieres subtareas que dependen de la parcela. Pon un paso **Ejecutar código** con: ```ts const tasks = ["Plaats vegen", "Sanitair"]; if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren"); return tasks; ``` Después, en **Crear tarea**, rellena el campo **Subtareas** solo con `{result}`: cada texto de la lista se convierte en una subtarea. ## Para cada [#voor-elk] Ejecuta los pasos posteriores a **Para cada** una vez por cada elemento de una lista, por ejemplo por cada factura abierta de un cliente. El propio flujo continúa por **Hecho**. | Campo | Qué rellenas | |---|---| | **Lista** | **Métodos de acceso de un cliente**, **Etiquetas NFC de un cliente**, **Facturas abiertas de un cliente**, **Reservas confirmadas de un cliente**, **Ocupaciones de un cliente**, **Documentos de un cliente** (solo activos) o **Contadores de una parcela**. Por defecto **Métodos de acceso de un cliente** | | **De** | El cliente o la parcela de la que quieres la lista, por ejemplo `{customer.id}` o `{occupation.terrainId}`. Obligatorio | El paso tiene dos salidas con significado propio: - **Para cada** lleva a los pasos que quieres hacer por cada elemento - **Hecho** es por donde continúa el propio flujo Así funciona: - Cada elemento recibe su propia ejecución, que recorre los pasos posteriores a **Para cada** hasta el final de esa rama. Las ves en la pestaña **Ejecuciones**, que solo muestra las últimas 20 - El elemento está en la variable `item`, por ejemplo `{item.id}`. Las variables del evento y de pasos anteriores siguen disponibles - El flujo no espera a que terminen los elementos. Nada más iniciarlos, continúa por **Hecho**. Por eso no puedes usar el resultado de un elemento en los pasos posteriores a **Hecho** - Se procesan como máximo 100 elementos, los más antiguos primero. Si hay más en la lista, los demás no se procesan - Si la lista está vacía o el campo **De** está vacío, no se inicia nada y el flujo continúa de inmediato por **Hecho** - **Facturas abiertas de un cliente** son facturas contabilizadas de las que aún queda algo pendiente. **Reservas confirmadas de un cliente** son reservas con el estado **Reservada** Un ejemplo: una factura vence y quieres crear un enlace de pago por cada factura abierta de ese cliente. Elige **Facturas abiertas de un cliente**, rellena `{invoice.customerId}` en **De** y pon detrás de **Para cada** un paso **Crear enlace de pago** con `{item.id}` como factura. ## Esperar hasta [#wachten-tot] Comprueba condiciones una y otra vez hasta que se cumplen, o se detiene pasado un tiempo. Úsalo cuando no sepas cuándo ocurrirá algo pero sí qué esperas, por ejemplo hasta que una factura esté pagada. | Campo | Qué rellenas | |---|---| | **Hasta** | Una o varias condiciones, igual que en [Si / si no](#als--anders) | | **Comprobar cada** | Cada cuánto vuelve a mirar Tillor, en minutos, horas, días o semanas. Mínimo 5 minutos. Por defecto 1 hora | | **Dejar de esperar tras** | Cuánto espera el paso como máximo. Por defecto 7 días | El paso tiene dos salidas: **Cumplido** (se cumplen las condiciones) y **Tiempo agotado** (ha pasado el tiempo de espera sin que se cumplieran). Ten en cuenta lo siguiente: - La primera comprobación se hace de inmediato. Si las condiciones ya se cumplen, el flujo continúa directamente por **Cumplido**. Si no has rellenado ninguna condición, siempre se cumple - En cada comprobación, Tillor vuelve a leer los registros del evento, como en un [retraso](#gegevens-worden-opnieuw-gelezen). Una condición como `invoice.paymentStatus` es `PAID` ve, por tanto, el pago en cuanto existe - Un intervalo inferior a 5 minutos pasa a ser de 5 minutos - Durante la espera, la ejecución recibe el estado **En espera**. Para pausar y modificar el flujo vale lo mismo que en [Retraso](#wat-er-tijdens-het-wachten-gebeurt) ## Esperar un evento [#wachten-op-een-gebeurtenis] Pausa el flujo hasta que ocurra algo en Tillor, por ejemplo que la factura se haya pagado. | Campo | Qué rellenas | |---|---| | **Evento** | Lo que esperas. La misma lista que en el [disparador](/automatiseringen/triggers#als-er-iets-gebeurt). Obligatorio | | **Solo para el mismo registro** | Continúa solo si el evento trata del registro con el que se inició el flujo. Activado por defecto | | **Dejar de esperar tras** | Cuánto espera el paso como máximo. Por defecto 7 días | El paso tiene dos salidas: **Recibido** (llegó el evento) y **Tiempo agotado** (ha pasado el tiempo de espera sin evento). Si **Solo para el mismo registro** está activado, se añade una tercera salida, **Eliminado**. Úsala cuando se eliminó el registro del flujo mientras este esperaba. Ten en cuenta lo siguiente: - Con **Solo para el mismo registro** activado cuenta, por ejemplo, solo el pago de la factura con la que se inició el flujo. Si lo desactivas, cualquier evento de ese tipo hace que el flujo continúe - Si no conectas **Eliminado** a nada, Tillor detiene los flujos en espera de ese registro y elimina las tareas que creó el flujo y que solo el flujo podía completar. Si conectas la salida, el flujo continúa por ahí - Si el flujo se inicia sin registro, por ejemplo con **Cada día a una hora**, cuenta cualquier evento de ese tipo - Un evento causado por un paso de una automatización también cuenta. Los flujos en espera continúan, por tanto, también con el trabajo de **Flujo de trabajo** - Tras **Recibido**, los datos del evento que esperabas están en las variables, sin el compañero que lo causó. Si esperas `invoice:paid`, `{invoice.paymentStatus}` te da después el nuevo estado - Durante la espera, la ejecución recibe el estado **En espera**. Para pausar y modificar el flujo vale lo mismo que en [Retraso](#wat-er-tijdens-het-wachten-gebeurt) ## Pedir una decisión [#vraag-om-een-beslissing] Crea una tarea con botones que defines tú y espera a que alguien elija un botón. Así incorporas un momento en el que una persona revisa, por ejemplo antes de que el flujo bloquee a un cliente o contabilice una factura. Cada opción es un botón de la tarea y una salida del paso. | Campo | Qué rellenas | |---|---| | **Título de la tarea** | El título de la tarea. Obligatorio | | **Descripción** | Explica a tu compañero qué debe decidir | | **Opciones** | Los botones de la tarea. Consulta más abajo. Al menos una | | **Asignar a** | Elige uno o varios compañeros | | **Asignar a grupos** | Elige uno o varios grupos | | **Vincular a** | Los registros en los que aparece la tarea, como el cliente o la factura. Rellenado de antemano con los registros que se conocen en este paso | | **Dejar de esperar tras** | Cuánto espera el paso como máximo. Por defecto 3 días | ### Configurar las opciones [#opties-instellen] 1. En **Opciones**, haz clic en **Añadir opción** y rellena el nombre, por ejemplo **Aprobar**. Ese nombre aparece en el botón y en la salida 2. Haz clic en el cuadrito de color a la izquierda del nombre (**Icono y color**) para elegir un color y un icono. El icono no es obligatorio 3. Activa **Pedir una nota** si el compañero debe indicar un motivo con esta elección 4. Activa **Pedir confirmación** si el compañero debe confirmar primero. Entonces rellenas un **Título de confirmación** y un **Mensaje de confirmación** y eliges en **Gravedad** entre **Info**, **Advertencia** o **Destructivo**. En estos textos puedes usar variables 5. Repite esto para cada opción. Puedes crear como máximo 8 opciones Si la lista aún está vacía, el botón **Aprobar / Rechazar** prepara de inmediato dos opciones: un **Aprobar** verde y un **Rechazar** rojo. Cada opción necesita un nombre; si no, Tillor avisa **Cada opción necesita un nombre.** Sin opciones, Tillor avisa **Añade al menos una opción.** ### Salidas [#uitgangen] El paso tiene una salida por opción, con el nombre y el color de esa opción, y además siempre **Tiempo agotado**. | Salida | Cuándo | |---|---| | El nombre de una opción | Alguien eligió ese botón en la tarea | | **Tiempo agotado** | Ha pasado el tiempo de espera sin elección, o se eliminó la tarea | Ten en cuenta lo siguiente: - Los botones están en la tarjeta de la tarea, en la lista de tareas y en la propia tarea. Una tarea así no tiene casilla: no puedes completarla sin más, solo elegir un botón. Tras la elección, la tarea queda en **Completada** y se indica qué opción se eligió. Consulta [Tareas con botones de elección](/taken/taakdetails#taken-met-keuzeknoppen) - Puede elegir quien tenga asignada la tarea, también mediante un grupo, y los administradores. Si no asignas a nadie, puede elegir cualquiera que vea la tarea - La tarea recibe prioridad **Alta**. Aparece a nombre de **Flujo de trabajo** - Si se elimina la tarea antes de que alguien elija, el flujo continúa por **Tiempo agotado**. Tras **Tiempo agotado** por el tiempo de espera, la tarea sigue existiendo - Los pasos posteriores pueden usar `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}` y `{approval.decidedBy.name}`. `{approval.label}` es el nombre de la opción elegida y `{approval.note}` la nota que rellenó el compañero - Durante la espera, la ejecución recibe el estado **En espera**. Para pausar y modificar el flujo vale lo mismo que en [Retraso](#wat-er-tijdens-het-wachten-gebeurt) Una [ejecución de prueba](/automatiseringen/testen-en-uitvoeringen) no puede saber si estás abierto, qué decide un compañero ni si un registro existe. Por eso, bajo **¿Qué ocurre en estos pasos?** eliges tú la salida de **¿Abierto ahora?**, **Como máximo una vez por periodo**, **Consultar un registro**, **Para cada**, **Esperar hasta**, **Esperar un evento** y **Pedir una decisión**. En **Para cada**, la prueba sigue por la salida que elijas, **Para cada** o **Hecho**, no por las dos. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una salida que no conectas hace que la ejecución termine ahí. - En un paso de espera, la ejecución recibe el estado En espera y continúa más tarde. Una automatización pausada detiene las ejecuciones en espera en cuanto pasa el tiempo de espera. - Tras un tiempo de espera, Tillor vuelve a leer los datos, de modo que los pasos vean la situación actual. ## ¿Problemas? [#problemen] Un paso **Si / si no** necesita al menos una condición. Haz clic en **Añadir condición**. Rellena en **Duración** una cantidad mayor que 0. Un paso **Según el valor** compara el valor exactamente, incluidas las mayúsculas. Los valores de selección están en la notación de Tillor, como `RENTAL_CARAVAN`. Si el campo está vacío, el flujo también sigue por **Predeterminado**. Un paso **Pedir una decisión** necesita al menos una opción con nombre. Haz clic en **Añadir opción** en **Opciones**. El flujo espera un tiempo, una condición, un evento o una decisión. En la pestaña **Ejecuciones** aparece cuándo continúa o caduca. En **Esperar hasta** es por defecto tras 7 días, en **Pedir una decisión** tras 3 días. Si se elimina la tarea antes de que alguien elija, el flujo continúa por **Tiempo agotado**. Consulta [Tareas con botones de elección](/taken/taakdetails#taken-met-keuzeknoppen). # Problemas y activación (/es-ES/automatiseringen/problemen) Tillor revisa tu flujo de forma continua mientras lo construyes. Mientras haya problemas abiertos, no puedes activar la automatización. Así se evita que un flujo que no puede funcionar intente enviar recordatorios o tareas reales. ## Dónde ves los problemas [#waar-zie-je-de-problemen] - En cada paso con un problema aparece un pequeño número de advertencia - En el panel de la derecha, los problemas del paso seleccionado aparecen en un bloque naranja encima de los ajustes - En la parte superior del panel hay un botón con el total, por ejemplo **3 problemas**. Haz clic para ver la lista y haz clic en un aviso para saltar al paso - En la vista general de automatizaciones aparece una etiqueta como **3 problemas** junto al nombre, y un filtro **Problemas** ## Por qué no puedo activarla [#waarom-kan-ik-niet-inschakelen] El interruptor **Activo** no funciona mientras haya problemas, con el texto **Corrige primero los problemas pendientes**. En la vista general tampoco puedes activar el interruptor de la automatización. Si la automatización ya está activada, no puedes guardar cambios que tengan problemas. Un flujo que está en marcha debe seguir siendo válido. Corrige los problemas o pausa antes la automatización. ## Qué significan los avisos [#wat-de-meldingen-betekenen] | Aviso | Qué ocurre | Qué haces | |---|---|---| | **Añade un disparador para empezar.** | El flujo no tiene disparador | Un flujo necesita siempre al menos un disparador. Arrastra **Cuando ocurra esto** desde la lista de la izquierda al lienzo | | **Este evento ya no existe. Elige otro.** | El evento del disparador ya no existe | Elige otro en **Evento** | | **No está conectado, así que este paso nunca se ejecuta.** | Ninguna línea llega al paso | Conecta el paso a una salida de otro paso o elimínalo | | **Este paso forma parte de un bucle. Un flujo solo puede avanzar.** | Una línea vuelve a un paso anterior | Elimina la línea que apunta hacia atrás. Un flujo no puede dar vueltas en círculo | | **[Campo] es obligatorio.** | Un campo obligatorio está vacío, como el **Título** de una tarea | Rellena el campo. Los campos obligatorios llevan un asterisco | | **[Campo]: [variable] no está disponible en este paso.** | Usas una variable que no existe en este paso | Elige una variable de la lista detrás del botón **Variable**. Comprueba también que el paso que genera la variable esté antes en el flujo | | **[Campo] no es un JSON válido.** | El **Payload** o el **Body** no es JSON correcto | Revisa llaves, comas y comillas. Las variables están permitidas | | **Añade al menos una opción.** | Un paso **Pedir una decisión** no tiene opciones | Haz clic en **Añadir opción** en **Opciones** | | **Cada opción necesita un nombre.** | Una opción de **Pedir una decisión** no tiene nombre | Rellena el nombre o elimina la opción | | **Añade una condición.** | Un paso **Si / si no** no tiene condiciones | Haz clic en **Añadir condición** | | **Una condición no tiene un campo válido.** | El campo de una condición está vacío o es desconocido | Elige o escribe un campo que esté en la lista detrás de **Variable** | | **Introduce un valor para [variable].** | Una condición tiene una comparación pero aún no tiene valor | Rellena el valor o elige una comparación como **está vacío** que no necesita ninguno | | **[Campo]: [variable] no es un formato conocido.** | Usas detrás del `\|` un formato que no existe | Usa `currency`, `number`, `date`, `datetime`, `time`, `upper` o `lower`. Consulta [Dar formato a un valor](/automatiseringen/variabelen#een-waarde-opmaken) | | **[Campo]: [variable] no es una unidad.** | Escribes un desplazamiento de fecha con una unidad que no existe | Usa `minutes`, `hours`, `days`, `weeks` o `months` | | **[Campo]: el campo personalizado [variable] no existe.** | Usas un campo personalizado que no existe (ya) | Elige un campo existente de la lista detrás de **Variable** | | **[Campo]: [variable] tiene un formato o un desplazamiento de fecha, que solo funciona en textos.** | Usas un formato en el campo de código de **Ejecutar código** | Calcúlalo en el código | | **[Campo]: [variable] no es un nombre de variable.** | El nombre de un resultado contiene caracteres no permitidos | Usa letras, cifras y puntos, como `result` o `result.names` | | **Un retraso de 0 no hace nada.** | El retraso está en 0 | Indica una duración mayor que 0 | | **La ruta debe empezar por / y permanecer dentro de la API de tu organización.** | La **Ruta** de una solicitud API no está permitida | Haz que la ruta empiece por una sola `/` y no incluyas `..` ni `\` | | **La URL debe empezar por https://.** | La **URL** de una solicitud API no es segura | Usa una dirección que empiece por `https://` | | **La expresión cron no es válida. Usa cinco campos, como 0 8 * * 1.** | La expresión cron no es correcta | Consulta [Según una expresión cron](/automatiseringen/triggers#volgens-een-cron-expressie) | ## Qué no puede comprobar Tillor de antemano [#wat-tillor-niet-vooraf-kan-controleren] Algunos errores solo salen a la luz cuando el flujo se ejecuta de verdad. - Una URL formada por variables solo se puede comprobar cuando está rellena - En los eventos cuyos datos no están descritos, Tillor no comprueba las variables - Si un registro existe, si se puede enviar una factura o si otro servidor está disponible, solo se sabe durante una ejecución Un flujo sin avisos no es, por tanto, necesariamente un flujo que siempre funciona. Pruébalo con [Pruebas y ejecuciones](/automatiseringen/testen-en-uitvoeringen) y revisa las primeras ejecuciones reales. Si cambia un evento o un campo en el que se apoya tu flujo, lo verás como aviso en el paso correspondiente. Modifica el paso antes de volver a activar la automatización. # Pruebas y ejecuciones (/es-ES/automatiseringen/testen-en-uitvoeringen) En el editor trabajas con dos pestañas para comprobar si un flujo hace lo que quieres: **Ejecución de prueba** para un ensayo y **Ejecuciones** para lo que ha ocurrido de verdad. Las abres a la derecha, en el panel. La cuarta pestaña, **Historial**, muestra versiones anteriores del flujo, consulta [Versiones anteriores](/automatiseringen/aan-de-slag#eerdere-versies). ## Una ejecución de prueba [#een-testuitvoering] Elige la pestaña **Ejecución de prueba**. Una prueba recorre el flujo con datos de ejemplo y muestra qué pasos daría. Una ejecución de prueba no envía nada, no crea nada y no cambia nada. Los retrasos se omiten, para que veas enseguida el resultado final. Las acciones solo muestran lo que harían, con el texto **No se ejecuta en una prueba.** ### Datos de ejemplo [#voorbeeldgegevens] Arriba está **Probar con un registro real**. Para cada registro del disparador, como **Ocupación**, elige un registro con **Elegir un registro** (busca por nombre o número). Tillor carga el registro tal como está ahora, con los registros a los que hace referencia, en los datos de ejemplo. La prueba sigue sin enviar, crear ni cambiar nada. Bajo **Datos de ejemplo del evento** están los datos con los que trabaja la prueba, en formato JSON. Si la automatización ya se ha iniciado alguna vez de verdad, la prueba empieza con los datos de la última ejecución real. Si no, Tillor rellena un ejemplo con la forma del evento: un texto pasa a ser *example*, un número 1 y una fecha el momento actual. Cambia los valores para probar otros casos, por ejemplo otro tipo de parcela o una factura con otro estado. Si el texto no es un JSON válido, aparece **Los datos de ejemplo no son un JSON válido.** y no puedes iniciar la prueba. Si el flujo contiene una **Solicitud API**, aparece también un campo **Ejemplo de respuesta de la API**. Pega ahí la respuesta que esperas de la solicitud. Así la prueba puede recorrer los pasos posteriores a la solicitud, y Tillor ofrece los campos de la respuesta como variables. Consulta [Usar una respuesta de API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). ### Qué ocurre en estos pasos [#wat-gebeurt-er-bij-deze-stappen] En algunos pasos el resultado depende del mundo exterior: **Enviar webhook**, **Solicitud API**, acciones con una salida **Omitido** o **Error**, y lógica como **¿Abierto ahora?**, **Consultar un registro**, **Esperar un evento** y **Pedir una decisión**. Bajo **¿Qué ocurre en estos pasos?** eliges para cada paso por qué salida continúa la prueba. Así pruebas también el camino para cuando algo sale mal. ### El resultado [#het-resultaat] Haz clic en **Ejecutar prueba**. Verás los pasos en orden, con, para cada paso: - los valores rellenados, por ejemplo el título de una tarea tal como se crearía - en una condición, por cada línea qué se comparó y si se cumplió. Verde es correcto, rojo no, con el valor que había realmente (*era …*) - por qué salida continuó el flujo (**Continúa por: Sí**) - en un retraso, hasta cuándo se esperaría Después de ejecutar, el botón pasa a llamarse **Ejecutar de nuevo**. La prueba reproduce los pasos uno a uno (**Paso 2 de 5…**). Con **Mostrar todo** te saltas esa reproducción. En el lienzo se colorea el camino que siguió la prueba, y los pasos que no llegaron a ejecutarse se atenúan. Haz clic en el nombre de un paso en el resultado para saltar a ese paso. Abajo aparece **Terminó tras 5 pasos.** Si el filtro de **Solo cuando** no coincide con tus datos de ejemplo, verás **El filtro del disparador no coincide con estos datos, así que el flujo no se iniciaría.** Comprueba entonces qué condición está en rojo. Con **Borrar** quitas el resultado del lienzo. ### Qué no muestra una prueba [#wat-een-test-niet-laat-zien] - Si una factura se puede enviar de verdad, si un endpoint está disponible o si existe una ruta de API - Cómo se ven los registros después de un retraso. La prueba trabaja con tus datos de ejemplo y no vuelve a leer nada - Errores que solo aparecen con datos reales, como un campo vacío Por eso, revisa siempre las primeras ejecuciones reales en la pestaña **Ejecuciones**. ## Ejecuciones reales [#echte-uitvoeringen] En la pestaña **Ejecuciones** están las últimas 20 ejecuciones reales de esta automatización, las más recientes arriba. La lista se actualiza sola aproximadamente cada 15 segundos. Mientras no se haya iniciado nada, aparece **Aún no hay ejecuciones. Activa la automatización y espera a su evento.** Cada ejecución muestra la hora de inicio, el número de pasos o (en una espera) cuándo continúa, y un estado. | Estado | Qué significa | |---|---| | **En curso** | La ejecución está en marcha ahora mismo | | **En espera** | La ejecución está en un [retraso](/automatiseringen/logica#vertraging), espera un evento o una aprobación, y continuará más tarde | | **Completada** | El flujo se ha recorrido hasta el final | | **Fallida** | No se pudo ejecutar un paso. El aviso aparece como **Falló: …** | | **Cancelada** | La ejecución se detuvo porque la automatización se pausó o se eliminó mientras esperaba | Haz clic en una ejecución para abrirla. Verás entonces: - todos los pasos realizados, con la hora y lo que hizo el paso - los valores rellenados, por ejemplo el título que recibió realmente la tarea - en una condición, qué líneas se cumplieron - en un paso fallido, el mensaje de error, que puede estar en inglés En el lienzo se colorea el camino que siguió esta ejecución. Los pasos que no llegaron a ejecutarse se atenúan. Haz clic en el nombre de un paso para saltar a ese paso. Debajo de los pasos hay un botón como **3 conjuntos de datos**. Muestra los datos con los que empezó la ejecución y lo que produjo cada acción, como el id de la tarea creada o la respuesta de una solicitud API. Así puedes comprobar qué valores tenía una variable. Abajo, en una ejecución abierta, hay también una **Traza**: un código de letras y cifras. Si algo no cuadra en una ejecución, pasa ese código a soporte. Así encontramos exactamente esta ejecución. Los eventos que no superaron el filtro de **Solo cuando**, o para los que la automatización ya se ejecutó una vez con **Ejecutar una vez por registro**, no inician ninguna ejecución y por eso no aparecen en la lista. En la vista general de automatizaciones aparece, junto a cada automatización, la hora de la última ejecución, con una barrita al lado por cada ejecución reciente. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tras una ejecución de prueba no ha cambiado nada en Tillor. La automatización solo funciona de verdad cuando activas **Activo**. - Las ejecuciones reales permanecen en la pestaña **Ejecuciones**. Esta muestra las últimas 20. - Una ejecución fallida genera un correo para quien creó la automatización, como máximo uno por hora. ## ¿Problemas? [#problemen] Tillor muestra **Los datos de ejemplo no son un JSON válido.** y no deja iniciar la prueba. Revisa llaves, comas y comillas. Con estos datos de ejemplo el flujo no se iniciaría. Mira qué condición está en rojo y ajusta los datos o la condición. Tillor muestra **Aún no hay ejecuciones. Activa la automatización y espera a su evento.** Los eventos que no superaron el filtro no aparecen. Consulta [Preguntas frecuentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet). Una prueba no envía nada y no vuelve a leer registros. Si una factura se puede enviar o una dirección está disponible, solo se sabe de verdad en la ejecución. Abre la ejecución para ver el mensaje de error y los datos de cada paso. ¿Necesitas ayuda de soporte? Pasa el código de la **Traza** de la ejecución. ## Una ejecución que no quiere iniciarse [#een-uitvoering-die-niet-wil-starten] Consulta [Preguntas frecuentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet) para una lista de comprobación. # Disparadores (/es-ES/automatiseringen/triggers) El disparador es el momento de inicio de una automatización: el "cuándo". Está en la parte superior de cada flujo, bajo el nombre **Cuando ocurra esto**. Un ejemplo: *empieza cuando termina una ocupación*. También determina qué datos pueden usar los pasos siguientes. Un flujo puede tener varios disparadores. Cada disparador inicia una ejecución propia, con su propio filtro. Añades uno desde la lista de la izquierda. El último disparador no se puede eliminar. ## Cuándo empieza la automatización [#waar-start-de-automatisering-op] En **Empieza por** eliges uno de los siete momentos de inicio. | Opción | Empieza cuando | |---|---| | **Cuando ocurre algo** | Ocurre un evento en Tillor, como una ocupación que termina o una factura que se paga | | **Factura vencida** | Una factura contabilizada sigue pendiente después de la fecha de vencimiento | | **Webhook entrante** | Otro sistema envía un mensaje a la dirección propia de la automatización | | **Se elige una acción de tarea** | Alguien elige en una tarea un botón de opción vinculado a esta automatización | | **Se alcanza una fecha** | Se alcanza una fecha de un registro, opcionalmente un tiempo antes o después. Por ejemplo, un día antes de la llegada de una reserva | | **Cada día a una hora** | Es la hora elegida de cada día | | **Según una expresión cron** | Le toca el horario que indicas | Primero eliges, por tanto, el tipo de momento de inicio y después los detalles. Si eliges otro momento de inicio, los filtros de **Solo cuando** se vacían. Estaban escritos para la elección anterior y ya no encajan. ## Cuando ocurre algo [#als-er-iets-gebeurt] En **Evento** eliges qué debe iniciar la automatización. Haz clic en el campo y escribe para buscar, por ejemplo *occupation* o *invoice*. Los eventos aparecen con la notación de Tillor, como `occupation:ended`: primero de qué trata y después qué ocurrió. Estos son los eventos que necesitarás con más frecuencia: | Evento | Empieza cuando | |---|---| | `occupation:ended` | Termina una ocupación | | `reservation:created` | Se crea una reserva | | `reservation:updated` | Se modifica una reserva | | `customer:created` | Se crea un cliente | | `customer:updated` | Se modifica un cliente | | `invoice:created` | Se crea una factura | | `invoice:updated` | Se modifica una factura | | `invoice:paid` | Una factura está pagada | | `payment:created` | Entra un pago | | `task:created` | Se crea una tarea | | `task:status-changed` | Cambia el estado de una tarea | | `task:assigned` | Se asigna una tarea a alguien | | `task:action-chosen` | Alguien elige un botón de opción en una tarea | | `integration-alarm:created` | Un contador emite una alarma | | `comment:created` | Se publica un comentario | | `document:created` | Se añade un documento | | `signatureRequest:updated` | Se actualiza una solicitud de firma | | `signatureRequest:completed` | Todos los firmantes de una solicitud de firma han firmado | | `mandate-agreement:signed` | Un cliente ha firmado un mandato SEPA | | `mandate-agreement:activated` | Un mandato SEPA se ha activado | | `mandate-agreement:expired` | Una solicitud de mandato SEPA ha caducado sin firma | | `mandate-agreement:failed` | La activación de un mandato SEPA ha sido rechazada o ha fallado | | `productPriceChange:applied` | Entra en vigor un [precio de producto programado](/producten/prijzen-plannen) | Es la misma lista que la de los [webhooks](/ontwikkelaars/events). Por tanto, puedes usar cualquier evento para el que Tillor pueda enviar un webhook. Algunos eventos que ocurren con muchísima frecuencia, como el estado físico de las barreras, la escritura en la bandeja de entrada, los registros de controladores y la presencia de vehículos, no figuran en la lista. Bajo el campo **Evento** está el enlace **¿Falta un evento? Solicítalo**. Consulta [Solicitar un paso o un evento](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen). ### Qué datos recibes [#welke-gegevens-krijg-je-mee] La mayoría de los eventos llevan asociado un registro, como una ocupación, una factura o una tarea. Ese registro, más los registros a los que se refiere, están disponibles después como variables en los pasos. En `occupation:ended`, por ejemplo, puedes usar: - `{occupation.terrain.name}` para el nombre de la parcela - `{occupation.customer.firstName}` para el nombre del cliente - `{occupation.reservation.displayId}` para el número de la reserva. No toda ocupación tiene una reserva: en ese caso queda vacío Además, siempre están `{triggeredBy.name}` y `{triggeredBy.id}`: el compañero que provocó el evento. Si el evento lo provocó el sistema, por ejemplo una sincronización bancaria, esos campos están vacíos. Bajo los ajustes del disparador está **Datos que proporciona este evento**. Ahí ves exactamente qué variables puedes usar. En un evento cuyos datos no están descritos, Tillor indica que no hay nada que elegir. Las variables que escribas tú mismo siguen funcionando. Consulta [Variables y plantillas](/automatiseringen/variabelen). ## Se elige una acción de tarea [#er-wordt-een-taakactie-gekozen] Algunas tareas tienen botones de opción en lugar de una casilla, por ejemplo de [Pedir una decisión](/automatiseringen/logica#vraag-om-een-beslissing). Un botón puede estar vinculado a una automatización. Con este disparador, esa automatización empieza en cuanto alguien elige ese botón. Consulta también [Tareas con botones de opción](/taken/taakdetails#taken-met-keuzeknoppen). Vincular un botón a una automatización no se hace en el editor de flujos. Si lo necesitas, pídeselo al administrador de Tillor o a soporte. Los pasos reciben los datos de la tarea, por ejemplo `{task.name}` y `{task.id}`, además de `{action.label}` (el nombre del botón elegido) y `{note}` (la nota que rellenó el compañero, si el botón la pedía). Bajo **Datos que proporciona este evento** ves la lista completa. ## Factura vencida [#factuur-is-vervallen] Este disparador se activa para cada factura que: - está contabilizada (los borradores y las facturas canceladas no cuentan) - no es una nota de crédito - aún tiene un importe pendiente - tiene una fecha de vencimiento anterior a hoy Para cada una de esas facturas empieza una ejecución propia. Los datos de la factura y del cliente están disponibles como `{invoice.…}`, por ejemplo `{invoice.displayId}`, `{invoice.amountOutstanding}` y `{invoice.customer.firstName}`. Si desactivas **Ejecutar una vez por registro**, la automatización empieza para la misma factura como máximo una vez al día mientras esté vencida. Si lo dejas activado, empieza exactamente una vez por factura. Normalmente es lo que quieres para un recordatorio. En **Pendiente de recordatorio** eliges cuánto tiempo debe llevar abierta la factura, con la misma regla que en la lista de facturas. Activa **Omitir clientes excluidos de recordatorios automáticos** para saltarte a los clientes que lo tienen indicado en sus ajustes de facturación. Una factura que se ha excluido de los recordatorios automáticos tampoco inicia el flujo. ## Webhook entrante [#inkomende-webhook] Un webhook es un mensaje que un sistema envía a una dirección. Con este disparador, ese sistema inicia la automatización, por ejemplo tu sitio web, un formulario o una plataforma de reservas. Cada automatización recibe una dirección propia y secreta. 1. En **Empieza por** elige **Webhook entrante** 2. Guarda la automatización. En **Dirección** aparece la URL 3. Haz clic en **Copiar** y configura la dirección en el otro sistema 4. Activa la automatización El otro sistema envía un `POST` con JSON a esa dirección. El contenido queda disponible después como `{body.…}`, por ejemplo `{body.email}` o `{body.reservering.nummer}`, y los parámetros de la URL como `{query.…}`. Con **Solo cuando** también puedes filtrar por esos campos. Así funciona además: - La dirección es el secreto. Quien la conozca puede iniciar la automatización. Compártela, por tanto, solo con el sistema que la necesita - Si la dirección se filtra, haz clic en **Nueva dirección** y guarda. La dirección anterior deja de funcionar desde ese momento - Una automatización desactivada o una dirección incorrecta devuelve un error `404` - El contenido puede ser de 100 KB como máximo - Cada llamada inicia una ejecución por disparador de webhook del flujo. La dirección pertenece al primer disparador de webhook. **Nueva dirección** en ese disparador la sustituye - No hay ningún registro vinculado, así que **Ejecutar una vez por registro** no tiene efecto ### Ignorar repeticiones [#herhalingen-negeren] Si el otro sistema envía a veces la misma llamada dos veces, con **Ignorar repeticiones** evitas que el flujo empiece dos veces. Tillor recuerda una clave de la llamada. Si vuelve la misma clave, no empieza nada. | Opción | Cuál es la clave | |---|---| | **Cada llamada inicia el flujo** | No hay clave. Predeterminado | | **Desde una cabecera** | El valor de una cabecera que eliges en **Nombre de la cabecera**, por ejemplo `Idempotency-Key` | | **Desde el cuerpo JSON** | El valor de un campo del JSON, que eliges en **Campo**, como `id` o `data.eventId` | | **El mismo cuerpo JSON** | Todo el contenido. Una llamada con exactamente el mismo contenido cuenta como repetición | En **Recordar la clave durante** eliges cuánto tiempo vale la clave, en horas, días o semanas. Pasado ese tiempo, la misma clave vuelve a iniciar el flujo. Con 0, la clave vale hasta que elimines la automatización. Una llamada sin la cabecera elegida o sin el campo elegido se rechaza. ## Se alcanza una fecha [#een-datum-is-bereikt] Este disparador empieza en una fecha de un registro. En **Fecha** eliges cualquier campo de fecha de un registro que Tillor también envía con los eventos, escrito como registro y campo. Algunos ejemplos: | Fecha | Registro | |---|---| | `reservation.checkIn` | La fecha de llegada de una reserva | | `reservation.checkOut` | La fecha de salida de una reserva | | `invoice.dueDate` | La fecha de vencimiento de una factura | | `task.dueDate` | La fecha límite de una tarea | | `occupation.paidUntil` | Hasta cuándo está pagada una ocupación | | `accessMethod.periodTo` | El fin de la validez de un código QR, una matrícula u otro método de acceso | | `nfcTag.activatedUntil` | Hasta cuándo está activada una etiqueta NFC | | `mandateAgreement.expiresAt` | Cuándo caduca una solicitud para firmar un mandato SEPA | | `customer.birthday` | La fecha de nacimiento de un cliente | | `contact.birthday` | La fecha de nacimiento de una persona de contacto | De forma predeterminada, el disparador empieza una vez, en la propia fecha. Activa **Repetir cada año** para que solo cuenten el día y el mes: el flujo empieza entonces cada año de nuevo, como en el cumpleaños con `contact.birthday`. Un 29 de febrero cae en otros años el 28 de febrero. También puedes elegir datos que se guardan en un registro como campos adicionales. `document.userMetadata.insuranceExpiryDate` es la fecha de vencimiento de un documento, como el justificante de pago del seguro. Una fecha así, sin hora, cuenta como medianoche (UTC, la hora estándar internacional). Con **Solo cuando** limitas entonces el disparador a un tipo, por ejemplo `document.userMetadata.documentType` es `INSURANCE_PAYMENT_PROOF`, y a documentos activos con `document.status` es `ACTIVE`. Con **Cuánto tiempo** y **Antes o después** desplazas el momento. *1 día* y **Antes** en `reservation.checkIn` inicia el flujo un día antes de la llegada. Con 0 empieza en la propia fecha. Una fecha sin hora cuenta como medianoche. Con **Hora** eliges en qué momento de ese día empieza el flujo. **La hora de la fecha** usa el momento que figura en el campo, como la hora de llegada de una reserva. **Hora fija del día** empieza el día de la fecha a la hora y el minuto que elijas, en la zona horaria de tu organización. Así, `contact.birthday` con **Repetir cada año** empieza cada año a las 09:00 en el cumpleaños. **Cuánto tiempo** cuenta entonces desde esa hora: *1 día* y **Antes** empieza el día anterior a las 09:00, aunque esa noche cambie la hora del reloj. Para cada registro empieza una ejecución propia, con los datos de ese registro como variables, por ejemplo `{reservation.displayId}` y `{reservation.customer.firstName}`. Con **Solo cuando** lo limitas, por ejemplo a reservas con estado confirmado. Así funciona además: - Por registro y por momento, el flujo empieza una vez. Si la fecha se desplaza a más tarde, por ejemplo porque un huésped llega más tarde, vuelve a empezar en el nuevo momento - Si el momento ya había pasado cuando guardaste o activaste la automatización, ya no empieza por él - Los momentos perdidos, por ejemplo durante un mantenimiento, Tillor los recupera hasta una hora después ## Cada día a una hora [#elke-dag-op-een-uur] En **Hora** elige una hora (de 0 a 23) y en **Minuto** un minuto de 0 a 59. La hora es la de la zona horaria de tu organización. Los pasos reciben `{now}`: el momento en que empezó la ejecución. ## Según una expresión cron [#volgens-een-cron-expressie] Elige un ritmo, como cada día, cada lunes a las 08:00 o los lunes impares (el 1.º, 3.º y 5.º). En **Personalizado** configuras el intervalo, los días de la semana y la hora, hasta el minuto. En **Expresión cron** escribes tú mismo el horario. Una expresión cron es una notación corta para una hora repetida. Tiene cinco partes, separadas por un espacio: **minuto**, **hora**, **día del mes**, **mes** y **día de la semana**. | Expresión | Significado | |---|---| | `0 8 * * 1` | Cada lunes a las 08:00 | | `7 8 * * 1` | Cada lunes a las 08:07 | | `30 7 * * 1-5` | Cada día laborable a las 07:30 | | `0 9 1 * *` | El primero de cada mes a las 09:00 | | `0 8 * * 1#1,1#3,1#5` | Cada lunes impar (1.º, 3.º y 5.º del mes) a las 08:00 | | `0 8 * * 1L` | El último lunes del mes a las 08:00 | | `0 8 * * 1 W2:2026-10-05` | Cada dos semanas en lunes a las 08:00, desde la semana del 5 de octubre de 2026 | | `*/15 * * * *` | Cada cuarto de hora | | `* * * * *` | Cada minuto | En cada parte puedes usar un número, una lista con comas (`8,17`), un rango (`1-5`), un paso (`*/15`) o un asterisco (`*`, cualquier valor). El día de la semana 0 y 7 son ambos domingo. `1#2` es el segundo lunes, `1L` el último. Un sexto campo `W2:2026-10-05` repite cada dos semanas, contadas desde esa semana. Nombres como *MON* o *JAN* no funcionan. Si rellenas tanto un día del mes como un día de la semana, la automatización empieza en uno de los dos. Si la expresión no es válida, Tillor lo indica en el disparador. Las horas valen en la zona horaria de tu organización. ## A qué hora empieza exactamente un horario [#hoe-laat-start-een-schema-precies] Tillor comprueba cada minuto qué horarios le tocan. Una automatización que debe empezar a las 08:07 empieza en ese minuto. Esto vale para **Factura vencida**, **Se alcanza una fecha**, **Cada día a una hora** y **Según una expresión cron**. Por minuto, un horario empieza como máximo una vez. Una comprobación que se ejecuta recién en el minuto siguiente ya no recupera el minuto anterior. Los eventos empiezan de inmediato, sin este retraso. ## Solo cuando [#alleen-wanneer] Con **Solo cuando** haces que la automatización empiece únicamente si los datos cuadran. Así empiezas, por ejemplo, solo para caravanas estáticas, o solo para facturas por encima de un importe. Déjalo vacío para empezar en cada evento de este tipo. 1. Haz clic en **Añadir condición** 2. Elige el campo con el botón **Variable** (o escribe la ruta, por ejemplo `invoice.status`) 3. Elige cómo comparar 4. Rellena el valor. En campos con una elección fija, como un estado, un tipo de parcela o un compañero, eliges de una lista Puedes usar las siguientes comparaciones: | Opción | Se cumple cuando | |---|---| | **es** | El campo es igual al valor | | **no es** | El campo no es igual al valor | | **contiene** | El valor aparece en algún lugar del campo | | **es mayor que** | El campo es mayor que el valor (en números y fechas) | | **es menor que** | El campo es menor que el valor (en números y fechas) | | **es uno de** | El campo es igual a uno de los valores elegidos | | **está vacío** | El campo está vacío | | **no está vacío** | El campo no está vacío | Las mayúsculas no importan. Los números se comparan como números, así que 10 es mayor que 9. Si tienes más de una condición, eliges cómo se combinan: **Deben cumplirse todas** o **Basta con que se cumpla una**. Los eventos que detiene el filtro no inician ninguna ejecución y, por tanto, tampoco dejan rastro en la pestaña **Ejecuciones**. Si quieres ver si tu filtro es correcto, usa la **Ejecución de prueba**: ahí ves por cada condición si se cumplió. ## Ejecutar una vez por registro [#eén-keer-per-record-uitvoeren] Con **Ejecutar una vez por registro**, la automatización empieza como máximo una vez por factura, reserva u otro registro, por muchas veces que ocurra el evento para él. Es útil sobre todo con eventos que se repiten a menudo, como `invoice:updated`: una factura se modifica decenas de veces, pero solo quieres enviar un recordatorio. Tillor recuerda por registro que la automatización ya ha empezado. Ese recuerdo desaparece si eliminas la automatización. Solo funciona con eventos que llevan asociado un registro, y con **Factura vencida** y **Se alcanza una fecha**. Con **Se alcanza una fecha** significa: aunque la fecha se desplace más tarde, el flujo no vuelve a empezar. Con un horario como **Cada día a una hora** no tiene efecto. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Cada vez que se produce el momento de inicio y el filtro se cumple, empieza una ejecución con los datos de ese momento como variables. - Un evento empieza de inmediato. Una fecha, una hora o un horario empieza en el minuto en que le toca. - Si el filtro no encaja, no empieza nada y no queda rastro en la pestaña **Ejecuciones**. ## ¿Problemas? [#problemen] Comprueba que la automatización esté activada, que hayas elegido el **Evento** correcto y que el filtro de **Solo cuando** no sea demasiado estricto. Prueba con los datos de un caso real en la pestaña **Ejecución de prueba**. Más en [Preguntas frecuentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet). Usa cinco campos separados por un espacio, como `0 8 * * 1`. Nombres como *MON* no funcionan. La automatización está desactivada o la dirección no es correcta. Activa la automatización y copia la dirección de nuevo. Con otro momento de inicio, los filtros de **Solo cuando** se vacían, porque estaban escritos para el momento de inicio anterior. Vuelve a añadirlos. **Ejecutar una vez por registro** está activado. Entonces empieza como máximo una vez por factura, reserva u otro registro. ## Más información [#meer-lezen] # Variables y plantillas (/es-ES/automatiseringen/variabelen) Con las variables creas textos que cambian según el caso. Escribes una variable entre llaves y Tillor rellena el valor real cuando la automatización se ejecuta. Un ejemplo de título de tarea: ```text Controleer {occupation.terrain.name} ``` Si la ocupación termina en la parcela 12, la tarea se llamará *Controleer 12*. ## Insertar una variable [#een-variabele-invoegen] Encima de cada campo de texto donde funcionan las variables está el botón **Variable**. Haz clic y verás una lista con todos los datos disponibles, agrupados por registro. Escribe para buscar (**Buscar variables**) y haz clic en una línea. Tillor coloca la variable en la posición del cursor. También puedes escribir una variable tú mismo. Bajo el campo, un recuadro gris muestra cómo queda el texto con datos de ejemplo, para que veas enseguida si es correcto. Las variables funcionan en campos de texto como títulos, descripciones, subtareas, mensajes, el id de un cliente, factura u otro registro, la ruta o la URL de una solicitud API, el cuerpo, la carga útil de un webhook, el nombre del evento del webhook y los valores de las cabeceras. En los dos últimos falta el botón **Variable**, pero una variable que escribas tú mismo sí se rellena. Tillor no comprueba errores en esos dos campos y no muestra un ejemplo. En los campos donde eliges un dato para comparar, escribes la variable sin llaves. Esto vale para **Solo cuando**, **Si / si no** y **Hasta** en **Esperar hasta** (por ejemplo `invoice.status`), para el **Campo** de un **Según el valor** y para la **Fecha** de un **Retraso**. ## Qué variables hay [#welke-variabelen-zijn-er] | Variable | Disponible | Contenido | |---|---|---| | `{occupation.…}`, `{invoice.…}`, `{task.…}`, `{reservation.…}` y otras | Después de un evento | Los campos del registro del que trata el evento. El nombre del registro es también el comienzo de la variable | | `{occupation.terrain.name}` | Después de un evento | Campos de los registros a los que se refiere el registro, como el cliente o la parcela. Funciona un nivel en profundidad | | `{triggeredBy.name}`, `{triggeredBy.id}` | Siempre | El compañero que provocó el evento. Vacío si lo hizo el sistema | | `{invoice.…}` | En **Factura vencida** | Los campos de la factura vencida y del cliente | | `{reservation.…}`, `{task.…}` y otras | En **Se alcanza una fecha** | Los campos del registro cuya fecha se ha alcanzado, más los registros a los que se refiere | | `{now}`, `{today}` | Siempre | El momento en que se ejecuta el paso, y la medianoche de ese día en la zona horaria de la organización. Junto con un desplazamiento (más abajo), `{today + 1 day}` da mañana | | `{threadId}`, `{messageId}` | En eventos sobre mensajes de la bandeja de entrada, como `inbox:message-created` | El id de la conversación y del mensaje | | Los campos del evento | Después de **Esperar un evento**, mediante **Recibida** | Los datos del evento que se esperaba. Sustituyen los datos de los mismos registros del comienzo del flujo | | `{createdTask.id}`, `{createdTask.name}` | Después de **Crear tarea** | La tarea que acaba de crearse | | `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}`, `{foundTask.status}` | Después de **Buscar tarea**, mediante **Encontrada** | La tarea que encontró el paso | | `{updatedTask.id}`, `{updatedTask.status}` | Después de **Definir estado** | La tarea cuyo estado se ha cambiado | | `{updatedTask.id}`, `{updatedTask.priority}` | Después de **Establecer prioridad de tarea** | La tarea cuya prioridad se ha cambiado | | `{updatedTask.id}` | Después de **Actualizar tarea** | La tarea que se ha modificado | | `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}`, `{foundDocument.userMetadata.insuranceExpiryDate}` | Después de **Buscar documento**, mediante **Encontrada** | El documento que encontró el paso | | `{updatedDocument.id}` | Después de **Actualizar documento** | El documento que se ha modificado | | `{response.status}`, `{response.body}`, `{response.data.…}` | Después de **Solicitud API** | La respuesta de la solicitud | | `{foundCustomer.…}`, `{foundInvoice.…}`, `{foundReservation.…}` y otras | Después de **Consultar un registro**, mediante **Encontrada** | Los campos del registro que encontró el paso, más los registros a los que se refiere. El nombre es `found` más el tipo de registro: `foundCustomer`, `foundReservation`, `foundOccupation`, `foundInvoice`, `foundPayment`, `foundTerrain`, `foundTask`, `foundDocument`, `foundAccessMethod`, `foundNfcTag`, `foundMeter`, `foundInboxThread` o `foundInboxMessage` | | `{body.…}`, `{query.…}`, `{receivedAt}` | Después de **Webhook entrante** | El cuerpo JSON, los parámetros de consulta y la hora de recepción de la llamada del webhook | | Cada nombre de destino de **Asignar variables** | Después de **Asignar variables** | Lo que rellenes como destino en ese paso, por ejemplo `{invoice.displayId}` tras `invoice` ← `{foundInvoice}` | | `{item.…}` | En los pasos tras **Para cada** | Los campos del elemento para el que se ejecuta ahora el paso, como `{item.id}` | | `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}`, `{approval.decidedBy.name}` | Después de **Pedir una decisión**, mediante una opción | La tarea, la opción elegida, el nombre de esa opción, la nota y el compañero que eligió | | `{task.…}`, `{action.label}`, `{note}` | En **Se elige una acción de tarea** | La tarea, el botón elegido y la nota que se rellenó con él | | `{createdComment.id}` | Después de **Añadir un comentario** | El comentario que acaba de publicarse | | `{bookedInvoice.displayId}` | Después de **Contabilizar factura**, mediante **Listo** | El número de la factura contabilizada | | `{paymentLink.url}` | Después de **Crear enlace de pago**, mediante **Listo** | El enlace con el que el cliente puede pagar en línea | | `{consumptionInvoice.id}` | Después de **Facturar consumo**, mediante **Listo** | La factura del consumo del contador | | `{extendInvoice.id}` | Después de **Borrador de factura de prórroga** | El borrador de factura que prorroga la ocupación | | `{createdAccessMethod.id}`, `{createdAccessMethod.value}` | Después de **Crear método de acceso** | El nuevo método de acceso y su valor, como el código de un código QR o un PIN | | `{error.message}`, `{error.step}` | Después de una acción con **Continuar si este paso falla**, mediante **Error** | El mensaje de error y el nombre del paso que falló | Qué campos tiene exactamente un registro lo ves en la lista tras el botón **Variable**. En el disparador también está el resumen **Datos que proporciona este evento**. ### Solo lo que viene antes en el flujo [#alleen-wat-eerder-in-de-flow-komt] Un paso solo puede usar variables del disparador que lo alcanza y de pasos que estén antes en el mismo camino. Si varios disparadores alcanzan el mismo paso, solo están disponibles las variables que proporciona cada uno de esos disparadores. Un campo de un paso anterior cuenta si cada uno de esos disparadores también pasa por ese paso. Si usas una variable que no existe en ese punto, Tillor muestra **[Campo]: [variable] no está disponible en este paso.** Un flujo con un aviso así no se puede activar. Algunos registros guardan datos adicionales en un solo campo, como los datos del documento en `userMetadata`. Cada clave bajo él es una variable: `{document.userMetadata.documentType}`, `{document.userMetadata.insuranceExpiryDate}` u otra clave. Las claves conocidas, como el tipo y la fecha de vencimiento de un documento, también están en la lista y puedes compararlas como fecha. Una fecha sin hora, como `2026-10-07`, aparece en un mensaje como `07-10-2026`. Las variables de **Para cada** (`{item.…}`) solo existen en los pasos tras la salida **Para cada**, no tras **Listo**. Las variables de una salida que no tomaste tampoco existen: `{paymentLink.url}` solo está si el paso pasó por **Listo**, y `{foundTask.id}` solo después de **Encontrada**. En eventos cuyos datos no están descritos, Tillor no puede comprobar qué variables existen. Entonces no recibes ese aviso. Comprueba, por tanto, esos flujos con especial cuidado con una ejecución de prueba. ### Un valor nuevo sustituye al anterior [#een-nieuwe-waarde-vervangt-de-oude] Una segunda **Solicitud API** en el mismo flujo sustituye el `response` de la primera. Lo mismo vale para `createdTask` tras una segunda **Crear tarea**, para `foundTask` tras una segunda **Buscar tarea** o **Consultar un registro** sobre **Tarea**, y para `error` tras un segundo paso fallido. Usa, por tanto, los datos de una respuesta en el paso que viene justo después. ## Cómo se rellenan los valores [#hoe-waarden-worden-ingevuld] Tillor adapta el formato al tipo de campo. **En texto normal** (títulos, descripciones, subtareas): - Las fechas están en la zona horaria de tu organización, por ejemplo `05-10-2026`. Si la hora no cae exactamente en la medianoche, también aparece una hora, como `05-10-2026 14:30` - Un campo vacío da un texto vacío - Una variable que Tillor no conoce se queda tal como la escribiste, por ejemplo `{occupation.terain.name}`. Así, una errata se nota enseguida en la tarea o el mensaje - Si no existe un registro vinculado, la variable queda vacía. Una ocupación sin reserva no da nada para `{occupation.reservation.displayId}`, y un evento que provocó el sistema no da nada para `{triggeredBy.name}`. Si en ese caso quieres otro texto, pon delante un **Si / si no** con **está vacío** **En JSON** (la **Carga útil** de un webhook y el **Cuerpo** de una solicitud API): - El texto se rellena de forma segura. Las comillas, los saltos de línea y otros caracteres especiales del valor no pueden romper el JSON - Los números y los valores sí/no van sin comillas, así que no pongas comillas alrededor. El texto sí va entre comillas - Las fechas pasan como fecha y hora internacionales, como `2026-10-05T08:00:00.000Z`, para que el sistema receptor pueda manejarlas bien ```json { "reservation": "{reservation.displayId}", "adults": {reservation.numberOfAdults} } ``` Si el JSON no es válido después de rellenarlo, por ejemplo porque un número está vacío, la ejecución se detiene con un mensaje de error. **En una ruta o URL** (en una solicitud API): - Los valores se convierten para que quepan en una dirección. Un nombre con un espacio no da, por tanto, una dirección rota - Las fechas también van aquí como fecha y hora internacionales - Lo que escribes tú mismo se queda como lo escribes. Si quieres un espacio en un término de búsqueda, escribe tú mismo `%20` ## Desplazar una fecha [#een-datum-verschuiven] Tras una variable de fecha puede ir un desplazamiento: `{reservation.checkOut + 1 day}`, `{today - 2 weeks}`, `{invoice.dueDate + 3 hours|date}`. Las unidades son `minutes`, `hours`, `days`, `weeks` y `months` (también vale el singular). Los días y las semanas son duraciones fijas, de modo que una validez dura lo mismo a través del horario de verano e invierno; los meses siguen el calendario, así que el 31 de enero más un mes es el 28 o 29 de febrero. En un valor que no es una fecha, el desplazamiento no hace nada, y una unidad que no existe es un error en el paso. Los campos de fecha como **Válido hasta** aceptan la misma notación. ## Dar formato a un valor [#een-waarde-opmaken] Pon tras la variable un `|` y un formato, por ejemplo `{invoice.amountOutstanding|currency}`. Sin formato, un importe aparece sin adornos, como `1295.3`. Con `|currency` pasa a `€ 1.295,30`. | Formato | Ejemplo | Resultado | |--------|-----------|-----------| | `currency` | `{invoice.amountOutstanding\|currency}` | `€ 1.295,30` | | `currency:USD` | `{invoice.amountOutstanding\|currency:USD}` | `US$ 1.295,30` | | `number` | `{invoice.amountOutstanding\|number}` | `1.295,3` | | `number:2` | `{invoice.amountOutstanding\|number:2}` | `1.295,30` (número fijo de decimales) | | `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` | - Los números e importes aparecen siempre en notación belga: un punto para los millares y una coma para los decimales - Las fechas y horas están en la zona horaria de tu organización - Si el formato no puede leer el valor, por ejemplo `|currency` sobre texto, el valor aparece simplemente sin formato - Un formato que Tillor no conoce se queda tal como lo escribiste, y el editor muestra un aviso al respecto - En JSON y en una URL, el valor con formato se rellena como texto. En JSON, pon por tanto comillas alrededor ## Usar una respuesta de API [#een-api-antwoord-gebruiken] Después de una [Solicitud API](/automatiseringen/acties/integraties#api-verzoek) puedes usar campos de la respuesta con `{response.data.…}`. La respuesta de una búsqueda de tareas tiene, por ejemplo, este aspecto: ```json { "items": [ { "id": "task_1", "priority": "LOW" } ] } ``` Entonces `{response.data.items.0.id}` da el id de la primera tarea (la primera de una lista es el número 0) y `{response.data.items.0.priority}` su prioridad. Tillor solo puede ofrecer los campos de una respuesta como variable cuando sabe qué aspecto tiene la respuesta. Puede hacerlo de dos maneras: - Deja que la automatización se ejecute una vez de verdad. Tillor usa entonces la respuesta de la última ejecución - Pega un ejemplo en la pestaña **Ejecución de prueba**, en el campo **Ejemplo de respuesta de la API**. Ese campo aparece en cuanto el flujo contiene una **Solicitud API**. Debajo están los **Campos de esta respuesta**. Haz clic en un campo para copiarlo, con las llaves incluidas Después, los campos aparecen en la lista tras el botón **Variable** y en la lista de **Campo** de un **Según el valor**. Si escribes tú mismo una ruta bajo `response.data`, siempre se acepta, incluso sin ejemplo. Además: - `{response.body}` contiene los primeros 4000 caracteres de la respuesta. Si la respuesta es más larga, el resto se corta - `{response.data}` está vacío si la respuesta no es JSON o si es muy grande (más de 100.000 caracteres) - En una búsqueda sin resultado, `{response.data.items.0.id}` no existe. Un **Según el valor** sobre ese campo pasa entonces por **Predeterminado** En la pestaña **Ejecución de prueba** también rellenas los datos de ejemplo del evento. Así ves en la ejecución de prueba qué valores rellenaría Tillor. Consulta [Pruebas y ejecuciones](/automatiseringen/testen-en-uitvoeringen). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - En cuanto la automatización se ejecuta, Tillor sustituye cada variable por el valor real. Una variable que Tillor no conoce se queda tal como la escribiste. - Si un dato está vacío, el lugar queda vacío. Si entonces quieres otro texto, pon delante un **Si / si no** con **está vacío**. ## ¿Problemas? [#problemen] Una variable que Tillor no conoce se queda literalmente. Normalmente hay una errata. Elige la variable con el botón **Variable**. Usas un dato que aún no existe en este punto del flujo, por ejemplo de un paso que viene más tarde o de una salida que no tomaste. Coloca antes en el flujo el paso que proporciona el dato. Mientras el aviso siga ahí, no puedes activar la automatización. Un número vacío invalida el JSON. El texto va entre comillas, los números no. Comprueba los campos con una ejecución de prueba. Tillor aún no conoce la forma de la respuesta. Deja que la automatización se ejecute una vez de verdad, o pega un ejemplo en **Ejemplo de respuesta de la API** en la pestaña **Ejecución de prueba**. # Preguntas frecuentes (/es-ES/automatiseringen/veelgestelde-vragen) ## ¿Quién puede usar las automatizaciones? [#wie-kan-automatiseringen-gebruiken] Quien tiene **Ver automatizaciones** ve las automatizaciones y sus ejecuciones. Quien tiene **Gestionar automatizaciones** también puede crearlas, modificarlas, activarlas y eliminarlas. Los administradores con **Todos los permisos** pueden hacerlo todo. Estos permisos los das en los miembros de tu organización. Ojo con **Gestionar automatizaciones**: una automatización trabaja con todos los permisos de tu organización. Quien puede construir flujos puede, por tanto, hacerlo todo mediante un flujo. Dáselo solo a personas en las que confíes. Quien no tiene ninguno de los dos permisos no ve la opción de menú **Administrador > Automatizaciones**. ## ¿Por qué no empieza mi automatización? [#waarom-start-mijn-automatisering-niet] Repasa estos puntos. 1. **¿Está activada?** Una automatización con el interruptor desactivado (filtro **En pausa**) no empieza. Si tiene problemas, no pudiste activarla. Consulta [Problemas y activación](/automatiseringen/problemen) 2. **¿Es el evento correcto?** Una reserva nueva es `reservation:created`, una modificación `reservation:updated`. Comprueba también que el evento ocurra realmente con la acción que haces 3. **¿Lo detiene el filtro?** Los eventos que no superan el filtro de **Solo cuando** no dejan ninguna ejecución. Usa la pestaña **Ejecución de prueba** con los datos de un caso real para ver qué condición no se cumple. Fíjate en los valores de los campos de elección: un estado de factura es, por ejemplo, `BOOKED` 4. **¿Está activado Ejecutar una vez por registro?** Entonces la automatización no vuelve a empezar para una factura o reserva para la que ya se ejecutó. Consulta [Ejecutar una vez por registro](/automatiseringen/triggers#eén-keer-per-record-uitvoeren) 5. **¿Es un horario?** Entonces empieza en el minuto en que le toca. Una hora fija y un horario usan la zona horaria de tu organización 6. **¿La acabas de activar o modificar?** Puede tardar medio minuto hasta que todo lo nota 7. **¿Llegan muchos eventos a la vez?** Entonces las ejecuciones se procesan una a una y puede tardar un poco hasta que le toque a la tuya Si la automatización empieza pero después algo sale mal, mira en la pestaña **Ejecuciones** qué ocurrió y dónde se quedó atascada la ejecución. ## ¿Por qué mi horario empieza tarde? [#waarom-start-mijn-schema-te-laat] Los horarios se comprueban cada minuto. Una automatización que empieza en una fecha, una hora o según un horario comienza en ese minuto. Un evento empieza de inmediato. ## ¿Puede una automatización seguir iniciándose a sí misma? [#kan-een-automatisering-zichzelf-blijven-starten] Dentro de un mismo flujo, no. Si conectas una salida de modo que el flujo volvería a un paso anterior, Tillor rechaza esa línea. Un flujo con un bucle así no se puede activar. Si una ejecución llega aun así a un paso que ya hizo, se detiene en lugar de repetir ese paso. Tampoco mediante eventos. Lo que hace un paso ocurre como el usuario **Flujo de trabajo**, y los eventos que provoca **Flujo de trabajo** no inician automatizaciones. Una automatización que empieza con `task:created` y hace un **Crear tarea** no vuelve, por tanto, a empezar con la tarea que creó ella misma. Esto vale también entre automatizaciones: una no puede iniciar otra. Si en poco tiempo entran muchos eventos, por ejemplo por un envío grande, cada evento inicia una ejecución. Tillor las procesa varias a la vez. No se pierde nada, pero puede tardar un poco. ## ¿Qué límites hay? [#welke-grenzen-gelden-er] | Qué | Límite | |---|---| | Pasos en una automatización | 100 | | Ramas en un **Según el valor** | 8, además de **Predeterminado** | | Conexiones desde una salida | 1 paso. Si conectas de nuevo, la línea nueva sustituye a la anterior | | Longitud del nombre | 120 caracteres | | Longitud de la descripción | 500 caracteres | | Comentarios y marcos en el lienzo | 50 en total | | Opciones en **Pedir una decisión** | 8 | | Tiempo de espera de una solicitud API | 15 segundos | | La respuesta en `{response.body}` | Los primeros 4000 caracteres | | La respuesta en `{response.data}` | Hasta 100.000 caracteres, si es mayor queda vacía | | Retraso en segundos | No exacto, puede ser unos segundos más tarde | | Horarios | Comprobación cada minuto | | Elementos en un **Para cada** | 100 cada vez | | Comprobación en **Esperar hasta** | Como máximo cada 5 minutos | | Contenido de un webhook entrante | 100 KB | | Ejecuciones en la pestaña **Ejecuciones** | Las últimas 20 | ## ¿Pueden empezar varias automatizaciones con el mismo evento? [#kunnen-er-meerdere-automatiseringen-op-dezelfde-gebeurtenis-starten] Sí. Cada automatización activada cuyo disparador y filtro encajan inicia su propia ejecución. No cuentes con un orden fijo. ## ¿Puedo hacer que después de una salida se hagan dos cosas a la vez? [#kan-ik-na-één-uitgang-twee-dingen-tegelijk-laten-doen] No, una salida lleva a un paso. Pon las acciones una detrás de otra, o crea una segunda automatización con el mismo disparador. ## ¿Qué ocurre con las ejecuciones en curso si cambio algo? [#wat-gebeurt-er-met-lopende-uitvoeringen-als-ik-iets-verander] | Lo que haces | Lo que ocurre con las ejecuciones | |---|---| | Modificar el flujo y guardar | Las ejecuciones nuevas usan el flujo nuevo. Las ejecuciones que ya están en curso o esperando terminan con el flujo tal como era | | Pausar la automatización | Las ejecuciones que esperan en un retraso se detienen en cuanto termina el tiempo de espera y reciben el estado **Cancelada**. Lo que ya está en curso en ese momento termina. Si la vuelves a activar antes de que termine el tiempo de espera, la ejecución simplemente continúa | | Eliminar la automatización | Se eliminan las ejecuciones y el historial. Las ejecuciones en espera se detienen | ## ¿Qué ocurre si un paso falla? [#wat-gebeurt-er-als-een-stap-mislukt] La ejecución se detiene con el estado **Fallida** y los pasos siguientes no se ejecutan. Quien creó la automatización recibe un correo sobre la ejecución fallida, como máximo uno por hora por automatización. Tillor no reintenta el paso. En **Enviar webhook** y **Solicitud API** puedes capturar un fallo con la salida **Fallida**. En otras acciones activa **Continuar si este paso falla**: el paso recibe entonces una salida **Error** y el flujo continúa por ahí. Consulta [Si un paso falla](/automatiseringen/acties#als-een-stap-mislukt). ## ¿Se envía algo de verdad durante una prueba? [#wordt-er-echt-iets-verstuurd-tijdens-een-test] No. Una ejecución de prueba no envía nada, no crea nada y no modifica nada. Consulta [Pruebas y ejecuciones](/automatiseringen/testen-en-uitvoeringen). ## ¿Están mis datos guardados de forma segura? [#zijn-mijn-gegevens-veilig-opgeslagen] Tus flujos y el historial de ejecuciones, incluidas las cabeceras con claves o tokens, se guardan cifrados. Para las direcciones de internet, solo se permite `https` y las direcciones internas se rechazan. ## Me falta un evento, una condición o una acción [#ik-mis-een-gebeurtenis-voorwaarde-of-actie] Usa **Solicitar un paso** en el editor. Consulta [Solicitar un paso o un evento](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen). ## ¿Puedo gestionar las automatizaciones también desde mi propio sistema? [#kan-ik-automatiseringen-ook-vanuit-mijn-eigen-systeem-beheren] Sí, si tu integración dispone de todos los permisos. Consulta [Para desarrolladores](/ontwikkelaars/automatiseringen). Empieza con un disparador y una acción, déjalos funcionar unos días y revisa las ejecuciones. Solo después amplía con condiciones y retrasos. # Ejemplo: revisión de la caravana de alquiler (/es-ES/automatiseringen/voorbeeld-nalopen) Este ejemplo construye un flujo con un filtro, **Buscar tarea**, **Establecer prioridad de tarea**, un **Si / si no** y una tarea con subtareas. No necesitas ninguna solicitud API. En los entornos de demostración de Tillor, este flujo ya está disponible como ejemplo en pausa con el nombre **Nalopen huurcaravan**. Puedes verlo allí mientras lo construyes. ## Qué hace el flujo [#wat-de-flow-doet] Un huésped se va de una caravana estática. La caravana debe revisarse para el siguiente huésped. - Si aún no hay una tarea de revisión abierta para esa parcela, el flujo crea una, con cinco subtareas y una fecha límite a los 7 días. La tarea también va al compañero que detuvo la ocupación - Si ya hay una tarea de revisión abierta, por ejemplo porque la caravana quedó libre dos veces en poco tiempo, el flujo no crea una segunda tarea. En su lugar, la prioridad de la tarea existente sube un nivel ```mermaid flowchart TD A["Ocupación terminada
solo caravanas estáticas"] --> F{"¿Tarea de revisión abierta?"} F -- Encontrada --> P["Prioridad un nivel más alta
hasta Alta"] F -- No encontrada --> B{"¿Terminada por un compañero?"} B -- Sí --> C["Crear tarea de revisión
con el nombre del compañero"] B -- No --> D["Crear tarea de revisión"] ``` Los dos pasos de tarea de abajo son casi iguales. Solo difiere la descripción: si fue el sistema quien terminó la ocupación, no hay ningún compañero que mencionar. ## Qué necesitas [#wat-je-nodig-hebt] - Tienes el permiso **Gestionar automatizaciones**, o **Todos los permisos** - En tu organización existe un tipo de parcela para caravanas estáticas, en este ejemplo **Stacaravan** - Opcional: un tablero y una columna para las tareas de revisión ## Construir el flujo [#de-flow-bouwen] ### 1. Crear un flujo vacío [#1-een-lege-flow-maken] 1. Ve a **Administrador > Automatizaciones** y haz clic en **Nueva automatización** 2. Elige **Empezar desde cero** 3. En la ruta de navegación de arriba, escribe el nombre **Nalopen huurcaravan** 4. Haz clic en el lienzo, junto a los pasos, y en el panel rellena en **Descripción** para qué sirve el flujo ### 2. Configurar el disparador [#2-de-trigger-instellen] 1. Haz clic en el disparador. Deja **Empieza por** en **Cuando ocurre algo** 2. En **Evento** elige `occupation:ended`. Escribe *occupation* para buscar 3. En **Nombre del paso** ponle al paso el nombre *Ocupación terminada* Ahora el flujo empieza con cada ocupación que termina. Tú lo quieres solo para caravanas estáticas: 1. En **Solo cuando** haz clic en **Añadir condición** 2. Haz clic en **Variable** y elige `occupation.terrain.terrainTypeId` 3. Deja la comparación en **es** 4. En el valor, elige el tipo de parcela **Stacaravan** ### 3. Buscar una tarea de revisión abierta [#3-een-open-nalooptaak-zoeken] 1. Añade un paso **Buscar tarea**, conecta el disparador con él y ponle el nombre *¿Tarea de revisión abierta?* 2. En **Título** escribe `Nalopen {occupation.terrain.name}` 3. Deja activados **Vinculada a los registros del evento**, **Solo tareas no completadas** y **Omitir subtareas** El paso busca ahora una tarea principal que aún no esté completada, que se llame exactamente *Nalopen* seguido del nombre de la parcela y que esté vinculada a la misma parcela, el mismo cliente o la misma reserva. Después el flujo continúa por **Encontrada** o **No encontrada**. ### 4. Subir la prioridad [#4-de-prioriteit-verhogen] 1. Añade un paso **Establecer prioridad de tarea**, ponle el nombre *Subir prioridad* y conecta con él la salida **Encontrada** 2. Deja **Tarea** en `{foundTask.id}` 3. Deja **Cambio** en **Un nivel más alto** y **Subir hasta** en **Alta** ### 5. Comprobar quién detuvo la ocupación [#5-nagaan-wie-de-bezetting-stopzette] 1. Añade un paso **Si / si no**, conecta con él la salida **No encontrada** de *¿Tarea de revisión abierta?* y ponle el nombre *¿Terminada por un compañero?* 2. Haz clic en **Añadir condición** y en **Variable** elige `triggeredBy.id` 3. Elige la comparación **no está vacío** `{triggeredBy.id}` está vacío si la ocupación la terminó el sistema, por ejemplo una tarea programada. Entonces el flujo pasa por **No**. ### 6. Crear la tarea [#6-de-taak-aanmaken] Añade un paso **Crear tarea**, ponle el nombre *Crear tarea de revisión* y conecta con él la salida **Sí**. Rellena los campos así: | Campo | Valor | |---|---| | **Título** | `Nalopen {occupation.terrain.name}` | | **Descripción** | `Automatisch gegenereerd.`, una línea vacía y `Bezetting stopgezet door @{triggeredBy.name}({triggeredBy.id})` | | **Prioridad** | **Baja** | | **Vence después de** | 7 días | | **Asignar también a quien causó el evento** | Activado | | **Vincular a registros** | Activado | | **Subtareas** | Cinco líneas: *Kuisen*, *Inboedel*, *Internet + TV*, *Kader QR code*, *Controleren op werkjes* | Con `@{triggeredBy.name}({triggeredBy.id})` se menciona al compañero en la descripción. Si quieres que la tarea vaya a un tablero, elige en **Añadir al tablero** un tablero y en **Columna** una columna. A quien debe recibir siempre la tarea lo eliges en **Asignar a**. Deja el título igual que el de *¿Tarea de revisión abierta?*. De lo contrario, el paso de búsqueda no encontrará la tarea la próxima vez. ### 7. La tarea para el sistema [#7-de-taak-voor-het-systeem] 1. Haz clic en el paso *Crear tarea de revisión* y luego en **Duplicar paso** 2. Ponle a la copia el nombre *Crear tarea de revisión (sistema)* y conecta con ella la salida **No** 3. Deja la **Descripción** solo en `Automatisch gegenereerd.` ### 8. Probar y activar [#8-testen-en-inschakelen] 1. Comprueba que no haya ningún botón de problemas (como **1 problema**) en la parte superior del panel 2. Abre la pestaña **Ejecución de prueba** y haz clic en **Ejecutar prueba**. Verás qué camino toma el flujo y qué título y descripción recibiría la tarea. No se crea nada 3. Activa el interruptor **Activa** ## Por qué dos pasos en lugar de uno [#waarom-twee-stappen-in-plaats-van-één] También puedes usar los pasos **Buscar tarea** y **Establecer prioridad de tarea** por separado. Si, por ejemplo, no quieres hacer nada cuando la tarea ya existe, simplemente no conectes nada con **Encontrada**. Si quieres dar un comentario o un estado distinto a la tarea existente, pon otro paso tras **Encontrada**, como **Definir estado** con `{foundTask.id}`. ## Qué ocurre en la práctica [#wat-er-in-de-praktijk-gebeurt] | Situación | Qué hace el flujo | |---|---| | Ninguna tarea de revisión abierta para esta parcela | Crea una tarea nueva con cinco subtareas | | Tarea abierta con prioridad **Baja** | La pone en **Media** | | Tarea abierta con prioridad **Media** | La pone en **Alta** | | Tarea abierta con prioridad **Alta** o **Urgente** | Deja la prioridad como está | | Ocupación en otro tipo de parcela | No empieza | La tarea está a nombre de [**Flujo de trabajo**](/automatiseringen/workflow-gebruiker) y está vinculada a la parcela y al cliente de la ocupación, y a la reserva si existe. No toda ocupación tiene una reserva. El compañero que detuvo la ocupación figura como persona asignada en la tarea. # ¿Quién ejecuta una automatización? (/es-ES/automatiseringen/workflow-gebruiker) Una automatización no trabaja a tu nombre. Todos los pasos los ejecuta un usuario fijo de tu organización que se llama **Flujo de trabajo**. ## Lo que notas de ello [#wat-je-ervan-merkt] - Una tarea que crea una automatización figura a nombre de **Flujo de trabajo** - Un comentario que añade una automatización mediante una [solicitud API](/automatiseringen/acties/integraties#api-verzoek) también figura a nombre de **Flujo de trabajo** - En el editor, en el panel de la derecha, mientras no hayas seleccionado ningún paso, aparece el recordatorio de que los pasos se ejecutan como el usuario **Flujo de trabajo** de tu organización, nunca como tú Así siempre queda claro qué hizo un compañero y qué hizo una automatización. Tu nombre no aparece en algo que no hiciste tú. ## Qué es **Flujo de trabajo** [#wat-workflow-is] - Un usuario de sistema, no un compañero. No puedes iniciar sesión con él y no tiene buzón de correo - Hay uno por organización. Solo existe dentro de tu organización y no puede hacer nada en ningún otro sitio - Tiene todos los permisos dentro de tu organización, como un administrador. Por eso solo los administradores pueden crear y modificar automatizaciones - No es miembro de la organización, como sí lo es un compañero Como **Flujo de trabajo** tiene permiso para todo, una automatización también puede hacer todo lo que permite la Tillor API. Una **Solicitud API** puede, por ejemplo, modificar o eliminar datos. Por eso, mantén tus flujos pequeños y pruébalos bien. ## Qué no puede hacer **Flujo de trabajo** [#wat-workflow-niet-mag] Una automatización no puede crear, modificar, activar ni eliminar automatizaciones, y tampoco puede ver sus ejecuciones. Una solicitud API para ello se rechaza. Así, un flujo no puede modificarse a sí mismo ni a otro flujo. ## Evento causado por **Flujo de trabajo** [#gebeurtenis-veroorzaakt-door-workflow] Lo que hace **Flujo de trabajo** provoca eventos normales, por ejemplo una tarea nueva. En la cronología y en los webhooks, el causante que aparece es entonces **Flujo de trabajo**. Estos eventos no inician automatizaciones: por tanto, un flujo no puede iniciarse a sí mismo ni iniciar otro flujo. Una ejecución que espera con **Esperar un evento** sí continúa con él: eso no puede iniciar ningún flujo nuevo, así que tampoco un bucle. Encontrarás más información en [Preguntas frecuentes](/automatiseringen/veelgestelde-vragen#kan-een-automatisering-zichzelf-blijven-starten). ## A quién asignas [#wie-wijs-je-toe] **Flujo de trabajo** nunca se asigna a sí mismo a una tarea y nunca recibe un aviso de **Avisar a compañeros**. Si quieres que un compañero se encargue de la tarea, elige un compañero en **Asignar a**, o marca **Asignar también a quien causó el evento**. # Registrar un pago (/es-ES/betalingsverwerking/betaling-registreren) Un pago se registra en una factura contabilizada con saldo pendiente. La pantalla de pago es la misma para todos los métodos. Solo cambian los campos que hay bajo **Método de pago**. ### Abre la factura [#open-de-factuur] Ve a Administración > Facturas o abre la factura desde Clientes > cliente > Facturación. La factura debe estar contabilizada y tener un saldo pendiente. ### Haz clic en Realizar pago [#klik-op-maak-betaling] Se abre la pantalla **Nuevo pago para** la factura. Arriba aparecen el total de la factura y el importe pendiente. ### Elige el método de pago [#kies-de-betaalmethode] En **Método de pago**, elige cómo llega el pago. Las opciones que ves dependen de la factura y de lo que haya configurado tu organización. - **Terminal** envía la solicitud a un terminal de pago con tarjeta. Consulta [Terminal](/betalingsverwerking/terminal). - **Efectivo**, **Transferencia bancaria** y, en su caso, **Otros** registran dinero que entró fuera de Tillor. Consulta [Efectivo y transferencia](/betalingsverwerking/contant). - **Transferencia interna** traslada saldo a otra factura del mismo cliente. Consulta [Transferencia interna](/betalingsverwerking/interne-overboeking). - **Mandato SEPA** cobra el importe con un mandato activo del cliente. Consulta [Cobrar una factura](/betalingsverwerking/incasso). ### Introduce el importe [#vul-het-bedrag-in] **Importe** se rellena por defecto con el importe pendiente. Con los botones 25 %, 50 %, 75 % y 100 % rellenas rápidamente una parte, o escribes tú mismo un importe. El importe no puede ser superior al importe pendiente. ### Realiza el pago [#voer-de-betaling-uit] Haz clic en **Realizar pago**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] Se actualizan el importe pendiente y el estado de pago de la factura. El pago aparece en la factura, en **Pagos**, y en Administración > Pagos. Cómo encontrarlos se explica en [Encontrar pagos](/betalingsverwerking/betalingen-bekijken). ¿Prefiere el cliente pagar por sí mismo? Entonces envía la factura con **Enviar notificación**. Consulta [Pagar en línea](/betalingsverwerking/online). ## ¿Problemas? [#problemen] El botón solo aparece en una factura contabilizada con saldo pendiente. Una factura en borrador primero hay que contabilizarla. Una factura pagada por completo ya no tiene botón. El cliente no tiene ningún mandato activo cuyo importe máximo sea suficiente para este importe. En una nota de crédito, el método no aparece en la lista. Consulta [Cobrar una factura](/betalingsverwerking/incasso). Terminal solo aparece en la lista si Mollie está conectado y tu organización puede recibir pagos con tarjeta. Consulta [Terminal](/betalingsverwerking/terminal). # Encontrar pagos (/es-ES/betalingsverwerking/betalingen-bekijken) Ves los pagos en tres sitios: en la propia factura, en la vista general de todos los pagos y en la pantalla de detalle de un pago. ## Ver los pagos de una factura [#betalingen-van-een-factuur-bekijken] Abre la factura y desplázate hasta **Pagos**. Solo ves los pagos asociados a esta factura. ## Buscar entre todos los pagos [#alle-betalingen-doorzoeken] Ve a Administración > Pagos. Filtra por fecha, método de pago, estado o cliente, o busca por nombre de cliente o número de factura. En el menú de acciones (tres puntos) de un pago puedes, según el pago: | Acción | Qué hace | |---|---| | **Detalles** | Abre la pantalla de detalle | | **PDF de pago** | Crea un justificante de pago | | **Sincronizar** | Obtiene el estado actual en Mollie. Solo en pagos de Mollie que ya existen en Mollie | | **Omitir retraso** | Envía ahora al banco un cobro programado. Consulta [Cobrar una factura](/betalingsverwerking/incasso) | | **Desvincular de la factura** | Quita el pago de la factura | | **Cancelar** | Cancela un pago que aún no ha finalizado | | **Eliminar** | Elimina el pago | ## Leer los detalles de un pago [#de-details-van-een-betaling-lezen] Haz clic en **Detalles** para abrir la pantalla **Detalles del pago**. Ahí ves el importe, el estado, el método, la factura y una cronología. - **Fecha de vencimiento** aparece en un cobro SEPA en curso. El estado muestra entonces Previsto con esa fecha. - **Enviar después** aparece en un cobro que Tillor aún no ha enviado al banco. - **Informe de pagos** muestra el informe en el que acaba el pago. Mientras el pago aún no está en un informe, aparece el número de informe seguido de **(previsto)**. En un pago de Mollie aparece **Con el próximo pago de Mollie**, porque el informe solo se conoce en el momento del pago. Encontrarás más información sobre los informes en [Informes de pago](/boekhouden/betalingsrapporten). ## Etiquetas de estado [#statuslabels] | Estado | Significado | |---|---| | Pendiente | El pago sigue en curso | | Autorizado | Aprobado, aún no finalizado | | Pagado | Finalizado | | Fallido | No se ha podido completar | | Cancelado | Interrumpido antes de terminar | | Caducado | La sesión de pago ha caducado | | Reembolsado y Parcialmente reembolsado | El importe se ha devuelto total o parcialmente | | Contracargo | El banco o el emisor de la tarjeta ha recuperado el importe | ## Hacer seguimiento de los importes pendientes [#openstaande-bedragen-opvolgen] Ve a Administración > Facturas. La tarjeta **Facturas con saldo pendiente** muestra las facturas contabilizadas que aún no están pagadas por completo. En las tablas, filtra por estado de pago **Pendiente** y ordena por fecha de vencimiento. ### Enviar un recordatorio [#een-aanmaning-versturen] Un recordatorio se envía por factura, no de forma masiva. ### Abre la factura [#open-de-factuur] Elige una factura que siga pendiente. ### Envía el recordatorio [#verstuur-de-aanmaning] Haz clic en **Enviar notificación** y elige **Enviar recordatorio**. Confirma el envío. El cliente recibe un recordatorio con un enlace para pagar en línea. Consulta [Pagar en línea](/betalingsverwerking/online). ## ¿Problemas? [#problemen] Usa **Sincronizar** en el menú de acciones del pago. Tillor obtiene entonces los datos actuales. Ayuda sobre todo si se ha perdido un aviso de Mollie. La acción solo aparece en pagos de Mollie que ya tienen una transacción en Mollie. En un cobro que Tillor aún no ha enviado, no hay nada que obtener. # Registrar efectivo y transferencia (/es-ES/betalingsverwerking/contant) Con **Efectivo**, **Transferencia bancaria** y, en su caso, **Otros** dejas constancia de que un cliente ha pagado al margen de Tillor. Tillor no envía nada. Actualiza el saldo pendiente de la factura. - **Efectivo**: el cliente paga en metálico en recepción. - **Transferencia bancaria**: has recibido una transferencia bancaria que no se asoció automáticamente a la factura. - **Otros**: para otros pagos con una descripción propia, como un cheque o un trueque. El método solo aparece si tu organización lo ha activado. ## Registrar un pago [#een-betaling-registreren] ### Abre la pantalla de pago [#open-het-betaalscherm] Abre una factura contabilizada con saldo pendiente y haz clic en **Realizar pago**. ### Elige el método [#kies-de-methode] En **Método de pago**, elige **Efectivo** o **Transferencia bancaria**. ### Introduce el importe [#vul-het-bedrag-in] Escribe un importe o usa los botones 25 %, 50 %, 75 % y 100 %. ### Comprueba la fecha de recepción [#controleer-de-datum-van-ontvangst] **Fecha de recepción** se rellena por defecto con hoy. Modifícala si el dinero llegó otro día. ### Añade una nota si quieres [#voeg-eventueel-een-opmerking-toe] En **Nota** puedes poner un número de referencia o una anotación. En **Otros**, la descripción es obligatoria. ### Realiza el pago [#voer-de-betaling-uit] Haz clic en **Realizar pago**. La fecha determina en qué informe de pagos acaba el pago. Si hoy registras un pago de ayer, pon la fecha de ayer para que se complete el informe correcto. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] El pago aparece de inmediato en la factura y en Administración > Pagos. Consulta [Encontrar pagos](/betalingsverwerking/betalingen-bekijken). En **Transferencia bancaria** también puedes hacer que el cliente reciba un correo con el consejo de usar la comunicación estructurada en las próximas transferencias. La casilla **Enviar recordatorio de comunicación estructurada** está en la pantalla de pago. La casilla aparece en gris si el cliente no tiene dirección de correo electrónico. ## Ajustes para pagos manuales [#instellingen-voor-handmatige-betalingen] En Soporte > Configuración > Pagos encontrarás estos ajustes: | Ajuste | Qué hace | |---|---| | **Mostrar método de pago "Otros"** | Añade el método **Otros** a la pantalla de pago | | **Máximo en efectivo** | El importe máximo en efectivo por pago, por defecto 2999 euros | | **Predeterminado: recordatorio de transferencia bancaria manual** | Activa por defecto la casilla del recordatorio | | **Máximo en efectivo** | Importe máximo que puedes registrar como pago en efectivo, en euros enteros (por defecto 2999) | ## ¿Problemas? [#problemen] Un pago en efectivo no puede superar el **Máximo en efectivo** de Soporte > Configuración > Pagos (por defecto 2999 euros). Registra el importe en partes, o elige otro método. El método está desactivado. Activa **Mostrar método de pago "Otros"** en Soporte > Configuración > Pagos. Los pagos manuales no están disponibles para todas las facturas. La pantalla lo indica. ## Véase también [#zie-ook] # Grupos de pago (/es-ES/betalingsverwerking/groepen) Un grupo de pago agrupa varios pagos entrantes bajo un nombre, de modo que puedas asociarlos de una vez a una factura contabilizada. Es útil si solo quieres conciliar al final del día o de una actividad. Ejemplos: - **Cerrar un turno de caja**: todos los pagos con tarjeta del día están en un grupo. Los asocias a la factura de ingresos diarios. - **Facturar una actividad**: los participantes pagan por adelantado en línea. Al contabilizar, asocias todo el grupo a la factura. - **Una reserva con anticipo y saldo**: el anticipo y el pago final están juntos en un grupo y se asignan de una vez. ## Las reglas [#de-regels] - Un grupo tiene el estado Abierto (aún sin asociar) o Asignado (ya asociado a una factura). - Un grupo no tiene cliente propio. El cliente se deduce de la factura a la que asocias el grupo. - Los pagos de un grupo solo se mueven juntos. Un pago individual de un grupo no se puede asociar a otra factura. - Solo puedes asociar un grupo a una factura contabilizada. Las facturas en borrador aún pueden cambiar o desaparecer. ## Asociar un grupo a una factura [#een-groep-aan-een-factuur-koppelen] ### Abre los grupos de pago [#open-de-betalingsgroepen] Ve a Administración > Pagos y mira en **Grupos de pago**. La lista muestra por defecto solo los grupos abiertos. Cambia el filtro **Estado** para ver también los grupos asignados. ### Elige Asignar [#kies-koppelen] Abre el menú de acciones (tres puntos) de un grupo abierto y elige **Asignar**. ### Elige la factura [#kies-de-factuur] Selecciona la factura contabilizada a la que debe asociarse todo el grupo. ### Confirma [#bevestig] Haz clic en **Asignar** en la ventana. Todos los pagos del grupo pasan de una vez a esa factura, y el grupo obtiene el estado Asignado. También puedes hacerlo desde la factura. Elige ahí **Asignar pago** en el menú de acciones, ve a la pestaña **Grupos de pagos** y haz clic en **Asignar grupo**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] Un grupo asignado aparece en el PDF de la factura como una línea con el total del grupo. Los pagos individuales se despliegan en la vista general de pagos de la factura. El propio grupo lo ves en los detalles de cada pago que contiene. Si el grupo contiene un pago de Mollie que ya existe en Mollie, junto a **Asignar** aparece también **Sincronizar**. Esa acción obtiene a la vez los datos actuales de todos los pagos aptos del grupo. Ayuda si dudas del estado o si se ha perdido un aviso. Un grupo vacío puedes eliminarlo con **Eliminar**. ## ¿Cómo llegan los pagos a un grupo? [#hoe-komen-betalingen-in-een-groep] Tu sistema de caja o de actividades puede indicar un nombre de grupo al crear un pago de Mollie. Tillor crea entonces un grupo por sí mismo, o usa un grupo abierto existente, y coloca el pago en él. Los campos para ello están en [Metadatos de Mollie](/ontwikkelaars/mollie-metadata#ingestie-hints-voor-betalingsgroepen). ## ¿Problemas? [#problemen] La factura aún es un borrador. Contabilízala primero, porque solo las facturas contabilizadas pueden recibir un grupo. Eso no es posible para un pago que sigue en un grupo. Trabaja a nivel de grupo. ## Véase también [#zie-ook] # Cobrar una factura con un mandato (/es-ES/betalingsverwerking/incasso) Si un cliente tiene un mandato activo, Tillor puede cobrar una factura de su cuenta bancaria. Tú eliges cómo: asocias el mandato a la factura para que el cobro empiece solo tras contabilizarla, o inicias el cobro manualmente con **Realizar pago**. Un mandato se solicita mediante [Hacer firmar un mandato SEPA](/betalingsverwerking/mandaat). Una nota de crédito no se puede cobrar. ## Dejar que una factura se cobre automáticamente [#een-factuur-automatisch-laten-innen] ### Abre la factura [#open-de-factuur] Ve a Administración > Facturas y abre una factura del cliente, en borrador o contabilizada. ### Elige el mandato [#kies-het-mandaat] En **Mandato de domiciliación**, elige el mandato del cliente. En la lista solo aparecen mandatos activos. Elige **Sin mandato** para quitar de nuevo la asociación. El campo indica lo que ocurre: Tillor crea de inmediato un pago pendiente, y se cobra al banco dos días después de contabilizar. Hasta entonces puedes cancelar el pago. ### Contabiliza la factura [#boek-de-factuur] Tras contabilizar, la factura muestra **El cobro está programado para el** con la fecha. Ese día, Tillor envía el cobro al banco. Si la factura ya estaba contabilizada cuando asociaste el mandato, se aplica el mismo plazo de dos días desde ese momento. Si Tillor ya ha enviado el cobro al banco, ya no puedes modificar el mandato de la factura. ### El importe máximo de un mandato [#het-maximumbedrag-van-een-mandaat] Cada mandato tiene un importe máximo. Lo ves en la lista de mandatos como **máx.** con un importe. Si una factura es superior, entonces: - el mandato aparece en gris en la lista, con el aviso de que el máximo es inferior al importe de la factura; - la factura muestra el aviso de que el importe de la factura supera el máximo del mandato; - Tillor no puede contabilizar una factura con un mandato así asociado. Elige entonces un mandato con un máximo más alto, o deja que el cliente pague de otra forma. ## Iniciar un cobro manualmente [#een-incasso-handmatig-starten] ### Abre la pantalla de pago [#open-het-betaalscherm] Abre la factura contabilizada y haz clic en **Realizar pago**. ### Elige Mandato SEPA [#kies-sepa-mandaat] En **Método de pago**, elige **Mandato SEPA**. Si aparece en gris, el cliente no tiene ningún mandato activo que soporte el importe. ### Elige el mandato y el retraso [#kies-het-mandaat-en-de-vertraging] Selecciona el **Mandato**. Tillor elige por sí mismo el primer mandato activo que soporte el importe. En **Retraso (días)** introduces de 0 a 7 días. Con 0, el cobro va de inmediato al banco; con un número mayor, Tillor espera esos días. ### Realiza el pago [#voer-de-betaling-uit] Haz clic en **Realizar pago**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] El pago aparece en la factura y en Administración > Pagos. - Mientras el cobro espera, en los detalles aparece **Enviar después** con la fecha. Elige **Omitir retraso** en el menú de acciones para enviarlo ya al banco, o **Cancelar** para detenerlo. - Tras el envío, el pago tiene el estado Pendiente con la **Fecha de vencimiento**. Un cobro SEPA tarda unos días. Después pasa a Pagado, o a Fallido si el banco rechaza el cobro. - Un cobro en curso ya cuenta en la contabilidad como pago pendiente. Si falla o lo cancelas, desaparece de nuevo del borrador. Consulta [Informes de pago](/boekhouden/betalingsrapporten). - En la página de pago, el cliente ve **Se cobra por domiciliación** con el importe y la fecha, y ningún botón de pago. Así nadie paga dos veces. El PDF de la factura y el correo de la factura indican el importe y la fecha del cobro. El pequeño primer pago con el que un cliente confirmó su mandato, Tillor lo descuenta de la siguiente factura. ## Cobrar automáticamente las facturas de suministros [#nutsfacturen-automatisch-innen] Las facturas de consumo de agua, electricidad y gas pueden cobrarse automáticamente con el mandato del cliente. - Si al firmar el cliente marca **Usar también este mandato para pagar automáticamente mis facturas de suministros (agua, luz, gas)**, Tillor configura este mandato en cuanto está activo. La casilla viene marcada por defecto. - También puedes elegir tú mismo el mandato en Clientes > cliente > Facturación, en la tarjeta **Configuración de facturación**, en **Mandato**. - En la lista de mandatos, el mandato para suministros aparece indicado con **Suministros**. Una nueva factura de consumo recibe entonces este mandato automáticamente como **Mandato de domiciliación**. ## ¿Problemas? [#problemen] El cliente no tiene ningún mandato con estado Activo cuyo máximo sea suficientemente alto. Comprueba la tarjeta **Mandatos** en Clientes > cliente > Facturación. El mandato asociado tiene un máximo inferior al importe de la factura. Elige otro mandato o quita el mandato de la factura. Tillor ya ha enviado el cobro al banco. Sigue el pago en Administración > Pagos. Abre el pago para ver el motivo. La factura vuelve a estar pendiente. Elige **Realizar pago** para un nuevo cobro u otro método, o envía al cliente un enlace de pago con **Enviar notificación**. Mientras el pago en Administración > Pagos siga mostrando **Enviar después**, puedes cancelarlo. Si ya se ha enviado, ya no es posible. Sí puedes revocar el mandato para las siguientes facturas, consulta [Revocar un mandato](/betalingsverwerking/mandaat-beheren). Las automatizaciones también pueden cobrar: el paso [Cobrar por domiciliación](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring). ## Véase también [#zie-ook] # Vista general (/es-ES/betalingsverwerking) Un pago en Tillor suele estar asociado a una factura contabilizada. El cliente puede pagar por sí mismo en línea, tú puedes registrar un pago en recepción, o Tillor cobra el importe automáticamente mediante un mandato SEPA. En esta página ves para qué sirve cada método. - Un pago está asociado a una factura contabilizada. En un borrador no se puede pagar. - Un pago en efectivo puede ser, por defecto, de como máximo 2999 euros. Lo ajustas con **Máximo en efectivo** en Soporte > Configuración > Pagos. - A partir de 2500 euros, la página de pago avisa al cliente de que el banco o la tarjeta puede rechazar el pago en línea. El cliente recibe entonces el IBAN y la comunicación estructurada para transferir. - Un cobro con un mandato se envía al banco dos días después de contabilizar. En **Realizar pago** eliges tú un retraso de 0 a 7 días. Hasta que el cobro sale, puedes cancelarlo. - Si una factura supera el máximo del mandato, no se puede cobrar. Si ese mandato está en la factura, tampoco puedes contabilizarla. - El enlace de firma de un mandato funciona 14 días. Tillor recuerda al cliente a los 7 días, 2 días antes de que caduque y el último día. - Una transferencia interna solo es posible entre dos facturas contabilizadas del mismo cliente. - Tillor no puede devolver dinero a un cliente. Una devolución se gestiona fuera de Tillor, por ejemplo con una transferencia bancaria. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Todos los métodos terminan en el mismo sitio: un pago en la factura. Después pasa al informe de pagos y a tu contabilidad. ```mermaid flowchart LR F[Factura contabilizada] --> M{Método de pago} M -- En línea --> P[Pago] M -- Terminal --> P M -- Efectivo o transferencia --> P M -- Cobro SEPA --> P M -- Transferencia interna --> P P -- Estado y saldo --> F P -- Por día --> R[Informe de pagos] R --> B[Contabilidad] ``` Un cobro permanece primero Pendiente. La factura figura entonces ya como pagada (pendiente). Si el cobro falla, la factura vuelve a estar pendiente. Los informes de pago y la conexión con el software de contabilidad se explican en [Contabilidad](/boekhouden). ## ¿Qué método eliges? [#welke-methode-kies-je] | Método | Cuándo | Cómo paga el cliente | Qué contabiliza Tillor | |---|---|---|---| | [Pagar en línea](/betalingsverwerking/online) | El cliente paga por sí mismo, en casa o de viaje | Mediante el enlace del correo o SMS de la factura, con iDEAL, Bancontact, tarjeta de crédito u otro método | El pago en cuanto el socio de pago lo confirma, aunque el cliente ya no haga nada más | | [Terminal](/betalingsverwerking/terminal) | El cliente está en recepción | Con tarjeta o teléfono en un terminal de pago de Mollie | El pago en cuanto el terminal lo finaliza | | [Efectivo y transferencia](/betalingsverwerking/contant) | Dinero recibido al margen de Tillor | Efectivo en recepción o una transferencia bancaria | El pago que registras tú, con la fecha de recepción | | [Mandato SEPA](/betalingsverwerking/incasso) | Facturas recurrentes o grandes, consumo | No paga. Tillor cobra el importe de la cuenta bancaria | Un pago pendiente hasta que el banco confirma el cobro | | [Transferencia interna](/betalingsverwerking/interne-overboeking) | Trasladar saldo entre dos facturas del mismo cliente | No paga. No entra dinero | Dos pagos asociados, uno positivo y otro negativo | Los pagos en línea, los pagos con tarjeta y los cobros pasan por Mollie. Los pagos en efectivo y las transferencias los registras tú mismo. } description="La pantalla de pago en una factura contabilizada" /> } description="Por factura, en la vista general y en los detalles" /> } description="La página de pago que ve el cliente" /> } description="Pagos con tarjeta en recepción" /> } description="Registrar pagos al margen de Tillor" /> } description="Trasladar saldo entre facturas" /> } description="A distancia o en recepción" /> } description="Cobrar automáticamente con un mandato" /> } description="Agrupar pagos y asociarlos de una vez" /> } description="Ejemplos elaborados de la práctica" /> ## Conceptos [#begrippen] - **Pago**: un importe recibido o en curso, con un método, un estado y normalmente una factura. - **Mandato**: la autorización de un cliente para cobrar facturas de su cuenta bancaria. Consulta [Mandato SEPA](/betalingsverwerking/mandaat). - **Grupo de pago**: un conjunto de pagos que más adelante asocias de una vez a una factura. Consulta [Grupos de pago](/betalingsverwerking/groepen). - **Informe de pagos**: el resumen diario de los pagos recibidos para la contabilidad. Consulta [Informes de pago](/boekhouden/betalingsrapporten). - **Transferencia interna**: trasladar saldo entre dos facturas del mismo cliente, sin que entre dinero. - **Cobro**: Tillor cobra el importe de la cuenta bancaria del cliente, con su mandato. - **Cliente**: el cliente al que pertenece la factura. Consulta [Cliente](/begrippen#klant). # Hacer una transferencia interna (/es-ES/betalingsverwerking/interne-overboeking) Con **Transferencia interna** trasladas un importe de una factura contabilizada a otra factura contabilizada del mismo cliente. No entra dinero. Tillor crea un pago positivo en la factura que saldas y un pago negativo asociado en la factura de destino. Esto no es un pago en efectivo, con tarjeta ni una transferencia bancaria. Esos métodos aparecen por separado en la pantalla de pago. ## Registrar una transferencia interna [#een-interne-overboeking-registreren] ### Abre la pantalla de pago [#open-het-betaalscherm] Abre la factura contabilizada con saldo pendiente y haz clic en **Realizar pago**. ### Elige Transferencia interna [#kies-interne-overboeking] En **Método de pago**, elige **Transferencia interna**. ### Elige la factura de destino [#kies-de-doelfactuur] En **Factura de destino**, selecciona la factura contabilizada a la que va el importe. La lista solo muestra facturas contabilizadas del mismo cliente. ### Introduce el importe [#vul-het-bedrag-in] Escribe un importe o usa los botones 25 %, 50 %, 75 % y 100 %. ### Realiza el pago [#voer-de-betaling-uit] Rellena, si quieres, **Fecha de recepción** y haz clic en **Realizar pago**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tillor crea dos pagos asociados, **Transferencia interna desde** y **Transferencia interna a**, cada uno con el número de factura de la otra factura. - Se actualiza el saldo pendiente de ambas facturas. - Si eliminas uno de los dos pagos, Tillor elimina también el otro. ## Transferencia interna y contabilidad [#interne-overboeking-en-boekhouding] - Una transferencia interna figura en el informe de pagos del día en que la registras. Si la registras hoy, aparece de inmediato en el [informe borrador](/boekhouden/betalingsrapporten#concept-en-definitief) de hoy. - Pasa a la exportación contable, junto con los pagos de Mollie. - Los pagos en efectivo, las transferencias bancarias y las cuentas bancarias no pasan a la exportación contable. ## Tras rectificar una factura con Prolongar periodo de ocupación [#na-het-omkeren-van-een-factuur-met-bezetting-verlengen] Con **Rectificar factura** conviertes una factura en una nota de crédito. Una transferencia interna entre esas dos facturas es solo una compensación en la contabilidad. No vuelve a prolongar ni a acortar la ocupación. Qué significa eso para **Pagado hasta**: - En la factura original, **Pagado hasta** no cambia. - En la nota de crédito, **Pagado hasta** solo retrocede si la factura original ya se había pagado con un pago real, como efectivo, transferencia bancaria o Mollie. Si solo se había compensado con una transferencia interna, **Pagado hasta** se mantiene igual. - **Facturado hasta** ya se ajustó al contabilizar. ## ¿Problemas? [#problemen] Solo aparecen facturas contabilizadas del mismo cliente. Contabiliza primero una factura en borrador, y no elijas la misma factura en la que haces el pago. ## Véase también [#zie-ook] # Revocar o reenviar un mandato (/es-ES/betalingsverwerking/mandaat-beheren) Todas las acciones de un mandato están en el menú (tres puntos) al final de la fila, en la tarjeta **Mandatos**. Esa tarjeta está en Clientes > cliente > Facturación. Las acciones que ves dependen del estado. | Estado | Acciones en el menú | |---|---| | Pendiente de firma | **Mostrar en el iPad**, **Enviar recordatorio**, **Reenviar enlace de firma**, **Cancelar solicitud** | | Enlace caducado | **Reenviar enlace de firma**, **Cancelar solicitud** | | Activación fallida | **Cancelar solicitud** | | Activo | **Abrir mandato firmado**, **Revocar mandato** | | Revocado | **Abrir mandato firmado** | **Mostrar en el iPad** solo aparece si la app de Tillor está en línea en un dispositivo de tu organización. ## Reenviar una solicitud pendiente [#een-openstaande-aanvraag-opnieuw-versturen] ### Abre el menú de la solicitud [#open-het-menu-bij-de-aanvraag] Busca la solicitud con estado Pendiente de firma o Enlace caducado. ### Elige la acción [#kies-de-actie] - **Enviar recordatorio** vuelve a enviar un correo al cliente, con un enlace nuevo. La fecha de fin no cambia. - **Reenviar enlace de firma** envía por correo un enlace nuevo que vuelve a funcionar 14 días. Un enlace enviado antes deja de funcionar después de ambas acciones. Tillor muestra **Recordatorio enviado** o **Enlace de firma reenviado**. El cliente recibe un correo. Cómo funcionan los recordatorios automáticos se explica en [Hacer firmar un mandato SEPA](/betalingsverwerking/mandaat#herinneringen-voor-het-tekenen). ## Cancelar una solicitud [#een-aanvraag-annuleren] Elige **Cancelar solicitud** si el cliente ya no necesita firmar. La solicitud pasa al estado Cancelado. Si está en la tableta, desaparece de ella. Después puedes iniciar una solicitud nueva. ## Revocar un mandato activo [#een-actief-mandaat-intrekken] Revoca un mandato si ya no se puede cobrar al cliente, por ejemplo por una mudanza, un contrato cancelado o a petición del cliente. Para el pago automático se necesitará después un mandato nuevo, con una nueva firma del cliente. ### Elige Revocar mandato [#kies-mandaat-intrekken] Abre el menú del mandato activo y elige **Revocar mandato**. ### Confirma [#bevestig] En la pantalla **¿Revocar este mandato?**, haz clic en **Revocar**. Tillor muestra **Mandato revocado**. Qué ocurre después: - Ya no se cobra ninguna factura mediante este mandato. Los cobros que Tillor aún no había enviado al banco se cancelan. - El estado del mandato pasa a Revocado. - El documento firmado se conserva como prueba, pero pasa al archivo. En los documentos del cliente lo encuentras en **Archivados**, de modo que la lista solo muestra los mandatos que siguen vigentes. - El cliente recibe un correo indicando que el mandato se ha revocado, con una copia del documento firmado. Los mandatos configurados fuera de Tillor solo muestran **Revocar mandato** en el menú. ## ¿Problemas? [#problemen] La acción solo aparece en un mandato con estado Activo. Una solicitud que aún no está firmada se cancela con **Cancelar solicitud**. Revocar solo cancela los cobros que Tillor aún no había enviado al banco. Un cobro que ya va de camino lo sigues en Administración > Pagos. Elige el mandato en **Mandato de domiciliación** en la factura. Consulta [Cobrar una factura](/betalingsverwerking/incasso). ## Véase también [#zie-ook] # Hacer firmar un mandato SEPA (/es-ES/betalingsverwerking/mandaat) Con un mandato SEPA, un cliente autoriza que se cobren facturas automáticamente de su cuenta bancaria. El cliente firma el mandato en el propio Tillor. Tillor guarda el documento firmado en el cliente y después puedes cobrar facturas. Eso se explica en [Cobrar una factura](/betalingsverwerking/incasso). Antes de empezar: - Los mandatos deben estar habilitados para tu organización. Si no es así, el botón **Crear mandato** indica que debes contactar con el administrador. - El cliente necesita una dirección de correo electrónico. - Un cliente solo puede tener una solicitud abierta a la vez. ## Solicitar un mandato [#een-mandaat-aanvragen] ### Abre el cliente [#open-de-klant] Ve a Clientes > cliente > Facturación. Abajo está la tarjeta **Mandatos** con todos los mandatos y solicitudes del cliente. ### Haz clic en Crear mandato [#klik-op-mandaat-aanmaken] Se abre un menú con una o dos opciones. Elige cómo firma el cliente. Elige **Enviar invitación de mandato**. El cliente recibe un correo con un enlace a la página de firma, y Tillor muestra **Mandato enviado para firma a** la dirección de correo del cliente. El enlace funciona 14 días, hasta el último día inclusive. El cliente no tiene que indicar ningún IBAN. Él mismo elige cómo confirma el mandato. Elige **Firmar en el iPad de recepción**. El mandato aparece en la tableta de recepción, y Tillor muestra **El mandato está en el iPad para que el cliente firme**. Esta opción solo aparece en el menú si la app de Tillor está en línea en un dispositivo de tu organización. Consulta [Tabletas y quioscos](/mobiele-app/tablets-en-kiosken). El cliente firma con el dedo en la tableta. El documento firmado anota que se firmó en recepción, y qué compañero usó la tableta. ¿La solicitud ya se ha enviado y quieres mostrarla aun así en la tableta? Abre el menú de la solicitud y elige **Mostrar en el iPad**. ## ¿Qué hace el cliente? [#wat-doet-de-klant] El cliente recorre varias pantallas. En la tableta son las mismas pantallas, con algunas diferencias que se indican más abajo. ### Ver el mandato [#het-mandaat-bekijken] La página **Firma tu mandato SEPA para** tu organización muestra quién es el acreedor, para quién cobra y qué tipo de pago es. El cliente toca **Firmar mandato**. ### Aceptar el texto [#de-tekst-accepteren] El cliente lee el resumen o, con **Leer el texto completo del mandato**, el texto entero, y marca que está de acuerdo. Debajo hay una segunda casilla para usar también el mandato para las facturas de suministros (agua, electricidad, gas). Esa casilla viene marcada por defecto. Consulta [Cobrar una factura](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen). ### Firmar [#tekenen] El cliente firma con el dedo o el ratón. ### Elegir la confirmación [#de-bevestiging-kiezen] En **¿Cómo quieres autorizar?**, el cliente elige entre dos formas de confirmar. - **Un pequeño primer pago** con su propio banco o tarjeta, por ejemplo mediante iDEAL, Bancontact, tarjeta de crédito o Apple Pay. El importe está entre 0 y 1 euro, según el método. Así el banco confirma que la cuenta es del cliente, y este no tiene que teclear ningún IBAN. Tillor descuenta el importe de la siguiente factura. - **Cuenta bancaria (SEPA)**: el cliente introduce su IBAN, confirma que la cuenta es suya e introduce un código de seis dígitos. Ese código llega por SMS al número de teléfono del cliente, o por correo si no se conoce ningún número. En la tableta, la vía del IBAN funciona igual: el código se envía por SMS al teléfono del cliente. Si el cliente elige el primer pago, la tableta muestra un código QR que el cliente escanea con su teléfono para pagar. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El mandato aparece en la lista con el estado Firmado, activando, o Pendiente del primer pago si el cliente eligió el pequeño pago. - En cuanto el mandato es válido en el socio de pago, el estado pasa a Activo. El cliente recibe por correo una copia del mandato firmado. - Tillor guarda el documento firmado en los documentos del cliente. Lo abres desde el menú del mandato con **Abrir mandato firmado**. El documento está sellado y lleva una marca de tiempo, de modo que cualquier modificación posterior se nota en un lector de PDF. Consulta [Sello y marca de tiempo](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel). - Si el cliente cierra la ventana antes de que el primer pago esté listo, la solicitud sigue abierta. El cliente puede volver a intentarlo con el mismo enlace o pasar a su IBAN. ## Estados [#statussen] | Estado | Significado | |---|---| | Pendiente de firma | El cliente aún no ha firmado | | Firmado, activando | Firmado con IBAN, Tillor crea el mandato | | Pendiente del primer pago | Firmado, el pequeño pago aún debe completarse | | Activo | Puedes usar el mandato para cobrar | | Activación fallida | El socio de pago rechazó el mandato. Tillor lo intenta de nuevo más tarde | | Enlace caducado | El cliente no firmó en 14 días | | Cancelado | Has cancelado la solicitud | | Revocado | El mandato activo se ha revocado | Los mandatos configurados fuera de Tillor muestran los estados Pendiente, Activo, Inactivo y Cancelado. Solo un mandato activo se puede usar para cobrar. ## Recordatorios antes de firmar [#herinneringen-voor-het-tekenen] Tillor envía por sí mismo recordatorios por correo al cliente mientras la solicitud siga abierta: cuando quedan 7 días, dos días antes de que caduque y el último día. Cada recordatorio contiene un enlace de firma nuevo. ¿Quieres dar tú mismo un empujón al cliente? Elige **Enviar recordatorio** en el menú de la solicitud. La fecha de fin se mantiene. Si el enlace ha caducado, o quieres dar otros 14 días, elige **Reenviar enlace de firma**. Encontrarás más información sobre estas acciones en [Revocar o reenviar un mandato](/betalingsverwerking/mandaat-beheren). ¿Quieres que una automatización reaccione cuando una solicitud caduque? Para eso existe el disparador **Solicitud de mandato caducada**, consulta [Automatizaciones](/automatiseringen). ## ¿Problemas? [#problemen] Pasa el cursor sobre el botón para ver el motivo. Normalmente el cliente no tiene dirección de correo electrónico, o los mandatos no están habilitados para tu organización. Añade una dirección de correo al cliente o pide a tu administrador que active los mandatos. Por cliente solo puede haber una solicitud abierta a la vez. Reenvía la solicitud existente o cancélala, y crea después una nueva. La opción solo aparece si la app de Tillor en un dispositivo de tu organización ha contactado con Tillor hace poco. Abre la app en la tableta, espera un momento e inténtalo de nuevo. El código se envía al número de teléfono del perfil del cliente. Comprueba que sea correcto. Si el cliente no tiene número, el código llega por correo. El cliente puede pedir un código nuevo. El cliente ve **Este enlace de firma ha caducado**. En la solicitud, elige **Reenviar enlace de firma**. El socio de pago ha rechazado el mandato. Tillor lo intenta de nuevo automáticamente más tarde. Si sigue sin funcionar, cancela la solicitud con **Cancelar solicitud** y pide al cliente que firme de nuevo, quizá con otra confirmación. ## Véase también [#zie-ook] # Hacer que un cliente pague en línea (/es-ES/betalingsverwerking/online) El pago en línea se realiza mediante la página de pago personal de una factura. El cliente abre la página, elige un método de pago y completa el pago en su banco o con el emisor de su tarjeta. Tillor colabora para ello con [Mollie](https://www.mollie.com), por lo que Mollie debe estar conectado. No hay un botón aparte de Enviar enlace de pago. Compartes la página con una notificación o con la URL personal de la factura. Antes de empezar: - La factura está contabilizada y hay un importe pendiente. De lo contrario, el cliente no tiene nada que pagar. - Mollie está conectado. Sin métodos de Mollie, el cliente solo ve un botón de pago, consulta [¿Problemas?](#problemen). - El cliente tiene dirección de correo electrónico o número de teléfono, o compartes tú mismo el enlace. ## Enviar el enlace de pago al cliente [#de-betaallink-naar-de-klant-sturen] ### Contabiliza la factura [#boek-de-factuur] El pago en línea solo es posible en una factura contabilizada con saldo pendiente. ### Envía una notificación [#verstuur-een-notificatie] Haz clic en **Enviar notificación** y elige un canal, como correo o SMS. El cliente recibe un mensaje con el botón **Consultar y pagar en línea**. ¿Prefieres compartirlo tú? Abre el menú de acciones (tres puntos) de la factura y elige **URL personal**. Tillor copia el enlace en tu portapapeles. Un recordatorio con el mismo enlace lo envías con **Enviar recordatorio**, consulta [Encontrar pagos](/betalingsverwerking/betalingen-bekijken#een-aanmaning-versturen). ¿El cliente solo quiere pagar una parte? Crea entonces un [enlace para un pago parcial](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). ## ¿Qué ve el cliente? [#wat-ziet-de-klant] El cliente abre la página **Tu factura de** tu organización. Ahí figuran el importe a pagar, un resumen de las líneas de la factura y un botón para ver la factura. Desde esa pantalla, el cliente continúa en tres pasos. ### Pagar [#betaal] El cliente toca **Pagar** con el importe. Si hay un botón de Apple Pay, el cliente puede pagar directamente con él. ### Elegir un método [#kies-een-methode] En **¿Cómo quieres pagar?** aparecen los métodos disponibles, como iDEAL, Bancontact y tarjeta de crédito. El orden lo da Mollie y se adapta al idioma del cliente. Se aplican estas reglas: - El método que el cliente usó la última vez en ese dispositivo aparece con **Último uso**. - Para clientes francófonos, Pay By Bank aparece arriba con **Suele ser la mejor opción**. - Si un método tiene una incidencia en Mollie, aparece un aviso, por ejemplo que el método no está disponible parcialmente o que está en mantenimiento. El cliente aún puede probar el método, pero el aviso indica que quizá no funcione. El texto de la incidencia procede de Mollie. ### Completar el pago [#rond-de-betaling-af] Lo que ocurre después depende del método y del dispositivo. Consulta más abajo. ### Completar en ordenador o teléfono [#afronden-op-computer-of-telefoon] Con iDEAL y Bancontact, Tillor muestra un código QR bajo **Escanea para pagar con**. El cliente abre la app del banco en su teléfono y escanea el código. La página continúa sola en cuanto llega el pago. Si el cliente prefiere pagar en el ordenador, puede hacerlo con **Pagar en el navegador**. Con Bancontact, Tillor muestra el botón **Abrir la app de Bancontact**. El cliente completa el pago en la app y luego vuelve a la página. Con **Pagar en el navegador**, el cliente también puede pagar en el navegador del teléfono. Con otros métodos, como la tarjeta de crédito, Tillor redirige al cliente a la página de pago del socio de pago y después lo trae de vuelta. Si la redirección no se produce sola, aparece un enlace para continuar. ### Si no funciona [#als-het-niet-lukt] - **Elegir otro método** lleva al cliente de vuelta a la lista. - **Empezar de nuevo** inicia un nuevo pago con el mismo método. Es útil si el cliente canceló en la app del banco o no pasó nada. - En un pago fallido, cancelado o caducado, la página indica el resultado y el cliente puede elegir otro método. ## Qué más puede mostrar la página [#wat-de-pagina-nog-meer-kan-tonen] | Situación | Lo que ve el cliente | |---|---| | La factura está pagada | **Pagada por completo** con el importe recibido, y una confirmación por correo | | El banco ha iniciado una transferencia | **Confirmando tu pago**. Con Pay By Bank suele tardar unos segundos y, como máximo, unos días laborables | | Hay un cobro SEPA programado | **Se cobra por domiciliación** con el importe y la fecha. El cliente no tiene que hacer nada. No hay opciones de pago, para que nadie pague dos veces | | El importe es superior a 2.500 euros | Un aviso de que el banco o la tarjeta puede rechazar el pago en línea por límites, con el IBAN y la comunicación estructurada para transferir | | El pago en línea no es posible para esta factura | **Pagar por transferencia** con los datos bancarios | ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] El enlace personal no tiene fecha de caducidad. Por tanto, el cliente también puede abrirlo más tarde. En cuanto Mollie confirma el pago, aparece en la factura y en Administración > Pagos. La factura pasa a Pagado cuando ha entrado todo el importe. No tienes que registrar nada tú. Consulta [Encontrar pagos](/betalingsverwerking/betalingen-bekijken) para los estados. ## ¿Problemas? [#problemen] Mollie no transmite entonces ningún método. El cliente solo ve el botón de pago y con él va directamente a la página de pago de Mollie. Si sigue así, comprueba la conexión con Mollie. Abre el pago en Administración > Pagos y usa **Sincronizar**. Con Pay By Bank, la confirmación puede tardar unos días laborables. Mollie informa de que el método tiene fallos. El cliente puede elegir otro método o volver a intentarlo más tarde. ¿Integras un sistema propio con pagos de Mollie? Consulta [Metadatos de Mollie](/ontwikkelaars/mollie-metadata). ## Véase también [#zie-ook] # Pagar con un terminal de pago (/es-ES/betalingsverwerking/terminal) Con el método de pago **Terminal** envías el importe pendiente de una factura a un terminal de pago en recepción. El cliente paga con tarjeta o con el móvil, y Tillor registra el pago en cuanto el terminal lo completa. Tillor es el Mollie Tech Partner exclusivo para pagos con terminal. Tillor suministra los terminales de [Mollie](https://www.mollie.com) y configura contigo Mollie Connect, el dispositivo y la vinculación con las facturas. Por eso, las preguntas sobre el pago con terminal en recepción llegan a Tillor. Tillor no vincula terminales de Worldline, CCV ni de otras marcas. Si ya tienes uno de esos terminales, te daremos un dispositivo de Mollie. Así, el pago online, el pago con terminal y el [informe de pagos](/boekhouden/betalingsrapporten) siguen formando una sola cadena. ## Iniciar un pago con terminal [#een-pinbetaling-starten] ### Abre la pantalla de pago [#open-het-betaalscherm] Abre una factura contabilizada con saldo pendiente y haz clic en **Realizar pago**. ### Elige Terminal [#kies-terminal] En **Método de pago**, elige la opción **Terminal**. ### Elige el terminal [#kies-de-terminal] Selecciona el terminal de tu recepción. Tillor solo muestra los terminales disponibles en ese momento. Si solo tienes uno, ya aparece seleccionado. ### Introduce el importe [#vul-het-bedrag-in] Escribe un importe o usa los botones 25%, 50%, 75% y 100%. Un importe parcial resulta útil para un anticipo o cuando el cliente paga una parte en efectivo y otra con tarjeta. ### Envía el pago [#stuur-de-betaling] Haz clic en **Realizar pago**. Aparece la pantalla **Procesando pago** mientras Tillor envía la solicitud al terminal. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] La pantalla sigue el pago en directo. El cliente paga en el terminal y la pantalla pasa de **Pago en curso** a **Pago correcto**. Se cierra sola tras unos segundos y el saldo pendiente de la factura queda actualizado. Mientras el terminal espera, puedes activar dos casillas: - **Imprimir A4 al pagar** pone el PDF de la factura en la cola de la impresora A4 en cuanto el pago se completa. La opción aparece en gris si no hay ningún conector en línea. - **Enviar por correo tras el pago** envía la factura por correo al cliente en cuanto el pago se completa. La opción aparece en gris si el cliente no tiene dirección de correo electrónico. Si el pago falla o caduca, recibirás el aviso **Pago fallido** o **Pago caducado**. Haz clic en **Reenviar al terminal** para volver a intentarlo. ## Configurar el terminal predeterminado [#de-standaardterminal-instellen] Tillor activa el terminal de pago con vuestra cuenta de Mollie. Tras vincular Mollie, Tillor elige el terminal por sí mismo si hay exactamente un terminal activo. Para elegir otro, ve a Ajustes > Integraciones, en Mollie, al campo **Terminal predeterminado** (junto al **Perfil principal**). Tillor propondrá entonces ese terminal en un pago con terminal. ## ¿Problemas? [#problemen] El método solo aparece cuando Mollie está vinculado y hay un terminal asociado a tu cuenta. Comprueba la vinculación en Ajustes > Integraciones. Tillor solo muestra los terminales que están en línea y activos. Comprueba que el terminal esté encendido y conectado, e inténtalo de nuevo. Tras un nuevo intento puede quedar un pago antiguo con el estado Pendiente. Cancélalo en Administración > Pagos con **Cancelar** en el menú de acciones, para que la factura sea correcta. Escribe a **support@tillor.eu**. ## Véase también [#zie-ook] # Ocupaciones (/es-ES/bezettingen) Una ocupación registra que un cliente utiliza una determinada parcela (una plaza de camping, un poste eléctrico y similares). Mientras la ocupación está en curso, Tillor imputa automáticamente al cliente el consumo de los contadores de esa parcela. Gestionas las ocupaciones en el perfil del cliente. Empieza por [Crear una ocupación](#een-bezetting-aanmaken). - Una parcela solo puede estar ocupada por un cliente a la vez. Las parcelas con una ocupación activa no aparecen en la lista de selección. - **Pagado hasta** solo acepta hoy o una fecha posterior. - La parcela de una ocupación no se puede cambiar después. Si un cliente se muda, finaliza la ocupación y crea una nueva. - Eliminar una ocupación no se puede deshacer, pero el consumo hasta la fecha de fin se conserva y todavía se puede facturar. - Con **Extender ocupación (factura)**, la factura en borrador recibe una fecha de vencimiento de 14 días después de su creación. - Solo los campos **Tipo**, **Frecuencia de alquiler** y **Precio** son informativos. No controlan automáticamente el registro de contadores ni la facturación. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Una ocupación conecta tres cosas: el cliente, la parcela y los contadores de esa parcela. Gracias a eso, Tillor sabe a nombre de quién va el consumo. ```mermaid flowchart LR K[Klant] --> B[Bezetting] B --> T[Terrein] T --> M[Meters op het terrein] M --> V[Verbruiksperiode van de klant] V --> F[Factuur] B -->|Bezetting verlengen| F ``` Al crearla, Tillor anota las lecturas iniciales de los contadores y, al finalizarla, las lecturas finales. El consumo entre ambas es del cliente. Una nueva ocupación en la misma parcela inicia un nuevo periodo. ## Consultar las ocupaciones [#bezettingen-bekijken] Abre un perfil de cliente en Clientes > Resumen y ve a la tarjeta **Ocupaciones** de la pestaña **Resumen**. - La tabla muestra por ocupación la **Parcela**, el **Tipo**, la **Frecuencia de alquiler**, el **Precio**, el **Estado** y **Pagado hasta**, con una indicación relativa como "dentro de 12 días". - Junto a **Pagado hasta** hay un icono de información con **Facturado hasta** en un tooltip, si esa fecha está rellenada o es igual a **Pagado hasta**. - Con **Filtrar ocupaciones...** buscas por nombre de parcela. - Las acciones de cada ocupación (editar, extender, eliminar) están en el menú de tres puntos al final de la fila. ## Crear una ocupación [#een-bezetting-aanmaken] Antes de empezar: - La parcela debe estar libre. Si no aparece en la lista, ya está ocupada. Consulta Problemas al final. - Si la parcela tiene contadores, ten a mano las lecturas iniciales. Si no rellenas nada, Tillor toma la última lectura conocida. ### Abre el perfil del cliente [#open-het-klantprofiel] Ve a Clientes > Resumen, abre el cliente y ve a la tarjeta **Ocupaciones**. ### Haz clic en Crear ocupación [#klik-op-bezetting-aanmaken] Encontrarás el botón en la barra de herramientas de la tabla. Se abre un diálogo. ### Rellena los datos [#vul-de-gegevens-in] Solo **Parcela** es obligatoria. El resto es opcional. - **Parcela**: elígela mediante **Seleccione una parcela**. En la lista solo aparecen las parcelas disponibles. Si no hay ninguna disponible, verás **No se encontraron parcelas disponibles.** - **Pagado hasta (opcional)**: hasta cuándo ha pagado el cliente por adelantado. Eliges hoy o una fecha posterior. - **Facturado hasta (opcional)**: déjalo vacío para seguir la misma fecha que **Pagado hasta**, o elige una fecha propia. - **Tipo**: **Alojamiento propio** (por defecto) o **Caravana de alquiler**. - **Frecuencia de alquiler (opcional)**: una de las opciones que ha configurado tu organización, cada una con un mes de inicio y un número de meses (por ejemplo, inicio en enero, 6 meses). Elige **Sin frecuencia** si no quieres registrar ninguna. - **Descripción (opcional)**: una aclaración, por ejemplo acuerdos de tarifas. - **Precio**: la ocupación toma el precio de la parcela. Con **Sustituir el precio heredado de la parcela** indicas un precio propio. - **Lecturas iniciales de contadores (opcional)**: aparece en cuanto la parcela tiene contadores. Si no tiene contadores, verás **Sin contadores vinculados**. ### Confirma [#bevestig] Haz clic en **Crear ocupación** para guardar. ### Rellenar las lecturas de los contadores [#meterstanden-invullen] Escribe tú mismo la lectura en la pestaña **Manual**. El campo muestra la última lectura conocida como ejemplo. Si hay lecturas anteriores, con **Seleccionar** también puedes elegir una lectura existente. Un contador que envía lecturas por sí mismo no permite la entrada manual. Elige una lectura existente mediante **Seleccione una lectura de contador**. Si introduces una lectura inferior a la última lectura guardada, Tillor muestra una advertencia. Entonces puedes confirmar igualmente el valor inferior o modificar lo introducido. ### ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La ocupación queda activa de inmediato y aparece en la tabla del perfil del cliente. - Tillor inicia un periodo de consumo para este cliente por cada contador de la parcela. Las nuevas lecturas cuentan desde ahora como consumo del cliente. - La parcela deja de estar disponible para otra ocupación. ## Editar una ocupación [#een-bezetting-bewerken] ### Abre el menú de la ocupación [#open-het-menu-van-de-bezetting] Haz clic en el menú de tres puntos junto a la ocupación y elige **Editar**. ### Ajusta los campos [#pas-de-velden-aan] Puedes modificar **Tipo**, **Frecuencia de alquiler**, **Descripción**, **Pagado hasta**, **Facturado hasta** y **Precio**. **Parcela** es de solo lectura. Si tu organización tiene [campos propios](/eigen-velden) para las ocupaciones, aparecen al final del diálogo. ### Guarda [#sla-op] Haz clic en **Guardar cambios**. El cambio aparece, con un resumen de antes y después, en la pestaña **Eventos** del cliente. ## Finalizar una ocupación [#een-bezetting-beëindigen] Finalizar elimina el vínculo entre cliente y parcela. Después, la parcela vuelve a estar disponible. ### Elige Eliminar [#kies-verwijderen] Haz clic en el menú de tres puntos junto a la ocupación y elige **Eliminar**. Se abre la ventana **Eliminar ocupación**. ### Elige la fecha y las lecturas finales [#kies-de-datum-en-de-eindmeterstanden] Si la parcela tiene contadores, puedes rellenar **Lecturas finales de contadores (opcional)**. Primero elige en **Fecha** el día en que termina la ocupación (hoy o antes). Después aparece un campo de lectura final por contador. Un contador manual lo rellenas mediante **Manual** o lo eliges mediante **Seleccionar**. Un contador automático siempre pide una lectura existente mediante **Seleccione una lectura de contador**. ### Confirma [#bevestig-1] Haz clic en **Eliminar**. Esto no se puede deshacer. ### ¿Qué ocurre después? [#wat-gebeurt-er-daarna-1] - Tillor cierra los periodos de consumo abiertos del cliente. El consumo hasta la fecha de fin se conserva y todavía se puede facturar. - La parcela vuelve a estar disponible para una nueva ocupación. - La ocupación desaparece de la tabla. ## Facturación: extender una ocupación [#facturatie-bezetting-verlengen] Con **Extender ocupación (factura)** creas una factura en borrador para el siguiente periodo de una ocupación, por ejemplo la tarifa anual de estacionamiento. Puedes hacerlo para una sola ocupación o para todas las ocupaciones del cliente a la vez. Antes de empezar: debe existir al menos un producto con la acción **Extender ocupación** (a menudo Staangeld). Consulta [Productos](/producten). ### Inicia la acción [#start-de-actie] Abre el menú de tres puntos junto a la ocupación y elige **Extender ocupación (factura)**. Haz clic en **Extender todas** en la barra de herramientas. Todas las ocupaciones van en una sola factura en borrador, con una línea principal por ocupación. ### Elige si facturas también el consumo [#kies-of-je-verbruik-meefactureert] Marca **Facturar consumo pendiente de esta parcela** (en **Extender todas**: **Facturar consumo pendiente (todas las parcelas)**) si quieres facturar también el consumo pendiente en la misma factura en borrador. Si no hay nada pendiente en los contadores afectados, se quedan solo las líneas de extensión de la ocupación. ### Crea la factura en borrador [#maak-de-conceptfactuur] Haz clic en **Crear factura borrador**. Tillor usa el primer producto con la acción **Extender ocupación** (por orden alfabético de nombre) y construye las líneas por ti. Después, completa el periodo en la factura y contabilízala cuando hayas terminado. ### ¿Qué ocurre después? [#wat-gebeurt-er-daarna-2] - Hay una factura en borrador lista para el cliente, con el aviso **Hecho** y una descripción de lo que se ha creado. - Si contabilizas la factura, Tillor pone **Facturado hasta** en el momento final de la línea. - Tras el pago, Tillor actualiza **Pagado hasta**. **Facturado hasta** solo avanza si todavía era anterior a ese momento final. Si ya existe una factura en borrador que extiende esta parcela, Tillor muestra **Revise antes de continuar**. Un segundo borrador puede dar líneas duplicadas o saltarse un periodo. Abre el borrador existente con **Abrir borrador ...** o elige **Crear borrador de todos modos**. ## Pagado hasta, tipo, frecuencia de alquiler y precio [#betaald-tot-type-huurfrequentie-en-prijs] | Campo | Significado | |---|---| | **Pagado hasta** | Hasta cuándo ha pagado el cliente por adelantado. Al crear o editar eliges hoy o una fecha posterior. | | **Facturado hasta** | Hasta cuándo se ha facturado. Si lo dejas vacío, la visualización sigue a **Pagado hasta**. | | **Tipo** | Distingue el alojamiento propio del alquiler. | | **Frecuencia de alquiler** | Registra el ritmo del alquiler para el seguimiento administrativo. | | **Precio** | Por defecto sigue a la parcela, pero se puede ajustar por ocupación. | ## Escenarios habituales [#veelvoorkomende-scenarios] ### Llega un nuevo huésped [#een-nieuwe-gast-checkt-in] 1. Busca al cliente o añádelo. 2. En el perfil del cliente, crea una ocupación en la parcela. 3. Introduce la lectura inicial, o deja que Tillor tome la última lectura. 4. A partir de ahora, Tillor vincula a este cliente el consumo de los contadores de esa parcela. ### Un huésped se va [#een-gast-vertrekt] 1. En la ocupación, elige **Eliminar**. 2. Elige la fecha de salida e introduce las lecturas finales. 3. Confirma. Tillor cierra los periodos de consumo y la parcela vuelve a estar disponible. ### Un cliente se muda a otra parcela [#een-klant-verhuist-naar-een-ander-terrein] 1. Finaliza la ocupación actual con las lecturas finales de la parcela anterior. 2. Crea una nueva ocupación en la nueva parcela con las lecturas iniciales. 3. Tillor lleva por separado los periodos de consumo de cada parcela. ## ¿Problemas? [#problemen] Solo las parcelas sin una ocupación activa aparecen en la lista. Si otro cliente todavía tiene la parcela, finaliza primero esa ocupación. Si no hay nada disponible, verás **No se encontraron parcelas disponibles.** Si faltan todas las parcelas y ves **Se produjo un error al cargar las parcelas.**, recarga la página. Otro usuario se te ha adelantado y ha ocupado la parcela. Recarga la página del cliente, elige otra parcela o finaliza primero la ocupación del otro cliente. Es lo previsto. Al crear o editar, **Pagado hasta** solo acepta hoy o una fecha posterior. Primero elige en **Fecha** el día en que termina la ocupación. Después aparece un campo por contador. Si la parcela no tiene contadores, no hay ningún campo. Es un contador que envía lecturas por sí mismo. Elige una lectura existente mediante **Seleccione una lectura de contador**. Si pone **No hay lecturas de contadores disponibles**, el contador todavía no ha enviado ninguna lectura. Normalmente no existe ningún producto con la acción **Extender ocupación**. Crea uno, consulta [Productos](/producten), e inténtalo de nuevo. Si extiendes todas las ocupaciones a la vez, comprueba también que pertenecen al mismo cliente. Ya hay un borrador para esta parcela, o la parcela está facturada hasta una fecha que todavía no está pagada. Lee el aviso. Con **Crear borrador de todos modos** continúas a conciencia; con **Abrir borrador ...** compruebas antes el borrador existente. No se puede deshacer. Crea una nueva ocupación en la misma parcela. El consumo hasta la fecha de fin de la ocupación anterior se ha conservado. ## Conceptos [#begrippen] - **Ocupación**: un cliente en una parcela durante un periodo. Consulta [ocupación](/begrippen#bezetting). - **Parcela**: el lugar en sí, con los contadores que pueda tener. Consulta [parcela](/begrippen#terrein). - **Pagado hasta**: la fecha hasta la que el cliente ha pagado por adelantado. - **Facturado hasta**: la fecha hasta la que ya se ha facturado. - **Periodo de consumo**: el periodo en el que el consumo de un contador se imputa a un solo cliente. Consulta [lote de consumo](/begrippen#verbruiksbatch). - **Frecuencia de alquiler**: el ritmo del alquiler, por ejemplo anual o semestral. ## Véase también [#zie-ook] # IVA e impuestos (/es-ES/boekhouden/belasting) Aquí descubres cómo llega el IVA a tus facturas y cómo comprueba Tillor el número de IVA de un cliente. La comprobación se hace mediante VIES, el servicio europeo con el que se puede verificar un número de IVA. ## Tipos de IVA [#btw-tarieven] Los tipos de IVA se configuran por producto. Ve a **Administración > Productos** y abre un producto para elegir el **IVA %** entre los tipos disponibles (por defecto 0%, 6%, 9%, 12% y 21%). ## Inversión del sujeto pasivo y otros regímenes sin IVA [#btw-verlegd-en-andere-regimes-zonder-btw] A veces no aplicas IVA, pero no se trata de un simple tipo del 0%: el cliente debe declarar el IVA por sí mismo, o la entrega está exenta. Por eso, en la lista desplegable **IVA %** de un producto aparecen, debajo de los tipos, cinco regímenes. Si eliges uno, el producto queda al 0% y Tillor sabe el motivo. | Régimen | Cuándo | Casilla en la declaración de IVA | |--------|---------|----------------------------| | **Inversión del sujeto pasivo (servicios UE)** | Un servicio para un cliente sujeto pasivo de IVA en otro país de la UE | 44 | | **Inversión del sujeto pasivo (cocontratante)** | Obras en bienes inmuebles para un cliente belga sujeto pasivo de IVA que presenta declaraciones periódicas | 45 | | **Entrega intracomunitaria** | Mercancías que envías a un cliente sujeto pasivo de IVA en otro país de la UE | 46 | | **Exportación fuera de la UE** | Mercancías que salen de la UE | 47 | | **Exento de IVA** | Una entrega que está exenta por su naturaleza (artículo 44 del Código del IVA) | 00 | Un régimen hace cuatro cosas que un tipo normal del 0% no hace: - **En la factura** aparece `0%*` en la línea, con la mención legal del régimen debajo de los totales, por ejemplo *Inversión del sujeto pasivo: el IVA es debido por el destinatario*. Si hay dos regímenes en una factura, el segundo recibe `**`. - **Solo puedes contabilizar con un número de IVA** en los dos regímenes de inversión del sujeto pasivo y en una entrega intracomunitaria. Introduce el número en el perfil del cliente; entonces también aparece en la factura. - **A la contabilidad** pasa la línea con el código del régimen, de modo que cae en la casilla correcta de tu declaración de IVA. Consulta [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#btw-regimes). - **Por Peppol** la línea recibe la categoría de IVA del régimen. Tillor no comprueba si un cliente o una entrega tiene derecho a un régimen. Si tienes dudas, consulta a tu contable. ## Validación del número de IVA [#btw-nummer-validatie] Cuando introduces un número de IVA en el perfil del cliente, Tillor lo comprueba automáticamente mediante el servicio europeo VIES en cuanto se ha indicado el país. ### Cómo funciona [#hoe-het-werkt] 1. Abre **Clientes > cliente** (sección **Datos del cliente**) 2. Indica el **país** e introduce el número de IVA (p. ej. `NL123456789B01` o `BE0123456789`) 3. Tillor valida el número automáticamente (tras una breve pausa) 4. Con un número de IVA válido aparece una marca verde; haz clic en ella para ver los datos de la empresa en VIES 5. ¿Quieres copiar el nombre y la dirección? Haz clic en **Aplicar dirección de la empresa** en esa ventana (el nombre de la empresa pasa al campo de nombre) 6. Con un número de IVA no válido aparece un icono rojo con una explicación La validación del IVA funciona para todos los países de la UE. Para empresas de fuera de la UE puedes introducir el número de IVA manualmente, sin validación. ### Países admitidos [#ondersteunde-landen] La validación admite todos los Estados miembros de la UE, entre ellos los Países Bajos (NL), Bélgica (BE), Alemania (DE), Francia (FR) y todos los demás países de la UE. ### Código de país en el PDF de la factura [#landcode-op-de-factuur-pdf] En el PDF de la factura, Tillor completa automáticamente un código de país que falte, en los países donde esa es la forma habitual de escribirlo: si introduces `0123456789` para un cliente belga, en la factura aparece `BE0123456789`. Para España, Italia y Portugal esto no ocurre, porque allí el número fiscal nacional se escribe sin código de país (un NIF español como `B04876793` permanece, por tanto, sin cambios). Si escribes tú mismo el código de país en el campo, siempre se respeta. ## Clientes belgas y Peppol [#belgische-klanten-en-peppol] Para los clientes belgas con número de IVA, debe constar un **ID de Peppol** en la pestaña **Facturación** antes de poder contabilizar facturas. Es obligatorio por ley para la facturación B2B en Bélgica. Consulta la [documentación de Peppol](/boekhouden/peppol) para más información. ## IVA en las facturas [#btw-op-facturen] Todas las líneas de factura muestran automáticamente el tipo de IVA correcto según el producto vinculado. En la factura ves **Subtotal**, **IVA** y **Total**; en el PDF de la factura aparece además un resumen por tipo de IVA. ¿Tienes permisos para modificar los ajustes de la organización? Ve a **Ajustes > Facturación** y activa **Desplegable de tipo de IVA en líneas de factura en borrador**. En las **facturas en borrador** aparece entonces una columna para elegir el tipo por línea (las opciones siguen los tipos configurados para vuestra organización). Al seleccionar un producto, el tipo estándar del producto sigue siendo el valor inicial. En esa misma columna también eliges un [régimen sin IVA](#btw-verlegd-en-andere-regimes-zonder-btw) para una línea. ## ¿Problemas? [#problemen] Tillor no ha podido confirmar el número mediante VIES. Comprueba el país y el número. Para una empresa de fuera de la UE también puedes introducir el número sin validación. El cliente no tiene número de IVA. La inversión del sujeto pasivo y una entrega intracomunitaria solo existen para un cliente sujeto pasivo de IVA. Introduce el número en Clientes > cliente, sección **Datos del cliente**, y vuelve a contabilizar. Una factura de Peppol solo puede indicar un motivo para la ausencia de IVA. Pon las líneas de cada régimen en una factura propia. Solo puedes elegir entre los tipos permitidos, por defecto 0%, 6%, 9%, 12% y 21%. La columna con los tipos solo aparece en las facturas en borrador y únicamente si **Desplegable de tipo de IVA en líneas de factura en borrador** está activado. ## Véase también [#zie-ook] # Métodos de pago (/es-ES/boekhouden/betalingsrapporten/betaalmethodes) Los informes de pagos contienen pagos de distintas fuentes. Solo **Mollie** y las **transferencias internas** se envían a la contabilidad. | Método | En el informe de Tillor | A la contabilidad | |---------|-------------------|------------------| | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | Sí (mediante la liquidación de Mollie) | Sí | | [Cuentas bancarias](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | Sí (el día del pago) | No | | [Transferencia interna](/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) | Sí | Sí | ```mermaid flowchart LR Mollie[Mollie] --> R[Tillor-rapport] Bank[Bankrekeningen] --> R Internal[Interne overboeking] --> R R --> BH[Boekhouding] Mollie --> BH Internal --> BH ``` ## Véase también [#zie-ook] # Transferencias internas (/es-ES/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) Con **Transferencia interna** trasladas un importe pendiente de una factura a otra factura **contabilizada** del **mismo cliente**. Tillor crea un pago positivo en la factura que pagas y un pago negativo vinculado en la factura de destino. Consulta [Transferencia interna: registrar](/betalingsverwerking/interne-overboeking) para el proceso de registro paso a paso con capturas de pantalla. ## En los informes de pagos [#in-betalingsrapporten] - Las transferencias internas aparecen en el informe de pagos de Tillor del día en que las registras (Bruselas). - **Sí** pasan a la exportación contable: junto con los pagos de Mollie, y **no** junto con las cuentas bancarias ni otros métodos manuales (efectivo, transferencia, ...). - En la exportación contable, cada línea aparece como `Tillor - Interne overboeking - {factuurnummer}`, vinculada a la factura y al cliente correspondientes. ## Véase también [#zie-ook] # Mollie (/es-ES/boekhouden/betalingsrapporten/betaalmethodes/mollie) Los pagos de Mollie (iDEAL, tarjeta de crédito, Bancontact, terminal, etc.) se sincronizan en Tillor y se vinculan a los informes de pagos mediante la **liquidación de Mollie**. ## Vincular en Tillor [#koppelen-in-tillor] 1. Ve a **Ajustes > Integraciones** y elige **Mollie** en la lista. 2. Sigue los pasos de OAuth de Mollie si la vinculación aún no está activa. 3. En la página de detalle, elige en **Perfil web** un **Perfil principal** (el perfil web de Mollie para pagos y sincronización). Opcionalmente, elige un **Terminal predeterminado** (el terminal de pago que Tillor propone por defecto en las facturas). 4. Haz clic en **Guardar**. Sin perfil principal, los pagos de Mollie no funcionan en Tillor; un terminal solo es necesario para los pagos con terminal. ### Iconos de estado en las listas de selección [#statusiconen-in-de-keuzelijsten] A la izquierda del nombre del perfil y del terminal hay un icono de color. Es el estado en Mollie, no el nombre en sí. | Icono | Perfil web | Terminal | |-------|----------------|----------| | Verde (marca) | Verificado: apto para pagos reales | Activo: listo para pagos con terminal | | Naranja (reloj) | Aún no verificado en Mollie | Pendiente: todavía no activo | | Rojo (prohibido) | Bloqueado | - | | Gris | - | Inactivo | Elige preferiblemente un perfil **verificado**. Un terminal **activo** es opcional y solo es necesario si quieres que Tillor proponga pagos con terminal. Sin perfil principal, los pagos y la sincronización no funcionan. ## Liquidaciones de Mollie [#mollie-settlements] Mientras Mollie no haya abonado un pago, este figura como **anticipo** en el informe borrador abierto. Solo al finalizarlo decide la liquidación a qué informe pertenece; consulta [Pagos de Mollie en el borrador](/boekhouden/betalingsrapporten#mollie-betalingen-op-het-concept). Para el **día de informe D**, Tillor busca una liquidación en este orden: 1. Liquidación **creada el día D** 2. Si no, liquidación **creada el día D+1** (lo habitual: los ingresos de D se abonan a la mañana siguiente) ```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] ``` **Reglas establecidas:** - Cada id de liquidación figura en **como máximo un** informe de pagos. - ¿Un informe ya tiene una liquidación? Esa vinculación **se mantiene**; Tillor no la sustituye. - Si faltan tanto D como D+1 (p. ej. fin de semana): el informe puede existir ya solo con pagos manuales o de cuentas bancarias; en cuanto Mollie publique, la sincronización diaria añade Mollie. ## Ejemplos [#voorbeelden] | Día de informe D | Liquidación creada en Mollie | Resultado | |--------------|----------------------------------|-----------| | Mar 20 may | Mar 20 may (`stl_aaa`) | `PAYR/2026/0140` (20 may) recibe `stl_aaa` | | Mar 20 may | Mié 21 may temprano (`stl_bbb`) | `PAYR/2026/0140` (20 may) recibe `stl_bbb` (regla D+1) | | Dom 18 may | Lun 19 may (`stl_ccc`) | `PAYR/2026/0138` (domingo) recibe `stl_ccc`, **no** el informe del lunes | | Lun 19 may | Lun 19 may (`stl_ccc`) | El informe del lunes busca su propia liquidación (`stl_ddd` el martes o después), no `stl_ccc` | | Sáb 17 may | Ninguna liquidación sáb/dom/lun por la mañana | Informe del 17 may: primero manual/cuentas bancarias; Mollie llega cuando haya liquidación | | Mar 20 may | El informe ya existía sin liquidación | Siguiente ejecución a las 09:00: la liquidación se vincula igualmente al 20 may, pagos vinculados | **Caso concreto (D+1):** los ingresos del **martes 20 de mayo** están en la liquidación `stl_6necch`, creada el **miércoles 21 de mayo** a las 06:08. Tillor vincula `stl_6necch` a **`PAYR/2026/0140` (día de informe 20 de mayo)**, no al informe del 21 de mayo. **Informe existente:** ¿ya figuraba `PAYR/2026/0140` en Tillor sin liquidación de Mollie vinculada y con dos líneas manuales? Tras la sincronización se vincula igualmente `stl_6necch`; las líneas existentes se conservan; los pagos de Mollie de esa liquidación se añaden. **Ya vinculado:** el informe del **15 de mayo** ya tiene `stl_old`. Tillor **no** modifica ese id. Los pagos de Mollie sueltos con el mismo id de liquidación van igualmente al informe que ya tiene esa liquidación. ## Sincronización en informes existentes [#synchronisatie-op-bestaande-rapporten] Tras crear los informes que faltan, Tillor busca **solo informes sin liquidación de Mollie vinculada** en una ventana móvil de **un mes natural antes de ayer** hasta ayer. Los informes que ya tienen una liquidación de Mollie **no** se vuelven a recuperar de la lista de liquidaciones de 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] ``` Los pagos que ya tienen un id de liquidación de Mollie, pero aún no figuran en un informe, van al informe con el mismo id de liquidación. ## Pagos de Mollie en Tillor [#mollie-betalingen-in-tillor] Tillor recupera los pagos de Mollie **cada 15 minutos** (por organización con vinculación activa de Mollie). Además, los webhooks de Mollie funcionan al instante: un pago pasa enseguida a **Pagado**, **Reembolsado** o **Contracargo**, incluso si se originó fuera de Tillor (por ejemplo, un terminal de pago). Si dudas o se perdió un webhook: **Sincronizar** en el menú de acciones del pago. Un pago aparece en un informe si: - figura en la **liquidación** vinculada (lista de Mollie), o - el pago ya tiene un id de liquidación que pertenece al informe. | Tipo en el informe | Significado | |-----------------|-----------| | Conocido | Pago vinculado a una factura en Tillor | | Desconocido | Sin vinculación a factura en Tillor → cuenta de espera 499000, salvo que envíes datos contables a través de Mollie | Los pagos de la liquidación que **no** existen en Tillor aparecen como pago de Mollie desconocido en el informe. En un informe de pagos ves los pagos de Mollie vinculados en la tabla **Pagos**: ## Metadatos de Mollie [#mollie-metadata] ¿Tienes una caja registradora u otro sistema que crea por sí mismo pagos de Mollie? Puedes dirigir a Tillor mediante metadatos en ese pago: vinculación a una factura o a un [grupo de pago](/betalingsverwerking/groepen), o directamente a la contabilidad. Los campos están en [Metadatos de Mollie](/ontwikkelaars/mollie-metadata). ## Véase también [#zie-ook] # Cuentas bancarias (/es-ES/boekhouden/betalingsrapporten/betaalmethodes/ponto) La vinculación bancaria se conecta mediante open banking con tu cuenta bancaria y recupera las transacciones automáticamente. ## Cómo funciona [#hoe-het-werkt] 1. **Transacciones**: cada 5 minutos, Tillor recupera transacciones bancarias de tu banco 2. **Comunicación estructurada**: se lee +++123/4567/89002+++ o el número de factura (INV/2024/0001) 3. **Vinculación**: Tillor busca una factura que coincida → se crea el pago y se vincula 4. **Transferencia manual duplicada**: si ya hay una transferencia manual en la misma factura con el mismo importe, se elimina para que el pago no cuente dos veces 5. En Tillor ves ese pago como **transferencia bancaria** ## Vincular [#koppelen] La integración se llama **Cuentas bancarias** y está en Ajustes > Integraciones > Cuentas bancarias. Rellenas un **ID de cliente** y un **Secreto de cliente**; un administrador de Tillor te ayuda con la configuración y acompaña la incorporación. ## Consultar transacciones bancarias [#banktransacties-bekijken] Las transacciones bancarias importadas están en **Administración > Transacciones bancarias**. Esa página solo es visible para usuarios con el permiso **Ver transacciones bancarias**. Sin ese permiso no ves la página en el menú. En la tabla **Transacciones**, la columna **Factura** está entre **Fecha valor** y **Concepto**: - ¿La transacción ya está en una factura? Entonces ves el número de factura como enlace (p. ej. `INV/2026/0001`). - ¿Todavía sin vinculación? Abre el menú de acciones (tres puntos) al final de la fila y elige **Asignar a factura**. Si hace falta, Tillor crea primero un pago y lo vincula a la transacción. Para ello necesitas el permiso **Asignar pago**; sin ese permiso no ves esta acción en el menú. - ¿La transacción ya está en una factura? Abre el mismo menú de acciones y elige **Desasignar de factura** para eliminar la vinculación (tanto manual como emparejada automáticamente). Haz clic en el icono (i) junto al IBAN para abrir el panel de detalle de esa transacción: importe, fecha valor, contraparte e IBAN, concepto, los datos del extracto de cuenta (referencia bancaria, referencia del ordenante, número de tarjeta, ...), la factura, el pago y el informe de pagos vinculados, y las referencias. El menú de acciones también está en la parte superior de ese panel. En el menú de acciones eliges además: - **Crear tarea** para asociar una tarea a la transacción, por ejemplo para procesar un pago manualmente. La tarea muestra la transacción como elemento vinculado; haz clic en ella para abrir el panel de detalle. Consulta [Elementos vinculados](/taken/taakdetails#gekoppelde-items). - **Copiar enlace** para obtener un enlace que abre la página **Transacciones bancarias** con el panel de detalle de esa transacción, por ejemplo para pegarlo en un comentario o en un mensaje. Ves la misma columna **Factura** en un **informe de pagos** en la tabla **Transacciones de cuenta bancaria**, siempre que tengas el permiso de lectura. ## Desvincular [#ontkoppelen] En **Administración > Transacciones bancarias** (y en un informe de pagos en **Transacciones de cuenta bancaria**) abres el menú de acciones de una fila vinculada y eliges **Desasignar de factura**. Funciona tanto para transacciones vinculadas manualmente como emparejadas automáticamente. En **Administración > Pagos**, **Desvincular de la factura** solo aparece en los pagos que tú mismo has vinculado o movido a una factura. Así evitas eliminar por accidente una vinculación automática correcta desde el resumen de pagos. ## Sincronizar manualmente [#handmatig-synchroniseren] En **Administración > Transacciones bancarias** y en un **informe de pagos** (tabla **Transacciones de cuenta bancaria**) está el botón **Sincronizar cuenta bancaria** si la vinculación bancaria está instalada y además tienes el permiso **Sincronizar transacciones bancarias**. Con él solicitas una sincronización bancaria nueva; después, Tillor importa nuevas transacciones e intenta vincularlas a facturas. Sin vinculación bancaria o sin ese permiso, el botón no aparece. Tillor también importa nuevas transacciones automáticamente, cada 5 minutos. Ambos permisos se configuran en **Ajustes > Permisos de usuario** (grupo **Transacciones bancarias**). ## En los informes de pagos [#in-betalingsrapporten] Las transferencias bancarias **sí** aparecen en el informe de pagos de Tillor de la fecha de pago (Bruselas), junto con los pagos manuales de ese día. **No** pasan a la exportación contable: solo Mollie y las transferencias internas. La vinculación bancaria está pensada sobre todo para la vinculación automática a facturas en Tillor. El cliente transfiere con comunicación estructurada → Tillor lo recupera de tu banco → la factura se empareja → pago + factura pagada. ## Véase también [#zie-ook] # Admisol (/es-ES/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) Admisol es un paquete contable que Tillor admite para enviar informes de pagos. Los informes de pagos se convierten a XML de Admisol y se envían a Admisol automática o manualmente. ## Instalación [#installatie] 1. Ve a **Ajustes** (marca **1** en la captura) y elige **Integraciones**. 2. Busca **Admisol** en la lista de integraciones (marca **2**) y abre la página de detalle. 3. En la página de detalle, rellena tu **ID de empresa** y tu **Clave del servicio web** (datos de Admisol) y haz clic en **Instalar**. ## Envío automático [#automatisch-versturen] Cuando un informe de pagos **cambia en su contenido** (por ejemplo, tras vincular pagos o tras **Recalcular informe**): 1. Tillor comprueba si Admisol está instalado para la organización 2. El informe se convierte a XML de Admisol 3. El XML se envía a Admisol En la **creación diaria** (09:00), Tillor recorre los días que faltan **de más antiguo a más reciente**. Cada informe nuevo solo se envía a Admisol cuando el informe anterior ha recibido una respuesta (aceptación o rechazo). Si el envío falla, Tillor se detiene para esa organización hasta la siguiente ejecución. El [informe borrador](/boekhouden/betalingsrapporten#concept-en-definitief) del día en curso ya se envía a Admisol en cuanto contiene un pago de Mollie o una transferencia interna, y después solo se vuelve a enviar cuando cambia el asiento. Los pagos en efectivo en el borrador no provocan un envío. Los pagos de Mollie en un borrador se contabilizan en contrapartida con el proveedor Mollie **sin referencia de documento**; Admisol lo contabiliza como **anticipo** ("pendiente de cobrar"). Los reembolsos que Mollie todavía no ha retenido figuran como una segunda línea de anticipo aparte en Mollie ("pendiente de retener"). En el envío definitivo, el pago real con costes bancarios ocupa su lugar, y los pagos que no estaban en la liquidación pasan como anticipo al siguiente borrador. Mientras el informe es borrador, en Admisol la referencia del documento figura como `PAYR/2026/0275 - Concept`; ese añadido desaparece en el envío definitivo. Si el informe pasa a definitivo el siguiente día laborable, Tillor lo vuelve a enviar, ahora con la liquidación de Mollie, bajo **el mismo número de documento y la misma fecha contable**. Si un envío automático falla, recibes un aviso y aparece una línea en la cronología de eventos del informe. ## Envío manual [#handmatig-versturen] 1. Ve a **Administración > Informes de pago** 2. Abre el informe que quieres enviar 3. Haz clic en **"Enviar a contabilidad"** ## ¿Qué pagos se envían? [#welke-betalingen-gaan-mee] Solo los pagos con: - **Mollie** como proveedor, o - **Transferencia interna** como método de pago Los pagos de cuentas bancarias no se envían a la contabilidad. ## Reembolso parcial (Mollie) [#gedeeltelijke-terugbetaling-mollie] Si un pago de Mollie vinculado se ha reembolsado en parte o por completo, Tillor envía el **importe original del pago** en el informe de pagos de la **liquidación de Mollie en la que entró el pago**. El **reembolso** aparece como línea negativa en el informe de la **liquidación en la que Mollie descuenta el reembolso** (etiqueta *Terugbetaling*). Pueden ser liquidaciones posteriores; varios reembolsos tienen cada uno su propia línea en el informe de su liquidación. Así, el informe coincide con lo que Mollie abona realmente. Al contabilizar los reembolsos solo en ese día de liquidación, no corresponde ninguna línea adicional a la cuenta de espera **499000** (*restant saldo*). ## Costes bancarios por factura de Mollie [#bankkosten-per-mollie-factuur] Mollie retiene sus costes en cada pago y los factura una vez al mes. Por eso, Tillor contabiliza los costes retenidos **por periodo de factura**: cada línea lleva el mes por el que Mollie factura los costes, por ejemplo *Bankkosten 01/2026*. Un pago en los primeros días del mes suele incluir todavía costes del mes anterior; estos figuran entonces como línea aparte en el mismo informe. Todas las líneas del mismo periodo suman el importe de la factura de Mollie de ese mes. Las líneas del mes en curso permanecen abiertas hasta que Mollie emite la factura. ### En el proveedor Mollie [#op-de-leverancier-mollie] Los costes retenidos no son un segundo gasto: Mollie paga con ellos su propia factura. Por eso, Tillor los contabiliza en el **proveedor Mollie**, sin referencia de documento. El gasto y el IVA solo entran a través de la factura de compra de Mollie. Cada mes, en el proveedor Mollie, casas la factura con las líneas *Bankkosten* de ese periodo; juntas tienen el mismo importe. No hace falta una corrección mediante una operación diversa. Mollie suele retener los costes de un pago ya en el momento en que el pago entra, aunque el abono llegue más tarde. Por eso, un informe borrador ya contabiliza esos costes por periodo de factura, y el anticipo en Mollie es el importe después de costes. Un pago con tarjeta que Mollie todavía retiene no tiene aún costes retenidos: esos costes solo llegan al informe con el abono. Hasta entonces, el mes en el proveedor Mollie no está completo. En Admisol, **no casees líneas de un informe borrador** (la referencia del documento termina en *- Concept*). En el envío definitivo, Admisol sustituye las líneas del informe, y los casamientos en esas líneas pueden desaparecer. Esto también puede ocurrir cuando vuelves a enviar un informe definitivo, incluso si no ha cambiado nada: comprueba después los casamientos en el proveedor Mollie. ## Reserva de saldo [#balansreserve] A veces Mollie retiene una parte del abono como **reserva de saldo**: dinero que todavía se te debe, pero que Mollie retiene temporalmente. Como no es un coste ni un reembolso, Tillor contabiliza ese importe en el **proveedor Mollie** con la etiqueta *Balansreserve*, igual que el propio abono. Así permanece como saldo a favor pendiente en Mollie en lugar de en la cuenta de espera. Si Mollie libera la reserva más adelante, en el informe de esa liquidación aparece una línea *Balansreserve* de signo contrario que vuelve a cancelar el saldo. No tienes que hacer nada; en el proveedor Mollie, las dos líneas se anulan entre sí. ## Facturas ya casadas en Admisol [#facturen-die-in-admisol-al-afgepunt-zijn] Admisol rechaza una línea en una factura o nota de crédito que hayas casado manualmente en Admisol con un asiento distinto del informe de pagos. Tillor contabiliza entonces las líneas de esa factura en el cliente **sin referencia de documento**, para que el informe siga adelante. Los importes y el cliente no cambian; solo el vínculo con la factura lo vuelves a casar tú mismo en Admisol. En la cronología de eventos del informe, el XML enviado indica de qué factura se trata. ## Parámetros contables [#boekhoudparameters] Tras la instalación, configuras los parámetros contables mediante **Ajustes** en la aplicación de Admisol (la misma pantalla que ID de empresa y Clave del servicio web). Contienen, entre otros, los tipos de documento para facturas y liquidaciones, el código de proveedor de Mollie, la cuenta del libro mayor por defecto para las líneas de factura y el departamento por defecto. Los campos que faltan reciben los valores por defecto de Tillor. Los pagos de Mollie desconocidos se contabilizan en la cuenta de espera **499000**. Por pago, también puedes indicar departamento y ejercicio mediante [metadatos de Mollie](/ontwikkelaars/mollie-metadata#directe-boekhoudmetadata-tillorbookkeeping). ### Regímenes de IVA [#btw-regimes] Una línea de factura con un [régimen sin IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) va a Admisol con un **perfil de dirección fiscal** y un **código fiscal** propios. Juntos determinan en qué casilla de la declaración de IVA entra la línea. Los valores por defecto son los de un expediente nuevo de Admisol: | Régimen | Perfil de dirección fiscal | Código fiscal | Casilla | |--------|------------------|----------|---------| | Inversión del sujeto pasivo (servicios UE) | `EU` | `vd21` | 44 | | Inversión del sujeto pasivo (cocontratante) | `MED` | `v21` | 45 | | Entrega intracomunitaria | `EU` | `v21` | 46 | | Exportación fuera de la UE | `EXP` | `v21` | 47 | | Exento de IVA | `NA` | `v0` | 00 | Si tu expediente usa otros códigos, ajústalos en los parámetros contables: por régimen hay un campo para el perfil de dirección fiscal y otro para el código fiscal. Encuentras los códigos de tu expediente en Admisol en **Instellingen > BTW-instellingen > Tax-relaties**. La ficha del cliente en Admisol conserva su propio perfil de dirección fiscal; solo la línea de factura recibe el del régimen. ## Véase también [#zie-ook] # Exact Online (/es-ES/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) Exact Online es el paquete contable que usan muchos parques neerlandeses y sus oficinas. Tillor vincula **clientes**, **facturas contabilizadas** e **informes de pagos** con Exact Online. La vinculación está **disponible bajo petición**, todavía no como autoservicio en el App Marketplace. ¿Quieres vincular Tillor con Exact Online? Solicita la activación mediante la [demo](https://tillor.eu/demo) o escribe a **support@tillor.eu**. Configuramos la vinculación junto con vuestro contable. ## Qué cubre la vinculación [#wat-de-koppeling-dekt] La exportación prevista sigue la misma cadena que [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) y [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo). El mapeo exacto de diarios y cuentas de ingresos lo acordamos en la activación. - **Clientes** de Tillor a Exact Online - **Facturas contabilizadas** (líneas e IVA) - **Informes de pagos**: solo **Mollie** y **transferencias internas**, como en las demás exportaciones contables Los pagos de cuentas bancarias sí aparecen en el informe de Tillor, pero no pasan a la exportación contable. Consulta [sistemas de contabilidad](/boekhouden/betalingsrapporten/boekhoudsystemen). ## Todavía sin autoservicio [#nog-geen-zelfbediening] Todavía no encuentras Exact Online en **Ajustes > Integraciones**. La elección de administración, el mapeo del libro mayor y la primera exportación se hacen junto con el soporte de Tillor. No hay un formulario de instalación que rellenar por tu cuenta. Tillor exporta a un solo paquete contable por organización. Si ya usas Admisol u Odoo, acordamos qué sistema sigue activo. ## Solicitar [#aanvragen] 1. Anota tu administración de Exact Online (división) y si tu contable colabora. 2. Solicita la vinculación mediante [tillor.eu/demo](https://tillor.eu/demo) o **support@tillor.eu**. 3. Tillor planifica la activación y el mapeo de diarios y cuentas de ingresos. ## Véase también [#zie-ook] # Resumen (/es-ES/boekhouden/betalingsrapporten/boekhoudsystemen) Tillor admite la integración con software de contabilidad para enviar informes de pagos. Los informes de pagos se convierten al formato de tu paquete contable (actualmente Admisol) y se envían automática o manualmente. [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) está disponible bajo petición. ## Sistemas admitidos [#ondersteunde-systemen] | Sistema | Estado | |---------|--------| | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | Admitido | | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | Clientes y facturas contabilizadas | | [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) | Bajo petición | ## General [#algemeen] - **Automático**: al crearse o en una actualización relevante de un informe de pagos, se envía a Admisol (solo si Admisol está instalado) - **Manual**: mediante **Administración > Informes de pago** → abrir informe → **Enviar a contabilidad** - **Qué pagos**: solo **Mollie** y **transferencias internas**. Las cuentas bancarias sí aparecen en el informe de Tillor, pero no pasan a la exportación contable. ## Véase también [#zie-ook] # Odoo (/es-ES/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) La integración con Odoo exporta desde Tillor los **clientes** y las **facturas contabilizadas** a Odoo. Los informes de pago hacia Odoo llegarán en una versión posterior; hasta entonces, utilice [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) si desea enviar los informes de pago automáticamente. ## Instalación [#installatie] 1. Vaya a **Ajustes** y abra el App Marketplace. 2. Busque la tarjeta **Odoo** y haga clic en **Instalar**. 3. Rellene primero los datos de **Conexión**: - **URL de Odoo** - por ejemplo `https://miempresa.odoo.com` o solo `miempresa` (Tillor completa entonces la URL `.odoo.com`) - **Nombre de usuario** - usuario con acceso a la API - **Clave API** - clave API (Odoo: perfil de usuario > Claves API) 4. Haga clic en **Continuar a la base de datos**. Tillor obtiene las bases de datos disponibles (o le permite introducir el nombre manualmente). 5. Elija la base de datos en **Base de datos** y complete la instalación. Al guardar, Tillor comprueba la conexión. Si Admisol y Odoo están instalados a la vez, Tillor utiliza **Admisol** para la exportación (prioridad fija). Instale Odoo solo si ya no utiliza Admisol. ## Parámetros contables (aplicación Odoo) [#boekhoudparameters-odoo-app] Tras la instalación, defina los parámetros de exportación en **Ajustes** de la aplicación Odoo (además de la URL, la base de datos, el usuario y la clave API). Tillor obtiene en directo desde Odoo los diarios de ventas y las cuentas de ingresos; usted los elige mediante un campo de búsqueda (código y nombre). | Campo en la aplicación | Valor predeterminado | Significado | |---|---|---| | **Código del diario de ventas** | INV | Diario de ventas en Odoo con este código | | **Cuenta de ingresos predeterminada** | 700000 | Cuenta de ingresos que se usa cuando la línea de factura no tiene número de cuenta contable propio | | **Contabilizar facturas automáticamente** | desactivado | Contabilizar en Odoo inmediatamente después de exportar | | **Adjuntar PDF de factura** | activado | PDF de la factura de Tillor como adjunto de la factura de Odoo | | **Adjuntar UBL Peppol** | activado | UBL de Peppol como adjunto adicional (solo si Tillor ya dispone de ese UBL) | Para cada línea de factura, Tillor busca primero una cuenta de Odoo con el mismo código que el **número de cuenta contable** de la línea; si no la encuentra, usa la cuenta de ingresos predeterminada. Para el IVA, Tillor busca en Odoo un IVA de ventas con el mismo porcentaje que el de la línea. ### Regímenes de IVA [#btw-regimes] Una línea de factura con un [régimen sin IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), como la inversión del sujeto pasivo, necesita en Odoo su propio IVA de ventas: un 0% normal acaba en la casilla equivocada de su declaración. Por eso, en los ajustes de exportación, introduzca para cada régimen que utilice el **nombre del IVA de ventas en Odoo**, exactamente como aparece en Odoo en **Contabilidad > Configuración > Impuestos** (en un Odoo belga, por ejemplo, `0% EU S` para servicios de la UE). Hay cinco campos: inversión del sujeto pasivo (servicios de la UE), inversión del sujeto pasivo (cocontratante), entrega intracomunitaria, exportación fuera de la UE y exento de IVA. Si el campo de un régimen está vacío o el IVA no existe en Odoo, la exportación de esa factura se detiene con un mensaje de error. Introduzca el nombre y vuelva a enviar la factura. ## PDF de la factura en Odoo [#factuur-pdf-in-odoo] Con **Adjuntar PDF de factura** (activado de forma predeterminada), Tillor sube el mismo PDF que ve en Tillor. En una exportación nueva esto ocurre **antes** de contabilizar en Odoo, de modo que la vista previa a la derecha de la factura pueda enlazarse. El nombre de archivo sigue el número de factura de Tillor (p. ej. `INV_2026_0001.pdf`). Tillor también establece ese PDF como adjunto principal de la factura de Odoo. En los **Eventos** de la factura de Tillor se ve si la exportación se ha realizado correctamente, incluidos el cliente, la factura, el PDF y el UBL. - Si la factura de Odoo ya existe (misma referencia: el número de factura de Tillor), Tillor actualiza el cliente, las líneas, las fechas y la referencia de pago. Si la factura ya estaba contabilizada en Odoo, Tillor la devuelve primero a borrador, modifica los datos y vuelve a contabilizar cuando **Contabilizar facturas automáticamente** está activado o la factura ya estaba contabilizada. - Después se sustituyen o añaden los adjuntos PDF y UBL cuando esas opciones están activadas. - Si la subida falla tras crear una factura en borrador nueva, esa factura de Odoo se elimina para que una exportación posterior pueda volver a intentarlo. ## UBL de Peppol en Odoo [#peppol-ubl-in-odoo] Con **Adjuntar UBL Peppol** (activado de forma predeterminada), Tillor sube el UBL de Peppol como adjunto adicional de la factura de Odoo. El nombre de archivo sigue el número de factura de Tillor (p. ej. `INV_2026_0001.xml`). - Tillor no genera el UBL por sí mismo: el archivo solo está disponible tras una entrega correcta por Peppol. - Si el UBL aún no está listo en el momento de la exportación, Tillor omite el adjunto UBL; en cuanto llega el UBL, se añade igualmente a la factura de Odoo existente. - Si falla la subida del UBL, la exportación completa a Odoo **no** falla (a diferencia del PDF). Solo un error de PDF tras una factura nueva revierte el borrador de Odoo. ## Facturas [#facturen] - Al **contabilizar** o **recontabilizar** una factura, Tillor la exporta automáticamente a Odoo. - Manualmente: acciones de la factura > exportar a contabilidad (el mismo botón que con Admisol). - Solo se exportan las facturas con el estado **Contabilizada**. - Si ya existe una factura de Odoo con el mismo número de factura de Tillor, no se crea una segunda factura. Tillor actualiza el cliente, las líneas y las fechas de esa factura (por ejemplo, tras moverla a otro cliente o recontabilizarla) y sustituye los adjuntos PDF/UBL cuando esas opciones están activadas. - Si el PDF de la factura cambia tras un **pago** (u otro importe en el documento), Tillor sustituye el adjunto PDF existente en Odoo en cuanto el nuevo PDF está listo. No se crea una segunda factura de Odoo ni se contabiliza ningún pago en Odoo. ## Clientes [#klanten] Los clientes se actualizan o se crean en Odoo con el número de cliente de Tillor como referencia. Los contactos existentes con el mismo número se actualizan. ## Informes de pago [#betalingsrapporten] El envío automático y manual de informes de pago a Odoo **todavía no está disponible**. El proceso diario de informes de pago omite Odoo sin mostrar ningún mensaje de error. ## Requisitos en Odoo [#vereisten-in-odoo] - Diario de ventas con el código configurado (por defecto `INV`) - Cuentas contables con códigos que coincidan con las líneas de Tillor o con la cuenta de ingresos predeterminada - Opcional: tipos de IVA de ventas en Odoo con los mismos porcentajes que en Tillor ## Véase también [#zie-ook] # Resumen (/es-ES/boekhouden/betalingsrapporten) Un **informe de pago** es un resumen diario de los pagos de un solo día natural. Numeración: `PAYR/YYYY/DDDD` (día del año, cuatro cifras; p. ej. `PAYR/2026/0054`). **Contenido:** pagos conocidos y desconocidos, la liquidación de Mollie (si procede) y las transacciones bancarias sin vincular de sus cuentas bancarias. Una liquidación de Mollie (settlement) es el importe que Mollie ingresa en su cuenta bancaria por una serie de pagos. Su contable trabaja con estos informes. Usted no tiene que crearlos ni cerrarlos. Véase también [¿Cómo encaja todo?](/boekhouden#hoe-hangt-dit-samen). ## Borrador y definitivo [#concept-en-definitief] Un informe tiene un **estado**: | Estado | Significado | |--------|-------------| | **Borrador** | El informe del **día en curso**. Los pagos de hoy (transferencias internas, efectivo, cuentas bancarias y Mollie) ya se vinculan a él y el informe ya va a la contabilidad. Los pagos de Mollie figuran como **anticipo**: dinero que Mollie aún debe liquidar. Todavía no hay liquidación de Mollie y el informe aún no se imprime automáticamente. | | **Definitivo** | El día está cerrado. Tillor ha vinculado la liquidación de Mollie (si procede), ha impreso el informe y ha enviado la versión definitiva a la contabilidad. | El informe en borrador de hoy se crea automáticamente: con la ejecución de las 09:00, o antes, en cuanto registre el primer pago manual o pago de cuenta bancaria de ese día. Usted nunca tiene que finalizar un borrador; Tillor lo hace en la siguiente ejecución diaria una vez que el día ha terminado. Un borrador se reconoce por el **número de informe gris subrayado con puntos** y la insignia **Borrador**, en la lista (columna y filtro **Estado**), en la página de detalle y en cualquier lugar donde se enlace al informe. El PDF de un borrador lleva **(borrador)** en el título. El número de informe y la fecha contable en la contabilidad siguen siendo los mismos cuando el borrador pasa a definitivo. ### Pagos de Mollie en el borrador [#mollie-betalingen-op-het-concept] Cada pago de Mollie ya cobrado que Mollie aún no ha liquidado entra enseguida en el informe en borrador abierto. En la contabilidad, el total figura como **anticipo al proveedor Mollie**: así ve en todo momento cuánto le debe aún Mollie. Una **domiciliación SEPA en curso** cuenta del mismo modo, incluso cuando el cobro no salga hacia Mollie hasta dentro de unos días. La factura ya figura en Tillor como pagada (en trámite) y así consta también en la contabilidad. Si el cobro falla o se cancela, el pago desaparece del borrador. Cuando el borrador pasa a definitivo, Tillor compara el informe con la liquidación de Mollie: - Los pagos que **están en la liquidación** se quedan en el informe. El anticipo se sustituye por el pago real, con las comisiones bancarias. - Los pagos que **no están** (por ejemplo, tarjeta de crédito con liquidación posterior, o ingresos posteriores al cierre de Mollie) pasan al **siguiente informe en borrador** y permanecen allí como anticipo. - Si un pago de la liquidación ya estaba en un borrador posterior, Tillor lo devuelve al informe de la liquidación. Solo se tienen en cuenta los pagos recientes: cobrados en el último mes y todavía sin liquidación en Mollie. Los **reembolsos** cuentan de inmediato. Un reembolso que Mollie aún no ha descontado de una liquidación figura como línea negativa en el borrador abierto. En la contabilidad siguen siendo dos anticipos distintos a Mollie: uno para los pagos pendientes de cobro y otro para los reembolsos que aún se descontarán; no se compensan entre sí. Esto también se aplica cuando el pago original ya está en un informe definitivo anterior: Mollie descuenta entonces el importe de una liquidación posterior. En cuanto una liquidación compensa el reembolso, este pasa al informe de esa liquidación y desaparece del borrador. Un borrador va a la contabilidad en cuanto contiene algo que la contabilidad registra (un pago de Mollie o una transferencia interna). Después, Tillor solo lo reenvía si el asiento cambia, siempre con el mismo número de documento. Los cambios se agrupan: el envío sale unos diez segundos después del último cambio y, como máximo, al cabo de un minuto, de modo que, por ejemplo, asignar un pago a una factura genere un solo envío. Por tanto, un borrador con solo pagos en efectivo o pagos de cuenta bancaria no se envía, y un pago en efectivo adicional no provoca un nuevo envío. ## Generación diaria [#dagelijkse-generatie] Cada **día laborable a las 09:00** (de lunes a sábado, zona horaria Europa/Bruselas), Tillor procesa todos los informes del **1 de enero hasta ayer** que aún faltan o siguen en **borrador**, **de más antiguo a más reciente**: los borradores se finalizan y los días que faltan se crean directamente como informe definitivo. Por cada informe, Tillor espera la respuesta de Admisol (éxito o error) antes de procesar y enviar el siguiente informe. Después, Tillor abre el **informe en borrador de hoy**. Para cada organización con una conexión activa de Mollie sigue una sincronización **limitada**: informes **sin** liquidación de Mollie desde **un mes natural antes de ayer** hasta ayer (véase [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)). ```mermaid flowchart TD start[Inicio día laborable 09:00] --> create[Finalizar borradores hasta ayer
crear los días que faltan] create --> manual[Vincular pagos manuales y de cuenta bancaria
al día del informe] manual --> rollover[Pagos de Mollie no liquidados
al siguiente borrador] rollover --> concept[Abrir el informe en borrador de hoy] concept --> mollieCheck{¿Mollie activo?} mollieCheck -- no --> done[Listo] mollieCheck -- sí --> sync[Actualizar informes sin liquidación
del último mes] sync --> done ``` ### ¿Qué contiene un informe? [#wat-zit-in-een-rapport] | Origen | Cuándo se vincula | |------|-------------------| | Pagos manuales | Día natural de la fecha de creación (Bruselas) | | Pagos de cuenta bancaria | Día natural de la fecha de pago (Bruselas) | | Mollie | Liquidación para el día de informe D (véase [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)) | Los pagos de cuenta bancaria **sí** figuran en el informe de Tillor de ese día, pero **no** pasan a la exportación contable (solo Mollie y las transferencias internas). ### Ayer sin liquidación de Mollie [#gisteren-zonder-mollie-settlement] ¿El informe de **ayer** todavía debe finalizarse (o crearse) y Mollie aún no tiene liquidación de ayer ni de hoy? Entonces Tillor **espera** al siguiente día laborable; mientras tanto, el informe sigue en **borrador**. Los días más antiguos sin liquidación sí reciben un informe (manual/cuentas bancarias); Mollie se vincula más tarde con la sincronización. Los ingresos del sábado y del domingo suelen recibir su liquidación de Mollie el lunes por la mañana. Esta pertenece al informe del **domingo** (regla D+1), no al del lunes. Véanse los [ejemplos en la página de Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden). ## Ejemplos [#voorbeelden] | Situación | Qué ve | |-----------|--------| | Día laborable, liquidación a la mañana siguiente | El informe de **ayer** recibe Mollie después (regla D+1) | | Transferencia interna registrada hoy | Figura enseguida en el **informe en borrador de hoy** y pasa a la contabilidad | | Pago de Mollie recibido hoy | Figura enseguida en el borrador, en la contabilidad como anticipo a Mollie | | Pago de Mollie que no está en la liquidación del informe | Al finalizar, pasa al siguiente borrador | | Informe de ayer aún en borrador, sin liquidación | Tillor **espera** a que Mollie publique (siguiente día laborable a las 09:00); el informe sigue en borrador | | El informe existía sin Mollie | La siguiente ejecución de las 09:00 añade liquidación y pagos | | El informe ya tenía un id de liquidación | El id **se mantiene**; solo se pueden vincular pagos adicionales | Más ejemplos de fechas (fin de semana, liquidación doble): [Mollie > Ejemplos](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden). ## Abrir un informe de pago y navegar [#betalingsrapport-openen-en-navigeren] 1. Vaya a **Administración > Informes de pago** (marca verde **1** en la captura). 2. Abra un informe de la lista. 3. En la página de detalle, utilice las flechas de la barra de acciones, a la derecha, para ir al informe anterior o siguiente. Al pasar el cursor sobre una flecha verá información adicional (número de informe, fecha y número de pagos) del informe al que va a navegar. A la derecha de la página de detalle está el **Registro de eventos**. Allí ve cuándo se creó el informe, cuándo pasó a definitivo y si se envió a la contabilidad. ## ¿Problemas? [#problemen] Mollie aún no ha publicado una liquidación de ayer. Tillor espera entonces al siguiente día laborable a las 09:00. El informe pasa a definitivo por sí solo; usted no tiene que hacer nada. Un pago entra en el informe del día en que se recibió. En efectivo y transferencia, es la **Fecha de recepción** que usted indicó. Ajuste esa fecha al registrar el pago, véase [Efectivo y transferencia](/betalingsverwerking/contant). El pago no estaba en la liquidación del informe. Pasa al siguiente borrador y permanece allí como anticipo hasta que Mollie lo liquide. Solo pasan los pagos de Mollie y las transferencias internas. Un informe con solo pagos en efectivo o pagos de cuenta bancaria no se envía. Un error al enviar lo encontrará en el **Registro de eventos** del informe. ## Véase también [#zie-ook] ## Conceptos [#begrippen] - **Informe de pago**: el resumen diario de pagos de un solo día natural, con número `PAYR/año/día`. - **Borrador**: el informe del día en curso. Todavía puede cambiar. - **Definitivo**: el día está cerrado y el informe se ha enviado a la contabilidad. - **Anticipo**: un pago de Mollie que Mollie aún no ha liquidado. - **Liquidación (settlement)**: el pago que Mollie le hace a usted. # Resumen (/es-ES/boekhouden) Aquí traslada los pagos y las facturas de Tillor a su software de contabilidad. Tillor agrupa los pagos por día en un informe de pago y lo reenvía, de modo que su contable no tenga que reescribir nada. - Se genera un informe de pago por día natural. El informe de hoy ya existe como **Borrador** y pasa a definitivo en cuanto termina el día. - Tillor procesa los informes cada día laborable (de lunes a sábado) a las 09:00, hora belga. - Solo los pagos de Mollie y las transferencias internas van a la contabilidad. El efectivo, las transferencias y las cuentas bancarias figuran en el informe, pero no se reenvían. - Los pagos de Mollie se actualizan cada 15 minutos y las cuentas bancarias cada 5 minutos. - Mollie suele liquidar al día siguiente. El fin de semana suele recibir su liquidación el lunes por la mañana. - Tillor agrupa los cambios en un borrador y lo envía unos diez segundos después del último cambio y, como máximo, al cabo de un minuto. - Un cliente belga con número de IVA necesita un ID de Peppol antes de que pueda contabilizar una factura. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] ```mermaid flowchart LR F[Factura contabilizada] --> B[Pago] B --> R[Informe de pago del día] R -- Mollie y transferencias internas --> X[Software de contabilidad] R -- Cuentas bancarias y efectivo --> O[Solo resumen en Tillor] ``` - Un pago pertenece a una factura. Véase [Facturas](/facturen). - Cada pago entra en el informe del día en que se recibió. - Un pago de Mollie figura primero como anticipo en el informe en borrador. En cuanto Mollie liquida, ese anticipo pasa a ser el pago real. - El informe va a su software de contabilidad. Qué sistemas son posibles, se lo explicamos en [Sistemas de contabilidad](/boekhouden/betalingsrapporten/boekhoudsystemen). ## ¿Qué hace? [#wat-doet-het] - **Informes de pago**: resúmenes diarios con el número `PAYR/YYYY/DDDD`, donde DDDD es el día del año - **Sistemas de contabilidad**: conexión con Admisol, Odoo para clientes y facturas (los informes de pago hacia Odoo llegarán más adelante) y [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) bajo petición - **Métodos de pago**: Mollie, cuentas bancarias y transferencias internas **Ejemplo:** los ingresos del **20 de mayo** se liquidan el **21 de mayo** y figuran en el informe **`PAYR/2026/0140` (20 de mayo)**. Más ejemplos: [ejemplos de Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden). En la aplicación web ve los pagos y las facturas como se muestra a continuación. ## Véase también [#zie-ook] ## Conceptos [#begrippen] - **Informe de pago**: el resumen diario de pagos de un solo día natural. - **Borrador**: el informe del día en curso, que todavía puede cambiar. - **Definitivo**: un informe cerrado que se ha enviado a la contabilidad. - **Liquidación (settlement)**: el importe que Mollie ingresa en su cuenta bancaria por una serie de pagos. - **Anticipo a Mollie**: dinero que Mollie aún debe liquidarle, tal como figura en la contabilidad. - **Libro mayor**: el número de cuenta de su contabilidad. Véase [Productos](/producten). - **Peppol**: la red europea para enviar facturas directamente al sistema del destinatario. Véase [Peppol](/boekhouden/peppol). # Peppol (/es-ES/boekhouden/peppol) Con Peppol envía una factura directamente al sistema de contabilidad del destinatario, sin PDF. Peppol es la red europea de facturación electrónica. En Tillor ocurre automáticamente: si un cliente tiene un ID de Peppol, la factura se envía sola tras contabilizarla. ## ¿Cuándo se usa Peppol? [#wanneer-gebruik-je-peppol] Peppol es obligatorio para: - **Facturas B2B belgas** - el envío de facturas a empresas belgas con número de IVA - **Contratos públicos** - facturación a organismos públicos en la mayoría de los países de la UE Para los clientes neerlandeses, Peppol es opcional pero compatible. A partir de 2026, Peppol es obligatorio para todas las facturas B2B en Bélgica. Asegúrese de que los ID de Peppol de sus clientes belgas estén configurados correctamente. ## Configurar Peppol [#peppol-instellen] ### Peppol para su organización [#peppol-voor-je-organisatie] Peppol utiliza el **número de IVA** y la **dirección** de su organización. Compruebe que estos datos son correctos en **Ajustes**. En el primer envío por Peppol, Tillor registra automáticamente su organización como remitente en la red Peppol. Póngase en contacto con el soporte de Tillor si Peppol aún no está disponible para su organización. ### Configurar el ID de Peppol de un cliente [#peppol-id-instellen-voor-een-klant] Para cada cliente al que desee facturar por Peppol: 1. Vaya a *Clientes > [cliente] > Facturación* 2. Abra **Configuración de facturación** 3. Introduzca el **ID de Peppol** o elija un destinatario mediante el icono de búsqueda 4. Haga clic en **Guardar** ¿Tiene un cliente belga con número de IVA? Entonces no podrá contabilizar una factura mientras no se haya configurado un ID de Peppol. ## Buscar un destinatario de Peppol [#een-peppol-ontvanger-opzoeken] ¿No conoce el ID de Peppol de un cliente? Utilice el icono de búsqueda a la izquierda del campo: 1. Vaya a *Clientes > [cliente] > Facturación* 2. Haga clic en el icono de búsqueda a la izquierda de **ID de Peppol** 3. Tillor busca automáticamente a partir del número de IVA del cliente 4. Seleccione el destinatario correcto entre los resultados No todas las empresas están registradas en la red Peppol. Si no se encuentra una empresa, puede seguir enviando la factura por correo electrónico. ## Enviar facturas por Peppol [#facturen-via-peppol-versturen] Cuando un cliente tiene un ID de Peppol configurado, Tillor envía la factura automáticamente por Peppol tras contabilizarla: 1. Cree la factura como de costumbre 2. Compruebe que el **ID de Peppol** del cliente está configurado correctamente 3. Revise las líneas y los importes en la factura en borrador y haga clic en **Contabilizar factura** 4. Tillor envía la factura automáticamente a través de la red Peppol (normalmente en unos minutos tras contabilizarla) ### Comprobar el estado del envío [#verzendstatus-controleren] Abra la factura contabilizada y consulte **Eventos** en el panel derecho. Allí verá si la factura se ha enviado por Peppol o si ha fallado el envío o la entrega. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La factura se envía automáticamente en cuanto la contabiliza. No tiene que enviar nada. - Una factura enviada por Peppol recibe la etiqueta **Enviada a través de Peppol** en la lista del perfil del cliente. - Una factura así ya no se puede devolver a borrador ni mover a otro cliente. Para corregirla, utilice una factura de abono. Véase [Corregir una factura](/facturen/corrigeren). - Si el envío falla, lo verá en **Eventos** de la factura y habrá un aviso en Comunicación > Notificaciones. Envíe entonces la factura por correo electrónico, véase [Enviar una factura](/facturen/versturen). ## ¿Problemas? [#problemen] El cliente es belga y tiene un número de IVA. Introduzca el ID de Peppol en Clientes > cliente > Facturación, **Configuración de facturación**. Si no conoce el ID, utilice el icono de búsqueda a la izquierda del campo. No todas las empresas están conectadas a Peppol. Envíe entonces la factura por correo electrónico. Compruebe que el ID de Peppol del cliente está rellenado antes de contabilizar. ## Véase también [#zie-ook] # Enviar una factura o un recordatorio (/es-ES/communicatie/e-mails) Con **Enviar notificación** envía una factura contabilizada al cliente. Con **Enviar recordatorio** recuerda al cliente una factura pendiente. Usted elige si se envía por correo electrónico, SMS, correo postal o WhatsApp, y después sigue la entrega en [Notificaciones](/notificaties). Tillor no envía estos mensajes por sí solo al contabilizar. Usted decide cuándo recibe algo el cliente. Si quiere que ocurra automáticamente, puede hacerlo con una [automatización](/begrippen#automatisering). Antes de empezar: - La factura debe estar **contabilizada**. En una factura en borrador no aparece el botón. - El cliente tiene al menos una dirección de correo electrónico, un número de teléfono o una dirección postal completa (calle, código postal y localidad). De lo contrario no verá **Enviar notificación**. - Para un recordatorio debe quedar todavía un importe pendiente. Una factura pagada no ofrece la opción **Enviar recordatorio**. - Para cada canal debe conocerse el dato correspondiente. De lo contrario, el canal aparece en gris, con el mensaje **No hay dirección de correo registrada**, **No hay número de teléfono registrado** o **No hay dirección postal registrada**. ## Enviar una factura [#een-factuur-versturen] ### Abra la factura [#open-de-factuur] Vaya a Administración > Facturas y abra una factura contabilizada. ### Haga clic en Enviar notificación [#klik-op-verstuur-notificatie] Se abre la ventana **Enviar notificación**. Elija los canales por los que el cliente recibirá la factura. ### Elija los canales y haga clic en Enviar [#kies-de-kanalen-en-klik-op-versturen] Tillor indica **Notificación enviada**. Si no se consigue, verá **Notificación no enviada**. Los canales funcionan así: | Canal | Qué recibe el cliente | |---|---| | **Correo electrónico** | Está activado de forma predeterminada. La factura va como PDF con el mensaje, a la dirección de correo del perfil del cliente | | **SMS** | Un texto breve con el enlace personal a la factura | | **Correo postal** | La factura como carta a la dirección postal del perfil del cliente. Está desactivado de forma predeterminada. Tillor muestra un importe orientativo de franqueo por carta | | **WhatsApp** | Aparece si ha conectado WhatsApp Business. Si la ventana de 24 horas del cliente está cerrada y no tiene un método de pago en Meta, Tillor bloquea el envío | ## Enviar un recordatorio [#een-aanmaning-versturen] ### Abra el menú junto a Enviar notificación [#open-het-menu-naast-verstuur-notificatie] Haga clic en la flecha junto al botón y elija **Enviar recordatorio**. ### Elija los canales [#kies-de-kanalen] En un recordatorio, **SMS** está activado de forma predeterminada si el cliente tiene un número de teléfono. Si elige **Correo postal**, el cliente recibe una carta de recordatorio con la factura adjunta y un código QR en la carta. Véase [Enviar una factura](/facturen/versturen). ### Confirme [#bevestig] Haga clic en **Enviar**. Si ha elegido también **Correo certificado con acuse de recibo**, aparece **Enviar con coste adicional**. Esa opción solo existe si el correo certificado es compatible en el país de la dirección postal. Tillor repercute el coste adicional a su organización. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El mensaje aparece en Comunicación > Notificaciones con el canal, el estado y un enlace a la factura. También lo ve en el cliente. - El correo electrónico y el SMS empiezan en Pendiente y pasan a Enviado en cuanto se entregan. El cliente puede leer el mensaje y hacer clic en el enlace. Ambas cosas se ven en la ventana de detalle. - En el correo postal, el estado pasa a Enviado en cuanto el servicio postal confirma que la carta está en camino o entregada. En el correo postal ve el importe del franqueo en el momento del envío y, en el correo certificado, también el importe adicional. - Si un mensaje queda bloqueado más de 5 minutos, Tillor lo vuelve a intentar. Tras 2 días sin envío pasa a Fallido. - Si el mensaje falla, la factura se queda como estaba. Siempre puede volver a enviarlo. ¿Quiere que Tillor reaccione por sí mismo, por ejemplo avisando a un compañero cuando falla un recordatorio? Para eso puede crear una [automatización](/begrippen#automatisering). ## ¿Problemas? [#problemen] La factura sigue siendo un borrador, o el cliente no tiene correo electrónico, teléfono ni dirección postal completa. Contabilice la factura o complete uno de esos datos en el perfil del cliente. La factura ya está pagada o aún no está contabilizada. Un recordatorio solo se puede enviar para una factura contabilizada con un importe pendiente. Falta el dato en el perfil del cliente. Añada la dirección de correo, el número de teléfono o la dirección postal y vuelva a abrir la ventana. Abra Comunicación > Notificaciones y haga clic en el canal del mensaje. En la ventana de detalle verá el mensaje de error. Normalmente la dirección o el número no son correctos. Corríjalo en el perfil del cliente y vuelva a enviar. El envío certificado solo es posible a direcciones postales de países donde Tillor lo admite. Para otras direcciones sigue siendo posible el correo ordinario. Consulte el estado en Comunicación > Notificaciones. Si el mensaje está en **Rebotado**, la dirección no existe. Si está en **Enviado**, pida al cliente que revise su correo no deseado. Véase [Notificaciones](/notificaties#problemen). ## Véase también [#zie-ook] # Resumen (/es-ES/communicatie) En Comunicación sigue todo lo que se dice o se envía entre su parque y sus clientes: llamadas telefónicas, mensajes que envía Tillor y comentarios internos. Aquí también decide qué mensajes van a un cliente y ve si han llegado. Las conversaciones que los clientes inician por chat o redes sociales están en la [bandeja de entrada](/inbox). - Un mensaje de factura o un recordatorio nunca sale solo al contabilizar. Lo inicia usted o una [automatización](/begrippen#automatisering) - Si un mensaje queda bloqueado más de 5 minutos, Tillor lo vuelve a intentar. Tras 2 días sin envío pasa a **Fallido** - Un SMS con los datos de la organización solo se puede enviar durante una llamada en curso, desde el panel de abajo a la derecha - Un mensaje nuevo en la bandeja de entrada aparece como tarjeta abajo a la derecha y desaparece al cabo de unos diez segundos - Las llamadas telefónicas solo entran una vez instalado Voys y cuando el plan de llamadas apunta a Tillor ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Toda la comunicación con un cliente se reúne en el perfil del cliente. Lo que sale y lo que entra circula por distintos canales. ```mermaid flowchart LR K[Cliente] -->|llama| T[Llamadas telefónicas] K -->|chat, WhatsApp, Messenger, Instagram| I[Bandeja de entrada] P[Parque] -->|factura o recordatorio| N[Notificaciones] N -->|correo, SMS, correo postal, WhatsApp| K P -->|comentario interno| O[Comentarios] T --> KP[Perfil del cliente] I --> KP N --> KP ``` - Las **llamadas** entran a través de su proveedor de telefonía y se asocian al cliente por el número de teléfono. - Los **mensajes de clientes** por chat o redes sociales llegan a la bandeja de entrada. - Los **mensajes a clientes** se envían desde una factura. La entrega se sigue en Notificaciones. - Los **comentarios** son internos. Los clientes no los ven. ## Apartados [#onderdelen] ## Conceptos [#begrippen] - **Proveedor de telefonía**: la empresa que le suministra la línea telefónica, por ejemplo Voys. - **Notificación**: un mensaje que Tillor envía a un cliente o a un [usuario](/begrippen#gebruiker). - **Canal**: la vía por la que va un mensaje, como correo electrónico, SMS, correo postal o WhatsApp. - **Bandeja de entrada**: el lugar donde llegan los mensajes de clientes por chat y redes sociales. - **Comentario**: una nota interna en un [cliente](/begrippen#klant), una factura u otro registro. Encontrará más términos en el [glosario](/begrippen). # Tipos de notificación (/es-ES/communicatie/notificatietypes) Esta lista muestra cada tipo de mensaje que puede encontrar en el [resumen de notificaciones](/notificaties) y cuándo lo envía Tillor. Ve el tipo en la columna **Tipo** y puede filtrar por él con el filtro **Tipo**. Los nombres coinciden con los de la pantalla. Los mensajes a clientes van por correo electrónico, SMS, correo postal o WhatsApp. Los mensajes a compañeros van por push, correo electrónico o teléfono, según las preferencias de cada compañero. Véase [Avisos en la aplicación](/notificaties#meldingen-in-de-app). Mensajes como **Nueva factura** o **Recordatorio de factura** no los envía Tillor automáticamente al contabilizar una factura. Usted los inicia con **Enviar notificación** o **Enviar recordatorio** en la factura. Véase [Enviar una factura o un recordatorio](/communicatie/e-mails). ## Facturas y pagos [#facturen-en-betalingen] | Tipo | Cuándo se envía | |---|---| | Nueva factura | Al cliente, cuando usted envía una factura. La factura va adjunta al mensaje | | Factura pagada | Al cliente, cuando una factura ha sido pagada | | Recordatorio de factura | Al cliente, como recordatorio de una factura pendiente | | Recordatorio de transferencia bancaria manual | Al cliente que paga por transferencia, con el consejo de usar la comunicación estructurada | | Archivo de factura | A la dirección de soporte de su organización, con su contable en copia, cuando un archivo de facturas está listo | | Error al enviar factura Peppol | Cuando una factura no se ha podido enviar por Peppol | | Error al enviar la factura al software de contabilidad | Cuando falla el reenvío de una factura a su software de contabilidad | | Envío de la factura al software de contabilidad recuperado | Cuando ese reenvío finalmente se ha logrado tras avisos anteriores | | Error al enviar el informe de pago al software de contabilidad | Cuando falla el reenvío de un informe de pago | | Facturas revertidas recontabilizadas | Cuando facturas revertidas se han vuelto a contabilizar automáticamente por la noche | | Pago bancario que no liquida la factura | Cuando un pago bancario se ha vinculado a una factura, pero la factura sigue pendiente después | | Consumo muy por encima de lo habitual, retenido de la facturación automática | Cuando un cliente no se ha facturado automáticamente porque la electricidad o el agua están muy por encima de lo habitual | | Precio de producto programado aplicado | A su organización, el día en que entra en vigor un [precio programado](/producten/prijzen-plannen). El precio antiguo y el nuevo aparecen uno junto al otro | | Reembolso automático inicio de máquina | Cuando se ha devuelto un pago en línea por el inicio de una máquina porque la máquina no arrancó | | Revisión de pagos NFC sin conexión | Cuando, tras la sincronización, no se pudieron revisar los pagos NFC sin conexión | | Saldo bajo en etiqueta NFC | Al cliente cuando el saldo de una etiqueta NFC es bajo | ## Mandatos SEPA y firma [#sepa-mandaten-en-ondertekenen] | Tipo | Cuándo se envía | |---|---| | Solicitud de firma de mandato SEPA | Al cliente con el enlace para firmar el mandato, también para los recordatorios antes de que caduque el enlace | | Código de verificación del mandato SEPA | Al cliente con el código que introduce en la página de firma, por SMS o correo electrónico | | Copia del mandato SEPA firmado | Al cliente, en cuanto el mandato está activo | | Mandato SEPA revocado | Al cliente, con el documento firmado adjunto una vez más | | Solicitud de firma | A un firmante cuando le toca el turno, por correo electrónico o por SMS si no hay dirección de correo | | Código de firma | Al firmante con el código para firmar, por SMS o correo electrónico | | Documento firmado | A todos los firmantes con el PDF firmado, en cuanto firma el último | | Firma rechazada | Al compañero que envió la solicitud, cuando un firmante la rechaza | | Aceptación del DPA | Confirmación de la aceptación del DPA, con el DPA firmado adjunto | | Código de verificación del DPA | Por SMS al responsable con el código para aceptar el acuerdo de encargado del tratamiento | ## Contadores, controladores y acceso [#meters-controllers-en-toegang] | Tipo | Cuándo se envía | |---|---| | Alarma de contador | Cuando un contador tiene una alarma nueva | | Alarma de contador resuelta | Cuando se ha resuelto una alarma de contador | | Retirada de contador | Cuando se han retirado contadores | | Contadores que requieren atención | Resumen de contadores cuyas lecturas no llegan o que llevan mucho tiempo con una alarma | | Controlador desconectado | Cuando un controlador no da señales de vida durante más de 5 minutos | | Controlador sobrecalentado | Aviso urgente cuando un controlador se calienta demasiado | | Conector desconectado | Cuando el conector de su parque ya no da señales de vida | | Conector de nuevo en línea | Cuando el conector vuelve a estar accesible | | Puerta HTTP del conector caída | Cuando el conector sigue funcionando, pero las cámaras ya no lo alcanzan | | Cámara LPR sin conexión | Cuando una cámara de matrículas no responde durante más de 5 minutos | | Punto de acceso abierto demasiado tiempo | Cuando un punto de acceso permanece abierto más tiempo del permitido | | Resumen de salidas de matrículas caducadas | Resumen de vehículos con un período de acceso caducado que salieron mientras la recepción estaba cerrada | | Código QR de acceso | Al cliente con el código QR para el acceso | | Tableta o quiosco sin conexión | Cuando una tableta o un quiosco no da señales de vida fuera de su período de reposo | | Batería baja en tableta o quiosco | Cuando una tableta o un quiosco tiene la batería casi agotada y no se está cargando | ## Tareas, comentarios y bandeja de entrada [#taken-opmerkingen-en-inbox] | Tipo | Cuándo se envía | |---|---| | Tarea asignada | Al compañero al que se le ha asignado una tarea | | Tarea desasignada | Al compañero al que se le ha quitado una tarea | | Tarea completada | Cuando se ha completado una tarea | | Recordatorio de tarea | Cuando llega el momento de recordatorio de una tarea | | Fecha límite de tarea | Cuando una tarea llega a su fecha límite sin haberse completado | | Resumen diario de una vista | Por correo electrónico, el resumen diario de una vista de tareas que usted sigue | | Respuesta a comentario | Alguien ha respondido a un comentario | | Mención en comentario | Le han mencionado en un comentario | | Comentario resuelto | Un comentario se ha marcado como resuelto | | Respuesta de comentario rechazada | Cuando una respuesta por correo electrónico a un comentario no se ha publicado porque la dirección del remitente no es correcta | | Mensaje de bandeja de entrada | Cuando llega un mensaje nuevo a la bandeja de entrada | | Derivación urgente de IA | Cuando el asistente de IA le transfiere una conversación urgente | | Seguimiento del chat web | A un visitante del sitio web con una respuesta sin leer, con un enlace para retomar la conversación | ## Automatizaciones e integraciones [#automatiseringen-en-integraties] | Tipo | Cuándo se envía | |---|---| | Mensaje de automatización | Texto que una automatización envía a un cliente | | Aviso de automatización | Aviso que una automatización envía a un compañero, por push, correo electrónico o ambos | | Ejecución de automatización fallida | Al creador de una automatización cuando una ejecución termina con un error | | Error en la entrega del webhook | Cuando fallan las entregas a su webhook y Tillor sigue reintentando | | Entrega del webhook fallida permanentemente | Cuando, tras todos los intentos, Tillor no ha podido entregar un evento de webhook | | Notificación externa | Mensaje que un sistema conectado ha enviado por sí mismo, véase [Notificaciones externas](/notificaties#externe-notificaties) | Un webhook es una conexión con la que Tillor transmite automáticamente un evento a otro sistema. ## Cuenta y organización [#account-en-organisatie] | Tipo | Cuándo se envía | |---|---| | Bienvenida de usuario | Mensaje de bienvenida para un usuario nuevo | | Verificación del correo | El enlace para confirmar una dirección de correo electrónico | | Invitación a la organización | Invitación para que alguien sin cuenta de Tillor se una a su organización | | Datos de la organización | SMS a quien llama con un enlace a los datos de su organización | | Envío del formulario de contacto | Cuando alguien rellena el formulario de contacto | | Recordatorio de horario en festivo | Recordatorio para rellenar el horario de apertura de un próximo festivo | | Documento eliminado | Al usuario que eliminó un documento | ## Avisos del equipo de Tillor [#meldingen-van-het-tillor-team] Estos mensajes están destinados al equipo de Tillor y normalmente no los verá: **Incidente del sistema**, **Alerta de seguridad**, **Alerta de Grafana** y **Caída de la pasarela LoRa**. ## Véase también [#zie-ook] # Resumen (/es-ES/communicatie/providers) A través de un proveedor de telefonía como Voys, Tillor ve quién llama y guarda las llamadas, las grabaciones y las transcripciones. Conecte el proveedor en Ajustes > Integraciones. Twilio no es un proveedor de telefonía: envía los SMS de Tillor y lo ha configurado el propio Tillor. ## Proveedores disponibles [#beschikbare-providers] # Twilio (/es-ES/communicatie/providers/twilio) Twilio envía en nombre de Tillor los SMS y, si está configurado, las notificaciones de WhatsApp. No es un proveedor de telefonía como Voys y usted no lo instala: Tillor lo ha configurado para toda la plataforma. ## Diferencia con Voys [#verschil-met-voys] | | Voys | Twilio | |---|---|---| | Telefonía (llamar, llamadas) | Sí | No | | Configuración en Tillor | **Ajustes > Integraciones** | No - configuración de la plataforma | | Visible para los usuarios | Llamadas, grabaciones, transcripciones | SMS enviados y notificaciones de WhatsApp | ## ¿Qué hace Twilio en Tillor? [#wat-doet-twilio-in-tillor] Una vez configurado Twilio, Tillor lo utiliza, entre otras cosas, para: - Enviar **notificaciones por SMS** (por ejemplo, recordatorios de pago, confirmaciones de reserva y notificaciones de facturas) - Enviar **datos de la organización por SMS** desde **Comunicación > Llamadas telefónicas** (botón de SMS con la información **Enviar los datos de la organización al interlocutor por SMS**) - Entregar **notificaciones de WhatsApp** cuando WhatsApp está configurado mediante Twilio en la plataforma - Utilizar **códigos de verificación por SMS** al firmar el acuerdo de tratamiento de datos (DPA) Los SMS enviados y las notificaciones de WhatsApp se siguen en **Comunicación > Notificaciones**: Usted no configura Twilio en Tillor. Pida a su administrador de la plataforma o al soporte de Tillor la conexión adecuada para su entorno. ## Sin instalación en Integraciones [#geen-installatie-in-integraties] A diferencia de Voys, Twilio **no** aparece en **Ajustes > Integraciones**. La conexión la gestiona el administrador del entorno de Tillor. ## Véase también [#zie-ook] # Telefonía Voys (/es-ES/communicatie/providers/voys) Con la integración con Voys, Tillor sabe quién llama y muestra de inmediato los datos del cliente. Las llamadas, las grabaciones y las transcripciones acaban después en [Llamadas telefónicas](/communicatie/telefoongesprekken). Voys es un proveedor de telefonía para empresas. Antes de empezar: - Necesitas una cuenta VoIP de Voys activa y acceso a los ajustes del plan de llamadas en Voys. - Necesitas el permiso **Gestionar integraciones**. - El número de teléfono de quien llama debe constar en el perfil del cliente o en una persona de contacto. De lo contrario, Tillor no vincula la llamada con ningún cliente. ## Configurar Voys [#voys-instellen] 1. Ve a **Ajustes** (barra lateral, en **Soporte**) 2. Elige **Integraciones** y abre **Voys** en la lista 3. En la página de detalle, rellena tus datos de Voys (`username`, `password`, `client_uuid`, `token`) y haz clic en **Instalar** Necesitas una cuenta VoIP de Voys activa. Una vez instalada y configurada la integración, Tillor vincula automáticamente las llamadas con los clientes cuando el número de teléfono coincide con el de un cliente o de un contacto. ## Encontrar las URL para Voys [#urls-voor-voys-terugvinden] Tillor y Voys se comunican mediante direcciones (URL). En algunos pasos, Voys pide una respuesta a Tillor, por ejemplo si estás abierto. Esa respuesta es **ACK** (sí, continuar) o **NAK** (no, sigue el otro camino). Un webhook es una dirección de este tipo que Voys llama durante una llamada. Para los webhooks, la búsqueda del nombre de quien llama y los códigos de acceso, usas las URL que Tillor genera para ti. 1. Ve a **Ajustes > Integraciones** y abre **Voys** 2. Tras la instalación, en la página de detalle, bajo **Ajustes**, está el bloque **URLs para configurar**. Copia ahí la URL correcta para cada finalidad Allí encontrarás, entre otras: - **Notificaciones de conversación** - URL del webhook para los eventos de la llamada - **Webhook para identificación de llamadas** - URL para la búsqueda del nombre de quien llama en tu plan de llamadas de Voys - **Agenda telefónica XML** - URL para que los teléfonos VoIP descarguen la agenda telefónica - **Códigos de acceso** - URL para controlar el punto de acceso (barrera, puerta de entrada o puerta) desde el plan de llamadas - **Webhook de horario de apertura** - ACK si Tillor está abierto, NAK si Tillor está cerrado - **Webhook de llamante permitido** - ACK si se puede pasar la llamada, NAK si la llamada debe ir al buzón de voz - **Webhook de enrutamiento** - ACK con un destino, NAK si no hay ningún destino configurado En el plan de llamadas de Voys, usa las mismas variables que indica Tillor (como `{callerid}`, `{did}`, `{callername}`, `{callid}` y `{code}`). ## Configurar las notificaciones de conversación en Voys [#gespreksnotificaties-in-voys-configureren] 1. En Voys, abre el módulo [Notificaciones de conversación](https://freedom.voys.nl/redirect/CallNotification) 2. Haz clic en **Añadir** 3. En paquete/servicio, elige **Personalizado** 4. Pega la URL de Tillor de **Notificaciones de conversación** 5. Guarda Documentación de Voys: - [Notificaciones de conversación](https://help.voys.nl/gespreksnotificaties) ## Configurar los nombres de quien llama (caller lookup) en el plan de llamadas [#bellernamen-caller-lookup-in-call-plan-configureren] Para buscar el nombre de quien llama, usas en Voys un paso de webhook en el plan de llamadas. 1. En Tillor, abre la URL **Webhook para identificación de llamadas** (en **Ajustes > Integraciones > Voys**, bajo **URLs para configurar**) y cópiala 2. En Voys, abre el módulo [Webhooks](https://help.voys.nl/webhooks) y crea un webhook con esta plantilla de URL 3. Activa ese webhook en tu plan de llamadas mediante el paso de webhook 4. En la plantilla de URL, usa las variables que admite Voys (`{callerid}`, `{did}`, `{callername}` y, si hace falta, `{code}`) 5. En el enrutamiento del webhook, configura **Variabele bellernaam** para que el nombre devuelto se muestre en los teléfonos Los webhooks de horario de apertura y de enrutamiento no buscan el nombre de quien llama. Para eso usa este paso aparte. Más información: - [Webhooks](https://help.voys.nl/webhooks) - [Qué son las notificaciones de conversación (diferencia con los webhooks)](https://help.voys.nl/gespreksnotificaties) ## Horario de apertura y destinos en el plan de llamadas [#openingsuren-en-bestemmingen-in-het-belplan] Tillor es la fuente del horario de apertura, las vacaciones y las excepciones por festivos. Voys ya no necesita conocer ese calendario. 1. En **Ajustes > Integraciones > Voys**, elige el teléfono de Voys para **abierto** y, opcionalmente, para **cerrado** 2. Copia el **Webhook de horario de apertura** o el **Webhook de enrutamiento** desde **URLs para configurar** 3. En Voys, crea un [webhook](https://help.voys.nl/webhooks) con esa plantilla de URL 4. Coloca ese webhook como paso del plan de llamadas, **por encima** de cualquier menú de opciones 5. Deja **Menu gebruiken** desactivado Dos patrones: - **Webhook de horario de apertura** - `status=ACK` sigue el camino **HTTP en menu gelukt** (abierto), `status=NAK` sigue **HTTP of menu mislukt** (cerrado). Si hay un destino configurado para abierto, va con ACK como `destination`. - **Webhook de enrutamiento** - Tillor elige el destino. En el paso correcto, configura **Variabele eindbestemming**. ACK + `destination` si hay destino; si no, NAK. En caso de error o de tiempo de espera agotado, Voys toma el camino fallido. Trátalo como cerrado. Documentación de Voys: [Webhooks](https://help.voys.nl/webhooks). ## Enviar automáticamente a quien llama al buzón de voz [#bellers-automatisch-naar-voicemail-sturen] Con el **Webhook de llamante permitido**, Voys decide para cada llamante si la llamada se pasa o no. Tillor comprueba si el número de quien llama pertenece a un cliente que tiene activado el buzón de voz automático. Primero, configura el plan de llamadas: 1. Copia el **Webhook de llamante permitido** desde **URLs para configurar** en **Ajustes > Integraciones > Voys** 2. En Voys, crea un [webhook](https://help.voys.nl/webhooks) con esa plantilla de URL 3. Coloca ese webhook como paso del plan de llamadas, **por encima** de los pasos que pasan la llamada 4. Deja **Menu gebruiken** desactivado 5. Dirige el camino **HTTP en menu gelukt** a tu enrutamiento normal y el camino **HTTP of menu mislukt** al buzón de voz 6. En **Ajustes > Integraciones > Voys**, bajo **Enrutamiento de llamadas**, marca **Buzón automático en Voys** Mientras esa opción esté desactivada, no verás **Enviar llamadas al buzón de voz** en el perfil del cliente. Después, activa el buzón de voz automático para cada cliente: 1. Abre el perfil del cliente y ve a la pestaña **Comunicaciones** 2. En **Ajustes de comunicación**, marca la opción **Enviar llamadas al buzón de voz** 3. Haz clic en **Guardar** Así funciona la respuesta: - **ACK** - la llamada puede pasar. Esto también vale para números desconocidos y para llamadas con número oculto. - **NAK** - el número pertenece a un cliente con buzón de voz automático. Voys sigue el camino fallido. Tillor compara el número de quien llama con el número de teléfono del perfil del cliente, sin importar los espacios ni el formato del prefijo del país. Los números de teléfono de las personas de contacto no cuentan. En caso de error o de tiempo de espera agotado, Voys también toma el camino fallido. Entonces todas las llamadas van temporalmente al buzón de voz, no solo las bloqueadas. Por eso, usa un buzón de voz cuyos mensajes revises con regularidad. Este webhook no tiene en cuenta el horario de apertura. Combínalo con el webhook de horario de apertura o de enrutamiento poniendo ambos como pasos separados en el plan de llamadas. Documentación de Voys: [Webhooks](https://help.voys.nl/webhooks). ## Enrutamiento fijo por llamante [#vaste-routering-per-beller] El mismo **Webhook de enrutamiento** puede dirigir de inmediato a quien llama a un teléfono de Voys concreto, a una extensión o a un número de teléfono. Esto solo vale para los clientes para los que hayas elegido un destino, y solo si **Enrutamiento fijo en Voys** está activado. 1. Coloca el **Webhook de enrutamiento** en el plan de llamadas, como en el horario de apertura 2. En el paso correcto, configura **Variabele eindbestemming** 3. En **Ajustes > Integraciones > Voys**, bajo **Enrutamiento de llamadas**, marca **Enrutamiento fijo en Voys** Mientras esa opción esté desactivada, no verás **Enrutamiento fijo de llamadas** en el perfil del cliente. El webhook solo usa entonces el teléfono para abierto o cerrado. Después, configura el destino para cada cliente: 1. Abre el perfil del cliente y ve a la pestaña **Comunicaciones** 2. En **Enrutamiento fijo de llamadas**, elige un teléfono de Voys, u **Otro** para un número de teléfono o una extensión (por ejemplo, 411) 3. Elige **Ninguno** para desactivar el enrutamiento fijo 4. Haz clic en **Guardar** Así elige el destino el webhook de enrutamiento: - Si hay un destino fijo para este llamante, ese es el `destination`. - Si no, `destination` es el teléfono de Voys para abierto o cerrado. - **NAK** - no hay destino fijo ni teléfono para el estado actual. Esto también vale para números desconocidos y para llamadas con número oculto, mientras no haya teléfono para abierto o cerrado. Tillor compara el número de quien llama con el número de teléfono del perfil del cliente, sin importar los espacios ni el formato del prefijo del país. Los números de teléfono de las personas de contacto no cuentan. En caso de error o de tiempo de espera agotado, Voys toma el camino fallido. Documentación de Voys: [Webhooks](https://help.voys.nl/webhooks). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Cada llamada que entra o sale aparece en Comunicaciones > Llamadas telefónicas, con el cliente si el número coincide. Consulta [Llamadas telefónicas](/communicatie/telefoongesprekken). - En una llamada entrante, quien llama aparece como una tarjeta abajo a la derecha en Tillor, con los datos del cliente. - Las grabaciones y las transcripciones llegan en cuanto termina la llamada, si las grabaciones de llamadas están activadas en tu cuenta de Voys. ## ¿Problemas? [#problemen] El bloque solo aparece después de la instalación. Primero haz clic en **Instalar** en la página de detalle de Voys. Voys solo envía las llamadas cuando el módulo de notificaciones de conversación usa la URL **Notificaciones de conversación** de Tillor. Comprueba en Voys que esa URL está ahí y que procede del bloque **URLs para configurar**. Comprueba que el webhook de búsqueda del nombre de quien llama está en el plan de llamadas y que **Variabele bellernaam** está configurada en el paso correcto. Los webhooks de horario de apertura y de enrutamiento no buscan nombres. Primero marca **Buzón automático en Voys** en Ajustes > Integraciones > Voys, en **Enrutamiento de llamadas**. Solo entonces aparece la opción en la pestaña **Comunicaciones** del cliente. Lo mismo vale para **Enrutamiento fijo de llamadas**. En caso de error o de tiempo de espera de un webhook, Voys toma el camino fallido. Comprueba que Tillor está accesible y que la URL del webhook sigue siendo correcta. Consulta la advertencia en [Enviar automáticamente a quien llama al buzón de voz](#bellers-automatisch-naar-voicemail-sturen). Tillor compara el número con el número de teléfono del perfil del cliente. Los números de las personas de contacto cuentan para vincular las llamadas, pero no para el buzón de voz ni para el enrutamiento fijo. ## Ver también [#zie-ook] # Llamadas telefónicas (/es-ES/communicatie/telefoongesprekken) En Comunicaciones > Llamadas telefónicas aparece cada llamada que entra o sale a través de tu proveedor de telefonía, con el cliente si Tillor reconoce el número. Usas la página para hacer el seguimiento de las llamadas y para enviar por SMS los datos de tu organización a quien llama durante una llamada en curso. Antes de empezar: - Las llamadas solo aparecen después de instalar y configurar [Voys](/communicatie/providers/voys). Sin la integración, la lista permanece vacía. - Las grabaciones y las transcripciones solo existen si las grabaciones de llamadas están activadas en tu cuenta de Voys. - El botón de SMS durante una llamada en curso solo funciona si el envío de SMS está configurado para tu entorno. Consulta [Twilio](/communicatie/providers/twilio). ## Ver las llamadas [#gesprekken-bekijken] En la tabla **Todas las llamadas** ves, por llamada: | Columna | Qué ves | |---|---| | **Dirección** | **Entrante** o **Saliente** | | **Iniciada el** | Fecha y hora | | **De** y **A** | Los números de teléfono | | **Duración** | La duración de la llamada, una vez terminada | | **Cliente** | El cliente vinculado, o un nombre que indicó Voys (no verificado) si no hay ningún cliente asociado | | **Estado** | En qué punto está la llamada | Tillor vincula una llamada con un cliente según el número de teléfono. Si el número aún no pertenece a ningún cliente, añádelo al perfil del cliente o a una persona de contacto. Las llamadas nuevas se vincularán entonces automáticamente. Una llamada pasa por estos estados: | Estado | Significado | |---|---| | Creada | La llamada acaba de empezar | | Sonando | El teléfono está sonando | | Contestada | Alguien ha descolgado | | En curso | La llamada está en curso | | Transferencia en caliente y Transferencia en frío | La llamada se ha transferido, con o sin aviso previo | | Colgada y Finalizada | La llamada ha terminado | | Fallida | La llamada no llegó a establecerse | ## Enviar los datos de la organización por SMS [#organisatiegegevens-via-sms-versturen] ¿Alguien pregunta por tu dirección o tu horario de apertura? Envíaselos por SMS en pocos segundos, mientras la llamada está en curso. ### Espera a que la llamada esté en curso [#wacht-tot-het-gesprek-loopt] La acción está en el panel de llamadas activas, abajo a la derecha, no en la lista. La llamada debe tener el estado **En curso**. En un teléfono, toca primero el icono del teléfono, arriba a la derecha. ### Despliega la llamada [#klap-het-gesprek-uit] Si la llamada está contraída, despliégala. ### Haz clic en el icono de mensajes [#klik-op-het-berichtenpictogram] La descripción emergente dice **Enviar los datos de la organización al interlocutor por SMS**. ### Elige el idioma [#kies-de-taal] Tillor marca con *(detectado)* el idioma que reconoce en quien llama. Elige el idioma del SMS. Quien llama recibe un enlace corto a una página pública con los datos de tu organización. Si la dirección de tu organización está rellenada, también aparecen botones de ruta para **Waze**, **Google Maps** y **Apple Maps**. El botón de correo de esa página ya incluye un asunto y un texto del mensaje, con el número y la hora de la llamada si se conocen. El enlace al sitio web lleva etiquetas de seguimiento, para que puedas medir cuántas personas llamantes hacen clic. ## Grabaciones y transcripciones [#opnames-en-transcripties] ### Abre la llamada [#open-het-gesprek] En la lista, haz clic en **Transcripción** en la llamada. Se abre la ventana **Detalles de la llamada**. ### Elige una pestaña [#kies-een-tabblad] En **Grabación**, la llamada se reproduce en tu navegador. En **Transcripción** está el texto escrito por interlocutor, y en **Resumen** un breve resumen. Tillor genera la transcripción y el resumen por sí mismo en cuanto termina la llamada y existe una grabación. Tarda un poco. En una llamada sin grabación no hay pestañas. Las grabaciones de llamadas pueden contener información sensible desde el punto de vista de la privacidad. Asegúrate de cumplir la normativa de privacidad (RGPD) al grabar llamadas e informa a quienes llaman de que las llamadas se graban. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una vez terminada, la llamada aparece en la lista con su duración, el cliente y, si hay grabación, una transcripción y un resumen. - Un SMS enviado con los datos de la organización aparece en Comunicaciones > Notificaciones con el tipo **Datos de la organización**. ## ¿Problemas? [#problemen] Comprueba que Voys está instalado en Ajustes > Integraciones y que las notificaciones de conversación de Voys apuntan a la URL de Tillor. Consulta [Telefonía Voys](/communicatie/providers/voys). Tillor compara el número de quien llama con el número de teléfono del perfil del cliente o de una persona de contacto. Añade el número y las llamadas nuevas se vincularán. Las llamadas que ya han entrado se quedan como estaban. El botón solo está en el panel de llamadas activas, abajo a la derecha, y solo mientras la llamada tiene el estado **En curso**. No está en la lista de esta página. Voys no ha grabado la llamada. Activa las grabaciones de llamadas en tu cuenta de Voys. Las llamadas anteriores no se pueden grabar con carácter retroactivo. ## Ver también [#zie-ook] # Conector (/es-ES/connector) El Conector de Tillor es una cajita pequeña en la red de tu parque. Conecta Tillor con los dispositivos que tienes en el lugar: impresoras de tickets, barreras, controladores de acceso y lectores de identidad. Sin conector, Tillor no puede manejar esos dispositivos. Si está apagado, no funcionan ni la impresión ni el manejo de barreras desde Tillor. Cómo seguir adelante entonces, lo encuentras en [Problemas](#problemen). Tillor entrega el conector ya preconfigurado y lo supervisa a distancia. Tú no tienes que instalar ni actualizar nada. - Cada organización tiene un conector. Si gestionas varios parques, cada parque (organización) recibe su propia cajita. - El conector se comunica con Tillor cada 15 segundos. - Si Tillor no sabe nada de él durante 3 minutos, el equipo de Tillor recibe un aviso automáticamente. - Tillor instala las actualizaciones por su cuenta, sin que tengas que hacer nada. - El conector establece por sí mismo una conexión saliente segura. No necesitas abrir puertos en tu router. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] El conector está entre Tillor en internet y los dispositivos de tu propia red. Tillor envía una orden al conector y este la ejecuta en el dispositivo correcto. En sentido contrario, el conector informa de lo que ha ocurrido, por ejemplo una matrícula leída. ```mermaid flowchart LR T[Tillor] <-->|beveiligde verbinding via internet| C[Connector in je park] C --> P[Bonnenprinter] C --> S[Slagboom of toegangscontroller] C --> I[Identiteitslezer] ``` Por ejemplo: - Imprimes un ticket o una etiqueta. Tillor lo envía al conector y este lo manda a tu impresora. - Das a un cliente un método de acceso. Tillor envía el cambio a los controladores de acceso a través del conector, consulta [Control de acceso](/toegangscontrole#hoe-hangt-dit-samen). - Un huésped escanea un documento de identidad al registrarse. El conector envía el escaneo a Tillor, consulta [Escaneos de identidad](/identiteitsscans). ## Lo que Tillor hace por ti [#wat-tillor-voor-je-doet] - **Entrega**: la cajita llega preconfigurada para tu organización. - **Instalación y vinculación**: vinculamos tus impresoras, barreras y escáneres durante la puesta en marcha. - **Actualizaciones**: las nuevas versiones se instalan automáticamente, sin interrupciones. - **Supervisión**: Tillor ve si el conector está conectado y avisa por sí mismo si se cae. ## Lo que necesitas tú [#wat-je-zelf-nodig-hebt] - Una toma de corriente cerca de tu equipo de red - Un cable de red hasta tu router o switch, en la misma red que tus impresoras y barreras - Una conexión a internet estable ## Dispositivos vinculados [#gekoppelde-apparaten] - **Impresoras**: consulta [Impresora](/printer) para configurarlas y usarlas. - **Barreras, puertas y controladores de acceso**: consulta [Control de acceso](/toegangscontrole). - **Lectores de identidad**: consulta [Escaneos de identidad](/identiteitsscans) para crear clientes a partir de un escaneo y para los plazos de conservación. En la red de tu parque puedes ver el estado del conector en `http://[adres-van-de-connector]:3000/`. Allí ves la conexión con Tillor, la cola de impresión y las últimas matrículas leídas. El soporte de Tillor te da la dirección durante la instalación. Encontrarás más sobre el protocolo en [MQTT](/ontwikkelaars/mqtt). ## ¿Problemas? [#problemen] Comprueba que la cajita recibe corriente y que el cable de red está bien conectado. Mira si funciona internet en tu parque. Después desenchufa la cajita un momento y vuelve a enchufarla. Si el problema continúa, ponte en contacto con el soporte de Tillor. Normalmente ya vemos nosotros mismos una caída. Mira primero el estado del conector, consulta el consejo técnico de arriba. Comprueba que el dispositivo está encendido y en la misma red. Si el conector está conectado y el dispositivo es accesible pero no ocurre nada, ponte en contacto con el soporte. Mira en **Operaciones del controlador** en la página Control de acceso. Si una orden se queda en **Pendiente**, el conector está sin conexión. ## Conceptos [#begrippen] - **Conector**: la cajita de tu parque que conecta Tillor con tus dispositivos. - **Controlador de acceso**: una cajita junto a una barrera que lee tags y códigos QR. - **Solución gestionada**: Tillor entrega, configura y mantiene la cajita por ti. Encontrarás más explicaciones en el [glosario](/begrippen). ## Ver también [#zie-ook] # Documentos (/es-ES/documenten) Con la gestión de documentos guardas archivos en un cliente, como pólizas de seguro, documentos de identidad, contratos, permisos y otros anexos. Los archivos que aún no pertenecen a nadie están en la lista central de documentos hasta que los vincules a un cliente. Empieza por [Documentos de un cliente](#documenten-bij-een-klant) o por [La lista central de documentos](#de-centrale-documentenlijst). - Un archivo puede pesar como máximo 250 MB. - Puedes subir PDF, Word, mensajes de Outlook (.msg), Excel, PowerPoint, imágenes (JPEG, PNG, GIF) y archivos de texto. - Tillor convierte las imágenes a PDF tras subirlas. Los demás tipos de archivo se quedan como están, con una vista previa en PDF al lado. - Cuando se elimina un documento, recibes una copia como anexo en tu correo electrónico, si el archivo pudo ponerse a salvo. - Un PDF que pertenece a una solicitud de firma, y el PDF firmado, se pueden archivar pero no eliminar. - Un documento archivado se conserva, pero ya no aparece entre los documentos activos. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] ```mermaid flowchart LR U[Upload of e-mail] --> C[Centrale documentenlijst] C -->|Koppelen aan klant| K[Documenten van de klant] K --> S[Ondertekenverzoek] S --> O[Ondertekende PDF bij de klant] M[SEPA-mandaat] --> K ``` Un documento está en un solo lugar: o en la lista central, o en un cliente. Si lo vinculas a un cliente, desaparece de la lista central. Los PDF firmados y los mandatos firmados se colocan solos entre los documentos del cliente. ## Documentos de un cliente [#documenten-bij-een-klant] ### Ver los documentos [#documenten-bekijken] 1. Ve a Clientes > Resumen y abre el perfil del cliente. 2. Haz clic en la pestaña **Documentos**. 3. Ves los documentos de este cliente, repartidos entre **Activo** y **Archivado**. 4. Haz clic en un documento (o en el ojito) para verlo a la derecha en la **Vista previa**. Con el icono de descarga lo guardas. ### Editar, mover o archivar un documento [#een-document-bewerken-verplaatsen-of-archiveren] El menú **…** junto a un documento contiene **Editar**, **Mover a cliente**, **Descargar**, **Archivar** (o **Desarchivar**) y **Eliminar**. ### Eliminar un documento [#een-document-verwijderen] Antes de empezar: un documento que pertenece a una solicitud de firma no se puede eliminar. Archívalo en su lugar. ### Elige Eliminar [#kies-verwijderen] Elige **Eliminar** en el menú **…** junto al documento. ### Confirma [#bevestig] Confirma en el cuadro de diálogo con **Eliminar**, o cancela con **Cancelar**. La eliminación no se puede deshacer. Tras la eliminación, recibes en el correo electrónico de tu cuenta un mensaje con el documento eliminado como anexo, de modo que normalmente tienes una copia a mano. ### Pedir que se firme un documento [#een-document-laten-ondertekenen] Bajo los documentos de un cliente están las **Solicitudes de firma**. Con **Solicitar firmas** haces que el cliente, una persona de contacto, un compañero o un tercero firme un PDF en línea. El PDF firmado aparece entre los documentos como **[título] (firmado)**, con el tipo **Acuerdo firmado** si el PDF original no tenía ningún tipo. Consulta [Firmas](/handtekeningen). ## La lista central de documentos [#de-centrale-documentenlijst] Además de los documentos de los clientes, Tillor tiene una lista central. Aquí aparecen los archivos que aún no están vinculados a un cliente, por ejemplo documentos que llegan por correo electrónico. Ve a Administración > Documentos. ### Subir un documento [#een-document-uploaden] Arrastra un archivo a la zona de subida, o haz clic en **Seleccionar archivo**. El archivo se guarda automáticamente y aparece como un elemento nuevo en la lista. En la zona de subida hay una dirección de correo electrónico especial. Envía el archivo como anexo a esa dirección y aparecerá solo en la lista central. ### Vincular un documento a un cliente [#een-document-koppelen-aan-een-klant] Cada documento de la lista central tiene un formulario de edición y un panel de vista previa. ### Busca el documento [#zoek-het-document] Ve a Administración > Documentos y desplázate hasta el documento. ### Rellena los campos [#vul-de-velden-in] - **Nombre del documento**: el nombre del documento. - **Asignar a cliente**: el cliente al que pertenece este documento (opcional). - **Tipo de documento**: por ejemplo **Póliza de seguro**, **Justificante de pago del seguro**, **Documento de identidad**, **Mandato SEPA**, **Acuerdo firmado** u **Otro** (opcional). - **Fecha de caducidad del seguro**: la fecha en que caduca un seguro o un permiso. Este campo solo aparece en los tipos de documento que pueden tener fecha de caducidad. - **Comentarios**: notas libres sobre el documento (opcional). ### Guarda [#sla-op] Haz clic en **Guardar cambios**. ### ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El documento desaparece de la lista central y aparece en la pestaña **Documentos** de ese cliente. - Si has rellenado una **Fecha de caducidad del seguro**, la ves como etiqueta en el documento. ## Sugerencias de IA en los documentos [#ai-suggesties-bij-documenten] Cuando subes un PDF, Tillor analiza su contenido en segundo plano. Si Tillor reconoce un nombre que coincide con un cliente de tu administración, junto a **Asignar a cliente** aparece un botón de sugerencia con el nombre del cliente y un porcentaje que indica lo seguro que está Tillor. También puede aparecer una sugerencia así para una fecha de caducidad del seguro. Haz clic en el botón para aceptar la sugerencia, o elige tú otro cliente. Una sugerencia es siempre una propuesta. Haz clic en **Guardar cambios** para confirmar tu elección. ## ¿Problemas? [#problemen] Si el documento pertenece a una solicitud de firma, como PDF original o como PDF firmado, Tillor rechaza la eliminación, porque es una prueba. Archívalo con **Archivar** en el menú **…**. El mensaje es **No se pudo archivar el documento.** Inténtalo de nuevo. Lo mismo vale para **Error al restaurar** en **Desarchivar**. Tus cambios en **Nombre del documento**, el cliente, el tipo o los comentarios no se han guardado. Revisa el formulario y haz clic de nuevo en **Guardar cambios**. No se pudo descargar el documento. Inténtalo de nuevo. Ese campo solo aparece en los tipos de documento que pueden tener fecha de caducidad, como **Póliza de seguro**. Primero elige el tipo correcto en **Tipo de documento**. Comprueba el tipo de archivo (PDF, Word, mensaje de Outlook, Excel, PowerPoint, JPEG, PNG, GIF o texto) y el tamaño (máximo 250 MB). En cuanto un documento se vincula a un cliente, solo está en ese cliente, en **Documentos**. Si está en el archivo, lo encuentras en **Archivado**. ## Conceptos [#begrippen] - **Tipo de documento**: la clase de documento, por ejemplo **Póliza de seguro** o **Documento de identidad**. - **Archivado**: un documento que se conserva pero ya no aparece entre los documentos activos. - **Lista central de documentos**: archivos que aún no están vinculados a un cliente. - **Solicitud de firma**: una orden para que se firme un PDF. Consulta [solicitud de firma](/begrippen#ondertekenverzoek). - **Cliente**: el registro de Tillor al que está asociado un documento. Consulta [cliente](/begrippen#klant). ## Ver también [#zie-ook] # Resumen (/es-ES/eigen-velden) Con los campos personalizados añades tú mismo campos a un registro. Piensa en un número de fianza de una bombona de gas en un cliente, un suplemento en una parcela o una hora de llegada prevista en una reserva. El campo aparece en el formulario de ese registro, igual que los campos que trae Tillor. Los gestionas en Ajustes > Campos personalizados. - El tipo de un campo y la clave no se pueden cambiar después de crearlo - Texto: por defecto un máximo de 1.000 caracteres, Texto largo 10.000. Una lista de opciones tiene un máximo de 200 opciones - Un grupo de campos tiene un máximo de 30 subcampos. Filas repetidas: por defecto un máximo de 100 filas, nunca más de 500 - Archivos: por defecto un máximo de 20 por campo (nunca más de 50), cada uno de un máximo de 50 MB - Un campo que desaparece por una condición se vacía al guardar el registro - Un campo eliminado desaparece de los formularios. Los valores rellenados se quedan en los registros - Todos los límites por tipo están en [Tipos de campo y ajustes](/eigen-velden/veldtypes) ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Creas un campo una sola vez y después aparece en todos los sitios donde se rellena ese tipo de registro. ```mermaid flowchart LR L[Keuzelijst met opties] -->|gebruikt door| V[Eigen veld van het type Keuze] V -->|staat in het formulier van| R[Klant, terrein, bezetting, taak en andere records] T[Toegang: wie mag zien en bewerken] --> V R -->|waarden komen terug in| E[Exports, filters en automatiseringen] ``` - **Las listas de opciones** las creas aparte de los campos. Si cambias una opción, queda correcta en todos los campos que usan la lista. - **Un campo** pertenece a un tipo de registro. El tipo y la clave quedan fijos. - **El acceso** se regula por campo. Quien no puede ver un campo nunca ve el valor, tampoco en exportaciones ni en automatizaciones. ## Dónde puedes añadir campos personalizados [#waar-kun-je-eigen-velden-toevoegen] Cada tipo de registro tiene su propia pestaña. Detrás del nombre aparece el número de campos. | Pestaña | Registro | |---|---| | **Clientes** | Perfil de cliente | | **Parcelas** | Parcela | | **Ocupaciones** | Ocupación | | **Contadores** | Contador | | **Tareas** | Tarea | | **Productos** | Producto | | **Documentos** | Documento | | **Reservas** | Reserva | | **Métodos de acceso** | Método de acceso | La pestaña **Listas de opciones** no tiene registros. Ahí creas listas de opciones que reutilizas en los campos de selección. ## Lo que puedes hacer con ellos [#wat-je-ermee-kunt] - Añadir un campo de un tipo concreto, como texto, número, importe, fecha, opción o archivo. Consulta [Tipos de campo y ajustes](/eigen-velden/veldtypes) - Colocar el campo en el formulario entre los campos existentes, o mostrarlo solo si otro valor se cumple - Hacer el campo obligatorio, si hace falta solo bajo una condición - Decidir quién puede ver el campo y quién puede editarlo. Consulta [Visibilidad y acceso](/eigen-velden/zichtbaarheid-en-toegang) Los valores están disponibles en la exportación de clientes y de parcelas y en las automatizaciones. Una automatización también puede rellenar un campo personalizado con el paso **Establecer campo personalizado**. ## Quién puede usarlos [#wie-kan-het-gebruiken] Crear, modificar, reordenar y eliminar campos es posible con el permiso **Gestionar campos personalizados**. Quien no lo tiene puede abrir la página si puede ver los ajustes, pero los botones están desactivados. Rellenar un campo en un registro puede hacerlo cualquiera que pueda ver y editar el campo. ## Apartados [#onderdelen] ## Conceptos [#begrippen] - **[Campo personalizado](/begrippen#eigen-veld)**: un campo adicional que añades tú mismo a un registro - **Etiqueta**: el nombre que ven tus compañeros encima del campo de entrada - **Clave**: el nombre fijo del campo, por ejemplo `gasMeterNumber`. La ves en la lista y se usa en exportaciones y filtros - **Tipo**: qué clase de valor guarda el campo - **[Lista de opciones](/begrippen#keuzelijst)**: una lista de opciones que usas en varios campos de selección Encontrarás más términos en el [glosario](/begrippen). Hay un ejemplo desarrollado en [Ejemplos prácticos](/praktijk). # Crear listas de opciones (/es-ES/eigen-velden/keuzelijsten) Un campo del tipo **Opción** u **Opción múltiple** necesita una lista de opciones. Creas la lista una vez y la usas en tantos campos como quieras. Si cambias una opción, queda correcta de inmediato en todas partes. ### Abre la pestaña Listas de opciones [#open-het-tabblad-keuzelijsten] Ve a Ajustes > Campos personalizados y haz clic en **Listas de opciones**. Cada lista muestra sus opciones con su color y cuántos campos la usan. ### Crea una lista [#maak-een-lijst-aan] Haz clic en **Nueva lista de opciones**. Rellena un **Nombre** y, si quieres, una **Descripción**. Tillor crea por sí mismo una **Clave**. ### Añade opciones [#voeg-opties-toe] Haz clic en **Añadir opción** y rellena la **Etiqueta**, por ejemplo *Temporada*. Elige un color con el punto de color. Una lista necesita al menos una opción. ### Guarda [#sla-op] Haz clic en **Guardar**. Después, elige la lista al crear un campo del tipo **Opción** u **Opción múltiple**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La lista está disponible al crear un campo del tipo **Opción** u **Opción múltiple**. - Si más adelante cambias la etiqueta o el color de una opción, queda correcto de inmediato en todos los campos que usan la lista. - El **Valor** de una opción queda fijo en cuanto se ha usado en un registro. ## ¿Problemas? [#problemen] Una lista que aún se usa en un campo no se puede eliminar. Tillor avisa de que la lista todavía la usa un campo. Primero quita la lista de esos campos o elimina esos campos. Todavía no existe ninguna lista. Crea una en la pestaña **Listas de opciones** y después elígela en el campo. Una lista necesita al menos una opción y un máximo de 200. Añade una opción con **Añadir opción**. # Crear un campo personalizado (/es-ES/eigen-velden/veld-aanmaken) Con un campo personalizado guardas un dato que Tillor no conoce por sí mismo, como el número de fianza de una bombona de gas en un cliente. Lo creas en unos minutos y a la derecha de la página ves enseguida cómo lo recibirán tus compañeros. Después lo rellenas en el propio registro, consulta [Visibilidad y acceso](/eigen-velden/zichtbaarheid-en-toegang). Antes de empezar: - Necesitas el permiso **Gestionar campos personalizados**. Sin ese permiso, el botón **Nuevo campo** está en gris. - Si el campo necesita una opción, crea primero una [lista de opciones](/eigen-velden/keuzelijsten). Si no, aparece **Crea primero una lista de selección**. - Elige el tipo con cuidado: después ya no se puede cambiar. ### Abre Campos personalizados y elige la pestaña [#open-eigen-velden-en-kies-het-tabblad] Ve a Ajustes > Campos personalizados y abre la pestaña del registro al que pertenece el campo, por ejemplo **Clientes**. Haz clic en **Nuevo campo**. Si la pestaña aún está vacía, bajo **Inicio rápido** ves algunas propuestas, como **Número de perros** en clientes. Haz clic en una propuesta para abrir el formulario ya rellenado. Las propuestas con una lista de opciones piden primero una lista. Consulta [Listas de opciones](/eigen-velden/keuzelijsten). ### Rellena el campo [#vul-het-veld-in] Bajo **1. Campo** eliges en **Se aplica a** el tipo de registro, das al campo una **Etiqueta** y eliges el **Tipo**. Cada tarjeta de tipo tiene una breve explicación. Tillor crea por sí mismo una **Clave** a partir de tu etiqueta. Bajo **3. Clave** puedes cambiarla con **Cambiar** antes de guardar. ### Ajusta el campo [#stel-het-veld-af] Bajo **2. Ajustes** están las opciones que corresponden al tipo elegido. Consulta [Tipos de campo y ajustes](/eigen-velden/veldtypes). Además puedes elegir: - **Ancho**: **Mitad** o **Ancho completo** en el formulario - **Posición en el formulario**: deja el campo al final (**Sección predeterminada (abajo)**), o elige un campo existente del formulario y coloca el campo **Antes** o **Después** de ese campo - **Obligatorio**: el registro no se puede guardar mientras el campo esté vacío - **Visibilidad**: muestra el campo solo si se cumple una condición - **Obligatorio cuando**: haz el campo obligatorio solo si se cumple una condición - **Reglas de validación**: compara el valor con otro campo, o compruébalo con una expresión - **Texto de ayuda**: una breve explicación bajo el campo de entrada ### Decide quién puede acceder [#bepaal-wie-erbij-mag] Bajo **4. Acceso** pone por defecto que todos pueden ver y editar el campo. Haz clic en **Restringir** para cambiarlo. Consulta [Visibilidad y acceso](/eigen-velden/zichtbaarheid-en-toegang). ### Guarda el campo [#sla-het-veld-op] Haz clic en **Guardar**. Tillor avisa con **Campo guardado** y te devuelve a la lista. El campo aparece de inmediato en el formulario del registro. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El campo aparece de inmediato en el formulario del registro, en el lugar que elegiste. - Los registros existentes todavía tienen un valor vacío. Si el campo es obligatorio, un compañero tiene que rellenarlo antes de volver a guardar ese registro. - Los valores se incluyen en la exportación de clientes y de parcelas y están disponibles en las automatizaciones. - Quién puede ver o editar el campo lo regulas bajo **4. Acceso**. ## Posición y condiciones [#plaats-en-voorwaarden] Con **Posición en el formulario** colocas un campo junto a los campos con los que va, en lugar de al final. Con **Visibilidad** muestras un campo solo si otro valor lo pide. En este ejemplo, **Winterstalling** solo aparece en una parcela con el **Tipo de contrato** Temporada, justo después de **Descripción**. Una condición consta de una o más reglas. En **Tipo de condición** eliges **Reglas** o **Expresión**. La expresión está pensada para casos complicados y requiere un poco de código. Para la mayoría de los campos bastan las reglas. Si un campo desaparece porque la condición ya no se cumple, Tillor borra el valor al guardar el registro. Si el campo vuelve, está vacío. Un campo que es obligatorio bajo una condición solo es obligatorio mientras está visible. ## Editar, mover o eliminar un campo [#een-veld-bewerken-verplaatsen-of-verwijderen] En la lista, cada campo tiene cuatro botones. | Botón | Qué hace | |---|---| | **Subir** y **Bajar** | Cambia el orden de los campos en el formulario | | **Editar campo** | Abre el campo. El tipo, la clave y el registro al que pertenece el campo quedan entonces fijos | | **Eliminar** | Elimina el campo tras una confirmación | Un campo eliminado desaparece de los formularios. Los valores rellenados se quedan en los registros, pero ya no se muestran ni se editan. ## ¿Problemas? [#problemen] El botón está desactivado sin el permiso **Gestionar campos personalizados**. Pide a un administrador que te lo conceda. No es posible. Crea un campo nuevo con el tipo correcto y después elimina el antiguo. Tillor no traslada los valores del campo antiguo. Comprueba en **Posición en el formulario** si has elegido un campo. Con **Sección predeterminada (abajo)**, el campo queda después de los campos estándar del formulario. Si tiene una condición en **Visibilidad**, solo está ahí cuando se cumple. # Tipos de campo y ajustes (/es-ES/eigen-velden/veldtypes) Al crear un campo eliges un tipo. Después ya no puedes cambiarlo. Bajo **2. Ajustes** están las opciones de ese tipo. Todas las opciones son opcionales, salvo que se indique otra cosa más abajo. En casi todos los tipos también puedes rellenar un **Mensaje de error**. Sustituye al mensaje estándar cuando un valor no es correcto. Con **Texto de ejemplo** decides qué aparece en el campo de entrada vacío. ## Texto y Texto largo [#tekst-en-lange-tekst] **Texto** es una línea, **Texto largo** varias líneas. | Ajuste | Qué hace | |---|---| | **Longitud mínima** y **Longitud máxima** | El número de caracteres. Sin máximo se aplican 1.000 caracteres en Texto y 10.000 en Texto largo | | **Formato** | **Texto libre**, **Correo electrónico**, **Número de teléfono**, **Dirección web**, **IBAN**, **Código postal**, **Solo dígitos** o **Patrón personalizado** | | **Patrón (expresión regular)** | Con **Patrón personalizado**. Todo el valor debe coincidir. Tillor rechaza los patrones con repeticiones anidadas o referencias hacia atrás y los patrones de más de 200 caracteres | ## Número e Importe [#getal-en-bedrag] **Importe** usa la moneda de tu organización. | Ajuste | Se aplica a | Qué hace | |---|---|---| | **Mínimo** y **Máximo** | Número, Importe | Límite inferior y límite superior | | **Solo números enteros** | Número | No se permiten decimales | | **Visualización** | Número, solo con números enteros | **Campo de entrada** o **Contador (− / +)** con botones | | **Incremento** | Número | El valor debe ser el mínimo (o 0) más un número entero de incrementos | | **Decimales máximos** | Número | Limita los decimales | ## Sí / no [#ja--nee] Un interruptor de activado/desactivado. Con **Debe estar marcada**, el registro solo se puede guardar con la casilla activada. Útil para un consentimiento. ## Fecha [#datum] | Ajuste | Qué hace | |---|---| | **Fecha más temprana** y **Fecha más tardía** | Límites fijos | | **No en el pasado** y **No en el futuro** | Se comparan con hoy en la zona horaria de tu organización | | **A menos de días de hoy** | Como máximo tantos días antes o después de hoy | ## Opción y Opción múltiple [#keuze-en-meerkeuze] Eliges una [lista de opciones](/eigen-velden/keuzelijsten). **Opción** guarda una opción, **Opción múltiple** varias. En Opción múltiple configuras **Mínimo seleccionado** y **Máximo seleccionado**. Una lista tiene un máximo de 200 opciones. ## Enlace a registro [#koppeling-naar-record] El campo apunta a otro registro de Tillor. | Ajuste | Qué hace | |---|---| | **Enlaza con** | Cliente, Parcela, Ocupación, Contador, Tarea, Factura, Reserva, Informe de pago, Llamada telefónica, Persona de contacto, Producto, Armario de contadores, Pago, Documento, Etiqueta NFC o Método de acceso | | **Varios registros** | Permite más de un registro vinculado. Entonces también puedes configurar un mínimo y un máximo | | **Visualización** | **Lista de opciones** o **Desplegable** (una lista única con búsqueda) | | **Solo los registros de este cliente** | Limita las opciones a los registros del cliente que estás editando. Solo en Persona de contacto, Factura, Reserva, Ocupación, Pago, Documento, Etiqueta NFC y Método de acceso | | **Solo registros de la parcela** | Limita las opciones a los contadores de la parcela: en una ocupación, la parcela de esa ocupación; en una parcela, la propia parcela. Solo en Contador. No puedes guardar un contador de otra parcela | | **Filtrar opciones** | TypeScript opcional que decide, para cada opción, si aparece en la lista, consulta [Filtrar opciones](#opties-filteren). En Persona de contacto, Producto, Armario de contadores, Pago, Documento, Etiqueta NFC, Método de acceso, Factura, Reserva, Ocupación, Contador y Parcela | Si un registro vinculado se elimina más tarde, el campo muestra **Eliminado**. Si hay al menos 50 registros entre los que elegir, primero escribes 2 caracteres para buscar. Si son menos, como los contadores de una sola parcela, los ves todos de inmediato. ### Filtrar opciones [#opties-filteren] Con **Filtrar opciones** decides tú qué registros ofrece el campo. Escribes TypeScript, como en la [fórmula de tarifa](/terreinen#tariefformule), que Tillor ejecuta para cada opción. Si devuelve `true`, la opción aparece en la lista; si no, no. En el filtro lees campos con llaves. El menú **Variable** muestra lo que hay, incluidos los campos personalizados: | Variable | Qué es | |-----------|------------| | `{option.…}` | El registro que podrías elegir, por ejemplo `{option.type}` o `{option.terrainId}` en un contador | | `{occupation.…}`, `{terrain.…}`, … | El registro que estás editando, con el nombre de su tipo, con `customFields` para sus campos propios | Ejemplo: solo contadores de electricidad de la parcela de la ocupación. ```ts return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId}; ``` ### Etiquetas propias [#eigen-labels] El mismo filtro también puede decidir cómo se llama una opción en la lista. Lo que devuelvas determina el resultado: | Devuelves | Resultado | |----------------|-----------| | `true` | La opción está en la lista con su propio nombre | | `false`, `null` o un texto vacío | La opción no está en la lista | | Un texto | La opción está en la lista con ese texto | | `{ label, group }` | La opción recibe esa etiqueta y se coloca bajo el encabezado `group`. Ambos son opcionales | Ejemplo: solo contadores de ICY e Hydrodigit, con el tipo incluido y agrupados por proveedor. ```ts if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false; return { label: {option.name} + " · " + {option.type}, group: {option.provider} }; ``` La etiqueta vale en la lista de opciones y en los chips elegidos del formulario. En los lugares que solo muestran el valor, como la página de detalle o una exportación, aparece el nombre propio del registro. **Insertar ejemplo** bajo el campo da un punto de partida. Un filtro que no compila no se puede guardar; el mensaje bajo el campo dice qué falla. El filtro no solo limita la lista. Si eliges mediante la API o un formulario antiguo un registro que el filtro omite, Tillor rechaza el guardado indicando el nombre del campo. Las automatizaciones y las importaciones no se comprueban, igual que pueden rellenar campos ocultos. ## Grupo de campos [#groep-velden] Un conjunto fijo de subcampos que aparecen juntos en el formulario, como **Perros** y **Otros animales** bajo **Animales**. | Ajuste | Qué hace | |---|---| | **Añadir subcampo** | Cada subcampo tiene una etiqueta, un tipo y ajustes propios. Haz clic en **Más** para la clave, el ancho y las condiciones. Un grupo puede tener un máximo de 30 subcampos | | **Visualización** | **Marco** (con borde) o **En línea** (los campos continúan en el formulario) | | **Columnas** | De 1 a 4 | | **Ancho en el grupo** | Cuántas columnas ocupa cada subcampo | ## Filas repetidas [#herhalende-rijen] Una tabla a la que añades filas con **Añadir fila**, por ejemplo varios vehículos. Configuras los subcampos como en un grupo. Con **Filas mínimas** y **Filas máximas** limitas la lista. Sin máximo se aplican 100 filas, y no puede haber más de 500. Un grupo o unas filas repetidas pueden contener, un nivel más abajo, otro grupo u otras filas repetidas, pero no más allá. ## Archivos [#bestanden] Para documentos y fotos. Un archivo que subes solo lo puede abrir quien puede ver el campo. | Ajuste | Qué hace | |---|---| | **Varios archivos** | Permite más de un archivo | | **Archivos mínimos** y **Archivos máximos** | Sin máximo se aplican 20 archivos, y no puede haber más de 50 | | **Tamaño máximo por archivo (MB)** | Un máximo de 50 MB por archivo, aunque quieras un valor más alto | | **Tipos de archivo permitidos** | **Cualquier archivo**, **Imágenes**, **PDF**, **Documentos de Office**, o una extensión propia como `.dwg` o un tipo MIME como `application/zip` | Tillor comprueba el tipo según el contenido del archivo, no solo según el nombre. ## JSON [#json] Pensado para datos estructurados que aporta una integración con otro sistema. Tus compañeros rara vez lo rellenan en el formulario. Con **Tamaño máximo (KB)** configuras un límite, por defecto 64 KB y como máximo 256 KB. ## Ajustes para cada tipo [#instellingen-voor-elk-type] | Ajuste | Qué hace | |---|---| | **Cifrar este valor** | Guarda el valor cifrado. Un campo cifrado no se puede buscar, filtrar ni ordenar y no está disponible como variable en las automatizaciones. Solo para campos de nivel superior, es decir, no para subcampos. Todos los campos personalizados se guardan cifrados de todos modos, actives esto o no | | **Solo API** | Oculta el campo en los formularios y en las vistas de detalle. Una integración lo rellena mediante la API. Un campo así no puede ser obligatorio | | **Solo API, solo lectura** | Muestra el campo, pero desactivado, para que tus compañeros vean el valor pero no lo cambien | | **Reglas de validación** | Compara una fecha, un número o un importe con otro campo (**Antes**, **En o antes de**, **Después**, **En o después de**, con un desplazamiento en días, semanas o meses), o comprueba el valor con una expresión. Un máximo de 10 reglas por campo | Un límite modificado no se aplica con carácter retroactivo. Un valor que no cambias no impide guardar el registro, aunque ya no cumpla la nueva regla. # Visibilidad y acceso (/es-ES/eigen-velden/zichtbaarheid-en-toegang) Un campo personalizado aparece en el formulario del registro al que pertenece. Por defecto, cualquiera con acceso a ese registro puede ver y rellenar el campo. Puedes restringirlo campo por campo. ## Dónde ves los valores [#waar-je-de-waarden-ziet] Rellenas los campos personalizados en el mismo sitio que el resto de los datos del registro. | Registro | Dónde | |---|---| | Cliente | El bloque **Datos del cliente** del perfil del cliente | | Parcela, contador, ocupación, reserva, producto, documento, método de acceso | El formulario para crear o editar el registro | | Tarea | La ventana de la tarea. Los cambios se guardan con **Guardar campos** | Un campo aparece en la posición que elegiste en **Posición en el formulario**. Si no eliges ninguna, aparece después de los campos estándar. Si un campo es obligatorio, no puedes guardar el registro mientras esté vacío. Un campo con **Visibilidad** solo aparece cuando se cumple la condición. Los campos personalizados también están en la exportación de clientes y parcelas y puedes usarlos en automatizaciones. ## Quién puede ver o editar un campo [#wie-mag-een-veld-zien-of-bewerken] Abre el campo en Configuración > Campos personalizados y ve a **4. Acceso**. Haz clic en **Restringir**. Hay dos bloques. | Bloque | Qué hace | |---|---| | **Quién puede ver este campo** | Si lo dejas vacío, cualquier miembro puede verlo. Quien no puede verlo nunca ve el valor, ni siquiera en exportaciones o en automatizaciones que edite | | **Quién puede editar este campo** | Si lo dejas vacío, cualquiera que vea el campo también puede editarlo. Los demás lo ven en solo lectura | En cada bloque eliges un **compañero o grupo** y/o un **permiso**. Si alguien coincide con alguno de los compañeros, grupos o permisos elegidos, tiene acceso. Solo puedes editar un campo si también puedes verlo. En la lista, un campo así recibe la etiqueta **Restringido**. Pasa el cursor por encima para ver la explicación: solo determinados compañeros, grupos o permisos pueden ver o editar este campo. La opción **Visibilidad** (una condición) solo oculta un campo en el formulario. Quien puede ver el campo todavía puede encontrar el valor. Usa **Quién puede ver este campo** si nadie más debe poder leerlo. ## Quién puede gestionar los campos [#wie-mag-velden-beheren] Crear, modificar, reordenar y eliminar campos y gestionar listas de opciones requiere el permiso **Gestionar campos personalizados**. Cómo se asignan los permisos se explica en [Invitar a usuarios y asignar permisos](/gebruikers/gebruikers-en-rechten). La página **Campos personalizados** es visible para quien puede ver o editar la configuración, o tiene este permiso. Sin el permiso solo ves los campos que puedes leer, y **Nuevo campo**, editar y eliminar están desactivados. ## ¿Problemas? [#problemen] Comprueba en **Quién puede ver este campo** si ese compañero, su grupo o uno de sus permisos está seleccionado. Si el campo es un campo **Solo API**, no aparece en los formularios. Mira en **Quién puede editar este campo**. Si hay compañeros, grupos o permisos seleccionados, los demás solo pueden leer. Si alguien intenta modificar el valor de todos modos, Tillor lo rechaza. # Crear y editar una factura (/es-ES/facturen/aanmaken-en-bewerken) Una factura nueva siempre es un borrador: la creas en el perfil del cliente y rellenas las líneas. Mientras sea un borrador, puedes añadir, modificar, mover y eliminar líneas. Después la [contabilizas](/facturen/boeken). Antes de empezar: - El cliente ya existe en Tillor. Consulta [Gestión de clientes](/klantenbeheer). - Para productos con parcela u ocupación, el cliente tiene una ocupación en esa parcela. Sin ocupación creas una oferta que no puedes contabilizar. ## Crear una factura [#een-factuur-aanmaken] Las facturas se crean en el perfil del cliente, no desde Administración > Facturas. ### Abre el cliente [#open-de-klant] Ve a Clientes > Resumen y abre el perfil del cliente. ### Crea la factura [#maak-de-factuur-aan] En el bloque **Facturas** haz clic en **Nueva factura**. Tillor crea una factura en borrador y abre enseguida la página de la factura. La factura recibe un número de borrador provisional. El número de factura definitivo, la fecha de factura y la fecha de vencimiento llegan al [contabilizar](/facturen/boeken). ## Añadir y modificar líneas [#regels-toevoegen-en-aanpassen] En la página de la factura hay una tabla con las líneas de factura. Abajo hay una fila vacía en la que empiezas una línea nueva. ### Elige un producto o escribe una descripción [#kies-een-product-of-typ-een-omschrijving] Elige un **Producto** de la lista y Tillor rellena la **Descripción** y el precio. También puedes escribir tú mismo una descripción. ### Rellena cantidad y precio [#vul-aantal-en-prijs-in] Ajusta la **Cantidad** y el **Precio (IVA incl.)** por unidad cuando haga falta. El **Total** de la línea se calcula automáticamente. Si tu organización tiene activado el IVA por línea, eliges también el tipo de IVA. ### Añade una nota (opcional) [#voeg-een-notitie-toe-optioneel] Debajo de la tabla puedes rellenar una **Nota (opcional)**. Ese texto aparece en la factura y es visible para el cliente. Los cambios se guardan automáticamente casi al instante. También puedes hacer clic en **Guardar cambios**, o en **Cancelar** para deshacer los cambios no guardados. ### Reordenar o eliminar líneas [#regels-herschikken-of-verwijderen] - Arrastra una línea con el asa de su izquierda para cambiar el orden. - Haz clic en la cruz a la derecha de una línea para eliminarla. En la cronología **Eventos** junto a la factura ves qué se cambió y cuándo, con el antes y el después de los campos y las líneas. ## Líneas con una acción [#regels-met-een-actie] Si el producto elegido tiene una acción en la línea de factura, debajo de la línea aparecen campos adicionales. Qué acciones tiene un producto se configura en el propio producto. Consulta [Acciones de producto](/producten/productacties). | Acción | Qué rellenas en la factura | |-------|-----------------------------| | **Recargar etiqueta NFC** | La etiqueta que se debe recargar. Tras el pago, Tillor suma el importe al saldo de la etiqueta. | | **Periodo** | Fecha de inicio y de fin y, en un producto con parcela, también la **Parcela** (en una lista o con **Elegir en el mapa**). | | **Prolongar periodo de ocupación** | La parcela para la que prolongas la ocupación, más fecha de inicio y de fin. | | **Solicitar datos de contacto** | Correo electrónico y teléfono del cliente. Si son obligatorios, no puedes contabilizar sin ellos. | | **Crear método de acceso** | El tipo de método de acceso y, si procede, una matrícula o un PIN. | | **Mostrar alerta** | Nada. Solo ves un aviso con el texto configurado en el producto. | | **Impedir reserva** | Nada. La factura no se puede contabilizar mientras la línea esté en ella. | ### Elegir periodo y parcela [#periode-en-terrein-kiezen] En una línea con **Periodo** eliges una fecha de inicio y de fin. Debajo ves el número de días y la **Cantidad** que cobra Tillor. Si el periodo no encaja exactamente con una semana o un mes del producto, Tillor redondea al alza y aparece **Redondeado al alza**. Con la casilla **Prorrata** cobras en cambio una semana o un mes parcial de forma proporcional. Esa casilla solo aparece en productos con periodo semanal o mensual. Si el producto pide una parcela, eliges primero el periodo y después la **Parcela**. Al contabilizar, Tillor crea la reserva. En la línea aparece entonces una tarjeta con número de reserva, estado, parcela y fechas. Si el cliente registra la entrada enseguida depende del producto: con **Registrar entrada al reservar** ocurre al contabilizar, con **Registrar la entrada al pagar** solo cuando la factura está pagada. Un anticipo solo reserva la parcela. ### Prolongar una ocupación [#een-bezetting-verlengen] Con **Prolongar periodo de ocupación** facturas un periodo para una ocupación del cliente, por ejemplo la cuota de estacionamiento. ### Elige la parcela [#kies-het-terrein] En **Seleccione una ocupación activa** elige la parcela. La lista muestra las ocupaciones activas del cliente. ### Elige el periodo [#kies-de-periode] Elige la **Fecha de inicio**. Después Tillor abre enseguida el calendario para la **Fecha de fin**. Debajo de las fechas ves hasta cuándo está facturada ahora la ocupación y cuántos días y qué cantidad abarca la línea. ### Configura el redondeo [#stel-het-afronden-in] La casilla **Redondear al límite del periodo siguiente** está activada por defecto. Entonces la línea termina en el siguiente límite de periodo de la frecuencia de alquiler, de modo que el cliente siga a largo plazo el mismo ciclo. Con la casilla desactivada, la línea dura exactamente un periodo desde la fecha de inicio. La línea recibe una descripción con el formato **Nombre del producto | Nombre de la parcela | Periodo**. La fecha de fin cuenta como último día, y un medio periodo también se cobra a la mitad. Si la ocupación ya tiene una fecha **Pagado hasta** y el redondeo está activado, la nueva línea empieza al día siguiente. Si **Pagado hasta** está todavía vacío, eliges tú la fecha de inicio y Tillor calcula la fecha de fin hasta el siguiente límite de periodo. Lo que ocurre con **Pagado hasta** y **Facturado hasta** después de contabilizar y pagar se explica en [Ocupaciones](/bezettingen). Dos casillas adicionales ayudan en situaciones excepcionales: - **Mostrar todas las parcelas (oferta)** te permite elegir cualquier parcela para crear una oferta. Si el cliente no tiene ocupación en esa parcela, no puedes contabilizar la factura. Los usuarios con el permiso **Correcciones de facturas** pueden contabilizar igualmente una factura así, consulta [Contabilizar una factura](/facturen/boeken#problemen). - **Marcar como abono (reembolso)** convierte la línea en un reembolso. La cantidad pasa a ser negativa y el periodo va desde hoy hasta **Pagado hasta**. Con **Redondear al límite del periodo** lo redondeas a un límite de periodo. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Los cambios se guardan automáticamente casi al instante. La cronología **Eventos** muestra quién cambió qué. - No se envía nada al cliente y no cambia nada en ocupaciones ni etiquetas. Eso ocurre solo al [contabilizar](/facturen/boeken) y con el pago. - Un borrador con una línea **Impedir reserva** no se puede contabilizar. - Un borrador se elimina con **Eliminar factura** en el menú de acciones. ## ¿Problemas? [#problemen] Solo las facturas en borrador se pueden editar. Una factura contabilizada se puede volver a pasar a borrador bajo ciertas condiciones, consulta [Corregir una factura](/facturen/corrigeren#terugzetten-naar-concept). El cliente no tiene ninguna etiqueta disponible. Vincula primero una etiqueta NFC al cliente. Consulta [NFC](/nfc). El botón está en el perfil del cliente, en el bloque **Facturas**, no en la lista de facturas de **Administración**. En **Prolongar periodo de ocupación** la lista solo muestra ocupaciones activas del cliente. Crea primero una ocupación, consulta [Ocupaciones](/bezettingen), o usa **Mostrar todas las parcelas (oferta)** para una oferta. ## Más información [#verder] # Imprimir, descargar o compartir una factura (/es-ES/facturen/afdrukken-en-downloaden) Con **Imprimir** imprimes una factura, la guardas como PDF o la envías a una impresora. El botón está en todas las páginas de factura, también en un borrador. La flecha junto a él abre un menú con las demás opciones. Un enlace para el cliente lo creas en [Compartir un enlace personal](#een-persoonlijke-link-delen). Antes de empezar: para las opciones de impresora, hay una Tillor Connector en marcha para tu organización. Sin conector, esas opciones aparecen en gris. ## Imprimir o guardar [#afdrukken-of-opslaan] | Opción | Qué hace | |-------|--------------| | **Imprimir** | Abre la ventana de impresión de tu navegador. También puedes usar el atajo Ctrl+P (Cmd+P en Mac). | | **Abrir en nueva ventana** | Muestra el PDF en una ventana nueva. | | **Descargar PDF** | Guarda la factura como archivo PDF. | | **Enviar a impresora A4** | Envía la factura a tu impresora A4 conectada. | | **Enviar a impresora de tickets** | Envía la factura a tu impresora de tickets conectada. | Las dos opciones de impresora están en gris mientras no haya una Tillor Connector activa para tu organización. Cómo se configuran las impresoras se explica en [Impresora](/printer). ## Mostrar la factura en una tableta [#de-factuur-tonen-op-een-tablet] Si hay una tableta en el mostrador que muestra documentos del cliente, puedes hacer que la factura aparezca allí. Abre los tres puntos arriba a la derecha de la página de la factura y elige **Vista previa en iPad**. En un pago en efectivo, el mismo botón también está en la ventana de pago. ## Compartir un enlace personal [#een-persoonlijke-link-delen] En una factura contabilizada puedes crear un enlace que el cliente mismo puede abrir para ver la factura y, si queda algo pendiente, pagar en línea. ### Abre el menú de acciones [#open-het-actiemenu] Haz clic en los tres puntos arriba a la derecha de la página de la factura y elige **URL personal**. ### Comparte el enlace [#deel-de-link] Tillor copia el enlace al portapapeles y muestra el aviso **URL generada**. Pégalo en un mensaje o correo al cliente. El menú de acciones contiene más opciones. Consulta [Corregir una factura](/facturen/corrigeren) para copiar, rectificar y recalcular una factura. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Imprimir, descargar y enviar a la impresora no cambian nada en la factura. - Con **Vista previa en iPad** el cliente ve la factura en la tableta. En la cronología de la factura consta que el PDF se envió a la tableta. - El enlace personal no tiene fecha de caducidad. El cliente ve el importe pendiente y puede pagar en línea. Consulta [Dejar que un cliente pague en línea](/betalingsverwerking/online). - Los productos también pueden imprimir automáticamente al pagar. Consulta [Acciones de producto](/producten/productacties#thermisch-printen-en-a4-printen). ## ¿Problemas? [#problemen] No hay ninguna Tillor Connector activa para tu organización. Comprueba la conexión y los ajustes de la impresora, consulta [Impresora](/printer). Esa opción solo está en el menú de acciones de una factura contabilizada. Tillor muestra entonces un aviso con el motivo, por ejemplo que se ha acabado el papel o el tóner. Resuélvelo e inténtalo de nuevo. ## Más información [#verder] # Registrar un pago (/es-ES/facturen/betalingen-registreren) En una factura contabilizada con un importe pendiente realizas un pago o lo registras, por ejemplo un pago con tarjeta, en efectivo o un cobro por domiciliación. El importe, el estado de pago y la lista **Pagos** junto a la factura se actualizan después. Todos los métodos están también en [Procesamiento de pagos](/betalingsverwerking). Antes de empezar: - La factura está contabilizada y aún queda un importe pendiente. Si no, falta **Realizar pago**. - Para **Terminal** hay Mollie vinculado. Para **Mandato SEPA** el cliente tiene un mandato activo. Si no, el método no aparece en la lista o está en gris. ## Realizar un pago [#een-betaling-uitvoeren] ### Abre la factura contabilizada [#open-de-geboekte-factuur] Ve a Administración > Facturas y abre una factura contabilizada. El botón **Realizar pago** está ahí mientras quede un importe pendiente. ### Elige el método de pago [#kies-de-betaalmethode] Haz clic en **Realizar pago** y elige un **Método de pago**. | Método | Lo usas para | |---------|-----------------| | **Terminal** | Un pago con tarjeta. Eliges un terminal de pago y Tillor le envía el pago. Consulta [Terminal](/betalingsverwerking/terminal). | | **Transferencia interna** | Mover el importe a otra factura contabilizada del mismo cliente (**Factura de destino**). Consulta [Transferencia interna](/betalingsverwerking/interne-overboeking). | | **Efectivo** | Registrar un pago en efectivo. Consulta [Efectivo](/betalingsverwerking/contant). | | **Transferencia** | Registrar una transferencia bancaria recibida. | | **Mandato SEPA** | Un cobro por domiciliación mediante un **Mandato** activo del cliente. Consulta [Mandato](/betalingsverwerking/mandaat). | | **Otros** | Otra forma de pago, como un cheque. Está detrás de **Más métodos de pago** y solo es visible si lo has activado. Entonces la descripción es obligatoria. | **Terminal** y **Mandato SEPA** solo aparecen si están disponibles para tu organización. **Mandato SEPA** está en gris mientras el cliente no tenga un mandato activo, y no existe para facturas de abono. ### Rellena el importe [#vul-het-bedrag-in] El **Importe** viene por defecto con el importe pendiente completo. Escribe otro importe o usa los botones **25%**, **50%**, **75%** y **100%**. El importe no puede ser superior a lo pendiente. ### Rellena los campos adicionales [#vul-de-extra-velden-in] En **Efectivo**, **Transferencia** y **Otros** rellenas opcionalmente la **Fecha de recepción** (no en el futuro) y un **Comentario**. En un cobro por domiciliación eliges el **Mandato** y, si quieres, un **Retraso (días)**, donde 0 lo envía enseguida. Si eliges **Transferencia** y el cliente tiene correo electrónico, puedes marcar **Enviar recordatorio de comunicación estructurada**. El cliente recibe entonces un correo con la sugerencia de usar la comunicación estructurada en los siguientes pagos. ### Realiza el pago [#voer-de-betaling-uit] Haz clic en **Realizar pago**. En **Efectivo** hay también un botón **Vista previa en iPad** para mostrar la factura al cliente en una tableta vinculada. ## Importes máximos [#maximumbedragen] Un pago en efectivo no puede superar el **Máximo en efectivo** de Soporte > Configuración > Pagos (por defecto 2999 euros). En un cobro por domiciliación, el importe no puede superar el máximo del mandato. ## Vincular un pago existente [#een-bestaande-betaling-koppelen] Si ya ha entrado un pago o una transacción bancaria que corresponde a esta factura, lo vinculas en lugar de crear uno nuevo. ### Abre el menú de acciones [#open-het-actiemenu] Haz clic en los tres puntos arriba a la derecha de la página de la factura y elige **Asignar pago**. ### Elige el pago [#kies-de-betaling] En la ventana, elige un pago o grupo. En las pestañas **Grupos de pago**, **Pagos con tarjeta y en línea** y **Transacciones bancarias** está lo que hay disponible. Arriba hay sugerencias que coinciden con el importe pendiente. ### Vincula [#koppel] Haz clic en **Asignar pago**, **Asignar grupo** o **Asignar transacción bancaria**, según lo que hayas elegido. Para transacciones bancarias necesitas además el permiso **Ver transacciones bancarias**. ## Crear un enlace para un pago parcial [#een-link-voor-een-deelbetaling-maken] Si el cliente solo quiere pagar una parte del importe pendiente, creas un enlace de pago por un importe que tú eliges. Es posible en cualquier factura contabilizada con un importe pendiente. ### Abre el menú de acciones [#open-het-actiemenu-1] Haz clic en los tres puntos junto a **Enviar notificación** y elige **Enlace de pago parcial**. ### Rellena el importe [#vul-het-bedrag-in-1] En **Importe** escribe lo que el cliente puede pagar. El importe debe ser mayor que 0 y no puede superar lo que aún está pendiente. ### Crea el enlace [#maak-de-link] Haz clic en **Crear y copiar el enlace**. Tillor copia el enlace al portapapeles y lo muestra en **Enlace de pago**. Con el botón de copiar junto a él lo copias de nuevo. Envía tú mismo el enlace al cliente, por ejemplo por correo o chat. El cliente abre la página de pago normal de la factura, pero ahora solo pide tu importe, con el aviso de que es un pago parcial del importe que aún está pendiente. El cliente paga entonces del modo que elija en [la página de pago](/betalingsverwerking/online). El enlace sigue siendo válido, pero nunca pide más de lo que está pendiente en ese momento. Si entretanto ya se ha pagado una parte, la página de pago se ajusta a la baja. Tras un pago, la factura queda en Parcial hasta que entra el importe completo. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El importe pendiente baja y el estado de pago cambia: Parcial mientras quede algo pendiente, Pagada cuando ha entrado todo. - En un cobro por domiciliación o un pago con tarjeta, la factura está primero en Pendiente hasta que el dinero entra definitivamente. - Si una línea tiene una acción de pago, Tillor la ejecuta en cuanto la factura está pagada. Por ejemplo recargar una etiqueta NFC, prolongar **Pagado hasta** de una ocupación o imprimir un ticket. Consulta [¿Cómo encaja todo?](/producten#hoe-hangt-dit-samen). - El pago aparece en el informe de pagos del día. Consulta [Informes de pagos](/boekhouden/betalingsrapporten). ## ¿Problemas? [#problemen] La factura debe estar contabilizada y debe quedar un importe pendiente. En una factura en borrador no puedes pagar. La factura debe estar contabilizada y debe quedar aún un importe pendiente. El cliente no tiene un mandato activo. Configúralo en los datos del cliente, consulta [Mandato](/betalingsverwerking/mandaat). Ese método de pago está desactivado por defecto. Activa **Mostrar método de pago "Otros"** en Soporte > Configuración > Pagos. El pago se ha iniciado, por ejemplo un cobro por domiciliación, pero el dinero aún no ha entrado definitivamente. En cuanto se procesa el pago, el estado pasa a **Pagada**. Consulta [Estados](/facturen/statussen). ## Más información [#verder] # Contabilizar una factura (/es-ES/facturen/boeken) Contabilizar convierte un borrador en una factura definitiva con su propio número de factura. Solo después puedes [enviar](/facturen/versturen) la factura y [cobrarla](/facturen/betalingen-registreren). Revisa por tanto las líneas antes de contabilizar, porque una factura contabilizada ya no se puede modificar libremente. Antes de empezar: - La factura tiene al menos una línea, o un total distinto de cero. - Las líneas con **Periodo** o **Prolongar periodo de ocupación** tienen fecha de inicio y de fin. - Si una línea tiene una acción que pide datos, están rellenados. Piensa en **Solicitar datos de contacto** o **Crear método de acceso**. - Para un cliente belga con número de IVA, hay un Peppol ID rellenado. Consulta [Peppol](/boekhouden/peppol). Si algo falla, **Contabilizar factura** está en gris. Pasa el ratón por encima del botón para leer el motivo. Consulta también [¿Problemas?](#problemen). ## Contabilizar una factura [#een-factuur-boeken] ### Abre la factura en borrador [#open-de-conceptfactuur] Ve a Administración > Facturas y abre una factura con estado Borrador, por ejemplo desde la lista **Borradores**. ### Revisa la factura [#controleer-de-factuur] Repasa las líneas y la nota. ### Haz clic en Contabilizar factura [#klik-op-boek-factuur] La factura recibe un número de factura correlativo. Tillor avisa de que la factura se ha contabilizado. ## ¿Qué cambia? [#wat-verandert-er] Así se ve una factura antes y después de contabilizar. Son dos facturas de ejemplo distintas, pero se ve la diferencia en número, estado y botones. **Antes de contabilizar**: un número de borrador provisional y el botón **Contabilizar factura**. **Después de contabilizar**: un número de factura definitivo, un estado de pago y los botones **Realizar pago** y **Enviar notificación**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La **fecha de factura** es el día de la contabilización. La **fecha de vencimiento** es ese día más el **Vencimiento predeterminado (días)** de tu organización, por defecto 7 días. Lo ajustas en Soporte > Configuración > Facturación. - Si el total no es múltiplo de 5 céntimos, Tillor añade por sí mismo una línea **Redondeo**. - Si la factura tiene un total negativo, pasa a ser una **Factura de abono**. - Si el cliente tiene un Peppol ID, Tillor envía la factura automáticamente por Peppol. Consulta [Peppol](/boekhouden/peppol). - Las líneas con **Prolongar periodo de ocupación** fijan **Facturado hasta** de la ocupación al final de la línea. **Pagado hasta** llega solo con el pago. Consulta [¿Cómo encaja todo?](/producten#hoe-hangt-dit-samen). - Las líneas con **Periodo** y **Pedir parcela** crean una reserva. Si el cliente registra la entrada enseguida depende del producto. - Si hay un mandato de domiciliación vinculado, Tillor crea enseguida un pago pendiente. El banco cobra dos días después de contabilizar. - El cliente no recibe nada automáticamente. La notificación la envías tú, consulta [Enviar una factura](/facturen/versturen). - ¿Quieres cambiar algo todavía? Dentro de 7 días y mientras no se haya enviado nada, [vuelve a pasar](/facturen/corrigeren#terugzetten-naar-concept) la factura a borrador. ## Elegir otro plazo de pago [#een-andere-betaaltermijn-kiezen] Si la fecha de vencimiento difiere de tu valor por defecto, no hace falta configurarlo de antemano. ### Abre el menú desplegable [#open-het-keuzemenu] Haz clic en la flecha junto a **Contabilizar factura** y elige **Condiciones de pago personalizadas…**. ### Elige el plazo [#kies-de-termijn] En **Condiciones de pago** elige una opción, desde **Vencimiento en la fecha de factura** hasta **Neto 60 días**. Ves enseguida la **Fecha de vencimiento estimada**. ### Contabiliza [#boek] Haz clic en **Contabilizar factura**. ## Enviar a tu contabilidad [#doorsturen-naar-je-boekhouding] El envío a tu software de contabilidad normalmente ocurre solo. Si quieres reiniciarlo, por ejemplo tras un error, puedes hacerlo por factura. Abre la factura contabilizada, haz clic en los tres puntos arriba a la derecha y elige **Enviar a software contable**. Qué sistemas están disponibles lo lees en [Contabilidad](/boekhouden). [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) está disponible bajo petición. ## ¿Problemas? [#problemen] Pasa el ratón por el botón. Tillor indica el motivo. Los más habituales están a continuación. El producto de esa línea no permite contabilizar. Elimina la línea o elige otro producto. A una línea con **Periodo** o **Prolongar periodo de ocupación** le falta una fecha. Rellena la fecha de inicio y de fin. Añade una línea, o asegúrate de que el total no sea cero. En las líneas con **Solicitar datos de contacto** rellena los campos obligatorios. En las líneas con **Crear método de acceso** elige un tipo y, en el reconocimiento de matrículas, también la matrícula. Una factura así es una oferta y no puedes contabilizarla. Haz que el cliente ocupe primero la parcela. Si tienes el permiso **Correcciones de facturas**, con la flecha junto a **Contabilizar factura** puedes elegir **Forzar contabilización**. La ocupación solo se prolonga entonces en cuanto el cliente ocupa la parcela. El importe de la factura no puede superar el importe máximo del mandato vinculado. Ajusta el mandato en **Mandato de domiciliación** dentro de **Información de la factura** junto a la factura, o reduce el importe. Consulta [Mandato SEPA](/betalingsverwerking/mandaat). Un producto con cuenta vigilada (por ejemplo una fianza) no puede dejar el saldo del cliente por debajo de cero. Si tienes el permiso **Anular el saldo de la cuenta**, puedes contabilizar igualmente indicando un motivo. Consulta [Vigilar el saldo del cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). Para un cliente belga con número de IVA debe constar un Peppol ID. Abre Clientes > cliente > Facturación, ve a **Configuración de facturación** y rellena el ID. Consulta [Peppol](/boekhouden/peppol). ## Véase también [#zie-ook] # Corregir una factura (/es-ES/facturen/corrigeren) Una factura contabilizada no se puede modificar sin más. La vía que elijas depende de hasta dónde haya llegado la factura. Todas las correcciones salvo volver a pasar a borrador están en el menú de acciones (tres puntos) junto a **Enviar notificación**. | Situación | Qué haces | |----------|-------------| | La factura acaba de contabilizarse y aún no se ha enviado | [Volver a borrador](#terugzetten-naar-concept) | | La factura ya se ha enviado o es demasiado antigua | [Rectificar](#een-factuur-omkeren) con una factura de abono | | Quieres reutilizar las mismas líneas | [Copiar](#een-factuur-kopiëren) | | La factura está a nombre del cliente equivocado | [Mover](#een-factuur-verplaatsen-naar-een-andere-klant) | | Los importes no cuadran | [Recalcular](#een-factuur-herberekenen) | ## Volver a borrador [#terugzetten-naar-concept] Mientras la factura aún no ha salido, la vuelves a pasar a borrador y la contabilizas de nuevo tras tu cambio. Es posible si se cumple todo lo siguiente: - La factura está contabilizada. - Tillor aún no ha enviado ninguna notificación por ella, por el canal que sea. - La factura no se ha enviado por Peppol. - La fecha de factura es de hace menos de 7 días. ### Abre la factura contabilizada [#open-de-geboekte-factuur] Ve a Administración > Facturas y abre la factura. ### Vuelve a pasarla a borrador [#zet-hem-terug] Haz clic en **Volver a borrador** y confirma con **Sí, revertir a borrador**. Si el botón no está, la factura no cumple las condiciones. ### Modifica la factura y contabiliza de nuevo [#pas-de-factuur-aan-en-boek-opnieuw] Cambia las líneas y haz clic en **Contabilizar factura**. Mientras tanto, la factura tiene un número de borrador con el número original entre paréntesis. La línea **Redondeo** se quita y vuelve al contabilizar de nuevo. Al contabilizar de nuevo, la factura recupera su número original, con la fecha de factura y la fecha de vencimiento originales. Un borrador que procede de una factura contabilizada no se puede eliminar. Tras volver a pasar a borrador, en la cronología **Eventos** aparece en ese evento un botón **Restaurar versión**. Con él sustituyes las líneas actuales por las líneas tal como estaban en el momento de volver a borrador. Si la factura está contabilizada de nuevo, Tillor la vuelve a pasar primero a borrador. Si la factura ya se ha impreso, mostrado al cliente o compartido de otro modo, ten cuidado. El cliente tiene entonces una versión que dejará de ser correcta. ### Cuando ya no se puede volver a borrador [#als-terugzetten-niet-meer-kan] Si la factura ya no cumple las condiciones, por ejemplo porque ya se envió una notificación o la factura tiene más de 7 días, con el permiso **Correcciones de facturas** puedes volver a pasarla a borrador igualmente. Abre los tres puntos arriba a la derecha de la página de la factura y elige **Forzar reversión a borrador**. Úsalo solo si es posible jurídica y contablemente. Una factura de abono mediante [rectificación](#een-factuur-omkeren) suele ser la solución más limpia. ## Rectificar una factura [#een-factuur-omkeren] Con la rectificación creas una factura de abono que anula una factura contabilizada. Funciona siempre, incluso si la factura ya se ha enviado o pagado. ### Rectifica la factura [#keer-de-factuur-om] Abre los tres puntos arriba a la derecha de la factura contabilizada y elige **Rectificar factura**. Tillor crea un borrador nuevo con las mismas líneas en importes negativos y lo abre. ### Revisa y contabiliza [#controleer-en-boek] Ajusta el borrador si hace falta y haz clic en **Contabilizar factura**. Pasa entonces a ser una **Factura de abono**. Las dos facturas se referencian entre sí. En la **Información de la factura** consta en la factura de abono **Rectificación de** y en la factura original **Rectificada como**. En la lista de facturas del perfil del cliente ves en el borrador la etiqueta **Borrador de reversión** y en la factura original **Esta factura fue revertida**. Si ya habías rectificado antes una factura, Tillor pide confirmación con **Sí, anular de nuevo**, para que no crees dos facturas de abono por error. Si quieres compensar la factura de abono con la factura original, elige **Transferencia interna** al pagar. Consulta [Transferencia interna](/betalingsverwerking/interne-overboeking). ## Copiar una factura [#een-factuur-kopiëren] Elige **Copiar factura** en el menú de acciones de una factura contabilizada. Tillor crea un borrador nuevo con las mismas líneas, la misma nota y el mismo mandato de domiciliación, y lo abre. La línea **Redondeo** no se copia. ## Mover una factura a otro cliente [#een-factuur-verplaatsen-naar-een-andere-klant] Si una factura está a nombre del cliente equivocado, la mueves. ### Abre el menú de acciones [#open-het-actiemenu] Haz clic en los tres puntos arriba a la derecha de la página de la factura y elige **Mover a cliente**. ### Elige el cliente [#kies-de-klant] Elige el **Cliente destino** y haz clic en **Mover factura**. La factura se traslada junto con los pagos vinculados, los lotes de contador y los comentarios. Una factura contabilizada se envía después de nuevo a tu contabilidad. Si la factura ya se ha enviado por Peppol, no puedes moverla. ## Recalcular una factura [#een-factuur-herberekenen] Si los importes de una factura contabilizada no cuadran con las líneas, elige **Recalcular factura** en el menú de acciones. Tillor vuelve a calcular los totales. ## Eliminar un borrador [#een-concept-verwijderen] Una factura en borrador se puede eliminar con **Eliminar factura** en el menú de acciones. Vuelves entonces al perfil del cliente. Las facturas contabilizadas no se pueden eliminar, esas se rectifican. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] | Vía | Consecuencia | |-------|--------| | Volver a borrador | El número de factura se conserva. Al contabilizar de nuevo, la factura recupera su número y fechas originales. | | Rectificar | Se crea una factura de abono que remite a la factura original. Se puede compensar con una [transferencia interna](/betalingsverwerking/interne-overboeking). | | Copiar | Se crea un borrador nuevo. La factura original no cambia. | | Mover | Pagos, lotes de contador y comentarios se trasladan con ella. Una factura contabilizada vuelve a ir a tu contabilidad. | | Recalcular | Los totales se vuelven a calcular a partir de las líneas. | ## ¿Problemas? [#problemen] No se cumple una de las condiciones. ¿Ya se ha enviado una notificación o la factura tiene 7 días o más? Entonces puedes rectificar o, con el permiso **Correcciones de facturas**, volver a borrador de forma forzada. Para ello necesitas el permiso **Correcciones de facturas**. Si la factura se ha enviado por Peppol, no se puede mover. Los configura un administrador. Consulta [Usuarios](/gebruikers). ## Más información [#verder] # Resumen (/es-ES/facturen) En Administración > Facturas encuentras todas las facturas de tu parque, con los importes pendientes arriba. Una factura empieza como borrador y solo es definitiva cuando la contabilizas. Después puedes enviarla, cobrarla y, si hace falta, corregirla. - Una factura nueva se crea en el perfil del cliente, no desde esta lista. - Una factura contabilizada recibe una fecha de vencimiento: el día de la contabilización más el plazo de vencimiento predeterminado de tu organización, por defecto 7 días. Puedes elegir otro plazo por factura. - Si el total no es múltiplo de 5 céntimos, Tillor añade al contabilizar una línea **Redondeo**. - Tillor no envía por sí misma una factura contabilizada al cliente. Eso lo haces tú con **Enviar notificación**. - Volver a borrador es posible hasta 7 días después de la fecha de factura, mientras no se haya enviado ninguna notificación y la factura no se haya enviado por Peppol. Después, rectificas la factura con una factura de abono. - Un pago en efectivo puede ser, por defecto, de 2999 euros como máximo. Lo ajustas con **Máximo en efectivo** en Soporte > Configuración > Pagos. - Un cobro por domiciliación con un mandato SEPA sale hacia el banco dos días después de contabilizar. Hasta entonces puedes cancelar el pago. - El enlace personal de una factura no tiene fecha de caducidad. El cliente ve en él lo que aún está pendiente. - Si el cliente tiene un Peppol ID, Tillor envía la factura automáticamente por Peppol tras contabilizarla. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Una factura es el comienzo de una cadena. Un pago depende de una factura contabilizada, los pagos de un día van a un informe de pagos y ese informe va a tu contabilidad. ```mermaid flowchart LR A[Conceptfactuur] -- Boeken --> B[Geboekte factuur] B -- Verstuur notificatie --> K[Klant ontvangt de factuur] K -- Klant betaalt online --> C[Betaling] B -- Jij registreert een betaling --> C C -- Saldo en betalingsstatus --> B C -- Per dag gebundeld --> D[Betalingsrapport] D -- Mollie en interne overboekingen --> E[Boekhouding] ``` - El saldo pendiente y el estado de pago de la factura se derivan solos de los pagos. - Un pago sin factura se puede vincular más adelante a una factura contabilizada. - Qué pagos van a la contabilidad lo lees en [Contabilidad](/boekhouden). ## La lista de facturas [#de-facturenlijst] Arriba hay cuatro contadores: **Total de facturas**, **Facturas abiertas** (impagadas o parcialmente pagadas), **Facturas vencidas** (fecha de vencimiento superada) y **Total pendiente** (el importe total de las facturas abiertas). Debajo hay cuatro listas: - **Pagos pendientes**: facturas contabilizadas cuyo pago se ha iniciado pero aún no ha entrado definitivamente - **Facturas con saldo pendiente**: facturas contabilizadas con un importe que aún debe pagarse, ordenadas por fecha de vencimiento - **Borradores**: los diez últimos borradores de factura creados - **Todas las facturas**: la lista completa, filtrada por defecto por facturas contabilizadas Las facturas nuevas no se crean desde esta lista. Eso se hace en el perfil del cliente, consulta [Crear una factura](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken). ### Buscar y filtrar [#zoeken-en-filteren] La barra de búsqueda busca por número de factura, nombre o apellido del cliente, correo electrónico e importe. En la lista **Todas las facturas** puedes además filtrar por: | Filtro | Qué haces con él | |--------|-------------------| | **Periodo** | Solo facturas dentro de un periodo determinado | | **Estado** | **Borrador** o **Contabilizada** | | **Estado del pago** | **Impagada**, **Parcial**, **Pendiente** o **Pagada** | | **Tipo de cliente** | **Estándar**, **Caravana de alquiler para trabajador** o **Caravana de remolque para trabajador** | | **Cliente** | Todas las facturas de un cliente | | **Productos** | Facturas con un producto determinado en una línea | | **Importe** | Facturas con un importe mínimo o máximo | En la lista **Facturas con saldo pendiente** está también el filtro **Pendiente de recordatorio**. Eliges un número de días (7 a 90) y ves las facturas vencidas que se crearon hace al menos tanto tiempo y para las que en los últimos días no se ha enviado ningún recordatorio por correo o SMS. Útil para decidir a quién reclamar de nuevo. ### Facturas por cliente [#facturen-per-klant] En un perfil de cliente encuentras todas las facturas de ese cliente en el bloque **Facturas** de la pestaña **Resumen**, o en la pestaña **Facturación**. Ahí también creas una factura nueva. ## Guías [#handleidingen] ## Relacionado [#gerelateerd] ## Conceptos [#begrippen] - **Borrador**: una factura que aún puedes modificar, con un número de borrador provisional. - **Contabilizada**: una factura definitiva con su propio número de factura. Consulta [Contabilizar](/begrippen#boeken). - **Factura de abono**: una factura contabilizada con un total negativo, por ejemplo tras rectificar una factura. - **Estado del pago**: si se ha pagado algo de la factura y cuánto. Consulta [Estados](/facturen/statussen). - **Cliente**: el cliente al que va dirigida la factura. Consulta [Cliente](/begrippen#klant). - **Ocupación**: un cliente en una parcela durante un periodo. Consulta [Ocupación](/begrippen#bezetting). # Estados de factura (/es-ES/facturen/statussen) Cada factura tiene un **estado** (si ya es definitiva) y, en cuanto está contabilizada, un **estado del pago** (cuánto se ha pagado). Ambos se pueden filtrar en la [lista de facturas](/facturen). ## Estado de la factura [#factuurstatus] | Estado | Significado | |--------|-----------| | Borrador | La factura aún se puede editar y tiene un número de borrador provisional. Todavía no puedes enviarla ni cobrarla. | | Contabilizada | La factura es definitiva y tiene su propio número de factura. Puedes enviarla, cobrarla y corregirla. | Un borrador que se ha vuelto a pasar desde una factura contabilizada tiene un número de borrador con el número de factura original entre paréntesis. Consulta [Corregir una factura](/facturen/corrigeren). ## Estado del pago [#betalingsstatus] El estado del pago aparece junto al número de factura de una factura contabilizada. | Estado | Significado | |--------|-----------| | Impagada | Todavía no se ha pagado nada. | | Parcial | Se ha pagado una parte y aún queda un importe pendiente. | | Pendiente | Se ha iniciado el importe completo, por ejemplo un cobro por domiciliación, pero el dinero aún no está procesado definitivamente. | | Pagada | La factura está saldada por completo. | Una factura está **vencida** si la fecha de vencimiento ha pasado y aún queda un importe pendiente. No es un estado aparte. Lo ves en el contador **Facturas vencidas** de la lista de facturas. ## Tipo de factura [#factuurtype] | Tipo | Significado | |------|-----------| | **Factura** | Una factura normal con un total positivo. | | **Factura de abono** | Una factura contabilizada con un total negativo, por ejemplo tras [rectificar una factura](/facturen/corrigeren#een-factuur-omkeren). | ## Etiquetas en la lista del perfil del cliente [#labels-in-de-lijst-op-het-klantprofiel] | Etiqueta | Significado | |-------|-----------| | **Enviada a través de Peppol** | La factura se ha enviado por Peppol. | | **Borrador de reversión** | Este borrador se creó para rectificar otra factura. | | **Esta factura fue revertida** | Existe una factura de abono o un borrador que anula esta factura. | ## Más información [#verder] # Enviar una factura (/es-ES/facturen/versturen) Con **Enviar notificación** envías al cliente una factura contabilizada por correo, SMS, WhatsApp o correo postal. Tillor nunca lo hace por sí misma. Si la factura ya se ha enviado pero aún no está pagada, envías un recordatorio de pago. Después el cliente puede pagar mediante el enlace del mensaje, consulta [Dejar que un cliente pague en línea](/betalingsverwerking/online). Antes de empezar: - La factura está contabilizada. En un borrador faltan los botones. - El cliente tiene al menos un correo electrónico, un teléfono o una dirección postal completa (calle, código postal y municipio). Si no, faltan los botones. - Para un recordatorio de pago, aún queda un importe pendiente. ## Enviar una factura [#een-factuur-versturen] ### Abre la factura contabilizada [#open-de-geboekte-factuur] Ve a Administración > Facturas y abre una factura con estado Contabilizada. ### Haz clic en Enviar notificación [#klik-op-verstuur-notificatie] Se abre una ventana **Enviar notificación**. ### Elige los canales [#kies-de-kanalen] Puedes elegir entre: - **Correo electrónico**: el cliente recibe un correo con la factura adjunta. Está activado por defecto si hay un correo electrónico. - **SMS**: el cliente recibe un mensaje SMS. Solo disponible con un número de teléfono. - **WhatsApp**: solo visible si WhatsApp Business está instalado. Requiere un teléfono, y un método de pago en Meta o una conversación en curso con el cliente. - **Correo postal**: la factura va en PDF por correo postal. Solo disponible con una dirección postal completa. Está desactivado por defecto y muestra un importe indicativo de franqueo por carta. Un canal que no es posible para este cliente aparece desactivado con el motivo, por ejemplo **No hay dirección de correo registrada**. Elige al menos un canal. ### Envía [#verstuur] Haz clic en **Enviar**. ## Enviar un recordatorio de pago [#een-aanmaning-versturen] Un recordatorio de pago es posible en cuanto la factura está contabilizada y aún queda un importe pendiente. ### Abre el menú desplegable [#open-het-keuzemenu] Haz clic en la flecha junto a **Enviar notificación** y elige **Enviar recordatorio**. ### Elige los canales [#kies-de-kanalen-1] Aquí **Correo electrónico** y **SMS** están activados por defecto si el cliente tiene correo electrónico y teléfono. Con **Correo postal** el cliente recibe una carta de recordatorio con la factura adjunta y un código QR para verla o pagarla en línea. ### Elige, si quieres, certificado [#kies-eventueel-aangetekend] Si has marcado **Correo postal**, puedes elegir **Correo certificado con acuse de recibo**. Eso solo es posible en un recordatorio, no en el primer aviso de factura, y solo si el envío certificado está disponible para esa dirección. Tillor muestra entonces el importe adicional indicativo sobre los gastos de franqueo normales. El botón se llama entonces **Enviar con coste adicional**. ### Envía [#verstuur-1] Haz clic en **Enviar**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] En la página de la factura, el bloque **Notificaciones** muestra qué mensajes se han enviado. Todos los mensajes de tu organización están en Comunicaciones > Notificaciones. Los envíos postales empiezan en **Pendiente**. Después sigue el estado de la carta: **PDF recibido**, **Validado**, **Procesando**, **En centro de impresión** y **Entregado al servicio postal**. En cuanto el transportista lo confirma, el estado pasa a **Enviado**. El correo no entregable pasa a **Fallido**. Una carta cancelada en el transportista recibe el estado **Omitido**. Abre el mensaje para ver el importe del franqueo, la referencia del transportista y el último estado de seguimiento. Encontrarás más al respecto en [Notificaciones](/notificaties). - Tillor envía el mensaje enseguida. El cliente recibe un enlace para ver la factura y pagarla en línea. - Un recordatorio de pago sigue siendo una acción suelta por factura. El filtro **Pendiente de recordatorio** de la [lista de facturas](/facturen) te ayuda a elegir a quién reclamar de nuevo. - Las automatizaciones también pueden enviar recordatorios de pago automáticamente. Consulta [Automatizaciones](/automatiseringen). Una factura para la que ya se ha enviado una notificación ya no se puede volver a pasar a borrador fácilmente. Consulta [Corregir una factura](/facturen/corrigeren#terugzetten-naar-concept). ## ¿Problemas? [#problemen] La factura debe estar contabilizada, y el cliente debe tener un correo electrónico, un teléfono o una dirección postal completa. Completa los datos en el perfil del cliente. Un recordatorio de pago solo es posible en una factura contabilizada con un importe pendiente. Abre el mensaje en Comunicaciones > Notificaciones para ver el mensaje de error. Comprueba después el correo electrónico, el teléfono o la dirección postal del cliente y envía de nuevo. Consulta [Notificaciones](/notificaties). ## Más información [#verder] # Invitar usuarios y dar permisos (/es-ES/gebruikers/gebruikers-en-rechten) Un compañero con una cuenta de Tillor se llama usuario en Tillor. Tú decides quién tiene acceso a tu organización y qué puede ver y hacer esa persona, con permisos. Para los compañeros a los que te diriges a menudo en conjunto, crea después un [grupo](/gebruikers/groepen). Antes de empezar: - Necesitas el permiso **Gestionar permisos de usuario**. Sin ese permiso, los botones **Invitar usuario** y **Editar permisos** aparecen en gris. - Solo puedes dar permisos que tú mismo tengas. Un permiso que a ti te falta no puedes activarlo para otra persona. - El propio permiso **Gestionar permisos de usuario** solo puede darlo a otro un usuario con **Todos los permisos**. ## Invitar a un compañero [#een-collega-uitnodigen] ### Abre los usuarios [#open-de-gebruikers] Ve a Soporte > Configuración > Usuarios. Verás los **Miembros** de tu organización y las **Invitaciones pendientes**. ### Haz clic en Invitar usuario [#klik-op-gebruiker-uitnodigen] Se abre la ventana **Invitar usuario**. ### Introduce la dirección de correo [#vul-het-e-mailadres-in] Escribe la **Dirección de correo** de tu compañero y haz clic en **Invitar**. Lo que ocurre después depende de la dirección de correo: El usuario pasa a ser miembro de tu organización de inmediato. Tillor avisa con **Usuario añadido a la organización**. La persona ve tu organización enseguida entre sus organizaciones. Tillor avisa con **Invitación enviada** y manda una invitación por correo. Hasta que la persona inicie sesión por primera vez, aparece en **Invitaciones pendientes** con la insignia **Pendiente**. En el primer inicio de sesión pasa a ser miembro de tu organización. Con **Revocar invitación** retiras la invitación, y Tillor avisa con **Invitación revocada**. Un usuario nuevo empieza con estos permisos: **Ver configuración**, **Editar configuración**, **Ver integraciones**, **Gestionar integraciones**, **Notificaciones de alarmas de contadores**, **Notificaciones de mensajes de la bandeja**, **Alertas de tableta y quiosco**, **Gestionar solicitudes de firma** y **Gestionar campos personalizados**. Comprueba si te parece bien y ajústalo. ## Editar permisos [#rechten-bewerken] ### Haz clic en Editar permisos junto al usuario [#klik-bij-de-gebruiker-op-rechten-bewerken] Se abre la ventana **Editar permisos de usuario**. Arriba aparecen los grupos de los que el usuario es miembro. Con **Buscar permisos** encuentras un permiso rápidamente. ### Activa o desactiva permisos [#zet-rechten-aan-of-uit] Los permisos están agrupados por apartado, como **Facturación**, **Pagos** o **Bandeja de entrada**. Abajo aparece cuántos permisos efectivos tiene el usuario. ### Guarda los permisos [#sla-de-rechten-op] Haz clic en **Guardar permisos**. Tillor avisa con **Permisos de usuario guardados**. ### ¿De dónde viene un permiso? [#waar-komt-een-recht-vandaan] Junto a cada permiso figura su origen. Así ves por qué alguien puede o no puede hacer algo. | Origen | Significado | |---|---| | **Directo** | Diste el permiso directamente a este usuario. Aquí puedes desactivarlo | | Un nombre de grupo | Ese [grupo](/gebruikers/groepen#groepsrechten) da el permiso. Aquí no puedes desactivarlo, solo en el grupo | | **Bloqueado** con un nombre de grupo | Ese grupo deniega el permiso. Aunque el usuario lo tuviera por sí mismo, sigue bloqueado | | **No concedido** | Nadie da el permiso | El botón **Editar permisos** aparece en gris en tu propia fila y para los usuarios con la insignia **Todos los permisos**. Esos usuarios lo tienen todo y no puedes limitarlos. ## Configurar las notificaciones de un compañero [#meldingen-van-een-collega-instellen] Con el icono de campana (**Ajustes de notificaciones**) junto a un usuario abres sus notificaciones en esta organización. Para cada notificación eliges correo, push o llamada telefónica. Con **Todas las notificaciones** desactivas un canal de una sola vez. Los cambios surten efecto de inmediato y solo valen en esta organización. Las notificaciones que se envían siempre no se pueden desactivar. Qué es una notificación y dónde la ves de nuevo está en [Notificaciones](/notificaties#meldingen-in-de-app). ## Eliminar a un usuario [#een-gebruiker-verwijderen] Haz clic en el icono de papelera (**Eliminar de la organización**) y confirma con **Eliminar usuario**. Tillor avisa con **Usuario eliminado de la organización**. La persona pierde de inmediato el acceso a esta organización. Su cuenta de Tillor sigue existiendo, y también sus otras organizaciones, si las tiene. No puedes eliminarte a ti mismo. A un usuario con **Todos los permisos** solo puedes eliminarlo si tú también tienes **Todos los permisos**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El usuario ve tu organización entre sus organizaciones y puede usar aquello para lo que tiene permisos. - Un cambio de permisos vale de inmediato tras guardarlo. - Un usuario eliminado pierde el acceso de inmediato. Su cuenta de Tillor sigue existiendo. ## ¿Problemas? [#problemen] No tienes el permiso **Gestionar permisos de usuario**. Pide a un compañero con **Todos los permisos** que te lo dé. Esa dirección de correo ya es miembro de tu organización, o ya hay una invitación abierta para esa dirección. Mira las listas **Miembros** e **Invitaciones pendientes**. Si la invitación ya está ahí, revócala e invita de nuevo si la persona no recibió el correo. Pídele que revise la carpeta de spam. Solo pasa a ser miembro si inicia sesión exactamente con la dirección de correo con la que lo invitaste. Si inicia sesión con otra dirección, revoca la invitación e invita a esa dirección. Solo puedes dar permisos que tú mismo tengas. Si junto al permiso aparece un nombre de grupo, ese grupo da o bloquea el permiso y lo cambias en el grupo. El compañero tiene **Todos los permisos**, o es tu propia fila. Esos no los puedes editar. Comprueba en la ventana **Editar permisos de usuario** si un grupo muestra el permiso como **Bloqueado**. La denegación de un grupo siempre gana a un permiso que diste directamente. No puedes eliminarte a ti mismo. A un usuario con **Todos los permisos** solo lo eliminas si tú también tienes **Todos los permisos**. ## Véase también [#zie-ook] # Grupos (/es-ES/gebruikers/groepen) Un grupo es un conjunto fijo de compañeros, por ejemplo **Recepción** o **Servicio técnico**. Usas un grupo en estos lugares: - **Asignar tareas**: al asignar una tarea, busca por el nombre del grupo - **Mencionar y avisar**: una mención o un aviso a un grupo llega a todos sus miembros - **Compartir vistas**: en una vista de tareas elige **Grupos concretos**, consulta [Vistas](/taken/weergaven#wie-ziet-een-weergave) - **Automatizaciones**: los pasos que crean o actualizan una tarea pueden asignarla a grupos ## Crear un grupo [#een-groep-maken] ### Abre Grupos [#open-groepen] Ve a Soporte > Configuración > Grupos. ### Haz clic en Nuevo grupo [#klik-op-nieuwe-groep] Introduce un **Nombre**, por ejemplo Recepción. ### Elige los miembros [#kies-de-leden] En **Miembros** elige a las personas. Solo puedes añadir usuarios que ya sean miembros de la organización. ### Haz clic en Guardar [#klik-op-opslaan] Tillor avisa con **Grupo guardado**. Haz clic en un grupo para cambiar su nombre o sus miembros. Si eliminas un grupo, las tareas asignadas directamente a una persona siguen asignadas. Solo desaparece el propio grupo. ## Permisos del grupo [#groepsrechten] Un grupo también puede dar o quitar permisos. Haz clic en la llavecita (**Permisos del grupo**) del grupo. Para cada permiso eliges: | Opción | Qué hace | |---|---| | **Permitir** | Todos los del grupo reciben el permiso ("Concedido a todos") | | **Heredar** | El grupo no hace nada con este permiso. Cada miembro conserva su propio acceso ("Hereda el acceso propio"). Es el estado inicial | | **Denegar** | El permiso queda bloqueado para todos los del grupo ("Bloqueado para todos") | Con **Buscar permisos** encuentras un permiso rápidamente. Abajo aparece cuántos permisos has configurado. Haz clic en **Guardar**, y Tillor avisa con **Permisos del grupo guardados**. Sin ese permiso, el botón **Permisos del grupo** aparece en gris. Tampoco puedes eliminar un grupo que todavía tenga permisos de grupo. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Los permisos del grupo se suman a los permisos propios de cada miembro. Una denegación siempre gana: si un permiso está en **Denegar** en un grupo y en **Permitir** en otro, sigue bloqueado. - En la ventana **Editar permisos de usuario** de un miembro ves, para cada permiso, qué grupo lo da o lo bloquea. Consulta [Editar permisos](/gebruikers/gebruikers-en-rechten#rechten-bewerken). - Si añades a un miembro, los permisos del grupo también valen para él. Si lo quitas, ya no. - Asignar una tarea, mencionar a alguien o enviar un aviso al grupo llega a todos los que en ese momento son miembros. ## Grupos de Microsoft Entra [#groepen-uit-microsoft-entra] Si ya gestionas a tu personal en Microsoft Entra ID, Entra puede mantener al día automáticamente los miembros de un grupo. Debajo de la lista de grupos aparece entonces la tabla **Grupos de Entra**, donde vinculas cada grupo de Entra a un grupo de Tillor. En un grupo vinculado, Entra es la fuente. Un miembro que añadas o quites a mano en Tillor se vuelve a igualar con Entra en la siguiente sincronización. Consulta [Grupos de Microsoft Entra](/gebruikers/microsoft-entra) para configurar el vínculo. ## ¿Problemas? [#problemen] Inténtalo de nuevo. Si sigue fallando, ponte en contacto con el soporte de Tillor. No tienes el permiso **Gestionar permisos de usuario**. Otro grupo de ese miembro deniega ese permiso. Una denegación siempre gana. Abre la ventana **Editar permisos de usuario** del miembro para ver qué grupo lo bloquea. En la lista solo aparecen usuarios de tu organización. Invita primero a la persona. Consulta [Invitar usuarios](/gebruikers/gebruikers-en-rechten). Si el grupo está vinculado a Microsoft Entra, Entra es la fuente y la siguiente sincronización iguala los miembros. Cambia al miembro en Entra. ## Véase también [#zie-ook] # Resumen (/es-ES/gebruikers) Aquí decides quién trabaja con Tillor y qué puede hacer: invitar usuarios, dar permisos, agrupar compañeros y ajustar la configuración de tu organización. Un usuario es cualquier persona con una cuenta que tiene acceso a tu organización. Lo gestionas en Soporte > Configuración. - Un usuario nuevo recibe un conjunto fijo de permisos iniciales (configuración, integraciones, algunas notificaciones, solicitudes de firma y campos personalizados). Todo lo demás lo das tú - Solo puedes dar permisos que tú mismo tengas. El permiso **Gestionar permisos de usuario** solo lo puede transmitir un usuario con **Todos los permisos** - Una denegación a través de un grupo siempre gana a un permiso que diste directamente - No puedes eliminarte a ti mismo ni editar tus propios permisos - No tienes una contraseña de Tillor aparte: inicias sesión con Google, Microsoft o Apple - Los datos de la empresa, como el número de IVA o el IBAN, no los cambias tú. Eso lo hace el soporte de Tillor ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Un usuario tiene permisos de dos maneras: directamente o a través de un grupo. Un grupo también puede denegar un permiso. ```mermaid flowchart TD U[Usuario] -->|dado directamente| R[Permisos del usuario] U -->|es miembro de| G[Grupo] G -->|Permitir| R G -->|Heredar| N[No hace nada, el usuario conserva sus propios permisos] G -->|Denegar| B[Permiso bloqueado, aunque el usuario lo tuviera por sí mismo] R --> A[Lo que el usuario ve y puede hacer en Tillor] B --> A ``` - **Directo**: activas un permiso en la ventana **Editar permisos de usuario**. Consulta [Invitar usuarios y dar permisos](/gebruikers/gebruikers-en-rechten). - **A través de un grupo**: en **Permisos del grupo** eliges para cada permiso **Permitir**, **Heredar** o **Denegar**. Vale para todos los del grupo. Consulta [Grupos](/gebruikers/groepen). - **Denegado**: si un permiso está en **Denegar** en un grupo, queda bloqueado, por muchos otros grupos o permisos directos que lo den. - Los mismos grupos los usas para asignar tareas, mencionar y compartir vistas. ## Tu propia cuenta [#je-eigen-account] Haz clic en tu nombre en la barra lateral (abajo) y elige **Cuenta**. Ahí gestionas tu perfil, tu número de teléfono, las sesiones activas, las aplicaciones OAuth y las plataformas de inicio de sesión vinculadas. En **Notificaciones** eliges para cada notificación si Tillor te avisa por correo o por push. Consulta [Iniciar sesión y acceso](/inloggen). ## Claves API [#api-sleutels] Una clave API permite que otro programa hable con Tillor en tu nombre. Pertenece a tu cuenta. Las gestionas en la página de tu cuenta. ### Abre tu cuenta [#open-je-account] Haz clic en tu nombre en la barra lateral (abajo) y elige **Cuenta**. ### Crea la clave [#maak-de-sleutel] Abre la sección **Claves API** y haz clic en **Crear clave API**. ### Cópiala enseguida [#kopieer-hem-meteen] Después Tillor ya no muestra la clave completa. En **Desarrolladores** (el mismo menú de usuario) también encuentras el acceso directo **Ir a Claves API**. Guarda las claves API en un lugar seguro y no las compartas nunca por canales no seguros. Si una clave se ha filtrado, elimínala o haz clic en **Regenerar** y crea una nueva si hace falta. ## Apartados [#onderdelen] ## Conceptos [#begrippen] - **Usuario**: alguien con una cuenta que tiene acceso a tu [organización](/begrippen#organisatie). - **[Permiso](/begrippen#recht)**: una autorización para ver o hacer algo, como **Editar productos**. - **Todos los permisos**: una insignia para los usuarios que pueden hacerlo todo. Sus permisos no se editan. - **[Grupo](/begrippen#groep)**: un conjunto fijo de compañeros, con permisos propios si hace falta. - **Invitación**: una solicitud abierta para que alguien sin cuenta se haga miembro. - **Clave API**: un código con el que otro programa trabaja con Tillor. Más términos están en la [lista de conceptos](/begrippen). # Configuración de pagos (/es-ES/gebruikers/instellingen-betalingen) En Soporte > Configuración > Pagos hay algunos ajustes que influyen en el registro de pagos y en el envío de notificaciones. Los ajustes valen para toda tu organización. ## Ajustes [#instellingen] | Ajuste | Qué hace | |---|---| | **Mostrar método de pago "Otros"** | Pone el método **Otros** en la pantalla de pago. Con él registras pagos con una descripción propia, por ejemplo un cheque o un trueque. Desactivado por defecto. | | **Predeterminado: recordatorio de transferencia bancaria manual** | Activa por defecto la casilla del recordatorio sobre la comunicación estructurada cuando registras una transferencia bancaria manual. Aún puedes activar o desactivar la casilla en cada pago. Desactivado por defecto. | | **Máximo en efectivo** | Un importe en euros enteros. Por defecto 2999. | | **Dirección de remitente de correo** | La dirección con la que Tillor envía las notificaciones por correo. | ## Máximo en efectivo [#maximumbedrag-contant] Con **Máximo en efectivo** decides cuánto puede ser un solo pago en efectivo. Por defecto son 2999 euros. Tillor lo comprueba en cada pago en efectivo, también si llega a través de una integración. Si el importe es mayor, regístralo en partes o elige otro método. Consulta [Efectivo y transferencia](/betalingsverwerking/contant). ## Dirección de remitente de las notificaciones [#afzenderadres-van-meldingen] Si dejas vacía la **Dirección de remitente de correo**, el nombre de tu organización aparece como remitente en las notificaciones, con una dirección de Tillor. Si introduces una dirección de correo válida, por ejemplo `meldingen@recreatiepark-het-meer.be`, Tillor usa esa dirección, con el nombre de tu organización como nombre del remitente. Introduce solo la dirección, sin nombre. Una dirección no válida no se guarda. ## Guardar los cambios [#wijzigingen-opslaan] Haz clic abajo en **Guardar configuración**. Con **Cancelar** devuelves el formulario a los valores guardados. ## Véase también [#zie-ook] # Configuración de facturación (/es-ES/gebruikers/instellingen-facturatie) En Soporte > Configuración > Facturación configuras los valores predeterminados de las facturas y del PDF que envías a los clientes. Los ajustes valen para toda tu organización. ## Qué aparece en el PDF de factura [#wat-staat-er-op-de-factuur-pdf] | Ajuste | Qué hace | |---|---| | **Condiciones generales en el PDF de factura** | El PDF recibe, en cada página, un reverso con las condiciones generales. En el pie hay una referencia a ellas. El texto de las condiciones es fijo y menciona el nombre jurídico de tu organización. Desactivado por defecto. | | **Tabla resumen de IVA en el PDF de factura** | Junto a los totales aparece una tabla con la base imponible y el importe de IVA de cada tipo de IVA. Desactivado por defecto. | | **Líneas por página del PDF de factura** | El número máximo de líneas en una página. Si hay más líneas, sigue una página nueva. Por defecto 20, mínimo 1. | ## Plazo de pago [#betaaltermijn] En **Vencimiento predeterminado (días)** introduces el número de días entre la fecha de factura y la fecha de vencimiento. Vale para las facturas en las que tú no has elegido una fecha de vencimiento. Por defecto son 7 días. Puedes introducir 0, y entonces la factura vence el día de la contabilización. Consulta [Contabilizar una factura](/facturen/boeken). ## Elegir tipos de IVA [#btw-tarieven-kiezen] En **Tipos de IVA permitidos** están los tipos que puedes elegir en la lista de IVA de las facturas en borrador. Por defecto son 0%, 6%, 9%, 12% y 21%. 1. Escribe un porcentaje entre 0 y 100 en el campo bajo la lista. Vale una coma o un punto. 2. Haz clic en **Añadir tipo**. 3. Quita un tipo con la cruz junto al porcentaje. 4. Haz clic en **Guardar configuración**. La lista siempre está ordenada de menor a mayor. Un tipo que ya está en la lista no se añade dos veces. Si una línea de factura existente tiene un tipo que luego quitas de la lista, ese tipo se queda en esa línea. Esa lista solo la ves si **Desplegable de tipo de IVA en líneas de factura en borrador** está activado. Entonces una factura en borrador recibe una columna de IVA en la que eliges un tipo para cada línea. Si eliges un producto, el tipo de ese producto sigue siendo el valor inicial. Consulta [IVA](/boekhouden/belasting) y [Crear y editar facturas](/facturen/aanmaken-en-bewerken). ## Facturas automáticas de consumo [#automatische-facturen-voor-verbruik] En **Importe mínimo para facturas de consumo automáticas** introduces un importe en euros. Para los clientes con facturación automática de suministros, Tillor solo crea una factura cuando el importe pendiente alcanza este importe. Si dejas el campo vacío (**Sin mínimo**), se factura cualquier importe pendiente. Si un cliente tiene un mínimo propio en su perfil, ese mínimo vale para ese cliente en lugar de este ajuste. Consulta [Gestión de contadores](/meterbeheer). ## Guardar los cambios [#wijzigingen-opslaan] Haz clic abajo en **Guardar configuración**. Con **Cancelar** devuelves el formulario a los valores guardados. Si solo tienes el permiso **Ver configuración**, los campos aparecen en gris. ## Véase también [#zie-ook] # Configurar periodos de alquiler (/es-ES/gebruikers/instellingen-huurperiodes) En una ocupación eliges una **Frecuencia de alquiler**. Las opciones que ves ahí las decides en Soporte > Configuración > Periodos de alquiler. Cada periodo que añades aquí se convierte en una opción de la lista. ## Añadir un periodo [#een-periode-toevoegen] ### Añade un periodo [#voeg-een-periode-toe] Abre **Periodos de alquiler** y haz clic en **Añadir periodo**. Aparece un bloque con los valores iniciales: enero, 12 meses. ### Rellena el periodo [#vul-de-periode-in] Elige el **Mes de inicio** e introduce en **Duración (meses)** un número del 1 al 12. Un periodo de 12 meses que empieza en enero es un año natural. Un periodo de 1 mes es un alquiler mensual. En **Etiqueta** puedes poner un nombre propio, por ejemplo Anual. ### Elige cómo redondear [#kies-hoe-je-afrondt] La casilla **Redondear fechas de inicio al siguiente periodo** está activada por defecto. Lo que hace lo lees en [Redondear al siguiente periodo](#afronden-naar-de-volgende-periode). ### Guarda [#sla-op] Haz clic en **Guardar configuración**. Con **Quitar periodo** eliminas un periodo. Con **Cancelar** devuelves el formulario a la lista guardada. Si todavía no has añadido ningún periodo, aparece **No hay periodos de alquiler configurados**. En el formulario de una ocupación no podrás elegir entonces ninguna frecuencia de alquiler. ## Dónde vuelves a ver los periodos [#waar-zie-je-de-periodes-terug] En el formulario de una ocupación, la lista está bajo **Frecuencia de alquiler**, con **Sin frecuencia** arriba del todo. Un periodo de 1 mes se llama ahí **Mensual**. Un periodo de 12 meses se muestra como **Año (ene - dic)**, con el primer y el último mes de tu periodo. Otras duraciones se muestran como **6 meses (abr - sep)**. Si en un periodo has rellenado una **Etiqueta**, esa etiqueta aparece en lugar de ese texto, en la lista y en la columna **Frecuencia de alquiler** de las ocupaciones. Si quitas un periodo de la configuración, las ocupaciones que ya se crearon con él conservan su frecuencia de alquiler. ## Redondear al siguiente periodo [#afronden-naar-de-volgende-periode] La casilla determina el estado inicial de **Redondear al límite del periodo siguiente** en la línea de factura con la que prorrogas una ocupación. En la línea de factura aún puedes activar o desactivar la casilla tú mismo. - Si la casilla está activada, la línea termina en el siguiente límite de periodo. Si empiezas a mitad de un periodo, el primer tramo se calcula proporcionalmente. Después el cliente sigue el mismo ciclo que los demás inquilinos. - Si la casilla está desactivada, la línea dura exactamente un periodo desde la fecha de inicio. Consulta [Crear y editar facturas](/facturen/aanmaken-en-bewerken) y [Ocupaciones](/bezettingen). ## Véase también [#zie-ook] # Configuración del control de acceso (/es-ES/gebruikers/instellingen-toegangscontrole) En Soporte > Configuración > Control de acceso configuras el comportamiento de las barreras para las matrículas cuyo periodo de acceso ha caducado. ## Permitir la salida de matrículas caducadas [#verlopen-kentekens-laten-uitrijden] Un visitante con una matrícula cuyo periodo de acceso ha caducado, de otro modo ya no pasa por la barrera de salida. Con **Permitir la salida de matrículas caducadas**, la barrera de salida se abre igualmente, durante un periodo de tolerancia tras la caducidad. Solo funciona fuera del horario de apertura. Si la recepción está abierta, el personal atiende el vehículo en el mostrador. La casilla está activada por defecto. Si la desactivas, la barrera de salida permanece cerrada para una matrícula caducada. | Ajuste | Qué hace | |---|---| | **Permitir la salida de matrículas caducadas** | Activa o desactiva el periodo de tolerancia. | | **Período de gracia de salida (días)** | El número de días tras la caducidad durante los cuales un vehículo aún puede salir fuera del horario de apertura. Por defecto 2, como máximo 30. Con 0 no hay tolerancia. | La tolerancia solo vale para las matrículas en una salida. Una matrícula bloqueada o no activa nunca recibe tolerancia. Para otros métodos de acceso, como etiquetas NFC o códigos QR, no existe la tolerancia. El horario de apertura viene de Soporte > Configuración > Horario de apertura. Consulta [Horario de apertura](/gebruikers/organisaties#openingsuren). ## Guardar los cambios [#wijzigingen-opslaan] Haz clic abajo en **Guardar configuración**. Con **Cancelar** devuelves el formulario a los valores guardados. ## Véase también [#zie-ook] # Grupos de Microsoft Entra (/es-ES/gebruikers/microsoft-entra) Con el aprovisionamiento, Microsoft Entra ID envía tus usuarios y grupos a Tillor. Si vinculas un grupo de Entra a un [grupo](/gebruikers/groepen) de Tillor, los miembros de ese grupo siguen a Entra: quien añades en Entra recibe las tareas y vistas del grupo, y quien quitas o desactivas las pierde. Para ello nadie tiene que volver a iniciar sesión. Entra usa para ello el protocolo SCIM. Tillor no lee nada por sí mismo de tu tenant de Microsoft: Entra decide qué usuarios y grupos envía. Solo durante [Configuración rápida](#snel-instellen) tu navegador habla con Microsoft para crear la aplicación por ti. ## Qué ocurre y qué no [#wat-er-wel-en-niet-gebeurt] - **Solo miembros existentes.** Entra no crea cuentas de Tillor. Alguien que todavía no es miembro de tu organización no cuenta hasta que lo [inviten](/gebruikers/organisaties). En cuanto pasa a ser miembro, entra de inmediato en sus grupos vinculados - **Sin datos de quienes no son miembros.** De las personas sin cuenta de Tillor, Tillor no guarda nombre ni dirección de correo, solo un código ilegible con el que las reconoce si más adelante se hacen miembros - **Nada sin vínculo.** Un grupo de Entra no cambia nada en Tillor hasta que lo vinculas a un grupo de Tillor en **Grupos de Entra sin vincular** - **Uno a uno.** Un grupo de Tillor pertenece como máximo a un grupo de Entra - **El nombre sigue siendo de Tillor.** Si renombras el grupo en Entra, ves el nombre nuevo tras **Entra ·**, pero el grupo de Tillor conserva su propio nombre - **Los grupos anidados** no se despliegan. Un grupo que es miembro de otro grupo no cuenta como miembro. Si quieres también a esas personas, asigna el grupo anidado por separado en Entra y vincúlalo al mismo grupo de Tillor o a otro - **El inicio de sesión no cambia.** La gente sigue iniciando sesión con Microsoft, consulta [Iniciar sesión](/inloggen) ## Antes de empezar [#voordat-je-begint] Necesitas: - En Tillor, el permiso **Editar configuración** - En Microsoft Entra, el rol **Cloud Application Administrator** o **Application Administrator** (o superior) - Una licencia de Entra que permita el aprovisionamiento automático hacia aplicaciones propias (Microsoft Entra ID P1 o superior) Asegúrate de que tus compañeros tengan en Tillor la misma cuenta de Microsoft o la misma dirección de correo que en Entra. Así Tillor reconoce quién es quién, consulta [Cómo reconoce Tillor a las personas](#hoe-tillor-mensen-herkent). ## Configuración rápida [#snel-instellen] Si eres administrador de Entra, Tillor deja la conexión lista de una sola vez. 1. Ve a **Soporte > Configuración** y elige **Grupos** 2. En **Microsoft Entra** haz clic en **Configurar con Microsoft** y después en **Iniciar sesión y configurar** 3. En la ventana de Microsoft inicia sesión con tu cuenta de administrador y da tu consentimiento. Microsoft pide permiso para gestionar aplicaciones y aprovisionamiento y para leer tus grupos Tillor crea entonces la aplicación en Entra, rellena la URL del tenant y el token, hace que los usuarios se reconozcan por su cuenta de Microsoft y hace que Entra envíe el tipo de cada grupo. Después empieza la sincronización y Tillor te envía a ti y a todos tus grupos de inmediato, para que no tengas que esperar a la primera sincronización. Por último, Tillor lee para cada grupo el tipo y si tiene un Team asociado. Ves cómo se marca cada paso. Tillor lo hace en segundo plano: puedes cerrar la ventana o incluso la página. Si más tarde vuelves a hacer clic en **Configurar con Microsoft**, ves cómo va, o hasta una hora después de terminar si ha salido bien o mal. Después puedes empezar de nuevo con **Configurar de nuevo**. Entra envía entonces todos tus usuarios y grupos. No tienes que elegir nada de antemano: los grupos aparecen en **Grupos de Entra sin vincular** y no cambian nada hasta que los vinculas. Para ello sigue en [Vincular grupos en Tillor](#groepen-koppelen-in-tillor). Los miembros de los grupos llegan con la primera sincronización. Dura unos minutos, en organizaciones grandes unas horas. Tillor usa el acceso solo para esta configuración. Va cifrado a la tarea en segundo plano y después no se guarda en ningún sitio; Microsoft lo hace caducar por sí misma tras aproximadamente una hora. Si vuelves a pasar por **Configurar con Microsoft**, Tillor encuentra la misma aplicación y no crea una segunda. La configuración rápida crea un token nuevo. Un token que pegaste antes a mano en Entra deja de funcionar. Si la configuración se detiene a medias, haz clic en **Reintentar**. Si no consigues iniciar sesión, por ejemplo porque tu organización bloquea el consentimiento para aplicaciones, o si quieres que Entra envíe solo determinados grupos, configura la conexión a mano como se explica a continuación. ## Configuración manual [#handmatig-instellen] ### Crear un token en Tillor [#token-maken-in-tillor] 1. Ve a **Soporte > Configuración** y elige **Grupos** 2. Arriba está **Microsoft Entra**. Si la conexión ya está configurada, haz clic en **Conexión** 3. Copia la **URL del inquilino**. Tiene este aspecto: `https://…/api/orgs//scim/v2` 4. Haz clic en **Generar token** y copia el token que aparece El token solo se muestra una vez. Pégalo enseguida en Entra. Si lo pierdes, haz clic en **Sustituir token** y usa el token nuevo. ### Crear una aplicación en Entra [#een-app-maken-in-entra] 1. Abre el [centro de administración de Microsoft Entra](https://entra.microsoft.com) 2. Ve a **Identity > Applications > Enterprise applications** y haz clic en **New application** 3. Haz clic en **Create your own application** 4. Ponle un nombre a la aplicación, por ejemplo **Tillor**, elige **Integrate any other application you don't find in the gallery (Non-gallery)** y haz clic en **Create** Si ya tienes una enterprise application para Tillor, también puedes usarla. ### Vincular el aprovisionamiento [#provisioning-koppelen] 1. En la aplicación abre **Provisioning** y haz clic en **Get started** (o **New configuration**) 2. Pon **Provisioning Mode** en **Automatic** 3. En **Admin Credentials** introduce: - **Tenant URL**: la URL del inquilino de Tillor - **Secret Token**: el token de Tillor 4. Haz clic en **Test Connection**. Entra debe indicar que la conexión se ha establecido 5. Haz clic en **Save** ### Comprobar los atributos [#attributen-controleren] En **Mappings** abre la regla **Provision Microsoft Entra ID Users**: - Pon **externalId** en **objectId** (por defecto está **mailNickname**). Así Tillor reconoce a alguien por su cuenta de Microsoft, aunque la dirección de correo sea distinta - Deja **userName** (← **userPrincipalName**), **active** y **emails[type eq "work"].value** (← **mail**) como están Deja activado **Provision Microsoft Entra ID Groups**. Los valores predeterminados (**displayName**, **externalId** ← **objectId**, **members**) están bien. Si quieres ver en Tillor qué tipo de grupo es, añade estos atributos a los grupos. En **Show advanced options** elige primero **Edit attribute list for customappsso** y añade los atributos de destino, y después **Add New Mapping** en cada regla: | Origen en Entra | Atributo de destino | Tipo | |---|---|---| | Expresión `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 | Si falta un origen en la lista de Entra, omite esa regla. Entra no puede enviar así si un grupo tiene un Team asociado; Tillor eso solo lo ve a través de **Configurar con Microsoft**. Puedes dejar los demás atributos como están. Tillor no los guarda. ### Asignar grupos [#groepen-toewijzen] 1. En la aplicación abre **Users and groups** y haz clic en **Add user/group** 2. Elige los grupos que debe recibir Tillor, por ejemplo **Recepción**, y haz clic en **Assign** 3. Comprueba en **Provisioning > Settings** que **Scope** esté en **Sync only assigned users and groups** Entra envía un grupo junto con sus miembros. No tienes que asignar los miembros por separado. ### Iniciar el aprovisionamiento [#provisioning-starten] En **Provisioning** pon **Provisioning Status** en **On** y haz clic en **Save**. La primera ronda puede tardar un poco, según el número de usuarios. Después Entra envía los cambios aproximadamente cada 40 minutos. Si quieres actualizar a una persona de inmediato, usa **Provision on demand** en Entra. ### Vincular grupos en Tillor [#groepen-koppelen-in-tillor] Actualiza **Configuración > Grupos**. Arriba está la línea **Microsoft Entra** con la última sincronización y cuántos grupos están vinculados. Bajo tus grupos de Tillor está **Grupos de Entra sin vincular** con los grupos enviados que todavía no hacen nada. Haz clic en **Mostrar** si la lista está cerrada y usa el campo de búsqueda para encontrar un grupo. Para cada grupo elige en **Vincular a…** qué debe ocurrir y haz clic después en **Guardar**. Con **Deshacer cambios** descartas tus elecciones. Un grupo de Tillor solo puede estar vinculado a un grupo de Entra; los grupos que ya están vinculados no se pueden elegir otra vez. | Opción | Qué ocurre | |---|---| | **Crear nuevo** | Tillor crea un grupo con el nombre de Entra y lo rellena con los miembros reconocidos | | Un grupo existente | Los miembros de ese grupo se sustituyen por los miembros reconocidos de Entra. Si Entra todavía no ha enviado los miembros de ese grupo, los miembros actuales se quedan hasta que la sincronización los entregue | A partir de ahora Entra actualiza los miembros en cada sincronización. El grupo vinculado desaparece de la lista y en tus grupos de Tillor aparece bajo el grupo **Entra · [nombre]** con el tipo de grupo que es. El vínculo solo se hace desde **Grupos de Entra sin vincular**. Un grupo de Tillor que gestionas a mano, como TI, no se vincula desde el propio grupo. Tras cada nombre de grupo aparece qué tipo de grupo es en Entra. Con los botones sobre la lista muestras un solo tipo. | Etiqueta | Qué es | |---|---| | **Seguridad** | Un grupo de seguridad normal, a menudo el grupo que quieres vincular | | **Seguridad habilitada para correo** | Un grupo de seguridad con dirección de correo propia | | **Lista de distribución** | Solo una lista de correo | | **Microsoft 365** | Un grupo con un buzón compartido y un sitio de SharePoint, a veces con un Team | | **Windows Server AD** | Viene de tu Active Directory local (híbrido) y se gestiona allí | | **Dinámico** | Entra decide los miembros por sí misma con una regla | | **Teams** | Tiene un Team asociado | | **Tipo desconocido** | Tillor todavía no conoce el tipo. Pasa de nuevo por **Configurar con Microsoft** | Los grupos de sitio de SharePoint, como **Propietarios**, **Miembros** y **Visitantes** de un sitio, no son grupos de Entra. Nunca llegan a Tillor. Lo que sí ves es el grupo de Microsoft 365 que hay detrás del sitio. ## Cómo reconoce Tillor a las personas [#hoe-tillor-mensen-herkent] Para cada usuario que envía Entra, Tillor busca a un miembro existente de tu organización: 1. Primero por la **cuenta de Microsoft** con la que esa persona inicia sesión en Tillor (el ID de objeto de Entra, si pones **externalId** en **objectId**) 2. Si no, por **dirección de correo**: la dirección de trabajo de Entra, o el **userPrincipalName** si es una dirección de correo Si Tillor no encuentra a nadie, o el usuario está desactivado en Entra, no cuenta en el grupo. En cuanto la persona pasa a ser miembro de la organización, cuenta de inmediato. Si lo vuelves a activar en Entra, cuenta en la siguiente sincronización. ## Qué ocurre con los cambios en Entra [#wat-er-gebeurt-bij-wijzigingen-in-entra] | En Entra | En Tillor | |---|---| | Miembro añadido a un grupo vinculado | Entra en el grupo de Tillor (si es miembro de la organización) | | Miembro quitado del grupo | Sale del grupo de Tillor | | Usuario desactivado (**Account enabled** desactivado) | Sale de todos los grupos de Tillor vinculados. Su cuenta de Tillor sigue existiendo | | Usuario o grupo que ya no está asignado a la aplicación | Entra envía una desactivación o eliminación, con el mismo efecto | | Grupo eliminado | Bajo el grupo de Tillor aparece **Eliminado en Entra. Los miembros se conservaron.** El grupo de Tillor sigue existiendo con sus últimos miembros y ya no se actualiza | Sacar a alguien por completo de tu organización se hace en Tillor, en [Organización](/gebruikers/organisaties). Entra solo gestiona los miembros de los grupos. ## Qué ves en el registro de actividad [#wat-je-terugziet-in-het-activiteitenlog] En el [registro de actividad](/activiteitenlog) ves: - Cada cambio en los miembros de un grupo de Tillor que aplica Entra, con quién entró o salió. Figura a nombre del sistema, no de un usuario - Cada ronda de sincronización de Entra, una línea por ronda. Una ronda en la que Entra no envía nada no se ve - Quién vinculó o desvinculó un grupo de Entra de un grupo de Tillor, y quién sustituyó el token ## Cambiar o detener el vínculo [#koppeling-wijzigen-of-stoppen] - **Desvincular**: haz clic en **Desvincular** en el grupo de Tillor. El grupo de Tillor se queda como está y vuelves a gestionarlo a mano. El grupo de Entra vuelve a aparecer en **Grupos de Entra sin vincular** - **Otro grupo de Tillor**: desvincula y vincula después el grupo de Entra a otro grupo en **Grupos de Entra sin vincular**. El grupo anterior conserva sus miembros, pero ya no se actualiza - **Detener por completo**: en Entra pon **Provisioning Status** en **Off**, o elimina la enterprise application ## Sustituir el token [#token-vervangen] En la línea **Microsoft Entra** haz clic en **Conexión** y después en **Sustituir token** si el token se ha filtrado o si lo necesitas de nuevo. El token antiguo deja de funcionar de inmediato. Pega el token nuevo en Entra en **Provisioning > Admin Credentials > Secret Token** y haz clic en **Save**. Hasta que lo hagas, la sincronización en Entra falla. ## Solucionar problemas [#problemen-oplossen] **La configuración con Microsoft se detiene en un paso** En el paso aparece el mensaje de Microsoft. Normalmente a tu cuenta le falta el rol de administrador o el consentimiento. Comprueba los roles en [Antes de empezar](#voordat-je-begint) y haz clic en **Reintentar**. Tillor reutiliza la aplicación y el aprovisionamiento que ya estaban creados. **Test Connection falla** Comprueba que la URL del inquilino se haya copiado completa, incluido `/scim/v2`, y que el token sea el último generado. Tras **Sustituir token**, un token antiguo deja de funcionar. **Un grupo no aparece en la lista** Espera a que termine la primera sincronización y actualiza la página. Si has configurado la conexión a mano, Entra solo envía los grupos asignados a la aplicación: comprueba **Users and groups** en la aplicación y espera a la siguiente ronda, o usa **Provision on demand**. **Falta alguien en el grupo de Tillor** - ¿Esa persona es miembro de tu organización de Tillor? Entra no crea cuentas - ¿La dirección de correo en Entra coincide con la de Tillor? Si no, pon **externalId** en **objectId**, para que Tillor lo reconozca por su cuenta de Microsoft. Eso solo funciona si ya ha iniciado sesión alguna vez en Tillor con Microsoft - ¿El usuario está activado en Entra? - ¿Es miembro directo del grupo, y no a través de un grupo anidado? **Mi cambio manual desaparece** En un grupo vinculado, Entra es la fuente. Cambia los miembros en Entra, o desvincula el grupo. **Más detalles sobre una ronda fallida** En Entra abre **Provisioning > Provisioning logs**. Ahí ves, para cada usuario y grupo, qué intentó Entra y qué respuesta dio Tillor. ## Véase también [#zie-ook] # Organización (/es-ES/gebruikers/organisaties) En la página **Configuración** (abajo en el menú principal, Soporte > Configuración) gestionas los ajustes de tu organización. A la izquierda cambias entre los apartados. Los apartados que ves dependen de tus permisos. | Apartado | Para qué sirve | |---|---| | **General** | Perfil de la organización, zona horaria, país predeterminado y colores de marca. Consulta [General](#algemeen) | | **Horario de apertura** | Horario semanal, temporadas, excepciones y festivos. Consulta [Horario de apertura](#openingsuren) | | **Facturación** | PDF, plazo de vencimiento y tipos de IVA. Consulta [Configuración de facturación](/gebruikers/instellingen-facturatie) | | **Impresión** | Impresoras y momentos de impresión. Consulta [Impresión](#afdrukken) | | **Pagos** | Método de pago Otros y dirección de remitente. Consulta [Configuración de pagos](/gebruikers/instellingen-betalingen) | | **Periodos de alquiler** | Frecuencias de alquiler para ocupaciones. Consulta [Configurar periodos de alquiler](/gebruikers/instellingen-huurperiodes) | | **Tarifa de parcela** | La fórmula de la tarifa calculada. Consulta [Fórmula de tarifa](/terreinen#tariefformule) | | **Control de acceso** | Salir con una matrícula caducada. Consulta [Configuración del control de acceso](/gebruikers/instellingen-toegangscontrole) | | **Mapa** | Centro y orientación del mapa. Consulta [Configurar el mapa predeterminado](/kaart#kaartstandaard-instellen) | | **Tipos de parcela** | Tipos para parcelas. Consulta [Tipos de parcela](/terreinen#terreintypes) | | **Etiquetas de tareas** | Etiquetas para tareas. Consulta [Etiquetas](/taken/labels) | | **Grupos** | Agrupar compañeros. Consulta [Grupos](/gebruikers/groepen) | | **Campos personalizados** | Campos adicionales en clientes, parcelas y más. Consulta [Campos personalizados](/eigen-velden) | | **Apple Wallet** | Fondo del pase y punto de acceso. Consulta [Apple Wallet](#apple-wallet) | | **Tabletas y quioscos** | Tabletas y quioscos. Consulta [Tabletas y quioscos](/mobiele-app/tablets-en-kiosken) | | **Integraciones** | Conexiones con otros servicios. Consulta [Integraciones](#integraties) | | **Usuarios** | Miembros, invitaciones y permisos. Consulta [Gestionar permisos de usuario](#gebruikersrechten-beheren) | - Los apartados que ves dependen de tus permisos. Los cambios se guardan abajo con **Guardar configuración** - Aproximadamente una semana antes de un festivo legal, Tillor envía un correo a la dirección de soporte si el horario de apertura de ese día sigue vacío - Tras guardar los ajustes de wallet, Tillor actualiza de nuevo todos los pases de wallet activos. Los visitantes suelen verlo al abrir el pase - En cuanto tu organización tiene facturas o pagos, la moneda ya no se puede cambiar Los datos de la empresa en las facturas (nombre, dirección, número de IVA, IBAN, logotipo) se configuran durante el alta. Ponte en contacto con el soporte de Tillor si quieres cambiarlos. ## Integraciones [#integraties] Elige **Integraciones** para ver las conexiones disponibles, como la telefonía de Voys, cuentas bancarias, Mollie o software de contabilidad (p. ej. Admisol). En **Integraciones**, en el menú de la izquierda, hay categorías (comunicación, pagos, contabilidad, contadores). Haz clic en una integración de la lista para abrir su página de detalle. Ahí instalas la conexión o ajustas la configuración (sin ventana de diálogo aparte). Consulta también el [resumen de integraciones](/integraties). ## General [#algemeen] En **General** configuras el perfil de la organización, la zona horaria, el país predeterminado y los colores de marca. Necesitas el permiso **Editar configuración** para guardar cambios. ## Horario de apertura [#openingsuren] En **Horario de apertura** editas un horario semanal. Con las opciones de color cambias a **periodos de temporada** (por ejemplo del 1 de julio al 31 de agosto) o a una **excepción** (una sola fecha o un periodo como del 24 al 26 de diciembre). Los **festivos legales** de los próximos 12 meses ya están ahí: elige un festivo e introduce las horas (o déjalas vacías si ese día estás cerrado). Deja vacío un día de la semana si ese día estás cerrado. La IA de la bandeja de entrada usa estas horas como horario de oficina. Aproximadamente una semana antes de un festivo legal, Tillor envía un correo de recordatorio a la **dirección de soporte** de la organización (o a la dirección de correo general si no hay dirección de soporte) cuando las horas de ese festivo aún no están rellenadas. Si usas Partoo, el horario de apertura se sincroniza automáticamente. Consulta [Partoo](/integraties/partoo). Un sitio web puede obtener las horas resueltas (incluidas etiquetas de temporada como Verano o Invierno) y los próximos festivos mediante la [API de horario de apertura](/ontwikkelaars/voorbeelden/opening-hours). ## Impresión [#afdrukken] En **Impresión** configuras las impresiones en PDF, las direcciones IP de las impresoras y el **horario de momentos de impresión**. Añade para cada día de la semana una o más horas (o deja el día vacío). Los pagos en línea, por mandato y por transferencia esperan al siguiente momento de ese día antes de que la factura pase a la cola de la impresora. ## Apple Wallet [#apple-wallet] En **Apple Wallet** configuras dos cosas una junto a otra: a la izquierda el **fondo del pase**, a la derecha la **ubicación del punto de acceso**. **Fondo del pase** (izquierda): foto opcional a sangre completa para el diseño Poster Generic en iPhone con **iOS 27**. Sube JPEG, PNG o WebP; los archivos grandes se reducen automáticamente. Arrastra sobre la vista previa para elegir qué parte de la foto queda visible detrás del código QR. La vista previa muestra tu elección al instante; solo tras **Guardar** abajo en **Configuración** la foto (o su eliminación) entra en vigor y Tillor envía el enfoque a los pases de acceso. En iPhone con **iOS 26 o anterior**, el pase usa el diseño generic clásico con los mismos datos (estado, nombre del visitante, validez, código QR). Sin imagen propia, todos los pases reciben el degradado predeterminado de Tillor. Con una foto propia, arriba aparece el **logotipo de la organización** de los datos de tu empresa, en color sobre la foto. En el degradado predeterminado, el logotipo es blanco sobre el degradado oscuro. En los pases Poster Generic (iOS 27), el código QR es **cuadrado**; en dispositivos más antiguos es rectangular, como en un pase generic clásico. **Ubicación del punto de acceso** (derecha): haz clic en el mapa o arrastra el marcador para fijar el punto GPS del punto de acceso principal. **Apple Wallet** y **Google Wallet** usan esa ubicación en el pase de acceso. En iPhone, iOS puede sugerir el pase en la pantalla de bloqueo cuando un visitante está cerca. Elige **Usar centro del mapa del parque** para quitar el marcador y usar el centro del mapa del parque. Tras guardar la **Configuración**, Tillor actualiza todos los pases de wallet activos de la organización (Apple mediante push silencioso, Google mediante sincronización de objetos). Los huéspedes suelen ver la actualización al abrir el pase en Wallet; a veces aún hace falta una actualización manual en la aplicación Wallet. La vista previa en Tillor muestra el mismo recorte que en el pase: arrastra la imagen para que el punto central quede donde quieres. En el reverso del pase de wallet aparecen el número de teléfono y la dirección de correo de la organización (el correo de soporte si está configurado, si no el general). En los pases bloqueados, caducados o revocados, esos datos también aparecen tras el texto de recepción en la pantalla de bloqueo (Apple) o en Google Wallet. ## Gestionar permisos de usuario [#gebruikersrechten-beheren] En **Usuarios** ves los **Miembros** de tu organización y las **Invitaciones pendientes**. Cómo invitar y eliminar compañeros y configurar sus notificaciones está en [Invitar usuarios y dar permisos](/gebruikers/gebruikers-en-rechten). ### Editar permisos [#rechten-bewerken] Haz clic en **Editar permisos** junto a un usuario. Toda la explicación, también sobre grupos y permisos bloqueados, está en [Editar permisos](/gebruikers/gebruikers-en-rechten#rechten-bewerken). A continuación están los permisos que suelen generar preguntas. ### Cuentas bancarias [#bankrekeningen] | Permiso | ¿Qué puede hacer el usuario? | |---|---| | **Ver transacciones bancarias** | Página **Administración > Transacciones bancarias** y el bloque **Transacciones de cuenta bancaria** en **Administración > Informes de pago** | | **Sincronizar transacciones bancarias** | Botón **Sincronizar cuenta bancaria** (importación manual) | Los permisos están en el diálogo de permisos, en el grupo **Transacciones bancarias**. Consulta también [Cuentas bancarias](/boekhouden/betalingsrapporten/betaalmethodes/ponto) para la conexión con open banking. ### Asignar pago [#betaling-koppelen] | Permiso | ¿Qué puede hacer el usuario? | |---|---| | **Asignar pago** | **Asignar pago** en una factura contabilizada, **Asignar** en los grupos de pagos y **Asignar a factura** en las transacciones bancarias (no visible sin el permiso) | El permiso está en el diálogo de permisos, en el grupo **Pagos**. ### Aplicaciones OAuth [#oauth-apps] | Permiso | ¿Qué puede hacer el usuario? | |---|---| | **Autorizar aplicaciones OAuth** | Dar permiso a terceros (p. ej. Cursor, Claude, ChatGPT) mediante OAuth, y seguir usando los tokens OAuth existentes | Los usuarios existentes conservan el permiso tras la migración. Los usuarios nuevos no lo reciben automáticamente. Márcalo en el diálogo de permisos del usuario. Desmárcalo para evitar que ese usuario vincule nuevas aplicaciones OAuth; los tokens existentes de ese usuario también dejan de funcionar. Los usuarios con este permiso en al menos una organización pueden autorizar. Consulta también [MCP](/ontwikkelaars/mcp). ## Acuerdo de tratamiento [#verwerkersovereenkomst] Si en lugar de Tillor aparece una pantalla **Acuerdo de tratamiento de datos requerido**, tu organización debe firmar el acuerdo de tratamiento (DPA) vigente antes de poder continuar. Primero puedes descargar el documento con **Descargar documento del DPA**. Después solicitas un código de verificación. Llega por SMS al número de teléfono de la persona responsable. Introduce el código y haz clic en **Aceptar DPA**. ## Datos en las facturas [#gegevens-op-facturen] Los datos de la empresa, como el nombre, la dirección, el número de IVA y el IBAN, aparecen automáticamente en las facturas. Se configuran durante el alta. Ponte en contacto con el soporte de Tillor para cambiarlos. ## Véase también [#zie-ook] # Prueba y validez (/es-ES/handtekeningen/bewijs-en-geldigheid) En cada firma, Tillor registra quién firmó, cuándo y cómo, y sella el PDF para que cualquier cambio posterior sea visible. El resultado es una firma electrónica simple, adecuada para contratos de alquiler, normas de la casa, exenciones de responsabilidad y condiciones. Para documentos en los que la ley exige una firma más fuerte, Tillor no es el lugar adecuado. ## ¿Qué aparece en las páginas de prueba? [#wat-staat-er-op-de-bewijspaginas] Al final del PDF firmado se añaden una o más páginas de **Prueba de firma**. En ellas aparece: - el título del documento, la solicitud, tu organización, el número de páginas y cuándo se creó, se envió y se completó la solicitud - dos huellas del archivo: la del PDF tal como lo subiste y la de las páginas firmadas antes de añadir las páginas de prueba. Si cambia un solo carácter del archivo, la huella deja de coincidir - por firmante: nombre, función, tipo, correo electrónico, número de teléfono e idioma, cuándo salió el enlace y cuándo abrió esa persona la página por primera vez, la hora de la firma, la dirección IP y el dispositivo - cómo se confirmó al firmante: con un código de un solo uso, a qué canal se envió el código y cuándo, o con sesión iniciada en Tillor en el caso del personal - la frase con la que el firmante dio su conformidad, exactamente como se veía en pantalla - lo que rellenó el firmante: cada campo de texto, fecha y casilla con su valor, también los que quedaron vacíos - la firma y la rúbrica tal como se dibujaron, y en qué páginas están. Una firma escrita a teclado aparece como imagen del nombre escrito, igual que una dibujada - cómo se firmó: en la página de firma mediante el enlace, en Tillor por un empleado con sesión iniciada, o en la tableta de la recepción (con código, o con la identidad confirmada por un empleado) - el **registro de auditoría**: cada paso con la hora, quién lo hizo y desde qué dirección IP y dispositivo. Por ejemplo *Enlace de firma enviado*, *Página de firma abierta*, *Código de verificación enviado*, *Código incorrecto introducido*, *Firmado* y *Completado y sellado* Las horas se muestran en la zona horaria de tu organización, con la hora UTC (la hora estándar mundial) al lado. Tillor guarda cifrados las direcciones IP y los dispositivos. Los ves en Tillor y en las páginas de prueba. Las firmas y los valores rellenados aparecen en el documento en los lugares que tú elegiste. Tu archivo original se guarda aparte y nunca cambia. Estos mismos pasos los ves también en la página de la solicitud, en **Historial**, y en el cliente, en **Eventos**. Las dos huellas son sumas de comprobación SHA-256. Una huella SHA-256 cambia por completo en cuanto cambia un solo byte de un archivo, por eso demuestra que el archivo no se ha modificado. En la página de prueba también aparece la huella del certificado del sello (ver más abajo). ## Sello y sello de tiempo [#zegel-en-tijdstempel] Como último paso, el PDF firmado se **sella** con una firma digital de tu organización, generada por Tillor. Si lo abres en Adobe Reader u otro lector de PDF, verás un panel de firmas. Si después del sellado se cambia algo del archivo, el lector lo avisa. El lector puede llamar al firmante **desconocido** o **no de confianza**. Es normal: el certificado procede de Tillor y no de una autoridad de certificación de pago. Qué certificado es, aparece con su huella en la página de prueba. El sello recibe además un **sello de tiempo** de un servicio de sellado de tiempo independiente y gratuito (FreeTSA, o DigiCert si no responde). Esto demuestra, con independencia de Tillor, cuándo existía el archivo exactamente en esta forma. La hora aparece en la página de la solicitud, en **Sello de tiempo**. ## Qué tipo de firma es [#welk-soort-handtekening] Es una **firma electrónica simple** según las normas europeas eIDAS. Tillor comprueba el correo electrónico o el número de teléfono con un código, registra el dibujo y guarda la prueba. Esto encaja con contratos de alquiler, normas de la casa, exenciones de responsabilidad y condiciones. Una firma **cualificada**, por ejemplo con itsme o una tarjeta eID, no es posible. Si tienes un documento para el que la ley lo exige, haz que se firme fuera de Tillor. ## ¿Qué pasa con la prueba? [#wat-gebeurt-er-met-het-bewijs] - El PDF original y el PDF firmado se quedan con los documentos del cliente. Puedes archivarlos, pero no eliminarlos. - La prueba forma parte del PDF firmado. Quien haya recibido una copia tiene también las páginas de prueba. - El registro de auditoría permanece en la página de la solicitud, aunque la solicitud haya sido rechazada, cancelada o haya caducado. ## ¿Problemas? [#problemen] Es correcto y normal. El sello procede de Tillor, no de una autoridad de certificación de pago. Lo importante es que el lector no avise de ningún cambio posterior al sellado. El certificado aparece con su huella en la página de prueba. El archivo se modificó después del sellado, por ejemplo al volver a guardarlo o editarlo. Descarga de nuevo el PDF firmado desde la página de detalle de la solicitud o desde los documentos del cliente. Ese archivo no ha sido modificado. Eso no es posible en Tillor. Haz que ese documento se firme fuera de Tillor. ## Ver también [#zie-ook] # Solicitar firmas (/es-ES/handtekeningen/handtekening-vragen) Con una solicitud de firma haces que una o más personas firmen un PDF en línea. La creas en dos partes: primero eliges el cliente y el PDF, y después, en el editor, configuras los firmantes y los campos. Cómo seguir después quién ha firmado, lo encuentras en [Seguir una solicitud](/handtekeningen/opvolgen). Antes de empezar: - Necesitas el permiso **Gestionar solicitudes de firma**. Si no lo tienes, el botón **Solicitar firmas** aparece en gris. - El archivo debe ser un PDF de hasta 250 MB. Tillor rechaza cualquier otro tipo de archivo con **No es un PDF. Elija un archivo PDF.** - Cada firmante necesita un correo electrónico o un número de teléfono para recibir el enlace o el código. En un cliente o una persona de contacto, lo rellenas antes en sus datos. - Cada firmante necesita al menos un campo de firma o de rúbrica. ## Crear una solicitud de firma [#een-ondertekenverzoek-maken] ### Inicia la solicitud [#start-het-verzoek] Elige desde dónde empiezas. Ve a Administración > Firmas y haz clic en **Solicitar firmas**. Elige el **Cliente**. Abre la pestaña **Documentos** del cliente y haz clic en **Solicitar firmas**. El cliente ya aparece rellenado. En **Documento**, elige un PDF que ya esté en ese cliente, o deja **Subir un PDF nuevo** y arrastra el PDF al recuadro (o haz clic en **Elegir PDF**). Rellena un **Título**, por ejemplo *Contrato de alquiler 2027*. Si lo dejas vacío, Tillor toma el nombre del documento. Después, haz clic en **Continuar**. Un PDF subido queda en los documentos del cliente. Tillor nunca lo modifica: las firmas se colocan en una copia aparte. ### Añade firmantes [#voeg-ondertekenaars-toe] En **Firmantes**, haz clic en **Añadir firmante** y elige: - **Cliente: [nombre]** - **Contacto del cliente** - **Empleado** - **Parte externa**: rellena **Nombre**, **Correo electrónico** y/o **Número de móvil** e **Idioma**. Hace falta al menos uno de los dos datos de contacto. Sin correo electrónico, la persona recibe el enlace por SMS. Puedes añadir un máximo de 10 firmantes. Firman de arriba abajo, y el siguiente solo recibe el enlace cuando el anterior ha firmado. Con **Firmar antes** y **Firmar después** (las flechas) cambias el orden, y con la papelera quitas a alguien. En el recuadro bajo el nombre puedes rellenar opcionalmente una **Función**, por ejemplo *Inquilino* o *Avalista*. Cada firmante recibe un color propio. Ese color lo ves de nuevo en sus campos del documento. ### Coloca los campos [#plaats-de-velden] En **Campos para**, elige el firmante para el que colocas campos. Después elige el tipo de campo y toca o arrastra en una página del documento. Arrastra un campo para moverlo y arrastra la esquina para hacerlo más grande o más pequeño. | Campo | Qué hace el firmante | | --- | --- | | **Firma** | Coloca la firma dibujada tocando el recuadro | | **Rúbrica** | Coloca la rúbrica dibujada tocando el recuadro | | **Nombre** | Nada: Tillor rellena el nombre del firmante | | **Fecha de firma** | Nada: Tillor rellena el día de la firma | | **Texto** | Escribe una línea, hasta 200 caracteres, por ejemplo una matrícula | | **Texto largo** | Escribe unas líneas, hasta 2.000 caracteres, por ejemplo una observación | | **Casilla** | Marca una condición | | **Fecha** | Elige una fecha, por ejemplo un día de llegada | Haz clic en un campo colocado para seleccionarlo. Debajo de los botones verás entonces: - **Firmante**: pone el campo a nombre de otro firmante, sin volver a dibujarlo. - En **Texto**, **Texto largo**, **Casilla** y **Fecha**, también una **Pregunta o etiqueta** (que el firmante ve junto al recuadro) y **Obligatorio**. Un campo que no es obligatorio puede quedar vacío. - La cruz del campo lo elimina. Si alguien necesita una rúbrica en cada página, usa **Rúbrica en cada página**. Tillor coloca entonces un campo de rúbrica en todas las páginas para ese firmante. Mientras un firmante no tenga campo de firma ni de rúbrica, verás **Aún sin campo de firma** junto a esa persona. ### Define el mensaje y el plazo [#stel-bericht-en-termijn-in] En **Solicitud**, rellena: - **Título**: tal como lo ven los firmantes. - **Mensaje para los firmantes**: opcional, aparece en el correo y en la página de firma. - **Firmar antes del**: la fecha límite. Por defecto son 14 días después de crearla. Se puede firmar hasta el final de ese día. - **Recordatorio tras**: tras cuántos días (de 1 a 14) recibe un recordatorio un firmante al que le toca firmar. Por defecto, 3 días. ### Envía la solicitud [#verstuur-het-verzoek] Haz clic en **Enviar** y confirma. El primer firmante recibe el enlace. Si quieres seguir más tarde, haz clic en **Guardar borrador**. Con la papelera de al lado (**Eliminar borrador**) descartas la solicitud, tras confirmar. El PDF se queda en los documentos del cliente. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - La solicitud pasa al estado En curso. La encuentras en el cliente, en **Documentos**, y en Administración > Firmas. Tillor avisa con **Enviada al primer firmante**. - El primer firmante recibe un correo con un enlace personal, o un SMS si solo hay número de teléfono. Cada firmante siguiente recibe el enlace en cuanto firma el anterior. - Un firmante al que le toca firmar y no responde recibe automáticamente un recordatorio pasados los días indicados en **Recordatorio tras**, un máximo de 2 veces. También puedes enviar tú un recordatorio en cualquier momento, ver [Seguir una solicitud](/handtekeningen/opvolgen#een-herinnering-sturen). - En cuanto todos han firmado, la solicitud pasa a Completada y el PDF firmado queda en el cliente. - Si el plazo termina sin que todos hayan firmado, la solicitud pasa a Caducada. Si quieres cambiar algo mientras todavía no ha firmado nadie, o solo has firmado tú, haz clic en **Volver a editar**. La solicitud vuelve a ser un borrador: los enlaces enviados dejan de funcionar y todos firman de nuevo cuando la vuelvas a enviar. Si ya ha firmado otra persona, cancela la solicitud y crea una nueva. ¿Quieres que una automatización reaccione a una solicitud completada, por ejemplo con una tarea? Usa entonces el disparador **Solicitud de firma completada**, ver [Disparadores](/automatiseringen/triggers). ## ¿Problemas? [#problemen] Te falta el permiso **Gestionar solicitudes de firma**. Pide a un administrador que lo añada en Ajustes > Usuarios. Has elegido otro tipo de archivo, por ejemplo Word. Guarda primero el documento como PDF y elige ese archivo. En la primera pantalla, **Cliente** o **Documento** está vacío. Rellena ambos y vuelve a hacer clic en **Continuar**. Tillor comprueba la solicitud antes de enviarla y dice qué falta: - **Añade al menos un firmante antes de enviar.** - Un firmante aún no tiene campo de firma ni de rúbrica. Tillor selecciona a esa persona. Arrastra entonces sobre el documento para colocar un campo. - Un firmante no tiene correo electrónico ni número de teléfono y por tanto no puede recibir un enlace ni un código. Esto también vale para un cliente o una persona de contacto: rellena primero un correo electrónico o un número de teléfono en sus datos. En la lista, junto a esa persona aparece **Sin correo electrónico ni teléfono**. - **Pon un título a la solicitud.** Es posible que la solicitud no haya salido. Recarga la página. Si la solicitud sigue como Borrador, vuelve a hacer clic en **Enviar**. Tus cambios no se han guardado. Recarga la página y comprueba lo que queda antes de continuar. Recarga la página. Si sigue sin funcionar, comprueba que el archivo sea un PDF válido. Haz clic en el campo y elige a la persona correcta en **Firmante**. El campo se queda en su sitio. ## Ver también [#zie-ook] # Resumen (/es-ES/handtekeningen) Con **Firmas** haces que un PDF como un contrato de alquiler, las normas de la casa, una exención de responsabilidad o un aval se firme en línea. Los firmantes firman uno tras otro, y tú decides en qué lugar de las páginas va cada firma, rúbrica o campo por rellenar. Cómo hacerlo, lo encuentras en [Solicitar firmas](/handtekeningen/handtekening-vragen). Cuando todos han firmado, Tillor crea un PDF firmado con páginas de prueba al final. Ese PDF queda después en los **Documentos** del cliente y cada firmante recibe una copia. Tu PDF original se conserva sin cambios. Preparar, enviar, recordar, retirar y cancelar solicitudes de firma requiere el permiso **Gestionar solicitudes de firma**, en el grupo **Firmas** de Ajustes > Usuarios. Si no tienes ese permiso, esos botones aparecen en gris. Todos los usuarios de tu organización pueden ver las solicitudes y firmar ellos mismos cuando les toca. - Una solicitud tiene como máximo 10 firmantes y solo admite archivos PDF, de hasta 250 MB. - Por defecto se puede firmar durante 14 días, hasta el final del último día. Tú eliges otra fecha si quieres. - Un firmante al que le toca firmar recibe por defecto un recordatorio a los 3 días (puedes elegir de 1 a 14 días), con un máximo de 2 recordatorios automáticos. Estos salen con el control diario de Tillor. - Al firmar, el firmante confirma con un código de 6 cifras. El código es válido 10 minutos y a los 2 minutos se puede pedir uno nuevo. - Tu PDF original nunca cambia. El original y el PDF firmado puedes archivarlos pero no eliminarlos, porque son la prueba. - La solicitud pasa al estado Caducada durante el control diario, no en el momento exacto en que termina el plazo. ## Dónde encontrarlo [#waar-vind-je-het] - Administración > Firmas muestra todas las solicitudes de firma con su estado y cuántas firmas hay ya. - En el perfil de un cliente, la pestaña **Documentos** tiene el botón **Solicitar firmas**, y debajo las **Solicitudes de firma** de ese cliente. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Una solicitud de firma pertenece siempre a un cliente y a un PDF. Los firmantes no tienen por qué ser el propio cliente: también puede firmar un contacto, un compañero o una parte externa. ```mermaid flowchart LR A[PDF en el cliente] --> B[Solicitud de firma con firmantes y campos] B --> C[Firma el firmante 1] C --> D[Firma el firmante 2] D --> E[PDF firmado con páginas de prueba] E --> F[Documentos del cliente] E --> G[Copia para cada firmante] ``` ## Cómo avanza una solicitud [#hoe-een-verzoek-verloopt] ```mermaid flowchart LR A[Borrador] -->|Enviar| B[En curso] B -->|todos han firmado| C[Completada] B -->|un firmante rechaza| D[Rechazada] B -->|Cancelar solicitud| E[Cancelada] B -->|plazo terminado| F[Caducada] B -->|Volver a editar| A ``` ## Estados [#statussen] | Estado | Significado | |---|---| | Borrador | Todavía estás preparando la solicitud. Aún no se ha enviado nada. | | En curso | La solicitud se ha enviado y se está firmando. | | Completada | Todos han firmado y el PDF firmado está en el cliente. | | Rechazada | Un firmante rechazó. La solicitud se ha detenido. | | Cancelada | Tú o un compañero habéis retirado la solicitud. | | Caducada | No se firmó a tiempo. | Por firmante ves **En espera** (aún no le toca), **Enlace enviado** (le toca), **Firmado** o **Rechazado**. ## Quién puede firmar [#wie-kan-ondertekenen] | Tipo | Cómo firma esa persona | |---|---| | **Cliente** | Mediante un enlace personal por correo, o por SMS si solo hay número de teléfono | | **Contacto** | Igual que el cliente, para un contacto de ese cliente | | **Empleado** | En el propio Tillor, sin código | | **Parte externa** | Igual que el cliente, con un nombre y un correo electrónico o número de teléfono que rellenas tú | Un cliente, contacto o parte externa también puede firmar en el mostrador, en una tableta con la aplicación de Tillor. Ver [En la tableta de la recepción](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie). ## Automatizar [#automatiseren] Una solicitud de firma puede iniciar una [automatización](/automatiseringen/triggers). Con **Solicitud de firma completada** creas, por ejemplo, una tarea en cuanto se firma un contrato de alquiler, y con **Solicitud de firma modificada** reaccionas a cada cambio de estado. Estos mismos eventos puedes enviarlos como [webhook](/ontwikkelaars/webhooks) a tu propio sistema. ## Conceptos [#begrippen] - **Solicitud de firma**: el encargo de hacer firmar un PDF, con firmantes, campos y un plazo. Ver [solicitud de firma](/begrippen#ondertekenverzoek). - **Firmante**: alguien que debe firmar. Un cliente, contacto, empleado o parte externa. - **Campo**: un lugar del PDF donde un firmante firma, pone su rúbrica o rellena algo. - **Borrador**: una solicitud que todavía estás preparando. Aún no se ha enviado nada. - **Páginas de prueba**: las páginas al final del PDF firmado que indican quién firmó, cuándo y cómo. Ver [página de prueba](/begrippen#bewijspagina). - **Sello**: la firma digital de tu organización con la que se cierra el PDF firmado. Ver [sello](/begrippen#zegel). # Así firma alguien (/es-ES/handtekeningen/ondertekenen) Esta página muestra lo que viven tus firmantes, para que puedas responder a sus preguntas, y cómo hacer que alguien firme en el mostrador en la tableta. Una solicitud la envías tú mismo con [Solicitar firmas](/handtekeningen/handtekening-vragen). Antes de empezar: - La solicitud debe estar en el estado En curso y al firmante le debe tocar firmar. Si todavía no le toca a nadie, aparece **Aún no es tu turno**. - Para la tableta necesitas el permiso **Gestionar solicitudes de firma** y la aplicación de Tillor debe estar en línea en un dispositivo de tu organización. - El firmante necesita un número de teléfono o un correo electrónico, porque el código se envía allí. Solo un empleado firma sin código. ## En la tableta de la recepción [#op-de-tablet-aan-de-receptie] Si alguien está delante de ti, no hace falta que abra el enlace él mismo. Esto sirve para un cliente, contacto o parte externa al que le toca firmar. ### Abre la solicitud [#open-het-verzoek] Ve a Administración > Firmas y abre la solicitud, o ábrela desde la pestaña **Documentos** del cliente. ### Haz clic en Firmar en tableta [#klik-op-op-tablet-tekenen] En el firmante al que le toca, haz clic en **Firmar en tableta** y elige cómo se confirma la identidad: - **Con código**: el firmante confirma en la tableta con el código que llega por SMS o correo, como con el enlace. - **Sin código**: has comprobado la identidad en el mostrador, por ejemplo con un documento de identidad. No se pide código. En la hoja de prueba consta que la identidad la confirmó un empleado, y en el historial quién fue. Tillor avisa con **Abierto en la tableta**. ### Haz que la persona firme [#laat-de-persoon-tekenen] El documento se abre en la aplicación de la tableta, con el nombre del firmante en letras grandes arriba. Comprueba ese nombre junto con la persona antes de seguir. Los pasos son los mismos que con el enlace, ver más abajo. Justo después de enviarlo, la tableta puede mostrar un momento **Preparando el documento…**. Después de firmar o rechazar, la tableta vuelve a la pantalla de inicio al cabo de unos segundos. Con varios firmantes, envías a cada uno por separado a la tableta cuando le toca. En la hoja de prueba consta que la firma se puso en la tableta. ## ¿Qué hace el firmante? [#wat-doet-de-ondertekenaar] El firmante recibe un correo, o un SMS si solo hay número de teléfono. Contiene un enlace personal a la página de firma, con tu mensaje y el nombre de tu organización. La página funciona en un teléfono, una tableta y un ordenador, en el idioma del firmante. El firmante ve el documento directamente en la aplicación, después de que hayas elegido **Firmar en tableta**. No hace falta enlace ni correo. Quien firma en la tableta con código, recibe el código en su propio teléfono o en su correo. Después, los pasos son los mismos. ### Empezar [#beginnen] En la primera tarjeta aparece quién más firma, el lugar en la cola (por ejemplo *Firmante 2 de 3*) y los pasos. A la derecha está el documento, con las firmas de los firmantes anteriores ya colocadas. Con **Empezar a firmar** el firmante comienza. Cada paso tiene un botón para volver. El botón de volver del teléfono también funciona. ### Dibuja tu firma [#teken-je-handtekening] El firmante dibuja una **Firma** con el dedo o el ratón, o elige **Escribir** y teclea su nombre completo. Tillor pone entonces ese nombre escrito en una letra manuscrita. Si hay campos de rúbrica, sigue del mismo modo una **Rúbrica** (dibujada o con iniciales escritas). Con **Borrar** el firmante empieza de nuevo. Cambiar entre **Dibujar** y **Escribir** vacía el recuadro. ### Coloca tu firma [#plaats-je-handtekening] El firmante toca cada recuadro marcado del documento (**Haz clic para firmar** o **Haz clic para rubricar**). **Siguiente campo** salta al siguiente recuadro vacío. Con **Recuadro anterior** y **Recuadro siguiente** el firmante recorre todos los recuadros. Un segundo toque en un recuadro ya relleno no hace nada. ### Rellena tus datos [#vul-je-gegevens-in] Solo si has colocado campos por rellenar: texto, fecha o una casilla marcada. En cada recuadro aparece **obligatorio** u **opcional**. Un recuadro obligatorio vacío detiene el paso. Lo que se escribe aparece enseguida en el documento. El nombre y la fecha de firma los rellena Tillor por sí mismo. ### Confirma y firma [#bevestig-en-onderteken] El firmante marca que ha leído el documento. Si falta algo, aparece una lista con botones que llevan a ese paso. Solo cuando todo está listo, el firmante hace enviar un código de 6 cifras con **Enviar código de verificación**: por SMS si hay número de teléfono, si no por correo. El código es válido 10 minutos. Si no llega, a los 2 minutos se puede usar **Reenviar código**. Después el firmante hace clic él mismo en **Firmar**. Nunca se firma automáticamente. ## ¿Qué ves después? [#wat-zie-je-daarna] - Si todavía no le toca a nadie, aparece **Aún no es tu turno** y llega un mensaje en cuanto sea el momento. - Quien ya ha firmado ve **Has firmado** hasta que los demás terminan. - En cuanto todos han firmado, cada firmante puede descargar el PDF firmado mediante el mismo enlace (**Firmado por todos**). - En una solicitud retirada, el firmante ve **Solicitud retirada**; en una caducada, **Plazo de firma terminado**; y en una rechazada, **Firma detenida**. - Un empleado firma en Tillor, con el botón **Firmar ahora** de la página de detalle o con el enlace del mensaje. No hace falta código, porque esa persona ya ha iniciado sesión. También aquí la firma puede ser dibujada o escrita. ## Rechazar [#weigeren] Con **Rechazar la firma** un firmante puede rechazar la solicitud y, opcionalmente, dar un motivo (hasta 500 caracteres). La solicitud se detiene entonces, ya no se pide nada a nadie más y quien creó la solicitud recibe un mensaje. Ver [Seguir una solicitud](/handtekeningen/opvolgen#wat-gebeurt-er-daarna). ## ¿Problemas? [#problemen] El botón solo aparece si la aplicación de Tillor en un dispositivo de tu organización ha contactado con Tillor en los últimos minutos, y solo con un cliente, contacto o parte externa al que le toca firmar. Abre la aplicación en la tableta, espera un momento y recarga la página. Comprueba también que **Mostrar recibos y documentos** esté activado en los [ajustes del dispositivo](/mobiele-app/toestelinstellingen#kassabonnen-en-geluid). Ver también [Tabletas y quioscos](/mobiele-app/tablets-en-kiosken). Tillor no pudo alcanzar ninguna tableta que muestre documentos. Comprueba que la aplicación esté abierta y que el dispositivo tenga conexión, y vuelve a intentarlo. El código va al número de teléfono, o al correo electrónico si no hay número de teléfono. Haz que el firmante mire la carpeta de spam y que use **Reenviar código** a los 2 minutos. Si el número o la dirección no son correctos, cámbialos en el cliente o en la persona de contacto y envía un recordatorio. En una parte externa, cancelas la solicitud y creas una nueva con los datos correctos. El código introducido no es correcto o ha caducado. Un código es válido 10 minutos. El firmante pide uno nuevo con **Reenviar código** y lo introduce. Cada intento incorrecto consta en el historial como **Código incorrecto introducido**. Falta algo todavía. Bajo **Pendiente antes de poder firmar** aparece lo que queda: dibujar la firma o la rúbrica, tocar algún recuadro más o rellenar un recuadro obligatorio. También debe estar marcada la casilla de que ha leído el documento. Si la solicitud ha vuelto a borrador, se ha cancelado o ha caducado, el enlace antiguo ya no funciona. Tras volver a enviarla, el firmante recibe un enlace nuevo. En una solicitud cancelada o caducada debes crear una nueva. La página ya estaba abierta mientras la solicitud cambiaba, por ejemplo porque ya está firmada. La página muestra ahora su estado. No ha ido nada mal. ## Ver también [#zie-ook] # Seguir una solicitud (/es-ES/handtekeningen/opvolgen) Tras enviar una solicitud de firma, la sigues en la página de detalle: quién ya ha firmado, a quién le toca y qué más puedes hacer. Desde aquí también envías un recordatorio, cancelas una solicitud y descargas el PDF firmado. Antes de empezar: - Ver puede hacerlo cualquiera. Recordar, cancelar, devolver a borrador y enviar a la tableta requiere el permiso **Gestionar solicitudes de firma**. Sin ese permiso, esos botones aparecen en gris. - La solicitud debe estar enviada. Un Borrador lo editas en el editor, ver [Solicitar firmas](/handtekeningen/handtekening-vragen). ## Abrir la solicitud [#het-verzoek-openen] Abre Administración > Firmas. La lista muestra por solicitud el **Título**, el **Cliente**, el **Estado**, cuántos han **Firmado** ya, cuándo se **Creó** y hasta cuándo se puede firmar (**Firmar antes del**). Busca por título o por nombre de cliente, o filtra con **Estado**, por ejemplo solo las solicitudes que aún están en curso. Haz clic en una solicitud para abrirla. Las mismas solicitudes aparecen también en el cliente, en la pestaña **Documentos**, bajo **Solicitudes de firma**. ## La página de detalle [#de-detailpagina] A la izquierda ves los datos de la solicitud, los firmantes por orden y el **Historial**. A la derecha está el documento, con las firmas que ya se han colocado. Arriba aparece a quién se está esperando, por ejemplo *Esperando la firma de Marc Janssens.* Por firmante ves si todavía debe esperar (**En espera**), ha recibido el enlace (**Enlace enviado**), ha **Firmado** o **Rechazado**, con la hora. La página se actualiza sola cuando alguien firma. ### Antes y después: de En curso a Completada [#voor-en-na-van-bezig-naar-afgerond] Así se ve el mismo tipo de solicitud durante la firma y después. Primero está en En curso: el inquilino ha firmado y le toca al avalista. En cuanto firma el último firmante, pasa a Completada. Todas las firmas están en el documento, el historial se ha completado y arriba aparece el botón para descargar el PDF firmado. ## Enviar un recordatorio [#een-herinnering-sturen] En un firmante al que le toca, haz clic en **Enviar recordatorio**. Esa persona recibe de nuevo el mismo enlace, y Tillor avisa con **El enlace se ha vuelto a enviar**. El enlace del primer mensaje sigue funcionando también. El botón no aparece en los empleados, que firman en Tillor, ni en los firmantes que todavía deben esperar. Además, Tillor envía recordatorios por sí mismo. Un firmante al que le toca recibe un recordatorio pasados los días que indicaste en **Recordatorio tras** (por defecto 3), contados desde el primer mensaje o el recordatorio anterior. Esto ocurre un máximo de 2 veces por firmante, y durante el control diario de Tillor. Por eso un recordatorio puede llegar hasta un día más tarde que el número de días que configuraste. ## Hacer firmar en la tableta [#laten-tekenen-op-de-tablet] Si el firmante está en el mostrador, haz clic en **Firmar en tableta** en esa persona. Cómo funciona y por qué el botón a veces no aparece, lo lees en [En la tableta de la recepción](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie). ## Firmar tú mismo como empleado [#zelf-ondertekenen-als-medewerker] Si le toca a un compañero o a ti, esa persona recibe un mensaje con un enlace a Tillor. En la página de detalle aparece entonces el botón **Firmar ahora**. ## Cancelar una solicitud [#een-verzoek-annuleren] Haz clic en **Cancelar solicitud** y confirma. Los enlaces de firma dejan entonces de funcionar y las firmas ya dadas no se usan. Si prefieres seguir adelante, haz clic en **Mantener**. Cancelar solo es posible mientras la solicitud está En curso. Una solicitud completada, rechazada o caducada ya no cambia. ## Volver a editar [#terug-naar-bewerken] Si todavía no ha firmado nadie, o solo has firmado tú, en la página de detalle aparece **Volver a editar**. La solicitud vuelve a ser un borrador, los enlaces enviados dejan de funcionar y todos firman de nuevo tras el envío. Si ya ha firmado otra persona, el botón no aparece. Cancela entonces la solicitud y crea una nueva. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - **Alguien firma**: el firmante pasa al estado **Firmado** y el siguiente recibe el enlace. La página se actualiza sola. - **Todos han firmado**: ves brevemente *Todos han firmado. Se está preparando el PDF firmado.* La solicitud pasa a Completada. El PDF firmado aparece como **[título] (firmado)** en los **Documentos** del cliente, con el mismo tipo de documento que el PDF original. Si este no tenía tipo, recibe el tipo **Acuerdo firmado**. Cada firmante recibe una copia. - **Alguien rechaza**: la solicitud se detiene con el estado Rechazada. Quien creó la solicitud recibe un aviso y ya no se pide nada a los demás firmantes. En el firmante aparece el motivo, si se rellenó. - **Tú cancelas**: la solicitud pasa al estado Cancelada y los enlaces dejan de funcionar. - **El plazo ha terminado**: pasado el día indicado en **Firmar antes del**, nadie puede firmar ya. Tillor pone la solicitud en Caducada durante el control diario. Hasta ese control, en la página de detalle ves que el plazo ha terminado. Si quieres que alguien aún firme, crea una nueva solicitud. ## El PDF firmado [#de-ondertekende-pdf] En la página de detalle descargas el PDF con **Descargar PDF firmado**, bajo el historial. Allí aparece también el **Sello de tiempo**, ver [Prueba y validez](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel). Por correo, el PDF va como adjunto en el mensaje al firmante. Si eso no funciona, aparece un botón para descargarlo. Quien solo tiene número de teléfono recibe un SMS con un enlace. El PDF firmado y el PDF original son la prueba de la firma. Por eso no puedes eliminarlos, pero sí archivarlos. ## Historial y eventos [#verloop-en-gebeurtenissen] Bajo **Historial** aparece cada paso con la hora y quién lo hizo: creada, enviada, enlace enviado, página abierta, código enviado, código incorrecto, firmado, rechazado, devuelto, cancelado, caducado y completado. La misma línea aparece en el cliente, en la pestaña **Eventos**, y en el [registro de actividad](/activiteitenlog). ## ¿Problemas? [#problemen] El botón solo aparece en un firmante con el estado **Enlace enviado**, es decir, al que le toca. En un empleado no aparece nunca, porque firma en Tillor. Si aparece pero en gris, te falta el permiso **Gestionar solicitudes de firma**. Vuelve a intentarlo. Si sigue fallando, comprueba el correo electrónico y el número de teléfono del firmante. En un cliente o una persona de contacto, los cambias en sus datos. En una parte externa, cancelas la solicitud y creas una nueva con los datos correctos. Ya ha firmado alguien distinto de ti. Entonces la solicitud ya no puede volver a borrador. Cancela la solicitud con **Cancelar solicitud** y crea una nueva. Cancelar solo es posible en una solicitud que está En curso. Recarga la página y mira cuál es ahora el estado. Una solicitud completada, rechazada o caducada ya no se puede cancelar. Ves *El plazo de firma ha terminado; la solicitud caduca en el próximo control diario.* Nadie puede firmar ya. En cuanto se haya ejecutado el control, la solicitud estará en Caducada. Tillor todavía está preparando el PDF. Recarga la página pasados unos minutos. En cuanto esté listo, aparece en los documentos del cliente y se muestra **Descargar PDF firmado**. Si pasado un cuarto de hora aún no está listo, Tillor lo vuelve a intentar en el siguiente control diario. Es lo previsto. El PDF original y el PDF firmado son la prueba. Sí puedes archivarlos. ## Ver también [#zie-ook] # Escaneos de identidad (/es-ES/identiteitsscans) Con un lector de identidad escaneas pasaportes, documentos de identidad, carnés de conducir, visados y permisos de residencia. Tillor reconoce el tipo de documento, lee los datos y con ellos crea rápidamente un cliente, sin que tengas que reescribirlo todo. El lector envía el escaneo a tu organización a través del [Conector de Tillor](/connector) en tu red local. Cómo crear después un cliente, lo encuentras en [Crear un cliente a partir de un escaneo](#klant-aanmaken-vanuit-een-scan). - Un escaneo sin cliente vinculado, Tillor lo elimina automáticamente a los 7 días, junto con los archivos correspondientes. - Un escaneo vinculado se conserva hasta que tú lo desvinculas o lo eliminas. El plazo de conservación lo decides tú. - Crear un cliente a partir de un escaneo requiere al menos un nombre de pila en el escaneo. - Si ya existe un cliente con el mismo número de registro nacional, vincula el escaneo a ese cliente en lugar de crear un duplicado. - Los archivos de escaneo se guardan cifrados. En las imágenes de las páginas aparece una marca de agua **Not valid as ID**. El retrato queda sin marca de agua. - El conector escucha por defecto en el puerto 8765. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] ```mermaid flowchart LR subgraph lokaal[Red local] R[Lector de identidad] C[Conector de Tillor] end T[Escaneo pendiente en Tillor] K[Cliente o persona de contacto] R --> C C --> T T -->|Crear o vincular cliente| K T -->|Sin vincular a los 7 días| X[Eliminado automáticamente] ``` Un escaneo empieza como escaneo pendiente. Si lo vinculas a un cliente o a una persona de contacto, se conserva en ese cliente. ## Crear un cliente a partir de un escaneo [#klant-aanmaken-vanuit-een-scan] Antes de empezar: - El escaneo debe estar en Tillor como escaneo pendiente. Si no está, ver Problemas al final. - El escaneo necesita un nombre de pila. ### Abre la lista de clientes [#open-de-klantenlijst] Ve a Clientes > Resumen y haz clic en **Crear nuevo cliente**. Mientras haya escaneos pendientes, el botón muestra un menú: elige **Manual** o un escaneo de la lista. ### Comprueba el escaneo [#controleer-de-scan] Al elegir un escaneo se abre una confirmación con una vista previa del documento y los datos de la zona de lectura. Haz clic en **Crear cliente**. La misma vía funciona con **Iniciar reserva** (**Nuevo cliente…**) y con el panel de abajo a la derecha con **Crear cliente a partir del escaneo**. ### ¿Qué pasa después? [#wat-gebeurt-er-daarna] - Tillor crea el cliente, vincula el escaneo y rellena, donde es posible, nombre, apellido, fecha de nacimiento, dirección y otros campos. - Llegas al nuevo perfil del cliente. - El escaneo ya no está en la cola y se conserva en el cliente. - La vinculación consta en la pestaña **Eventos** del cliente. ## Vincular a un cliente o una persona de contacto existente [#koppelen-aan-een-bestaande-klant-of-contactpersoon] Además de un cliente nuevo, también puedes vincular un escaneo a un cliente o una persona de contacto existente. En el perfil del cliente aparece una tarjeta de puntos **Asignar un escaneo de identidad pendiente** mientras haya escaneos pendientes adecuados. Elige un escaneo con **Elegir escaneo…** y haz clic en **Asignar a este cliente**. En la tarjeta de una persona de contacto puedes vincular un escaneo que todavía no tenga contacto y contenga al menos un nombre de pila, con **Asignar a contacto**. También puedes hacer que se cree un contacto nuevo con **Crear contacto a partir del escaneo**. Tras vincular, Tillor completa los datos del cliente o del contacto donde es posible. Como nombre de pila, Tillor toma solo la primera parte del nombre, por ejemplo `Andy` de `Andy Adhemar R`. En el escaneo siguen visibles todos los nombres. ## Desvincular, exportar o eliminar un escaneo [#een-scan-ontkoppelen-exporteren-of-verwijderen] En un escaneo vinculado hay acciones para **Descargar**, **Exportar PDF**, **Desvincular escaneo** y **Eliminar escaneo**. Eliminar quita de forma permanente el escaneo y todos los archivos cifrados y no se puede deshacer. ## Plazo de conservación y tu responsabilidad [#bewaartermijn-en-jouw-verantwoordelijkheid] Los escaneos que todavía no están vinculados a un cliente, Tillor los elimina automáticamente a los 7 días (el escaneo y los archivos correspondientes). Vincula o procesa a tiempo los escaneos pendientes con **Crear nuevo cliente**, el panel de abajo a la derecha o la tarjeta de puntos de un perfil de cliente. Para los escaneos vinculados rige otra regla: se conservan hasta que tu organización los desvincula o los elimina. Tú decides si, cuándo y con qué base jurídica se escanean documentos de identidad y cuánto tiempo hacen falta los escaneos vinculados. Tillor trata los escaneos como encargado del tratamiento siguiendo tus instrucciones. El cumplimiento de la normativa de privacidad, los plazos de conservación de los escaneos vinculados y la eliminación a tiempo cuando ya no hace falta guardarlos son responsabilidad tuya como responsable del tratamiento. ## ¿Problemas? [#problemen] Comprueba en el lector la dirección IP del conector y el puerto 8765, y que el conector esté funcionando. Ver [Conector](/connector). Solo cuentan como pendientes los escaneos sin cliente vinculado. Si el escaneo ya está vinculado, o tiene más de 7 días y por tanto se ha eliminado, ya no aparece. En el escaneo aparece el motivo. Si el escaneo no tiene nombre de pila, aparece *rellénalo en el escáner o vincula este escaneo manualmente*. Si el documento sigue siendo válido y ya existe un cliente con este número de registro nacional, abre el cliente propuesto arriba de la tarjeta o vincula el escaneo a ese cliente. El cliente no se ha creado y el escaneo sigue pendiente. Vuelve a intentarlo. Si no funciona, crea el cliente manualmente y vincula el escaneo con **Asignar a cliente**. Vuelve a intentarlo, o usa el panel de abajo a la derecha. ## Conceptos [#begrippen] - **Escaneo de identidad**: los datos y las imágenes leídos de un documento de identidad. - **Escaneo pendiente**: un escaneo que todavía no está vinculado a un cliente y desaparece a los 7 días. - **Zona de lectura (MRZ)**: las líneas de letras y cifras al pie del documento que lee el lector. - **Conector**: la cajita de tu red local que reenvía los escaneos a Tillor. Ver [conector](/begrippen#connector). - **Cliente**: el registro en Tillor. Ver [cliente](/begrippen#klant). ## Ver también [#zie-ook] # Leer y responder conversaciones (/es-ES/inbox/gesprekken) En la bandeja de entrada se reúnen todas las conversaciones de sus canales conectados. Aquí las lee, responde y las ordena. Cómo conectar un canal se explica en [Bandeja de entrada](/inbox). Antes de empezar: - Necesita el permiso **Ver bandeja de entrada** para leer conversaciones y **Gestionar bandeja de entrada** para responder o archivar. Sin **Ver bandeja de entrada**, la bandeja no aparece en la barra lateral. - Debe haber al menos un canal conectado. De lo contrario verá un enlace a Ajustes > Integraciones. ## Abrir la bandeja de entrada [#de-inbox-openen] ### Vaya a la bandeja de entrada [#ga-naar-de-inbox] En la barra lateral, bajo **Soporte**, elija **Bandeja de entrada** (marca **1** en la captura). Si todavía no hay ningún canal conectado, Tillor muestra un enlace a Ajustes > Integraciones. ### Elija una conversación [#kies-een-gesprek] A la izquierda está la lista **Conversaciones** con los hilos de todos los canales. Con **Abiertas** y **Archivadas** alterna entre las conversaciones activas y las resueltas. Haga clic en una conversación para abrirla a la derecha. Una conversación abierta muestra los mensajes en orden, con nombre y hora. Abajo está el campo de respuesta (marca **2** en el ejemplo). El fondo de una conversación sigue al canal: beige para WhatsApp, burbujas azules para Messenger, rosa para Instagram y gris claro para el chat web. ## Enviar una respuesta [#een-antwoord-sturen] ### Abra la conversación [#open-het-gesprek] Haga clic en la conversación de la lista. ### Escriba su respuesta [#typ-je-antwoord] Escriba abajo, en el campo de respuesta. ### Envíe [#verstuur] Haga clic en **Enviar** o pulse **Ctrl+Intro**. En sus propios mensajes aparece, junto a la hora, una marca para enviado, una doble marca para entregado y una doble marca azul para leído. Las respuestas que envíe desde la aplicación WhatsApp Business o desde la aplicación Messenger también aparecen en la conversación mientras la integración esté activa. Un mensaje que ya ha enviado no se puede editar. Los canales no ofrecen esa opción. En Messenger e Instagram, junto a un mensaje de texto propio hay un botón de eliminar. Este solo oculta el mensaje en Tillor; el cliente conserva el mensaje en su propia aplicación. Las fotos entrantes de Messenger se guardan y se muestran en la conversación; en la lista aparece entonces un icono de foto en lugar de texto. Las reacciones con emoji a mensajes de Messenger aparecen como contadores bajo el mensaje. ### WhatsApp y la ventana de respuesta de 24 horas [#whatsapp-en-het-antwoordvenster-van-24-uur] Un cliente que le escribe por WhatsApp abre una ventana de respuesta gratuita de 24 horas. Tillor muestra **Ventana de respuesta gratuita abierta** con una cuenta atrás. Si la ventana está cerrada, aparece **Ventana de 24 horas cerrada** y su respuesta se envía como plantilla de pago de WhatsApp, hasta que el cliente vuelva a escribir. - Si no se ha añadido ningún método de pago a su cuenta de WhatsApp Business en Meta WhatsApp Manager, Tillor bloquea las respuestas de pago. Las respuestas gratuitas dentro de la ventana siguen siendo posibles. - Si Meta aún no aprueba la plantilla en el idioma de su organización, su respuesta queda en espera. Suele tardar unos minutos y puede llegar a 48 horas. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Su respuesta aparece en la conversación con una marca: enviado, entregado o leído. Si la entrega falla, aparece **No entregado**. - Una conversación archivada desaparece de **Abiertas**. Si el cliente vuelve a escribir, la conversación reaparece. - La conversación también figura en el cliente, en Clientes > cliente > Comunicaciones. ## Encontrar y ordenar conversaciones [#gesprekken-terugvinden-en-opruimen] - **Buscar**: filtre los hilos por nombre o número de teléfono, dentro de **Abiertas** o **Archivadas**. - **No leídas**: en **Abiertas**, las conversaciones no leídas aparecen en negrita, con un punto rojo. Haga clic en **Marcar todo como leído** en la parte superior de la lista para marcarlo todo como leído de una vez. - **Archivar**: haga clic en **Archivar** en una conversación resuelta de **Abiertas**. - **Restaurar**: abra una conversación en **Archivadas** y haga clic en **Restaurar** para devolverla a la lista y poder volver a responder. - **Menú contextual**: haga clic con el botón derecho o mantenga pulsada una conversación para ver **Marcar como leído**, **Marcar como no leído**, **Fijar conversación** o **Desfijar conversación**, **Archivar** y **Restaurar**. El número junto a **Bandeja de entrada** en la barra lateral cuenta las conversaciones abiertas cuyo último mensaje es del cliente y que esperan respuesta. Los mensajes nuevos aparecen en directo; el número se actualiza solo. ## Etiquetas [#tags] Con las etiquetas clasifica las conversaciones para todo su equipo. 1. Abra una conversación y use el bloque **Etiquetas** del panel lateral. 2. Cree una etiqueta con **Nueva etiqueta** o elija una existente. En el menú de etiquetas edita o elimina etiquetas. 3. Filtre la lista con el icono de etiqueta situado junto al filtro de plataforma. Las etiquetas con **La IA puede aplicar** pueden ser añadidas por Tillie tras una respuesta automática. Las etiquetas que su equipo ya había puesto se conservan. ## Notificaciones [#meldingen] Los usuarios con **Notificaciones de mensajes de la bandeja** reciben una notificación push con cada mensaje nuevo de un cliente. Sus propias respuestas no generan notificación. Con **Ver bandeja de entrada** verá también, ante un mensaje nuevo, un aviso abajo a la derecha, en el mismo dock que los escaneos de identidad pendientes y las llamadas telefónicas activas. Ahí figuran el remitente, el canal y un fragmento del texto. Haga clic en él para abrir la conversación. El aviso desaparece tras unos diez segundos, salvo que mantenga el ratón encima. Si la conversación ya está abierta, no aparece ningún aviso. ## Conversaciones y clientes [#gesprekken-en-klanten] Tillor vincula una conversación a un cliente cuando es posible: - WhatsApp por número de teléfono. - Messenger por un nombre coincidente, o por un número de teléfono o correo electrónico que el propio cliente comparta en la conversación. - Instagram por un nombre coincidente o por el nombre de usuario con `@`. Meta no transmite ningún correo electrónico ni número de teléfono a través de Messenger e Instagram. Las conversaciones abiertas de un cliente también figuran en Clientes > cliente > Comunicaciones. El panel lateral derecho muestra, por canal, los datos del participante, como el número de WhatsApp, el nombre de usuario de Instagram con enlace al perfil o la página en el caso del chat web. Con el icono de panel situado sobre la conversación oculta o muestra el panel. ## ¿Problemas? [#problemen] Necesita el permiso **Ver bandeja de entrada**. Pida a un administrador que se lo conceda en Ajustes > Usuarios, con **Editar permisos** junto a su nombre. Para responder necesita **Gestionar bandeja de entrada**. En una conversación archivada tampoco puede responder: haga clic primero en **Restaurar**. Compruebe que la conversación está abierta y que tiene **Gestionar bandeja de entrada**. En WhatsApp, la causa también puede ser la ventana de respuesta cerrada, véase arriba. Después vuelva a intentarlo. El canal no pudo entregar el mensaje. En WhatsApp suele deberse a la ventana de 24 horas cerrada o a un método de pago que falta en Meta. Todavía no hay ningún canal conectado, o aún no ha llegado ningún mensaje. Conecte un canal en Ajustes > Integraciones. Tillor adapta la conversación automáticamente cuando un cliente edita o retira un mensaje en Messenger o Instagram, o lo edita en WhatsApp (dentro de 15 minutos). ## Véase también [#zie-ook] # Asistente de IA de la bandeja de entrada (Tillie) (/es-ES/inbox/inbox-ai-assistant) **Tillie** es el nombre predeterminado del asistente de IA de la [bandeja de entrada de Tillor](/inbox). Responde a las preguntas frecuentes, recopila datos para solicitudes de reserva o de venta y traspasa la conversación a su equipo cuando hace falta un compañero. Tillie funciona en **todos los canales de la bandeja de entrada**: [chat web](/inbox/website-chat), [WhatsApp Business](/inbox/whatsapp-business-inbox), [Messenger](/inbox/messenger) e [Instagram Direct](/inbox/instagram). Instale **Asistente de IA de la bandeja de entrada** por separado en **Ajustes > Integraciones**. El asistente pertenece a la bandeja de entrada, no solo al widget del sitio web. ## Instalar la integración [#integratie-installeren] 1. Vaya a **Ajustes > Integraciones** (barra lateral, bajo **Soporte**) 2. Abra **Asistente de IA de la bandeja de entrada** en la lista 3. Haga clic en **Instalar** 4. En **Ajustes**, defina lo que Tillie puede hacer (véanse los campos siguientes) | Campo | ¿Qué hace? | |------|----------------| | **IA de la bandeja de entrada activada** | Interruptor principal de todas las funciones de IA de la bandeja de entrada. Desactívelo para detenerlas sin desinstalar | | **Enviar respuestas automáticas** | Desactivado: Tillie no envía mensajes a los visitantes. Las traducciones, la detección de idioma y los borradores de respuesta para el equipo pueden seguir activos por separado | | **Activar la IA automáticamente en conversaciones nuevas** | Solo se aplica si las respuestas automáticas están activadas. Desactivado: cada conversación nueva empieza sin IA; la activa por conversación desde la barra lateral. Activado: las conversaciones nuevas de todos los canales reciben IA de inmediato (con 30 minutos de pausa tras un mensaje del equipo) | | **Generar borradores para el equipo** | Permite a los compañeros generar un borrador de IA en el cuadro de redacción. Ese borrador nunca se envía automáticamente | | **Traducir mensajes** | Traduce los mensajes entrantes al idioma de la organización y las respuestas del equipo al idioma del contacto. Las respuestas del equipo también reciben puntuación correcta, mayúsculas y abreviaturas de chat escritas por completo (incluso cuando no hace falta traducir) | | **Detectar el idioma del contacto** | Usa IA para detectar el idioma del visitante si aún no se conoce, y lo guarda en la conversación | | **Nombre del asistente de IA** | Nombre en las respuestas y los prompts (predeterminado **Tillie**) | | **Servidores MCP (JSON)** | Opcional. Conexiones MCP de solo lectura (URL y encabezados) | | **Herramientas MCP** | Tras guardar: **Cargar herramientas**, listar las herramientas de solo lectura y activar o desactivar cada una | Active **IA de la bandeja de entrada activada**, active **Traducir mensajes** (y, si quiere, **Detectar el idioma del contacto**) y desactive **Enviar respuestas automáticas**. Tillie traducirá, pero no enviará nada a los visitantes. ### Herramientas MCP (opcional) [#mcp-tools-optioneel] Si su parque tiene un servidor MCP con conexiones de solo lectura, Tillor puede obtener **datos del parque en directo** durante una conversación. Por ejemplo, actividades, caravanas en venta u otros datos que ofrezca su servidor. Tillor **no tiene una lista fija de nombres de herramientas**. Las herramientas que existen las verá tras **Cargar herramientas** en los ajustes de la integración. Solo puede activar herramientas que su servidor MCP marque como de solo lectura. 1. Rellene **Servidores MCP (JSON)** (URL y encabezados). 2. Guarde y haga clic en **Cargar herramientas**. 3. Active las herramientas que correspondan a su parque. Según la configuración de IA de su entorno, Tillie elige por sí misma qué herramienta activada encaja, basándose en la descripción de la herramienta de su servidor. Nunca llama a herramientas que usted no haya activado. Los resultados de MCP pasan a la respuesta de Tillie. No sustituyen a la base de conocimientos: precios, disponibilidad y normas no se los inventa si no proceden de ningún sitio. Tillie usa un modelo de IA que Tillor configura para su entorno. Si el asistente no responde, póngase en contacto con el soporte de Tillor. ## Qué hace Tillie tras un mensaje de un visitante [#wat-tillie-doet-na-een-bezoekersbericht] Tras cada mensaje entrante nuevo en una conversación donde la IA está activa: 1. Tillor muestra un **indicador de escritura** en el canal mientras se genera la respuesta 2. Tillor determina la intención: **reserva**, **venta** u **otro** (las organizaciones con flujo de caravana de alquiler también **caravana de alquiler**) 3. Tillie responde en el idioma del visitante; después desaparece el indicador de escritura Tillie decide por sí misma, según sus instrucciones, cuándo responde y cuándo calla. Ante un saludo inicial ("hola", "hey", "buenas") responde con una breve bienvenida y la pregunta de en qué puede ayudar. Tras un agradecimiento de cierre, no vuelve a reaccionar a un breve "gracias", "vale" o "no" del visitante, para que no se forme un bucle de agradecimientos. | Intención | Comportamiento | |-----------|--------| | **Reserva** | Pide los datos que faltan: llegada, salida, tipo (tienda, mobil home, caravana), perros sí/no (y cuántos), número de personas, niños y edades, después nombre, correo electrónico y número de teléfono, y opcionalmente la matrícula para el check-in (se puede omitir). Los datos que Tillor ya conoce (p. ej. del widget del sitio web o de WhatsApp) se rellenan; solo se piden los campos que faltan. Con un día de la semana ("lunes"), Tillie plantea primero una pregunta de confirmación ("¿Se refiere a …?") antes de continuar. Cada respuesta termina con una pregunta. Responde a preguntas breves de política desde la base de conocimientos (p. ej. modificar una reserva más adelante) y luego sigue recopilando. Cuando todo está completo, Tillie resume la **solicitud** y traspasa la conversación a un compañero; todavía no hay una reserva definitiva | | **Caravana de alquiler** | Recopila nombre, correo electrónico, dirección, país y motivo de la estancia (si se solicita), y después traspasa a su equipo | | **Venta** | Explica que el visitante debe pasar por la oficina para una visita o compra, y se lo comunica a su equipo | | **Otro** | Responde solo si la respuesta está en la base de conocimientos. En caso contrario, Tillie dice con sinceridad que no lo sabe, se ofrece a transmitir la pregunta a un compañero y traspasa la conversación | Tillie **no se inventa precios, disponibilidad ni normas**. Solo lo que figura en la base de conocimientos puede afirmarse como un hecho. ### Formulario de reserva en su sitio web [#boekingsformulier-op-je-website] ¿Conecta un formulario propio a [Chat web](/inbox/website-chat)? Entonces puede hacer que Tillie solo confirme y traspase de inmediato, sin preguntas de admisión. Eso encaja con un formulario cuya pestaña se cierra después. Véase [API del chat web - metadatos](/ontwikkelaars/website-chat#metadata-boekingsformulier). ## Por conversación: Automático, Activado o Desactivado [#per-gesprek-automatisch-aan-of-uit] En los detalles de la conversación, en la barra lateral, elige por hilo: | Modo | Comportamiento | |-------|--------| | **Automático** | Tillie responde, pero hace una pausa de **30 minutos** tras cada mensaje de su equipo | | **Activado** | Tillie responde siempre, incluso justo después de un mensaje del equipo | | **Desactivado** | Tillie no responde en esta conversación | Durante la pausa verá una cuenta atrás en la barra lateral. ## Etiquetas tras una respuesta de IA [#tags-na-een-ai-antwoord] En el panel lateral puede crear y asignar **etiquetas** para toda la organización (permiso **Gestionar bandeja de entrada**). Use **Nueva etiqueta** para crear una. Abra el menú de etiquetas en una conversación para asignarlas; editar y eliminar cada etiqueta está en ese mismo menú. Marque **La IA puede aplicar** si Tillie puede añadir esa etiqueta tras una respuesta automática. Tillie elige entonces por sí misma cero o más de esas etiquetas según la conversación; las etiquetas que su equipo ya había puesto se conservan. Etiquetas típicas son, por ejemplo, **Venta**, **Reserva** y **Urgente**. Tillie reconoce esos nombres y los vincula con lo que ya ha determinado en la conversación: | Intención de Tillie | Encaja con nombres de etiqueta como | |---|---| | Venta | Verkoop, Sale | | Reserva | Boeking, Reservatie, Booking | | Caravana de alquiler | Caravan, Verhuur | | Traspaso urgente | Urgent, Spoed, Dringend | El nombre de la etiqueta no tiene que coincidir exactamente: **Boeking aanvragen** también cuenta como etiqueta de reserva. Solo se tienen en cuenta las etiquetas con **La IA puede aplicar**. ## Idioma, tono y datos de contacto [#taal-toon-en-contactgegevens] Las respuestas siguen el idioma del visitante, no solo los cuatro idiomas del widget (`en`, `nl`, `de`, `fr`), sino cualquier idioma en el que Tillie pueda responder (p. ej. español, polaco, turco). Si alguien pide expresamente otro idioma, Tillie cambia y guarda el idioma elegido en la conversación. Los **resúmenes de traspaso** (visibles solo para su equipo) siguen siempre el **idioma de la organización** en Tillor, en cada traspaso (reserva, caravana de alquiler, venta, pregunta abierta, petición expresa de un compañero), independientemente del idioma de la conversación. Tillie recibe ese idioma de la organización en cada prompt. Los mensajes a los visitantes (IA y equipo) son siempre **texto plano**, sin markdown, porque WhatsApp, Instagram, Messenger y el widget no lo admiten. En WhatsApp, Tillie puede añadir hasta tres botones de respuesta bajo una respuesta breve, cuando un toque es una elección que el propio mensaje ya menciona. El mensaje sigue siendo legible si el cliente escribe en lugar de tocar. Fuera de la ventana de 24 horas, la respuesta se envía como plantilla sin botones. Tillie se mantiene serena y profesional, no habla de la competencia y no ignora las normas de seguridad si un visitante pide que ignore las instrucciones. Los datos de contacto para derivaciones proceden de su **perfil de organización de Tillor** (nombre, dirección, teléfono, correo electrónico, sitio web). El **horario de apertura de la oficina** lo define en **Ajustes > Horario de apertura** (horario semanal, periodos de temporada, festivos y excepciones); Tillie usa ese horario para indicar cuándo puede responder un compañero. Mantenga esos campos actualizados. Aproximadamente una semana antes de un festivo oficial, Tillor recuerda por correo electrónico a la dirección de soporte si el horario de ese día aún no está rellenado. ## Eventos en la conversación (solo para su equipo) [#gebeurtenissen-in-het-gesprek-alleen-voor-je-team] Durante la admisión de una reserva, Tillie actualiza nombre, correo electrónico y teléfono en cuanto el visitante los facilita. En la bandeja de entrada aparece entonces un evento **Datos de IA actualizados** (de → a), visible solo para su equipo. En un traspaso aparece un evento **Traspaso de IA**: una tarjeta destacada con un resumen (tabla para datos de reserva o de caravana de alquiler, más notas para preguntas abiertas). El resumen está siempre en el **idioma de su organización** (nl, en, de o fr), incluso cuando el visitante chatea en otro idioma. El visitante no ve esa tarjeta. ## Base de conocimientos: hechos que Tillie puede usar [#kennisbank-feiten-die-tillie-mag-gebruiken] Tillie responde a las preguntas a partir de una **base de conocimientos**: artículos breves con hechos verificados sobre su parque, por ejemplo horario de apertura, normas sobre mascotas, la piscina, puntos de carga o cómo modificar una reserva más adelante. Algunos artículos valen para todas las organizaciones de Tillor, otros son específicos de su parque. En una conversación, Tillie solo usa los artículos generales más los que se hayan añadido para su organización. ¿Quiere que se añadan, modifiquen o eliminen temas? Comuníquelo al soporte de Tillor. Rellenamos y mantenemos la base de conocimientos junto con usted, adaptada a lo que su recepción quiera poder responder. ## Flujos de conversación: guion por intención [#gespreksflows-draaiboek-per-bedoeling] Además de la base de conocimientos, Tillie sigue **flujos de conversación**: acuerdos sobre qué datos pide, en qué orden y cuándo traspasa la conversación a su equipo. Cada intención (reserva, caravana de alquiler, venta, otro; véase la tabla anterior) tiene su flujo. Los flujos vienen preconfigurados, pero Tillor los ajusta con usted a su parque. ¿Quiere, por ejemplo, que se pidan otros datos en una solicitud de reserva, o que Tillie traspase antes? Comuníquelo al soporte de Tillor. Revise las respuestas de IA en la bandeja de entrada antes de confiárselas a los visitantes. Una reserva por chat sigue siendo una **solicitud**, no una reserva definitiva. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una conversación que Tillie traspasa aparece en la bandeja de entrada con un bloque **Tillie transfirió esta conversación a su equipo** y los datos recopilados. - Su equipo recibe una notificación. En un traspaso urgente se envía mediante la notificación **Transferencia urgente de IA**. Véase [Tipos de notificación](/communicatie/notificatietypes). - Si un compañero responde, Tillie hace una pausa de 30 minutos en el modo **Automático**. ## ¿Problemas? [#problemen] Compruebe que **IA de la bandeja de entrada activada** y **Enviar respuestas automáticas** están activados en Ajustes > Integraciones > Asistente de IA de la bandeja de entrada. Después mire en la barra lateral de la conversación si el modo no está en **Desactivado**, o si hay una cuenta atrás en marcha tras un mensaje de su equipo. **Activar la IA automáticamente en conversaciones nuevas** está desactivado. Active el interruptor, o elija **Activado** por conversación. Tillie solo usa lo que figura en la base de conocimientos y no se inventa precios, disponibilidad ni normas. Complete la base de conocimientos. ## Relacionado [#gerelateerd] # Resumen (/es-ES/inbox) En la bandeja de entrada lee y responde a los mensajes de clientes y visitantes que llegan por WhatsApp, Messenger, Instagram o el chat de su sitio web, todo en un solo lugar. La encuentra en la barra lateral, en **Soporte > Bandeja de entrada**. Primero conecta los canales que quiere usar y después trabaja a diario en [Leer y responder conversaciones](/inbox/gesprekken). La bandeja de entrada está pensada para la comunicación en ambos sentidos con los clientes. Las notificaciones automáticas de WhatsApp, por ejemplo con un saldo NFC bajo, pasan por Twilio y no por estas integraciones. - Un mensaje nuevo aparece como tarjeta abajo a la derecha y desaparece tras unos diez segundos. El número junto a **Bandeja de entrada** cuenta las conversaciones abiertas que esperan respuesta - El asistente de IA Tillie hace una pausa de 30 minutos después de que un compañero haya respondido - Un mensaje de chat en el sitio web puede tener como máximo 4096 caracteres, sin imágenes ni archivos - Un cliente puede editar un mensaje de WhatsApp hasta 15 minutos después de enviarlo, y usted lo ve en la conversación - El recordatorio por correo electrónico a un visitante del sitio web se envía tras unos 5 minutos de inactividad. El enlace funciona 30 días - Un mensaje propio que elimina en Tillor (Messenger e Instagram) desaparece solo en Tillor, no para el cliente ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Cada canal se instala por separado. Después todas las conversaciones llegan a la misma lista, y Tillor las vincula a un cliente cuando es posible. ```mermaid flowchart LR W[WhatsApp] --> I[Bandeja de entrada] M[Messenger] --> I G[Instagram] --> I C[Chat en su sitio web] --> I I --> K[Cliente vinculado por teléfono o nombre] I --> A[Tillie responde o traspasa] A --> T[Su equipo] I --> T T -->|respuesta| W T -->|respuesta| M T -->|respuesta| G T -->|respuesta| C ``` - Su equipo responde en Tillor. La respuesta vuelve al cliente por el mismo canal. - Tillie, el asistente de IA, puede responder y traspasar una conversación a su equipo. Usted lo decide por conversación. - Las respuestas que envíe fuera de Tillor, por ejemplo en la aplicación WhatsApp Business, también aparecen en la conversación. ## Conectar canales [#kanalen-koppelen] Instale una integración por canal en Ajustes > Integraciones. En Messenger, al conectar, Tillor trae las conversaciones existentes de la página. Si Messenger ya está conectado, también puede iniciar esa sincronización manualmente desde la bandeja de entrada. ## Trabajo diario [#dagelijks-werken] ## Permisos [#rechten] | Permiso | ¿Qué puede hacer el usuario? | |-----------|------------------------| | **Ver bandeja de entrada** | Abrir la bandeja de entrada y leer conversaciones | | **Gestionar bandeja de entrada** | Enviar respuestas, archivar, restaurar y fijar conversaciones, marcarlas como no leídas y eliminar mensajes propios en Tillor (Messenger e Instagram) | | **Notificaciones de mensajes de la bandeja** | Recibir notificaciones push con los mensajes nuevos de clientes | Defina los permisos en Ajustes > Usuarios. ## Conceptos [#begrippen] - **Conversación o hilo**: todos los mensajes con un cliente o visitante en un canal. - **Abiertas y Archivadas**: las dos pestañas de la lista de conversaciones. Archivar saca una conversación de **Abiertas**, restaurar la devuelve. - **Tillie**: el nombre predeterminado del asistente de IA en la bandeja de entrada. Puede cambiar el nombre. Encontrará más términos en el [glosario](/begrippen). # Instagram (/es-ES/inbox/instagram) Con **Instagram** recibe los mensajes de Instagram Direct en la [bandeja de entrada de Tillor](/inbox). La integración usa una **página de Facebook** conectada con una **cuenta profesional de Instagram** en Meta Business Suite. Antes de empezar: - Necesita el permiso **Gestionar integraciones**. - Su cuenta de Instagram es una cuenta profesional (Business o Creator), conectada a una página de Facebook. ## Instalar la integración [#integratie-installeren] 1. Vaya a **Ajustes** (barra lateral, bajo **Soporte**) 2. Elija **Integraciones** y abra **Instagram** en la lista (marca **2**) 3. Haga clic en **Instalar** (marca **1**) y complete el flujo OAuth de Meta (permisos de mensajería de Instagram) 4. Elija la **página de Facebook** vinculada a su cuenta profesional de Instagram 5. Compruebe el campo **Nombre de usuario de Instagram** bajo la selección de página (Tillor muestra la cuenta conectada, por ejemplo `@suCuenta`) 6. Guarde los ajustes Sin una cuenta profesional de Instagram conectada a la página seleccionada, Tillor no puede completar la integración. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tras la instalación, los mensajes entrantes de Instagram Direct llegan solos a la [bandeja de entrada](/inbox). - Las respuestas desde la aplicación de Instagram también aparecen en la bandeja de entrada. Los mensajes que envíe a través de Tillor no se muestran por duplicado. - Si aun así no llega ningún mensaje, póngase en contacto con el soporte de Tillor. La conexión de Instagram con Meta debe estar configurada para toda la plataforma. - Messenger e Instagram son integraciones distintas. Si quiere ambos canales en la bandeja de entrada, instale las dos. ## ¿Problemas? [#problemen] ### La conexión falla o no hay Instagram en la página [#koppelen-mislukt-of-geen-instagram-op-de-pagina] Si la instalación se detiene con *No se pudo conectar la aplicación* o *Ninguna cuenta profesional de Instagram*, compruebe en Meta: 1. **Instagram profesional**: su cuenta de Instagram debe ser Business o Creator (no una cuenta personal). 2. **Vincular la página**: en [Meta Business Suite](https://business.facebook.com/) o en Business Settings, vincule la cuenta de Instagram a la **página de Facebook** con la que inicia sesión. 3. **Acceso a los mensajes**: en la aplicación de Instagram, vaya a **Ajustes** > **Mensajes y respuestas a historias** > **Herramientas conectadas** y permita el acceso a los mensajes (necesario para Direct en aplicaciones de bandeja de entrada). 4. **Inicio de sesión correcto en Meta**: use una cuenta que sea **administradora** de la página de Facebook con permisos de mensajería. Al instalar, Tillor busca todas las páginas de Facebook de su cuenta y elige la primera página con una cuenta profesional de Instagram conectada. Si tiene varias páginas, tras la instalación puede elegir otra en los ajustes de la integración. Al instalar, Tillor solicita siempre los permisos `instagram_basic`, `instagram_manage_messages` y `pages_read_engagement`. Póngalos primero en **Ready for testing** bajo **Use cases** (Messenger/Instagram) en la Meta Developer Console. **Invalid Scopes** significa que aún no figuran en la aplicación de Meta. Los permisos `instagram_business_*` pertenecen a otro método de inicio de sesión y no son para Tillor. ## Relacionado [#gerelateerd] # Messenger (/es-ES/inbox/messenger) Con **Messenger** recibe en la [bandeja de entrada de Tillor](/inbox) los mensajes de los clientes a través de una página de Facebook conectada. Antes de empezar: - Necesita el permiso **Gestionar integraciones**. - Inicia sesión en Meta con una cuenta que sea administradora de la página de Facebook. ## Instalar la integración [#integratie-installeren] 1. Vaya a **Ajustes** (barra lateral, bajo **Soporte**) 2. Elija **Integraciones** y abra **Messenger** en la lista (marca **2**) 3. Haga clic en **Instalar** (marca **1**) y complete el flujo OAuth de Meta 4. En la página de detalle, elija qué **página de Facebook** recibe los mensajes de Messenger 5. Guarde los ajustes Tillor muestra la página conectada en **Ajustes**, en la página de detalle. Tras la instalación, Tillor recibe automáticamente los mensajes entrantes de Messenger. Las respuestas que envíe también desde la aplicación Messenger aparecen en la bandeja de entrada. Los mensajes que envíe a través de Tillor no se muestran por duplicado. Para **Instagram Direct** instale la integración independiente [Instagram](/inbox/instagram). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tillor trae las conversaciones existentes de la página. Más adelante también puede iniciar esa sincronización usted mismo desde la bandeja de entrada. - Los mensajes nuevos llegan solos a la [bandeja de entrada](/inbox). Tillor los vincula a un cliente con el mismo nombre, o por un número de teléfono o correo electrónico que el cliente comparta en la conversación. ## ¿Problemas? [#problemen] Compruebe en Ajustes > Integraciones > Messenger que se ha elegido la **página de Facebook** correcta y que los ajustes se han guardado. Meta no transmite ningún correo electrónico ni número de teléfono a través de Messenger. Tillor solo vincula por un nombre coincidente o por datos que el propio cliente comparta. ## Relacionado [#gerelateerd] # Conversaciones por chat web (/es-ES/inbox/website-chat-gesprekken) Una conversación aparece en la bandeja de entrada en cuanto el visitante envía su primer mensaje, con el canal **Chat del sitio web**. Cómo responder se explica en [Leer y responder conversaciones](/inbox/gesprekken). Esta página explica lo que se ve de más en el chat web. En el panel lateral derecho hay un botón **Abrir en el sitio web** con la página donde el visitante estuvo activo por última vez, además de datos del visitante y de la sesión. Los campos adicionales del formulario del visitante también figuran ahí. ## ¿Quién es el visitante? [#wie-is-de-bezoeker] - Tillor reconoce a un visitante por su navegador. El mismo navegador en el mismo dispositivo abre, por tanto, la misma conversación. - El nombre, el correo electrónico y el teléfono del formulario del visitante se guardan en ese navegador tras el primer mensaje. Si el visitante vuelve más tarde, no tiene que rellenar nada de nuevo. - Si ese almacenamiento está vacío, por ejemplo en otro navegador o tras una limpieza, el widget completa los datos a partir de la conversación existente. - Los mensajes son texto de hasta 4096 caracteres. No se admiten imágenes ni archivos. ## Escritura y presencia [#typen-en-aanwezigheid] | Qué | Quién lo ve | Dónde | |-----|--------------|------| | **Escribiendo…** mientras el visitante escribe | Su equipo | Bajo la conversación en la bandeja de entrada, incluso antes del primer mensaje | | **Escribiendo…** mientras un compañero escribe | El visitante | En el widget | | **En línea** (punto verde) o **Visto por última vez** con una hora | Su equipo | Sobre la conversación | El visitante cuenta como en línea mientras la pestaña esté visible. El widget envía una señal de vida aproximadamente cada 20 segundos. Obtener mensajes, escribir y leer también cuentan como actividad. ## Marcas de verificación [#vinkjes] Los visitantes ven marcas en sus propios mensajes: | Marcas | Significado | |---------|-----------| | Una | Enviado | | Dos grises | Su equipo ha abierto la conversación y ha cargado los mensajes | | Dos azules | Su equipo ha marcado la conversación como leída | En la bandeja de entrada ve marcas en sus propias respuestas: | Marcas | Significado | |---------|-----------| | Una | Enviado | | Dos grises | El visitante está en la página y ha obtenido los mensajes, incluso con el chat cerrado | | Dos azules | El visitante tiene abierta la ventana de chat | Las respuestas de la bandeja de entrada aparecen automáticamente en el widget, incluso si el visitante abre la ventana más tarde. ## Actividad del visitante en la conversación [#bezoekersactiviteit-in-het-gesprek] Tras el primer mensaje, su equipo ve un texto informativo gris en la conversación. El visitante no lo ve. Estas líneas no aumentan ningún contador de no leídos ni generan notificación push. | Evento | Texto en la bandeja de entrada | |-------------|-------------------| | Chat cerrado | El usuario cerró el chat | | Otra pestaña o ventana minimizada | El usuario cambió de pestaña o minimizó el navegador | | Se abrió otra página | El usuario navegó a la URL de la página | La navegación también se detecta en sitios que cambian de página internamente sin recargar. El widget transmite la página actual aproximadamente cada 20 segundos, de modo que el panel lateral muestra la última página activa. ## Tillie en el chat web [#tillie-op-website-chat] Tillie, el asistente de IA, también funciona en el widget. Para ello instale **Asistente de IA de la bandeja de entrada** por separado. La instalación, la base de conocimientos y el comportamiento se explican en [Asistente de IA de la bandeja de entrada (Tillie)](/inbox/inbox-ai-assistant). Los mensajes de Tillie llevan en el widget un robot en lugar del logotipo de la organización. En cuanto el visitante escribe, su equipo puede ver **Escribiendo…**. El primer mensaje solo se envía con **Enviar**, junto con los datos de contacto rellenados. ## Véase también [#zie-ook] # Ajustes del chat web (/es-ES/inbox/website-chat-instellingen) Encontrará los ajustes en Ajustes > Integraciones > Chat web. Instalar y colocar el fragmento se explica en [Poner el chat en su sitio web](/inbox/website-chat). ## Widget [#widget] | Campo | ¿Qué hace? | |------|---------------| | **Widget activado** | Oculta el chat en todas partes sin eliminar la integración. Activado por defecto | | **Mostrar en páginas públicas de Tillor** | Muestra el botón de chat en páginas públicas de Tillor como el pase de acceso, la factura pendiente y el mapa público. Su propio sitio usa el fragmento. Activado por defecto | | **Mensaje de bienvenida** | Texto en el encabezado del chat y antes del primer mensaje del visitante. Máximo 500 caracteres. Si lo deja vacío, se usa un texto predeterminado en el idioma del widget | | **Tooltip del lanzador** | Etiqueta del botón flotante, pensada para lectores de pantalla. Máximo 80 caracteres | | **Mensaje de respuesta pronto** | Línea bajo el nombre de la organización en el encabezado del chat, por ejemplo "Solemos responder rápido" | | **Icono del lanzador** | Icono del botón de chat: **Bocadillo de diálogo**, **Chat redondeado**, **Signo de interrogación**, **Búsqueda** o **Persona** | | **Color de acento** | Color del botón de chat y de los mensajes del visitante. Elija un color o introduzca un valor hexadecimal, por ejemplo `#2563eb` | | **Dominios permitidos** | Nombres de host separados por comas que pueden cargar el chat. Vacío significa: cualquier dominio | | **Notificar por correo a visitantes sobre respuestas no leídas** | Véase [más abajo](#herinnering-per-e-mail). Activado por defecto | El encabezado del chat muestra automáticamente el logotipo de su organización. Los mensajes del asistente de IA llevan un robot en lugar de ese logotipo. Ninguno de los dos se puede configurar en Chat web. Si no define **Mensaje de bienvenida**, **Tooltip del lanzador** o **Mensaje de respuesta pronto**, el widget usa un texto predeterminado en su propio idioma. Ese idioma lo define en el fragmento con `data-locale` (véase [Opciones del fragmento](#opties-op-het-snippet)). ## Formulario del visitante [#bezoekersformulier] Aquí decide lo que rellena un visitante antes del primer mensaje. Si hay campos obligatorios, aparecen juntos con el campo de mensaje en una sola pantalla. El visitante lo rellena todo y hace clic en **Enviar**, sin un paso intermedio aparte. ### Campos predeterminados [#standaardvelden] | Campo | ¿Qué hace? | |------|---------------| | **Nombre obligatorio** | Los visitantes introducen su nombre. El nombre se guarda en la conversación | | **Correo electrónico obligatorio** | Los visitantes introducen su dirección de correo electrónico. La dirección se guarda en la conversación | | **Teléfono obligatorio** | Los visitantes introducen un número de teléfono. Tillor lo convierte a una notación fija y lo usa para vincular la conversación a llamadas y clientes | Cada campo se activa o desactiva por separado. Si solo está activado el teléfono, el visitante solo ve el campo de teléfono. ### Campos adicionales [#extra-velden] Haga clic en **Añadir campo** para preguntas propias. Puede añadir como máximo 8 campos adicionales. Elimine un campo con **Eliminar campo**. | Opción | Explicación | |-------|--------| | **Etiqueta del campo** | Lo que ve el visitante en el widget. Máximo 80 caracteres | | **Clave del campo** | Nombre interno del campo. Empiece con una letra minúscula y use solo minúsculas, cifras y `_` (máximo 32 caracteres) | | **Tipo de campo** | **Texto** o **Correo electrónico** | | **Obligatorio** | El visitante debe rellenar el campo antes de poder chatear. Un campo nuevo es obligatorio por defecto | | **Marcador de posición** | Pista en el campo de entrada. Máximo 120 caracteres | Las respuestas a los campos adicionales figuran en la bandeja de entrada, en la conversación, junto al canal y al id del visitante. ## Recordatorio por correo electrónico [#herinnering-per-e-mail] Los visitantes suelen cerrar la página antes de que su equipo o Tillie responda. Con **Notificar por correo a visitantes sobre respuestas no leídas**, el visitante recibe un correo electrónico con el botón **Continuar la conversación** en cuanto hay una respuesta lista que no ha leído. - El visitante debe haber facilitado una dirección de correo electrónico, mediante el formulario del visitante o rellenada de antemano. Sin dirección no ocurre nada. - El correo solo se envía cuando el visitante lleva unos 5 minutos sin actividad. Por cada serie de respuestas no leídas recibe un único correo. - El botón abre el chat y continúa la conversación, también en otro dispositivo o en otro navegador. El enlace funciona 30 días. - El visitante también puede responder directamente al correo. Esa respuesta aparece en la misma conversación de la bandeja de entrada, con un pequeño icono de sobre junto al mensaje. - Las respuestas de Tillie cuentan igual que las de su equipo. ## Opciones del fragmento [#opties-op-het-snippet] Además de `data-org-id` y `data-widget-key`, puede poner atributos opcionales en el script. Esto está pensado para quien coloca el fragmento en el sitio. | Atributo | ¿Qué hace? | |-----------|---------------| | `data-locale` | Idioma del widget: `en`, `nl`, `de`, `fr`, `pt` o `ro`, opcionalmente con región como `nl-BE`. Por defecto `en`; otro idioma recurre al inglés. La región determina el formato de fecha y hora | | `data-accent-color` | Color de acento para esta página como hexadecimal de 6 cifras. Prevalece sobre el color de **Ajustes** | | `data-messages` | Objeto JSON para adaptar textos sueltos, por ejemplo `{"send":"Versturen","messagePlaceholder":"Typ uw bericht…"}` | | `data-sounds` | `false` desactiva los sonidos en las respuestas nuevas del equipo y al enviar. Activado por defecto | | `data-launcher` | `false` oculta el botón de chat flotante. Entonces abre el chat con su propio botón mediante [el SDK del widget](/ontwikkelaars/website-chat#widget-sdk) | | `data-visitor` | Objeto JSON para rellenar de antemano nombre, correo electrónico y teléfono, por ejemplo `{"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"}` | | `data-visitor-name`, `data-visitor-email`, `data-visitor-phone` | Rellena de antemano uno de esos campos | | `data-debug` | `true` muestra líneas de registro en la consola del navegador | Los atributos solo completan campos vacíos. Si el visitante ya ha rellenado datos en este navegador, se conservan. Un ejemplo con textos en neerlandés: ```html ``` También puede activar la depuración sin modificar el fragmento: ejecute `localStorage.setItem('tillor-inbox-debug', '1')` en la consola del navegador y actualice la página. ## Protección contra spam [#spambeveiliging] El widget no usa captcha. Tillor protege el envío con la clave del widget y con **Dominios permitidos**. Si su formulario de contacto tiene un captcha propio, puede dejarlo como capa adicional. ## Condiciones para visitantes [#voorwaarden-voor-bezoekers] Bajo el campo de mensaje hay un breve aviso de que, al enviar, el visitante acepta las [condiciones del chat web](https://tillor.eu/chat-terms). El enlace se abre en una pestaña nueva y sigue el idioma de `data-locale`. ## Véase también [#zie-ook] # Poner el chat en su sitio web (/es-ES/inbox/website-chat) Con la integración de Chat web, su sitio obtiene un botón de chat. Los mensajes de los visitantes llegan a la [bandeja de entrada](/inbox), junto a WhatsApp, Messenger e Instagram. ### Instale la integración [#installeer-de-integratie] Vaya a Ajustes > Integraciones y abra **Chat web**. Haga clic en **Instalar**. No hace falta vincular ninguna cuenta externa; Tillor crea por sí mismo la clave del widget. ### Configure el widget [#stel-de-widget-in] En **Ajustes**, en la misma página, rellene como mínimo el **Mensaje de bienvenida** y el **Color de acento**. Rellene también **Dominios permitidos** para que solo su sitio pueda cargar el chat. Todas las opciones figuran en [Ajustes del chat web](/inbox/website-chat-instellingen). ### Copie el fragmento [#kopieer-het-snippet] Bajo **Insertar en su sitio web**, haga clic en **Copiar fragmento**. Si el bloque no aparece, guarde los ajustes y actualice la página. ### Pegue el fragmento en su sitio [#plak-het-snippet-op-je-site] Pegue el fragmento antes de la etiqueta de cierre `` en cada página donde deba aparecer el botón de chat. En un sitio con una plantilla o pie de página compartidos, colóquelo una sola vez en esa plantilla. ## ¿Qué verá después? [#wat-zie-je-daarna] Abra su sitio. Abajo a la derecha hay un botón de chat. Envíe usted mismo un mensaje de prueba: la conversación aparece en la bandeja de entrada con el canal **Chat del sitio web**. La explicación de lo que ven usted y el visitante está en [Conversaciones por chat web](/inbox/website-chat-gesprekken). La clave es legible en el fragmento, como en otros productos de chat. Limite el abuso con **Dominios permitidos** (nombres de host separados por comas, por ejemplo `recreatiepark-het-meer.be, www.recreatiepark-het-meer.be`). Si deja el campo vacío, el chat funciona en cualquier dominio donde esté el fragmento. ## Chat en páginas públicas de Tillor [#chat-op-publieke-tillor-paginas] Si **Chat web** está instalado, **Widget activado** está activado y **Mostrar en páginas públicas de Tillor** está activado, el botón de chat también aparece en las páginas públicas de su organización. Ahí no hace falta colocar ningún fragmento. Se trata, entre otras, de las páginas de un pase de acceso, una factura pendiente, una etiqueta NFC, los datos de la organización y el mapa público. - En esas páginas, Tillor usa el **Color de acento** de los ajustes. - **Dominios permitidos** solo vale para su propio sitio web, no para las páginas de Tillor. - Si desactiva **Widget activado**, el botón desaparece en todas partes. Si desactiva solo **Mostrar en páginas públicas de Tillor**, el chat sigue funcionando en su propio sitio. ## Desactivar el chat temporalmente [#de-chat-tijdelijk-uitzetten] Desactive **Widget activado** en Ajustes > Integraciones > Chat web. La integración sigue instalada y la clave de su widget no cambia. Vuelva a activar el interruptor para recuperar el chat. ## ¿Problemas? [#problemen] Compruebe primero que **Widget activado** está activado. Si hay una lista en **Dominios permitidos**, vea si el nombre de host de la página figura en ella, incluido `www.` si su sitio lo usa. Compruebe también que el fragmento está realmente en esa página y no solo en una plantilla que esa página no usa. Tillor muestra entonces el aviso de que no se pudo cargar el fragmento. Guarde los ajustes y actualice la página. En las páginas de Tillor no hace falta ningún fragmento. Su propio sitio solo muestra el chat con el fragmento del paso 3. Eso lo resuelve un desarrollador con el SDK del widget. Véase [API del chat web](/ontwikkelaars/website-chat). Tillor limita lo que un visitante envía por el chat, para que un script no pueda inundar tu bandeja de entrada y las respuestas de Tillie: 10 mensajes por minuto y 200 por día por visitante, y 30 por minuto y 600 por día para todos en la misma red juntos (como el wifi de tu camping). Adjuntos: 10 por hora por visitante y 50 por hora por red. Tras un minuto el visitante puede seguir; no se pierde ningún mensaje ya enviado. El widget muestra este aviso en inglés. ## Véase también [#zie-ook] # WhatsApp Business (/es-ES/inbox/whatsapp-business-inbox) Con **WhatsApp Business** recibe y responde a los mensajes de los clientes por WhatsApp en la [bandeja de entrada de Tillor](/inbox). Esto **no** es lo mismo que las notificaciones de WhatsApp a través de Twilio. Para los mensajes automáticos de WhatsApp (notificaciones), véase [Twilio](/communicatie/providers/twilio). La aplicación **WhatsApp Business** del marketplace es solo para las conversaciones de la bandeja de entrada. Antes de empezar: - Necesita el permiso **Gestionar integraciones**. - Tiene una cuenta de WhatsApp Business en Meta e inicia sesión con una cuenta que la administra. ## Instalar la integración [#integratie-installeren] 1. Vaya a **Ajustes > Integraciones** 2. Abra **WhatsApp Business** en la lista (marca **2**) 3. Haga clic en **Instalar** (marca **1**) y complete el flujo OAuth de Meta 4. Elija qué **número de WhatsApp** recibe los mensajes de la bandeja de entrada 5. Guarde los ajustes Tras la instalación, Tillor recibe automáticamente los mensajes entrantes. Las respuestas que envíe también desde la aplicación WhatsApp Business o desde un dispositivo vinculado aparecen en la bandeja de entrada. Los mensajes que envíe a través de Tillor no se muestran por duplicado. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Los mensajes entrantes aparecen solos en la [bandeja de entrada](/inbox), vinculados al cliente con el mismo número de teléfono. - Las respuestas las envía en Tillor. Fuera de la ventana de 24 horas se envían como plantilla de pago, véase [Leer y responder conversaciones](/inbox/gesprekken#whatsapp-en-het-antwoordvenster-van-24-uur). ## ¿Problemas? [#problemen] Compruebe en Ajustes > Integraciones > WhatsApp Business que se ha elegido el **número de WhatsApp** correcto y que los ajustes se han guardado. Añada un método de pago para su cuenta de WhatsApp Business en Meta WhatsApp Manager. Sin método de pago, Tillor bloquea las respuestas de pago. ## Relacionado [#gerelateerd] # Resumen (/es-ES/integraties) Una integración conecta Tillor con otro servicio, por ejemplo para pagos, contabilidad, telefonía, cámaras o su ficha de Google. Las gestiona todas en Ajustes > Integraciones. Cómo instalar una se explica en [Instalar una integración](/integraties/integratie-installeren). ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Una integración pertenece a toda su organización, no a un solo usuario. Tras instalarla, la conexión funciona donde se necesita: la conexión de cámaras en los puntos de acceso, la conexión de correo en el perfil del cliente, la conexión de pagos en las facturas. Algunas conexiones pasan por el conector, un pequeño programa en un ordenador de su propia red. Este debe estar entonces en línea. ```mermaid flowchart LR A[Ajustes > Integraciones] --> B[Instalar integración] B --> C[Pagos y facturas] B --> D[Perfil del cliente y bandeja de entrada] B --> E[Puntos de acceso y cámaras] E -. vía .-> F[Conector en su red] ``` - Para ver basta con el permiso **Ver integraciones**. Instalar, modificar y desinstalar requiere **Gestionar integraciones**. - Desinstalar no se puede deshacer. Después vuelve a instalar la integración y a rellenar los datos. - Partoo recibe su horario de apertura de los próximos 90 días y una actualización cada noche. Véase [Partoo](/integraties/partoo). - Los pagos realizados hace más de 24 horas ya no reciben superposición de cámara. Véase [UniFi Protect](/integraties/unifi-protect). - Las integraciones que ve dependen de su organización. ¿Falta alguna? Pregúntelo a su administrador de Tillor o al soporte. ## Integraciones disponibles [#beschikbare-integraties] | Integración | Para qué | Explicación | |---|---|---| | Mollie | Pagos en línea y con terminal, domiciliación SEPA | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | | Cuentas bancarias | Importar transacciones bancarias y vincularlas a facturas | [Ponto y cuentas bancarias](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | | Admisol | Enviar informes de pagos a su contabilidad | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | | Odoo | Exportar clientes y facturas a Odoo | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | | ICY | Leer contadores | [Gestión de contadores](/meterbeheer) | | Voys | Vincular llamadas telefónicas a clientes | [Voys](/communicatie/providers/voys) | | WhatsApp Business | Mensajes de WhatsApp en la bandeja de entrada | [WhatsApp Business](/inbox/whatsapp-business-inbox) | | Messenger | Conversaciones de Facebook Messenger en la bandeja de entrada | [Messenger](/inbox/messenger) | | Instagram | Conversaciones de Instagram Direct en la bandeja de entrada | [Instagram](/inbox/instagram) | | Chat web | Chat en directo en su sitio web | [Chat web](/inbox/website-chat) | | Asistente de IA de la bandeja de entrada | Responder automáticamente a las preguntas frecuentes | [Asistente de IA de la bandeja de entrada](/inbox/inbox-ai-assistant) | | UniFi Protect | Conectar cámaras a puntos de acceso y pagos | [UniFi Protect](/integraties/unifi-protect) | | Partoo | Mantener igual el horario de apertura en Google y otras fichas | [Partoo](/integraties/partoo) | | Outlook | Ver el correo de un cliente en el perfil del cliente | [Outlook](/integraties/outlook) | ## Conceptos [#begrippen] - **Integración**: una conexión entre Tillor y un servicio externo. - **Conector**: el programa en su red que conecta a Tillor dispositivos como cámaras e impresoras. Véase [Conector](/connector). - **Instalar y desinstalar**: activar o eliminar una conexión. Eliminar no se puede deshacer. - **Clave de API**: un código secreto con el que Tillor puede trabajar en otro servicio. - **Superposición**: texto que se muestra sobre las imágenes de cámara, por ejemplo un pago. Encontrará más explicaciones en el [glosario](/begrippen). # Instalar una integración (/es-ES/integraties/integratie-installeren) Una integración se instala en Configuración > Integraciones. La buscas, rellenas los datos del servicio externo y haces clic en **Instalar**. Después la ajustas en el bloque **Configuración** o la quitas con **Desinstalar**. Lo que hay disponible aparece en el [resumen](/integraties). Antes de empezar: - Con el permiso **Ver integraciones** solo ves la lista y los ajustes, pero no puedes cambiar nada. - Ten a mano las credenciales o claves del servicio externo. En Outlook se te redirige para que inicies sesión allí tú mismo. - En una conexión que pasa por el conector, como UniFi Protect, el conector debe estar en línea. ## Instalar una integración [#een-integratie-installeren] ### Busca la integración [#zoek-de-integratie] Usa la barra de búsqueda o elige a la izquierda, bajo **Integraciones**, una categoría: **Comunicaciones**, **Vigilancia**, **Pagos**, **Contabilidad** o **Contadores**. **Todas las integraciones** lo muestra todo. Una integración que ya está conectada lleva la etiqueta **Conectado**. ### Abre la integración [#open-de-integratie] Haz clic en ella. Algunas páginas tienen arriba el enlace **Ver documentación**. ### Rellena los datos y haz clic en Instalar [#vul-de-gegevens-in-en-klik-op-installeren] Lo que rellenas depende del servicio. En Outlook se te redirige al propio servicio para iniciar sesión. ## Ajustar o quitar [#aanpassen-of-verwijderen] Tras la instalación, en la misma página aparece un bloque **Configuración**. Ajusta ahí la conexión y guarda. Con **Desinstalar** quitas la conexión. Esto no se puede deshacer. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - La conexión funciona enseguida para toda tu organización. - Lo que hace la conexión lo ves en el lugar al que pertenece, por ejemplo en el perfil del cliente o en un punto de acceso. - Tras **Desinstalar**, la conexión se detiene. Lo que ya está en el otro servicio se queda allí. ## ¿Problemas? [#problemen] No hay ninguna integración que coincida con tu búsqueda o categoría. Prueba otro término o elige **Todas las integraciones**. Si falta una integración que esperas, no está activada para tu organización. Pregúntalo al soporte. No tienes el permiso **Gestionar integraciones**. Pregunta a tu administrador. No se pudo conectar la integración. Comprueba los datos rellenados e inténtalo de nuevo. Inténtalo de nuevo. Si no funciona, escribe a support@tillor.eu. Tu cambio no se ha guardado. Intenta guardar de nuevo. ## Ver también [#zie-ook] # Conectar Outlook (/es-ES/integraties/outlook) Con la conexión de Outlook ves en el perfil del cliente los correos que tu organización ha intercambiado con ese cliente. Tillor los obtiene en directo de Outlook y no los guarda. Antes de empezar: - Necesitas una cuenta de Microsoft cuyo correo Tillor pueda leer. - Para ver el correo en el perfil del cliente necesitas el permiso **Ver bandeja de entrada**. Sin ese permiso falta la pestaña **Outlook**. ## Instalar [#installeren] ### Abre la integración [#open-de-integratie] Ve a Configuración > Integraciones > Outlook. ### Haz clic en Instalar [#klik-op-installeren] Se te redirige a Microsoft. ### Inicia sesión y da tu permiso [#log-in-en-geef-toestemming] Inicia sesión con la cuenta cuyo correo Tillor puede leer. Tras la conexión ves, bajo **Configuración**, el nombre, la dirección de correo y el nombre de usuario de la cuenta conectada, y hasta cuándo está activa la conexión. ## Elegir buzones [#mailboxen-kiezen] Por defecto Tillor solo busca en el buzón de la cuenta conectada. En **Buzones** eliges buzones adicionales, por ejemplo un buzón compartido de recepción. - **Personal** es el buzón de la cuenta conectada. - **Compartido** son los buzones compartidos que esa cuenta puede abrir. Tillor los busca por sí mismo. - **Añadido manualmente** son direcciones que escribes tú. Escribe la dirección y elige **Añadir [dirección]**. ## Correo en el perfil del cliente [#mail-op-het-klantprofiel] En el perfil del cliente aparece una pestaña **Outlook**, entre **Comunicación** y **Eventos**. La pestaña solo está si Outlook está conectado y tienes el permiso **Ver bandeja de entrada**. - Arriba ves el número de mensajes y los buzones en los que se ha buscado. Con **Actualizar** obtienes el correo más reciente. - Tillor busca por la dirección de correo del cliente y de sus contactos. Si nadie tiene dirección de correo, aparece que no hay nada que buscar. - Cada mensaje muestra el asunto, si es **Recibido** o **Enviado**, de quién a quién, y un clip si tiene adjuntos. Haz clic en un mensaje para abrir el texto y los adjuntos. Con **Abrir en Outlook** vas al mensaje en el propio Outlook. - El mismo correo en varios buzones aparece una sola vez en la lista. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - Tillor solo lee el correo y no guarda nada. Si quitas la conexión, la pestaña **Outlook** desaparece del perfil del cliente. ## ¿Problemas? [#problemen] Tillor no pudo obtener la cuenta de Microsoft conectada. Actualiza la página o vuelve a conectar Outlook con **Instalar**. Outlook se conectó antes de que Tillor pudiera buscar buzones compartidos. Haz clic en **Volver a conectar Outlook**, o escribe tú mismo la dirección del buzón compartido. Todavía puedes escribir a mano una dirección de buzón en **Añadido manualmente**. Tillor no pudo cargar correo de Outlook. Inténtalo de nuevo con **Actualizar** o comprueba la conexión. La cuenta conectada no tiene acceso a ese buzón. Comprueba los permisos del buzón en Outlook. Outlook no está conectado, o te falta el permiso **Ver bandeja de entrada**. Intenta abrir el mensaje de nuevo. Si no ayuda, ve con **Abrir en Outlook** al propio mensaje. ## Ver también [#zie-ook] # Conectar Partoo (/es-ES/integraties/partoo) Partoo gestiona tus fichas en Google y otros sitios. Con esta conexión, Tillor envía tu horario de apertura a tu establecimiento de Partoo, para que no tengas que mantenerlo en dos sitios. El horario en sí lo gestionas en Tillor, consulta [Configuración de la organización](/gebruikers/organisaties#openingsuren). Antes de empezar: - Crea en Partoo un usuario aparte para Tillor, sin inicio de sesión en dos pasos. Con verificación en dos pasos Tillor no puede iniciar sesión. - Rellena tu horario de apertura en Tillor, consulta el apartado de horario de apertura en la configuración de la organización. ## Instalar [#installeren] ### Abre la integración [#open-de-integratie] Ve a Configuración > Integraciones > Partoo. ### Rellena los datos del usuario de Partoo [#vul-de-gegevens-van-de-partoo-gebruiker-in] Rellena el **Correo electrónico** y la **Contraseña** de ese usuario. ### Elige tu establecimiento [#kies-je-vestiging] La lista de establecimientos aparece solo cuando se han rellenado el correo electrónico y la contraseña. Elige tu establecimiento en **Establecimiento**. Escribe para buscar en **Buscar establecimientos…**. ### Haz clic en Instalar [#klik-op-installeren] ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] Tillor envía tus horarios semanales, temporadas y días excepcionales del [horario de apertura de tu organización](/gebruikers/organisaties#openingsuren): - Los horarios semanales son los de la semana actual. Partoo no conoce las temporadas, así que Tillor envía el horario de la temporada vigente. - Los días de los próximos 90 días cuyo horario difiere, como otra temporada, un festivo o una excepción, se envían como fechas aparte. Un periodo cerrado se convierte en un solo periodo. - Tillor lo envía cada noche y justo después de cada cambio en el horario de apertura, la zona horaria, el país predeterminado o la propia conexión. Solo se modifica lo que difiere de Partoo. ## Ajustar o quitar [#aanpassen-of-verwijderen] Cambia el correo electrónico, la contraseña o el establecimiento en el bloque **Configuración**. Deja la contraseña vacía para conservar la actual. Con **Desinstalar** se detiene el envío. Lo que ya está en Partoo se queda allí. ## ¿Problemas? [#problemen] Comprueba los datos del usuario de Partoo. Si ese usuario tiene activado el inicio de sesión en dos pasos, desactívalo o crea un usuario aparte. En Partoo, da al usuario acceso a tu establecimiento y vuelve a mirar. Inténtalo de nuevo en un momento. Si persiste, escribe a support@tillor.eu. Comprueba primero el horario de apertura en Tillor, la zona horaria y el país predeterminado. Tras un cambio, Tillor lo envía enseguida, y otra vez cada noche. ## Ver también [#zie-ook] # Conectar UniFi Protect (/es-ES/integraties/unifi-protect) Con la conexión de UniFi Protect llegas, desde un intento de acceso o un evento de un punto de acceso, a la grabación de la cámara correspondiente con un solo clic. Además, los pagos en efectivo y con tarjeta pueden aparecer como texto sobre las imágenes de una cámara, para que puedas revisarlas si hay una diferencia de caja. La instalación es igual que en cualquier integración, consulta [Instalar una integración](/integraties/integratie-installeren). Antes de empezar: - Las cámaras se leen en tu parque a través del [conector](/connector). Debe estar en línea. Si no lo está, Tillor avisa **El conector de Tillor está sin conexión o no es accesible.** - Necesitas los datos de tu consola UniFi OS. Es el aparato o el servidor en el que se ejecuta UniFi Protect. - Para la conexión con puntos de acceso, esos puntos de acceso deben existir, consulta [Control de acceso](/toegangscontrole). ## Instalar [#installeren] ### Abre la integración [#open-de-integratie] Ve a Configuración > Integraciones > UniFi Protect. ### Rellena la consola [#vul-de-console-in] - **Host de la consola**: la dirección IP local o el nombre de host de tu consola UniFi OS. - **Clave API**: un código secreto que creas en la consola, con el que Tillor puede leer las cámaras. - **ID de consola en la nube**: el ID largo que va tras `/consoles/` en la URL de unifi.ui.com de tu consola. ### Elige las cámaras de pago [#kies-de-betaalcameras] En **Cámara pagos en efectivo** y **Cámara pagos POS** elige una cámara, o deja **No registrar**. POS es el terminal de tarjeta. ### Haz clic en Instalar [#klik-op-installeren] En cuanto se rellenan el host y la clave API, Tillor carga las cámaras de la consola. ## Vincular cámaras a puntos de acceso [#cameras-koppelen-aan-toegangspunten] Tras la instalación, en el bloque **Configuración** aparece la tabla **Cámaras por punto de acceso**. Vincula cada **Punto de acceso** a una **Cámara**. Si la lista está vacía, añade primero puntos de acceso. Después, en los detalles de un intento de acceso y de un evento de punto de acceso aparece el enlace **Abrir en UniFi Protect**. Abre la grabación de ese momento en UniFi Protect, en una pestaña nueva. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - Si has elegido una cámara en **Cámara pagos en efectivo** o **Cámara pagos POS**, Tillor envía a esa cámara cada pago que pasa a **Pagado**. Los pagos en efectivo a la cámara de efectivo, los pagos con tarjeta en un terminal a la cámara POS. - Los pagos realizados hace más de 24 horas ya no reciben texto sobre las imágenes. - Los pagos con Mollie solo cuentan si pertenecen al perfil principal de Mollie. - Si cambias los datos, guarda. Si dejas vacía la **Clave API**, la clave existente sigue vigente. Con **Desinstalar** quitas la conexión. ## ¿Problemas? [#problemen] La consola no tiene cámaras, o la clave API no tiene acceso a ellas. Comprueba la clave y si las cámaras se ven en UniFi Protect. Comprueba el host, la clave API y si el conector está en línea. Tillor avisa: **Comprueba el host, la clave API y el conector.** Las cámaras se cargan a través del conector en tu red local. Inicia el conector o restablece la conexión, consulta [Conector](/connector). No hay ninguna cámara vinculada a ese punto de acceso. Vincula una en la tabla **Cámaras por punto de acceso**. Comprueba que la cámara en **Cámara pagos en efectivo** o **Cámara pagos POS** no esté en **No registrar**. Un pago realizado hace más de 24 horas ya no recibe superposición. Un pago con Mollie solo cuenta en el perfil principal. ## Ver también [#zie-ook] # Mapa (/es-ES/kaart) En el mapa ves de un vistazo qué parcelas están libres, reservadas u ocupadas, para cada día que elijas. Aquí también dibujas los límites de tus parcelas, para que Tillor conozca su superficie, y mides distancias. Las parcelas en sí las gestionas en [Parcelas](/terreinen). - El mapa se abre siempre en hoy. Tu estilo, etiquetas y capas sí se conservan. - Las reservas con salida registrada y las canceladas no cuentan para el color, la etiqueta de salida ni la doble reserva. - Las etiquetas de noches y salida desaparecen por debajo del nivel de zoom 17,5. El nombre de la parcela se mantiene. - Una parcela sin límite dibujado no aparece en el mapa. Solo se puede dibujar con el **Modo de edición** activado. - El mapa se abre en el centro del mapa que defines en **Configuración > Mapa**. Ese mismo punto determina también el tiempo. ## Abrir el mapa [#de-kaart-openen] Ve a Parque > Mapa. Ves directamente todas las parcelas con su estado de ocupación. - **Área verde** - parcela reservable libre - **Área gris** - la parcela **no es reservable** y no tiene ninguna estancia activa en la fecha elegida (ni reserva ni ocupación); faltan las etiquetas de noches y de salida - **Área cian** - reserva **registrada**, aún sin entrada registrada (también en días posteriores del periodo de estancia mientras no se haya registrado la entrada) - **Área azul** - reserva con **entrada registrada** (estancia activa en la fecha elegida) - **Área amarilla** - la parcela tiene una ocupación activa (alquiler de larga duración; vale para cualquier fecha elegida mientras dure la ocupación) - **Área roja** (superposición clara, borde rojo) - doble reserva: periodos de reserva que se solapan en la misma parcela Haz clic en una parcela del mapa para abrir una ventana emergente con el nombre, las reservas, la posible ocupación activa (huésped) y accesos directos. ## Elegir la fecha [#datum-kiezen] A la derecha de **Configuración del mapa** eliges una **fecha** (por defecto hoy). El mapa muestra entonces cómo están las parcelas ese día. Tras actualizar la página, la fecha vuelve a ser **hoy**; solo los demás ajustes del mapa (estilo, etiquetas, capas) se conservan. Las reservas con **salida registrada** y las **canceladas** no cuentan para el color, la etiqueta de salida ni la doble reserva (tampoco aparecen en la ventana emergente del mapa). En las parcelas libres aparece bajo el nombre una etiqueta con un icono de luna y el número de noches hasta la próxima entrada. En una reserva u ocupación con fecha de salida aparece una etiqueta con un icono de salida y el número de noches hasta el check-out (0 = hoy). Pasa el ratón sobre una etiqueta para ver el texto completo. En caso de **doble reserva** (dos o más reservas con periodos de estancia que se solapan en la misma parcela), la parcela recibe un borde rojo y una ligera superposición roja; delante del número de la parcela aparece un icono de triángulo rojo. En la ventana emergente ves una advertencia con las reservas implicadas. Por debajo del nivel de zoom **17,5**, el mapa oculta automáticamente las etiquetas de noches y salida; el nombre de la parcela sigue visible. Acércate hasta al menos **17,5** (o desactiva **Noches y salida** en la configuración del mapa) para ver esas etiquetas. Al alejar el zoom, los nombres de las parcelas se muestran más pequeños para que se solapen menos. ## Capas y colores [#lagen-en-kleuren] Abajo a la izquierda hay tres botones: **Capas**, **Exportar a PDF** y **Configuración del mapa**, y a su derecha el selector de fecha. Con **Capas** decides qué ves y cómo se colorean las parcelas. - En **Colores** eliges **Ocupación** o **Tipo de parcela**. Con **Ocupación**, las parcelas se colorean como se describe arriba. Con **Tipo de parcela**, cada parcela recibe el **Color del mapa** de su tipo, consulta [Tipos de parcela](/terreinen#terreintypes). - Con **Ocupación**, bajo **Capas de parcelas** hay una casilla por clase: **Libre**, **Reservada**, **Entrada registrada**, **Ocupada**, **No reservable** y **Doble reserva**. Quita una casilla para ocultar esas parcelas. - En **Tipos de parcela** eliges qué tipos aparecen en el mapa. **Sin tipo** corresponde a las parcelas sin tipo. Con **Exportar a PDF** descargas un PDF con las parcelas que están ahora en el mapa: nombre, superficie, gas y tarifa calculada, en la fecha elegida. ## Configuración del mapa [#kaartinstellingen] Con **Configuración del mapa** ajustas la visualización. | Ajuste | Descripción | |------------|--------------| | **Estilo** | **Satélite**, **Híbrido** o **Calles** | | **Modo de edición** | Muestra las herramientas para dibujar y editar límites de parcelas | | **Nombres de parcelas** | Muestra los nombres de las parcelas en el mapa. Solo funciona si al menos una capa está activada | | **Noches y salida** | Muestra junto a los nombres cuántas noches están libres y cuándo termina una estancia. Solo funciona si **Nombres de parcelas** está activado | Tus ajustes se guardan automáticamente. ## Establecer el mapa predeterminado [#kaartstandaard-instellen] En Soporte > Configuración > Mapa defines dónde se abre el mapa y cómo está girado. | Ajuste | Descripción | |---|---| | **Centro del mapa** | Haz clic en el mapa o arrastra el marcador al centro de tu parque. Debajo aparecen las coordenadas. | | **Rumbo del mapa** | La dirección de la brújula en grados (0-360) con la que se abre el mapa. | El centro del mapa también cuenta fuera del mapa. Es el lugar para el que se obtiene el tiempo en Parque > Tiempo, y las sugerencias de dirección al rellenar una dirección dan prioridad a lugares cercanos. Si en **Apple Wallet** no has indicado ninguna **Ubicación de la punto de acceso**, Apple Wallet y Google Wallet usan el centro del mapa para el pase de acceso. Consulta [Organización](/gebruikers/organisaties#apple-wallet). Si el centro está en un lugar equivocado, tampoco será correcto el tiempo. ## Dibujar límites de parcelas [#terreingrenzen-intekenen] Con el modo de edición fijas en el mapa el límite exacto de una parcela. Tillor calcula a partir de él la superficie en m², y la fórmula de tarifa la utiliza. 1. Ve a **Parque > Mapa** 2. Haz clic en **Configuración del mapa**, abajo a la izquierda 3. Activa el **Modo de edición** 4. Haz clic en los puntos deseados del mapa para dibujar un polígono 5. Cierra el polígono haciendo clic en el punto inicial 6. En el cuadro de diálogo, selecciona la parcela que quieres vincular 7. Haz clic en **"Actualizar"** La parcela aparece ahora como un área coloreada en el mapa. Las parcelas sin ubicación dibujada aparecen al principio de la lista de selección, para que puedas encontrarlas y vincularlas fácilmente. ## Medir distancias [#afstanden-meten] Con la función de medición puedes medir rápidamente distancias y superficies en el mapa - útil al organizar el terreno o al estimar distancias entre ubicaciones. 1. Haz clic arriba a la izquierda del mapa en **Medir distancia** o **Medir superficie** 2. Coloca puntos en el mapa (cierra una superficie haciendo clic en el punto inicial) 3. La medición se muestra en el mapa; usa **Borrar mediciones** para empezar de nuevo ## Abrir una parcela desde el mapa [#een-terrein-openen-vanaf-de-kaart] Desde el mapa puedes ir rápidamente a una parcela: 1. Haz clic en una parcela del mapa 2. La ventana emergente muestra el nombre, el estado de ocupación, las reservas activas y, si hay ocupación, el huésped 3. Haz clic en **"Ver detalles"** para ir a la página de detalle 4. Mientras no haya ocupación activa, puedes iniciar **"Crear reserva"** ## ¿Qué pasa tras dibujar? [#wat-gebeurt-er-na-het-intekenen] - La parcela recibe un color en el mapa y Tillor rellena la **Superficie** en la página de la parcela. - La **Tarifa calculada** se vuelve a calcular, porque la superficie cuenta. Consulta [Parcelas](/terreinen#hoe-het-tarief-tot-stand-komt). - La **Superficie total** que aparece arriba en la lista de parcelas cuenta a partir de ahora la parcela. ## ¿Problemas? [#problemen] La parcela aún no tiene un límite dibujado. Activa el **Modo de edición**, dibuja la parcela y elígela en el cuadro de diálogo. Las parcelas sin ubicación aparecen al principio de la lista de selección. Si la parcela sí aparece, comprueba en **Capas** si la capa de su estado está activada. Acércate hasta al menos el nivel 17,5 y comprueba en **Configuración del mapa** que tanto **Nombres de parcelas** como **Noches y salida** estén activados. Las parcelas grises, no reservables y sin estancia nunca tienen esa etiqueta. El centro del mapa está mal. Mueve el marcador en Soporte > Configuración > Mapa. Esa opción solo aparece si la parcela no tiene ocupación activa. La fecha elegida no se conserva. Tras actualizar, el mapa vuelve a hoy. ## Ver también [#zie-ook] # Gestión de clientes (/es-ES/klantenbeheer) Un cliente es el lugar de Tillor donde se reúne todo sobre una persona o empresa: datos, personas de contacto, facturas, ocupaciones, reservas, documentos y acceso. Creas un cliente, lo encuentras de nuevo en la lista y actualizas sus datos en el perfil del cliente. Empieza por [Añadir un cliente nuevo](#een-nieuwe-klant-toevoegen). - Al crear solo es obligatorio el **Nombre**. Los demás datos los completas después en el perfil del cliente. - Tillor avisa de un **posible cliente duplicado** si el nombre y el apellido juntos, el correo electrónico o el número de teléfono ya figuran en otro cliente. Un correo electrónico o un número de teléfono cuenta a partir de 4 caracteres. - Las sugerencias de dirección aparecen a partir de 3 caracteres escritos en el campo **Calle**. - Tillor elimina tras 7 días los escaneos de documentos de identidad sin cliente vinculado. - Eliminar un cliente también elimina todos los datos relacionados y no se puede deshacer. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Todo lo que registras en Tillor depende de un cliente. Una ocupación vincula al cliente con una parcela y, por tanto, también con los contadores de esa parcela. El consumo de esos contadores va a la factura del cliente. ```mermaid flowchart LR K[Klant] --> C[Contactpersonen] K --> R[Reserveringen] K --> B[Bezettingen] B --> T[Terrein] T --> M[Meters] M --> V[Verbruik] V --> F[Facturen] K --> F F --> P[Betalingen] K --> D[Documenten en ondertekenverzoeken] K --> O[Opmerkingen en taken] ``` ## Añadir un cliente nuevo [#een-nieuwe-klant-toevoegen] Antes de empezar: - Un escaneo de identidad si quieres crear al cliente con él. Si no hay ningún escaneo en la cola, elige simplemente introducirlo a mano. - ¿No sabes seguro si el cliente ya existe? Búscalo primero en la lista, consulta [Buscar y filtrar clientes](#klanten-zoeken-en-filteren). ### Abre la lista de clientes [#open-de-klantenlijst] Ve a Clientes > Resumen y haz clic arriba a la derecha en **Crear nuevo cliente**. Mientras haya escaneos de identidad pendientes, el botón muestra un menú con **Manual** y los escaneos de la cola. ### Elige cómo creas al cliente [#kies-hoe-je-de-klant-aanmaakt] Elige **Manual**. Se abre un formulario con **Nombre**, **Apellido(s)**, **Dirección de correo electrónico** y **Número de teléfono**. Rellena lo que sepas y haz clic en **Crear cliente**. Si es posible que ya exista un cliente con datos parecidos, abajo aparece un aviso amarillo con un enlace a ese cliente. Elige un escaneo del menú, por ejemplo **Lotte Peeters**. En la confirmación ves una vista previa del documento (anverso, reverso, retrato) y los datos de la zona de lectura. Haz clic en **Crear cliente**. Tillor crea al cliente, vincula el escaneo y rellena los datos del documento. Los escaneos pendientes también aparecen en el panel de abajo a la derecha, con **Crear cliente a partir del escaneo**. Más sobre escaneos en [Escaneos de identidad](/identiteitsscans). ### Comprueba si hay un cliente duplicado [#controleer-op-een-dubbele-klant] Si es posible que ya exista un cliente con el mismo nombre, el mismo correo electrónico o teléfono, Tillor muestra **Posible cliente duplicado** con el nombre y el número de cliente. Haz clic en **Usar este cliente** para abrir ese cliente, o en **Crear de todos modos** si realmente es otra persona. Tillor elimina los escaneos sin cliente vinculado **automáticamente tras 7 días**. Procésalos a tiempo. En los escaneos **vinculados**, **tu organización** determina el plazo de conservación y la base jurídica. Tillor los conserva hasta que los desvincules o los elimines. El cumplimiento de la normativa de privacidad y de plazos de conservación adecuados es **responsabilidad tuya** como responsable del tratamiento. ### ¿Qué pasa después? [#wat-gebeurt-er-daarna] - Llegas al nuevo perfil del cliente, donde rellenas el resto: dirección, número de IVA, personas de contacto y campos propios. - Si el cliente se ha creado desde un escaneo, ese escaneo pertenece al cliente y ya no está en la cola. - La creación aparece como primera línea en la pestaña **Eventos** del cliente. - Si quieres que ocurra algo de inmediato con un cliente nuevo, por ejemplo un correo de bienvenida, usa una [automatización](/automatiseringen). ## Comprobar un número de IVA [#een-btw-nummer-controleren] En la pestaña **Resumen**, en el bloque **Datos del cliente**, rellenas el **Número de IVA**. Tillor comprueba el número en el registro europeo VIES en cuanto también se ha rellenado **País** y el número es lo bastante largo. - Si el número es válido, ves una marca verde y una ventana con el nombre oficial de la empresa y la dirección de VIES. Haz clic en **Aplicar dirección de la empresa** para copiar esa dirección en el formulario. - Si el número no es válido, ves un icono rojo y un mensaje de error. ## El perfil del cliente [#het-klantprofiel] Al hacer clic en un cliente ves el perfil del cliente. Arriba están los datos resumidos del cliente, y debajo los comentarios fijados. Con las pestañas llegas al resto. | Pestaña | Qué encuentras | |---|---| | **Resumen** | Datos del cliente (formulario editable), comunicación reciente, facturas, lecturas, comentarios, ocupaciones y notificaciones | | **Facturación** | Todas las facturas de este cliente, y el [saldo por cuenta contable](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken) | | **Control de acceso** | Derechos de acceso y matrículas | | **Contactos** | Personas de contacto adicionales | | **Etiquetas NFC** | Etiquetas NFC vinculadas | | **Reservas** | Todas las reservas | | **Comunicación** | Mensajes e historial de comunicación | | **Outlook** | Correo de y para el cliente de tus buzones de Outlook. Esta pestaña solo aparece si [Outlook](/integraties/outlook) está conectado y puedes **Ver bandeja de entrada** | | **Eventos** | Cronología con cambios, incluida la creación de cliente o contacto, la asignación o desvinculación de un documento de identidad, y antes/después en actualizaciones de cliente, contacto, ajuste de facturación y método de acceso | | **Documentos** | Archivos y adjuntos guardados, y las [solicitudes de firma](/handtekeningen) | | **Tareas** | Tareas vinculadas a este cliente | ### De un vistazo [#in-één-oogopslag] En la pestaña **Resumen**, arriba a la izquierda, está la tarjeta **De un vistazo**. Muestra solo lo que requiere atención en ese momento y se pliega cuando no hay nada que mostrar: - **Reservas activas** y **Próximas reservas**, con un botón **Ver reserva** - **Contadores activos con alarmas** - **Tareas abiertas** de este cliente - **Escaneos de documentos de identidad** de este cliente Los mismos datos los ves en la tarjeta de una llamada entrante. Un comentario que fijas aparece directamente bajo los datos del cliente, arriba en el perfil. Consulta [Comentarios](/notities#opmerking-vastzetten). ### Cumpleaños [#verjaardagen] Si hoy es el cumpleaños del cliente o de su pareja, arriba en el perfil del cliente aparece un bloque verde **Cumpleaños hoy**, con el nombre y la edad, y caen confetis sobre la página. En el cliente, la fecha sale del campo **Fecha de nacimiento**. La pareja es el contacto con la relación **Pareja**. Una fecha de nacimiento del 29 de febrero cuenta el 28 de febrero en los años sin día bisiesto. ## Editar los datos del cliente [#klantgegevens-bewerken] En la pestaña **Resumen**, en el bloque **Datos del cliente**, ajustas los campos. Abajo en el formulario están **Cancelar** y **Guardar**. Cada cambio aparece en la pestaña **Eventos**, con un resumen **Antes / después** por campo, para que puedas ver exactamente qué se ha modificado. Si tu organización ha creado [campos propios](/eigen-velden) para clientes, aparecen como campos adicionales en el mismo bloque. ### Rellenar la dirección [#adres-invullen] La dirección consta de **Calle**, **N.º** y **Puerta**, seguidos de **Código postal**, **Ciudad** y **País**. - Si escribes al menos tres caracteres de la calle, Tillor sugiere direcciones. Elige una: se rellenan calle, número, código postal, ciudad y país. Las sugerencias vienen de OpenStreetMap, una base de datos de mapas gratuita. - Si escribes **Kerkstraat 5** en el campo **Calle**, la cifra pasa a **N.º**. Un espacio tras el número te lleva a **Puerta**. Si pegas una dirección completa, también se reparte. En países donde el número va antes de la calle, el número no se mueve automáticamente. - Si el código postal o la ciudad ya están rellenados, Tillor comprueba la dirección. Una marca verde con **Dirección encontrada** significa que la dirección existe. Un icono amarillo con **Escritura sugerida** muestra la ortografía habitual. Haz clic en **Actualizar dirección** para adoptarla. - La dirección se guarda como una sola línea, por ejemplo en facturas y exportaciones. Las sugerencias son una ayuda, no una obligación. Siempre puedes rellenar algo tú mismo. ## Buscar y filtrar clientes [#klanten-zoeken-en-filteren] Ve a Clientes > Resumen. Arriba hay una barra de búsqueda. - Escribe un nombre, correo electrónico, número de teléfono o número de cliente. - Los resultados se actualizan mientras escribes, con un breve retraso. - También puedes filtrar por **Creado** (intervalo de fechas), **Estado** y **Tipo**. ## Eliminar un cliente [#een-klant-verwijderen] Usa **Eliminar cliente** en el menú de arriba del perfil del cliente. Tillor pregunta **¿Está seguro de que desea eliminar este cliente?** Si confirmas, también desaparecen todos los datos relacionados. Esto no se puede deshacer. ## Escenarios habituales [#veelvoorkomende-scenarios] ### Un cliente nuevo reserva por primera vez [#een-nieuwe-klant-boekt-voor-het-eerst] 1. El cliente llama o reserva en línea. 2. Añades al cliente con **Crear nuevo cliente**. 3. Rellenas la dirección y los demás datos en el perfil del cliente (pestaña **Resumen** > **Datos del cliente**). 4. Creas una ocupación en la parcela deseada, consulta [Ocupaciones](/bezettingen#een-bezetting-aanmaken). 5. Tillor registra automáticamente el consumo de los contadores vinculados. Lo ves en **Lecturas** en **Resumen**. ### Cambiar los datos del cliente [#klantgegevens-wijzigen] Abre el perfil del cliente, cambia la dirección en el formulario y haz clic en **Guardar**. ## ¿Problemas? [#problemen] El aviso es **No se pudo crear el cliente.** Comprueba que el **Nombre** esté rellenado y que el correo electrónico sea una dirección válida, con una arroba y un dominio. Inténtalo de nuevo después. Ya existe un cliente con el mismo nombre y apellido, el mismo correo electrónico o el mismo número de teléfono. Haz clic en **Usar este cliente** si es la misma persona, o en **Crear de todos modos** si es otra persona. Tus cambios no se han guardado. Comprueba en el formulario si hay un correo electrónico no válido o un campo obligatorio vacío, y haz clic de nuevo en **Guardar**. Solo cuentan como pendientes los escaneos sin cliente vinculado. Si el escaneo ya está vinculado a un cliente, o tiene más de 7 días, ya no aparece. Consulta [Escaneos de identidad](/identiteitsscans). En el escaneo aparece el motivo. Normalmente el escaneo no tiene nombre: *rellénalo en el escáner o vincula este escaneo manualmente*. O ya existe un cliente con el mismo número de registro nacional. Abre entonces ese cliente y vincula el escaneo a él. El número no es válido o no está registrado en VIES. Comprueba que el **País** sea correcto y que el número esté completo. Tillor también avisa **El número de IVA debe tener como mínimo ... caracteres** si el número es demasiado corto para el país elegido, y pide tanto un número como un país si falta uno de los dos. La pestaña solo aparece si [Outlook](/integraties/outlook) está conectado y tienes el permiso **Ver bandeja de entrada**. Escribe al menos tres caracteres en el campo **Calle**. Si siguen sin aparecer sugerencias, rellena la dirección tú mismo. ## Conceptos [#begrippen] - **Cliente**: el registro en Tillor de una persona o empresa. Consulta [cliente](/begrippen#klant). - **Persona de contacto**: una persona adicional de un cliente, por ejemplo una pareja o un contacto de emergencia. - **Ocupación**: un cliente en una parcela durante un periodo. Consulta [ocupación](/begrippen#bezetting). - **Reserva**: una reserva para una estancia. Consulta [reserva](/begrippen#reservering). - **Eventos**: la cronología con todos los cambios de un cliente. Consulta [evento](/begrippen#gebeurtenis). - **VIES**: el registro europeo en el que Tillor comprueba un número de IVA. ## Ver también [#zie-ook] # Alarmas y estado del contador (/es-ES/meterbeheer/alarmen-en-status) Un contador da una alarma cuando transmite una anomalía, como un problema de conexión o una avería técnica. Aquí lees dónde lo ves, qué significa el indicador de estado y cómo se borra una alarma. ## Hacer seguimiento de una alarma [#een-alarm-opvolgen] ### Busca el contador con una alarma [#zoek-de-meter-met-een-alarm] Ve a Parque > Contadores. Un contador con una alarma activa tiene un triangulito. ### Abre el contador y lee la alarma [#open-de-meter-en-lees-het-alarm] En la lista de alarmas ves, por alarma, el mensaje, **Iniciada el** y si está Activa o Resuelta. El aviso depende del tipo de contador y del proveedor. ### Resuelve el problema [#los-het-probleem-op] Comprueba la batería y la señal en los detalles del contador y, si hace falta, pasa por el contador. ### Borra la alarma [#wis-het-alarm] En el menú de acciones del contador elige **Borrar alarmas**. ## Qué significa el estado [#wat-de-status-betekent] - **Indicador de estado**: los contadores inteligentes (ICY y Tillor Hydrodigit) muestran si se han comunicado recientemente y si hay alarmas. El indicador cambia de color con una alarma activa o si el contador lleva más de un día sin enviar nada. - **Nivel de batería** y **calidad de la señal**: como porcentaje en los detalles del contador, para los contadores que lo transmiten. ## Controladores ICY [#icy-controllers] Los módulos ICY de las parcelas se comunican a través de un controlador en el armario de contadores. Si un controlador se cae, ningún contador detrás de ese controlador envía nada. Si tu parque tiene contadores ICY, en Parque > Contadores, encima de la lista, aparece la tarjeta **Controladores ICY**. Indica cuántos controladores hay, cuántos no ha visto ICY en la última hora y cuántas alarmas hay abiertas en controladores. Haz clic en **Mostrar** para ver la tabla: - **Controlador**: el nombre del armario de contadores en el que cuelgan la mayoría de los contadores del controlador, con un círculo verde o rojo. Si el nombre en ICY difiere, aparece en gris al lado. Si los contadores no están en ningún armario de contadores, solo ves el nombre de ICY. - **Contadores**: cuántos de tus contadores se comunican a través de este controlador. En un contador, ese nombre aparece en **Controlador** en la tarjeta **Información**. - **Alarmas**: las alarmas que ICY notifica en el propio controlador, con desde cuándo. Una alarma desaparece de la lista en cuanto ICY deja de notificarla; no hace falta borrarla. Una alarma que Tillor todavía no conoce por su nombre aparece como **Alarma desconocida** con el código de ICY. Quien recibe notificaciones push de alarmas de contadores, recibe también un aviso cuando una alarma en un controlador es nueva y cuando se resuelve. - **Visto por última vez**: cuándo vio ICY el controlador por última vez. Si fue hace más de una hora, la hora aparece en rojo. Un controlador con una alarma o un controlador que lleva más de una hora en silencio aparece arriba, y entonces la tarjeta se abre sola. Tillor actualiza la lista cada vez que se leen los contadores ICY. ## Si todos tus contadores se quedan en silencio a la vez [#als-al-je-meters-tegelijk-stilvallen] Los contadores Tillor Hydrodigit y Tillor EM300 envían su lectura a Tillor a través de un receptor, la pasarela LoRa. Normalmente envían una medición unas dos veces al día. Si todos los contadores LoRa recientemente activos de tu organización llevan más de 24 horas sin enviar nada, lo más probable es que el fallo esté en la pasarela o en la conexión con Tillor y no en los contadores. Un solo contador en silencio no genera este aviso: se necesitan al menos dos contadores activos. Entonces los administradores de Tillor reciben un aviso, con la última medición recibida y los contadores afectados. Esos contadores no aparecen además por separado como contador que necesita atención. No tienes que configurar nada. Si en tus contadores ves una **Última lectura** común y antigua, ponte en contacto con el soporte. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - Una alarma borrada ya no aparece como activa en la lista. El triangulito junto al contador en Parque > Contadores solo corresponde a alarmas activas. - Si el contador vuelve a transmitir el problema, recibes una alarma nueva. ## ¿Problemas? [#problemen] La causa sigue ahí. Comprueba la batería, la señal y la ubicación del contador, y llama al soporte si hace falta. Mira si todos tienen una **Última lectura** antigua. Entonces la causa es la pasarela o la conexión. Ponte en contacto con el soporte. Mira en la tarjeta **Controladores ICY** si un controlador tiene una alarma o aparece en rojo. Entonces el fallo está en ese controlador o en su conexión y no en los contadores. Comprueba la corriente y la red del armario de contadores y, si hace falta, ponte en contacto con ICY. El aviso de la pasarela requiere al menos dos contadores activos. Mira tú mismo el estado, la batería y la señal de ese contador. ## Ver también [#zie-ook] # Lotes de consumo (/es-ES/meterbeheer/consumptie-batches) Esta página explica cómo Tillor divide el consumo de un cliente en periodos, para que sepas por qué un importe tiene el aspecto que tiene. Un **lote de consumo** (o periodo de consumo) es un periodo de consumo de contador para un cliente y un contador. Tillor registra automáticamente cuándo empieza un periodo, cuándo termina y si ya se ha facturado. Si solo quieres facturar, ve a [Facturar el consumo](/meterbeheer/verbruik-factureren). ## Ciclo de vida de un lote [#levenscyclus-van-een-batch] ```mermaid flowchart TD A[Creado
solo lectura inicial] -- lecturas --> B[Abierto
lectura inicial y final] B -- cerrar --> C[Cerrado
fijado] C -- facturar --> D[Facturado
finalizado] ``` ### Estados [#statussen] | Estado | Descripción | |--------|-------------| | **Abierto** | Las nuevas lecturas se añaden automáticamente al periodo | | **Cerrado** | El periodo está cerrado y espera a su facturación | | **Facturado** | El consumo se ha incluido en una factura | ## ¿Cuándo se crea un lote? [#wanneer-wordt-een-batch-aangemaakt] - **Al crear una ocupación**: cuando vinculas a un cliente con una parcela que tiene contadores e indicas una lectura inicial - **Al introducir una lectura manual**: cuando introduces una lectura para un contador de una parcela con ocupación activa y todavía no existe un lote abierto para esa combinación de cliente y contador ## ¿Cuándo se cierra un lote? [#wanneer-wordt-een-batch-gesloten] - **Al finalizar la ocupación**: cuando el cliente deja la parcela (se elimina la ocupación) - **Al corregir o reiniciar el contador**: cuando la lectura baja (por ejemplo, un contador sustituido o corregido). El sistema cierra el periodo anterior, crea un lote "salto" cerrado con consumo negativo (por ejemplo, -90 con 100→10) y la siguiente lectura inicia un nuevo lote abierto - **Al crear una nueva ocupación**: cuando se vincula a otro cliente (o al mismo cliente otra vez) con lecturas iniciales explícitas Si una lectura baja (corrección, reinicio o sustitución), Tillor cierra automáticamente el lote en curso, crea un lote "salto" cerrado con consumo negativo y abre enseguida un nuevo lote con la nueva lectura. El lote salto es fácil de reconocer y de marcar como pagado. La siguiente lectura se añade al nuevo lote. ## Ejemplos [#voorbeelden] El cliente ocupa la parcela, consume y se marcha. Es el escenario más habitual. ``` 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 ``` La ocupación continúa; facturas por periodo sin cerrar el lote. ``` 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) ``` Solo lectura inicial y después una corrección. Lote salto con consumo -90 m³ y después un nuevo lote abierto. ``` 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³ ``` Primero consumo normal y después se sustituye el contador. Lote salto con consumo -140 m³ y después un nuevo lote abierto. ``` 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³ ``` Una lectura con la misma cifra que la inicial. Tillor ajusta la fecha de inicio. ``` 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" ``` El cliente deja la parcela y vuelve más tarde. Nuevo lote, sin vínculo con el 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 ``` Habías facturado el consumo mientras la ocupación continuaba; después eliminas el borrador de factura. ``` 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 ``` Dos periodos distintos en el mismo contador: el segundo lote **no** empieza en la lectura final del primero. Tillor **no** los fusiona. ``` 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) ``` La primera factura cubre el periodo hasta la lectura X; después llegan nuevas lecturas y una **segunda** factura sobre la continuación. Eliminar la primera factura no cambia la segunda. ``` 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 ``` ## Facturación [#facturering] ### Forma 1: con el botón de factura (factura nueva) [#manier-1-via-factuurknop-nieuwe-factuur] 1. Ve a **Clientes** > cliente > pestaña **Resumen** (tarjeta **Lecturas**) 2. Haz clic en **Facturar consumo** 3. El sistema crea una factura con el consumo como línea, o lo añade a un borrador de factura existente 4. Los lotes se marcan como facturados y se vinculan a la factura ### Forma 2: marcar como facturado manualmente [#manier-2-handmatig-als-gefactureerd-markeren] Si has facturado el consumo fuera de Tillor: 1. Abre el lote en la tarjeta **Lecturas** (perfil del cliente) o **Consumo** (**Parque** > **Contadores** > contador) 2. Haz clic en el icono de advertencia junto al periodo 3. Confirma con **Sí, marcar como facturado** 4. El lote se cierra sin vínculo con ninguna factura Solo los lotes marcados manualmente se pueden "revertir". Los lotes vinculados a una factura real no se pueden deshacer: primero hay que eliminar la factura. ### Nuevo lote automático [#automatische-nieuwe-batch] Cuando marcas un lote como facturado (y la ocupación sigue en curso), Tillor crea automáticamente un **nuevo lote abierto** que empieza en la lectura final del anterior. Así el consumo continúa sin huecos. ``` Batch 1: 0 → 50 m³ (gefactureerd) ↓ Batch 2: 50 → (open, klaar voor nieuwe uitlezingen) ``` ## Eliminar una factura [#factuur-verwijderen] Si eliminas un **borrador de factura** al que estaba vinculado consumo, Tillor ajusta automáticamente los lotes de consumo. ### ¿Qué ocurre siempre? [#wat-gebeurt-er-altijd] - Desaparece el vínculo con esa factura. - El lote vuelve a figurar como **no facturado** y puede volver a acabar en una factura. ### ¿Cuándo vuelven a ser uno dos lotes? [#wanneer-worden-twee-batches-weer-één] A veces, tras facturar, Tillor había iniciado automáticamente un **nuevo lote abierto** en la **lectura final** del periodo facturado. Si eliminas esa factura, el sistema busca una continuación así: | Condición | Consecuencia | |-----------|--------------| | Hay otro lote con la **misma lectura inicial** que la **lectura final** del lote facturado (la misma lectura como punto de unión) | Esa continuación se **fusiona** en el lote original. Vuelves a tener **un solo** periodo continuo. | | La continuación **todavía no está facturada** (no tiene factura) | La fusión está **permitida**. | | La continuación **empieza en otra lectura** distinta de la lectura final del lote facturado | **No** hay fusión: son dos periodos independientes. | | La continuación **ya se ha vuelto a facturar** (otra factura) | **No** hay fusión: ese periodo permanece en la otra factura. | ### Lectura final tras la fusión [#eindstand-na-samenvoegen] Tras la fusión, el lote vuelve a estar **abierto** (si la continuación estaba abierta) y la **lectura final** es la lectura final actual de esa continuación, es decir, incluye las lecturas llegadas **después** de la factura. Si técnicamente la continuación no tenía lectura final pero sí hay lecturas más recientes en el contador, Tillor completa la lectura final con la **lectura más reciente posterior al punto de unión** (la misma lógica que al crear un lote). Solo los lotes **sin** vínculo con una factura puedes volver a dejarlos como "no facturados" con el icono de revertir (en **Parque** > **Contadores** > contador, en los periodos liquidados). Los lotes vinculados a una factura real siguen las reglas anteriores solo **después** de que elimines esa factura. ## Situaciones específicas [#specifieke-situaties] ### Periodo sin consumo [#periode-zonder-verbruik] Si llega una lectura con la misma cifra que la inicial (consumo = 0), Tillor ajusta automáticamente la fecha de inicio. El periodo mostrado solo refleja el periodo en el que realmente hubo consumo. ### El cliente vuelve [#klant-keert-terug] Cuando un cliente vuelve a ocupar una parcela después de haberse marchado: - Se crea un **lote completamente nuevo** - El lote no empieza donde terminó el anterior - Eliges de nuevo una lectura inicial (o la lectura del contador en ese momento) ### Contador vinculado a varios clientes [#meter-gekoppeld-aan-meerdere-klanten] Cada combinación de cliente y contador tiene sus propios lotes. Una misma parcela puede tener varias ocupaciones (por ejemplo, en periodos distintos), cada una con sus propios periodos de consumo. ## Vista general en la aplicación [#overzicht-in-de-applicatie] Dónde ves los lotes: - **Clientes** > cliente > pestaña **Resumen** > tarjeta **Lecturas**: por contador, solo los periodos **pendientes** (acento naranja), con el botón **Facturar consumo** arriba. - **Parque** > **Contadores** > contador > tarjeta **Consumo**: por cliente, primero los periodos pendientes (naranja) y debajo los periodos liquidados (verde con factura vinculada, gris si se marcaron manualmente). - **Clientes** > **Consumo pendiente**: tabla con los clientes que todavía tienen consumo por facturar. ## Véase también [#zie-ook] # Resumen (/es-ES/meterbeheer) Con la gestión de contadores lees a distancia los contadores de tu parque y ves quién consume qué, sin que nadie tenga que pasar por los armarios de contadores. Ves las lecturas, el consumo por periodo y las alarmas, y facturas el consumo al cliente que en ese momento está en la parcela. Tus contadores los encuentras en Parque > Contadores. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Un contador nunca pertenece directamente a un cliente. El contador está asociado a una **parcela**, y el cliente está asociado a esa parcela mediante una **ocupación**. Quien tenga ahora una ocupación en la parcela recibe el consumo de los contadores de esa parcela. ```mermaid flowchart LR M[Contador] -->|lo vinculas a| T[Parcela] K[Cliente] -->|recibe una ocupación en| T T --> V[Consumo del cliente] V --> F[Factura] ``` Esto tiene tres consecuencias que suelen sorprender: - No hay ningún botón para vincular un contador a un cliente. Lo haces en dos pasos: contador a parcela, cliente a parcela. Consulta [Vincular un contador a un cliente](/meterbeheer/meter-koppelen). - Si un cliente se traslada, no trasladas el contador. La ocupación termina y el siguiente cliente recibe el consumo desde su propia lectura inicial. - Si en la parcela no hay ocupación, el consumo no pertenece a nadie y tampoco se puede facturar. - Una parcela tiene como máximo una ocupación activa a la vez. Una parcela con una ocupación no aparece en la lista de selección de **Crear ocupación**. - Los contadores de una red LoRa compartida envían una medición aproximadamente dos veces al día. Consulta el recuadro de abajo. - Tillor avisa de una posible avería en el receptor (la pasarela) si todos tus contadores LoRa activos recientemente llevan más de 24 horas sin enviar nada, y solo con al menos dos contadores activos. - Si quieres facturar el consumo de un cliente y el importe pendiente es inferior al importe mínimo, Tillor espera al siguiente día de facturación. - Con la facturación automática, Tillor retiene una factura si el consumo de electricidad o de agua es al menos el doble de lo que el cliente consume habitualmente. - Un contador eliminado no se puede recuperar, ni sus lecturas ni sus periodos de consumo. LoRa es una conexión inalámbrica de largo alcance y bajo consumo de energía. El contador envía su lectura a un receptor en tu parque o cerca de él, la pasarela, y esta la reenvía a Tillor. El Dev EUI es el número único de un contador LoRa, de 16 caracteres (cifras 0-9 y letras a-f). Ese número lo introduces al crear el contador. Los contadores ICY se reconocen por su número de serie. ## ¿Qué quieres hacer? [#wat-wil-je-doen] ## ¿Cómo llegan las lecturas? [#hoe-komen-de-meterstanden-binnen] Los contadores inteligentes envían su lectura por sí mismos, normalmente a diario o cada semana. No tienes que hacer nada: las nuevas lecturas aparecen solas en el contador y en el cliente que está en la parcela. Si un contador no está conectado a una conexión inteligente, introduces la lectura tú mismo. ## Conceptos [#begrippen] - **Contador**: un contador de agua, gas o electricidad. Consulta [Conceptos](/begrippen#meter). - **Parcela**: el lugar donde está el contador y donde se aloja un cliente. Consulta [Conceptos](/begrippen#terrein). - **Ocupación**: un cliente en una parcela durante un periodo. Consulta [Conceptos](/begrippen#bezetting). - **Periodo de consumo** (lote de consumo): el consumo de un cliente en un contador, desde una lectura inicial hasta una lectura final. - **Consumo pendiente**: consumo que todavía no se ha facturado. - **Lectura inicial**: la lectura del contador con la que un cliente empieza su ocupación. # Vincular un contador a un cliente (/es-ES/meterbeheer/meter-koppelen) Un contador no se vincula al cliente en sí. Asocias el contador a una parcela y das al cliente una ocupación en esa parcela. Después el consumo llega solo al cliente. Consulta [¿Cómo encaja todo?](/meterbeheer#hoe-hangt-dit-samen) para ver el esquema. Antes de empezar: - El contador ya está en Parque > Contadores. Un contador que ya está asociado a una parcela no aparece en la lista de selección. - La parcela existe y todavía no tiene ocupación activa. Si la parcela está ocupada, no aparece en la lista de **Crear ocupación**; si aparece **No se encontraron parcelas disponibles.**, todas están ocupadas. - El cliente existe. ## Paso 1: asociar el contador a la parcela [#stap-1-de-meter-aan-het-terrein-hangen] ### Abre la parcela [#open-het-terrein] Ve a Parque > Parcelas y haz clic en la parcela. ### Haz clic en Añadir contador [#klik-op-meter-toevoegen] Al final de la tarjeta **Contadores** está **Añadir contador**. Elige el contador en la lista. ### Confirma con Asignar contador [#bevestig-met-meter-toekennen] El contador ya aparece en la tarjeta **Contadores** de la parcela. ## Paso 2: poner al cliente en la parcela [#stap-2-de-klant-op-het-terrein-zetten] ### Abre el cliente [#open-de-klant] Ve a Clientes > Resumen y abre el cliente. En la pestaña **Resumen** está la tarjeta **Ocupaciones**. ### Haz clic en Crear ocupación [#klik-op-bezetting-aanmaken] Elige la parcela. Si hay contadores en la parcela, puedes indicar una **lectura inicial** por contador. Para ello eliges una lectura existente o escribes un valor. Si no hay contadores, verás **Sin contadores vinculados**. ### Confirma [#bevestig] Haz clic otra vez en **Crear ocupación**. ## Desvincular un contador [#een-meter-loskoppelen] Abre la parcela, ve a la tarjeta **Contadores** y, en el menú (...) del contador, elige **Desvincular de la parcela**. El contador sigue existiendo y puedes asociarlo a otra parcela. Esta opción solo está en la página de la parcela, no en el menú del propio contador. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tillor inicia, para cada contador de la parcela, un periodo de consumo para este cliente, a partir de la lectura inicial. Consulta [Lotes de consumo](/meterbeheer/consumptie-batches). - Las nuevas lecturas se añaden a ese periodo. Las ves en el cliente, en la tarjeta **Lecturas**, y en el contador, en la tarjeta **Consumo**. - Si la ocupación termina, Tillor cierra el periodo. Después puedes facturar el consumo, consulta [Facturar el consumo](/meterbeheer/verbruik-factureren). - Si más tarde asocias un contador adicional a una parcela con una ocupación en curso, para ese contador empieza un periodo de consumo en cuanto introduces una lectura. ## ¿Problemas? [#problemen] La lista solo muestra contadores sin parcela. Si el contador ya está asociado a otra parcela, ve a esa parcela y elige **Desvincular de la parcela**. Todas las parcelas ya tienen una ocupación activa. Primero finaliza la ocupación de la parcela que quieres usar, o crea una parcela nueva. Esa opción solo está en el menú (...) de la página de la parcela, en la tarjeta **Contadores**. Tillor avisa con **No se pudo desvincular el contador** si no ha funcionado; inténtalo de nuevo. Comprueba tres cosas: ¿está el contador asociado a la parcela?, ¿tiene el cliente una ocupación activa en esa parcela? y ¿ha llegado alguna lectura después del inicio? Sin ocupación, el consumo no pertenece a nadie. ## Véase también [#zie-ook] # Eliminar un contador (/es-ES/meterbeheer/meter-verwijderen) Un contador que ya no existe se elimina en tres pasos. Esto no se puede deshacer. Si solo quieres quitar el contador de una parcela, desvincúlalo, consulta [Vincular un contador a un cliente](/meterbeheer/meter-koppelen#een-meter-loskoppelen). ### Abre el menú de acciones [#open-het-actiemenu] Haz clic en los tres puntos del contador, en la lista o en la página del contador, y elige **Eliminar contador**. ### Paso 1 de 3: Continuar [#stap-1-van-3-doorgaan] Lees que el contador desaparece para todos en tu organización. Haz clic en **Continuar**, o en **Cancelar** para parar. ### Paso 2 de 3: mira lo que desaparece [#stap-2-van-3-bekijk-wat-verdwijnt] Ves todas las lecturas con sus fotos, los comentarios, las alarmas y las desviaciones, y el número de periodos de consumo. Los periodos de consumo que todavía no están facturados aparecen en rojo. Si el contador sigue asociado a una parcela, también se indica. Haz clic en **Continuar**. ### Paso 3 de 3: escribe el nombre [#stap-3-van-3-typ-de-naam] Escribe el nombre del contador. Solo entonces se activa **Eliminar definitivamente**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El contador, sus lecturas, fotos, comentarios y alarmas desaparecen, también para tus compañeros. - Los periodos de consumo que todavía no estaban facturados ya no se pueden facturar. Por eso, primero factúralos o márcalos, consulta [Facturar el consumo](/meterbeheer/verbruik-factureren). - Si eliminas el contador en su propia página, después vuelves a la lista de contadores. ## ¿Problemas? [#problemen] Tienes que escribir el nombre del contador exactamente. Comprueba las mayúsculas y los espacios. El contador no se ha eliminado. Inténtalo de nuevo; si sigue fallando, ponte en contacto con soporte. Necesitas el permiso **Editar contadores**. Pídeselo a tu administrador. ## Véase también [#zie-ook] # Ver lecturas y tendencias (/es-ES/meterbeheer/meterstanden-en-trends) En la página de un contador ves la última lectura, quién usa el contador ahora y cómo evoluciona el consumo. Así ves rápido si un contador hace lo que debe y si pasa algo raro. Si quieres facturar el consumo, ve a [Facturar el consumo](/meterbeheer/verbruik-factureren). ## Abrir un contador [#een-meter-openen] ### Ve a Parque > Contadores [#ga-naar-park--meters] Ves todos los contadores con **Nombre**, **Tipo** (agua, electricidad o gas), **Proveedor**, **Módulo** (Campère o PRM, solo en contadores ICY), **Parcela** y la **Última lectura** con fecha. Los contadores con una alarma activa tienen un triangulito. ### Haz clic en el contador [#klik-op-de-meter] Arriba ves los datos del contador y, entre otras, las tarjetas **Información**, **Consumo**, **Consumo y tendencias**, las alarmas y la actividad. Qué hay en cada sitio: - **Información**: número de serie, tipo, parcela, última medición y, si el contador lo transmite, el nivel de batería. En un contador ICY también aparece qué **Módulo** hay en la plaza (Campère o PRM), a través de qué **Controlador** se comunica ese módulo (con el nombre del armario de contadores de ese controlador), el **Tiempo de desconexión** configurado en ICY y, si ICY lo conoce, el **Número de serie del módulo**. - **Cliente** en la cabecera: el cliente con una ocupación activa en la parcela del contador. Si aparece **Sin cliente**, la parcela no está ocupada o el contador no está asociado a ninguna. - **Consumo**: por cliente, el consumo pendiente y el liquidado. - **Actividad**: bajo la tarjeta **Consumo**, la línea de tiempo con la creación del contador, los cambios y las lecturas introducidas, modificadas o eliminadas manualmente. Los cambios que Tillor detecta en ICY, como otro número de serie u otro tiempo de desconexión del módulo, también aparecen ahí. ## Leer el consumo y las tendencias [#verbruik-en-trends-lezen] Arriba de la tarjeta **Consumo y tendencias** aparece el consumo de **Esta semana** y de **Semana pasada**, la diferencia **vs semana pasada** y la media por semana (**Media / semana**). Si el contador todavía tiene poco historial, aparece **Historial insuficiente**. Bajo el gráfico están las **Conclusiones**: la previsión para los próximos 30 días, el total del periodo elegido, un día pico, los días sin consumo y la evolución. Si el consumo de los últimos 7 días está claramente por encima de lo normal, aparece **Uso elevado**, con el tiempo de esos días. Consulta [Tiempo](/weer). Con los botones de arriba a la derecha de la tarjeta cambias la **Agrupación** entre **Por día** y **Por hora**, y el **Tipo de gráfico** entre área y barras. Por hora muestra los consumos horarios como barras; una hora que todavía no ha terminado recibe la indicación **en curso**. - Si eliges un periodo de dos días o menos, como **Hoy** o **Ayer**, el gráfico muestra automáticamente barras por hora. - En un periodo más largo, **Por hora** muestra los últimos 31 días. Haz clic arriba a la derecha en el botón del calendario. A la izquierda eliges un periodo rápido: **Hoy**, **Ayer**, **Últimos 7 días**, **Último mes**, **Últimos 3 meses** o **Todo**. A la derecha eliges una **Fecha de inicio** y una **Fecha de fin** en el calendario y confirmas con **Aplicar**. Si haces clic en un solo día, se muestra ese día. También puedes ajustar la hora de inicio y de fin. ## Contadores conmutables [#schakelbare-meters] En los contadores que puedes encender o apagar a distancia, como ICY, el gráfico del historial también muestra el estado de encendido y apagado. Una línea verde significa que el contador estaba encendido. Una línea roja con marcas discontinuas significa apagado. Si una lectura no tiene dato de encendido o apagado, cuenta como encendido. En un contador ICY eliges, en el menú de acciones, bajo **Amperaje**, cuántos amperios recibe la plaza. Solo ves los valores hasta el máximo configurado en ICY para el módulo de esa plaza: si es 16 A, 20 A y 25 A no aparecen en la lista. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] No cambia nada en tus datos: son solo vistas. Las tendencias y el tiempo se actualizan en cuanto llegan nuevas lecturas. ## ¿Problemas? [#problemen] El contador todavía no tiene suficientes días con mediciones para compararlo con la semana pasada. Vuelve más tarde. Para el periodo elegido no hay consumo. Elige un periodo más largo, por ejemplo **Todo**. Mira en [Alarmas y estado del contador](/meterbeheer/alarmen-en-status) si hay una alarma o una avería en el receptor. Tillor no ofrece ningún valor por encima del máximo configurado en ICY para el módulo de esa plaza. Si ese máximo no es correcto, ponte en contacto con ICY. En la parcela del contador no hay ocupación activa, o el contador no está asociado a ninguna parcela (**Sin parcela**). Consulta [Vincular un contador a un cliente](/meterbeheer/meter-koppelen). ## Véase también [#zie-ook] # Facturar el consumo (/es-ES/meterbeheer/verbruik-factureren) El consumo de un cliente está listo para facturar en cuanto hay un periodo de consumo con consumo. Lo pasas a una factura con un solo botón, o dejas que Tillor facture automáticamente un día fijo. Cómo nace y se cierra un periodo lo lees en [Lotes de consumo](/meterbeheer/consumptie-batches). Antes de empezar: - El cliente tiene o tuvo una ocupación en una parcela con contadores. Sin ocupación no hay consumo que facturar, consulta [Vincular un contador a un cliente](/meterbeheer/meter-koppelen). - Hay consumo pendiente. Si ves **No se encontraron contadores con consumo pendiente.**, no hay nada que facturar. ## Facturar el consumo [#verbruik-factureren] ### Abre el cliente [#open-de-klant] Ve a Clientes > Resumen, abre el cliente y mira la tarjeta **Lecturas**. Ahí están, por contador, los periodos pendientes. ### Haz clic en Facturar consumo [#klik-op-factureer-verbruik] Tillor pone en una factura, por periodo, una línea principal con el importe y debajo una línea informativa con las fechas y las lecturas. Si ya hay un borrador de factura adecuado, Tillor añade ahí las líneas. ### Elige tú qué contadores y qué factura [#kies-zelf-welke-meters-en-welke-factuur] Abre la flechita junto al botón y elige **Añadir con selección...**. En **Facturación avanzada** eliges un borrador de factura existente en **Factura (opcional)**, o lo dejas vacío para una factura nueva. En **Seleccionar contadores** marcas qué contadores se incluyen. Ve a Clientes > Consumo pendiente. Ves los clientes con consumo que todavía hay que facturar, con el importe total por cliente. Por defecto aquí solo aparecen clientes sin facturación automática. Factura directamente desde la fila. Si has facturado el consumo en otro sitio, lo marcas sin factura: 1. Abre el periodo en la tarjeta **Lecturas** (perfil del cliente) o **Consumo** (Parque > Contadores > contador). 2. Haz clic en el icono de advertencia junto al periodo. 3. Confirma con **Sí, marcar como facturado**. Tillor no crea ninguna factura con esto. Solo los periodos que has marcado así los puedes revertir con el icono de revertir en los periodos liquidados. Un periodo vinculado a una factura real solo queda libre cuando eliminas esa factura. ## Facturar automáticamente [#automatisch-factureren] Si en un cliente está activada la facturación automática de suministros, Tillor crea la factura por sí mismo el día elegido y la envía. Lo configuras en el perfil del cliente. Dos reglas determinan si esa factura se crea de verdad: - **Importe mínimo.** Si el importe pendiente es inferior, Tillor espera a un día de facturación posterior. El mínimo para todos los clientes está en **Ajustes > Facturación** como **Importe mínimo para facturas de consumo automáticas**. En el perfil del cliente puedes poner, en los ajustes de factura, un **Importe mínimo** propio, que tiene prioridad para ese cliente. Si dejas ambos vacíos, se factura cualquier importe. - **Consumo claramente por encima de lo habitual.** Si el consumo pendiente de electricidad o de agua es al menos el doble de lo que el cliente consume habitualmente, Tillor no crea la factura. Recibes un correo en la dirección de soporte de tu organización y la factura queda sin hacerse hasta que alguien lo haya revisado. Tillor compara cada tipo consigo mismo: electricidad con electricidad anterior, agua con agua anterior. El consumo habitual es el valor central de las últimas facturas de ese tipo. No hay un límite fijo en m³ o kWh. Si el cliente todavía no tiene una factura anterior de ese tipo, la factura sí sale automáticamente. Si tras la revisión la lectura es correcta, factura el consumo tú mismo desde el perfil del cliente o desde **Clientes > Consumo pendiente**. Pon ahí el filtro **Facturación automática** en **Con fecha** para ver los clientes retenidos. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Los periodos pasan de pendientes a liquidados. Si la ocupación sigue activa, Tillor abre enseguida un nuevo periodo desde la lectura final, para que no haya huecos. - Las líneas están en un borrador de factura. Contabilízala y envíala como cualquier otra factura, consulta [Facturas](/facturen). - Si vuelves a eliminar el borrador de factura, el consumo vuelve a estar disponible. Consulta [Eliminar una factura](/meterbeheer/consumptie-batches#factuur-verwijderen). ## ¿Problemas? [#problemen] No se pudo incluir el consumo en la factura. Inténtalo de nuevo. Si no funciona con un borrador de factura elegido, elige **Crear factura nueva**. El consumo estaba al menos dos veces por encima de lo habitual. Comprueba la lectura y factura tú mismo si todo es correcto. Por defecto la lista solo muestra clientes sin facturación automática. Pon el filtro **Facturación automática** en **Con fecha** para los demás clientes. Si el cliente sigue sin aparecer, no hay consumo pendiente. Comprueba si el cliente tiene una ocupación activa en la parcela donde está el contador, y si ha llegado una lectura después de la lectura inicial. Un periodo sin consumo no genera ningún importe. ## Véase también [#zie-ook] # Resumen (/es-ES/nfc) Una etiqueta NFC es una tarjeta, pulsera, llavero o pegatina que un cliente acerca a un lector, como en el pago sin contacto. Con ella toma una ducha, abre una puerta o carga su coche. En esta página ves cómo encajan una etiqueta, un cliente y un saldo. Los pasos para vincular o recargar una etiqueta están en [Gestionar etiquetas](/nfc/nfc-tags). Encuentras todas las etiquetas de tu organización en la página **Controladores**, en la tarjeta **Etiquetas NFC**. - Una etiqueta aparece sola en Tillor en cuanto se acerca por primera vez a un lector. No la creas tú. - Una etiqueta pertenece como máximo a un cliente y tiene el estado **Activo**, **Inactivo** o **Bloqueado**. - El saldo está en euros en la etiqueta. Un cambio de saldo siempre se guarda como transacción y no se puede editar ni eliminar. - Un pago que todavía hay que escribir en la etiqueta queda abierto 2 minutos. Después caduca. - Una etiqueta bloqueada ya no funciona en los lectores. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] La etiqueta en sí no sabe nada. Tillor recuerda quién la tiene, cuál es el saldo y adónde puede acceder. El lector se lo pregunta a Tillor en el momento en que el cliente acerca la etiqueta. ```mermaid flowchart TD K[Cliente] --> T[Etiqueta NFC] T --> G[Grupos de acceso
¿adónde puede ir la etiqueta?] T --> S[Saldo
¿cuánto crédito tiene?] L[Lector en ducha, puerta o punto de carga] -->|el cliente acerca la etiqueta| T L --> TR[Transacción
importe, motivo y lector] S --> TR ``` - Sin cliente, el lector rechaza la etiqueta. En la pantalla aparece entonces **Tag niet gekoppeld**. - Sin el grupo de acceso adecuado, el lector rechaza la etiqueta con **Geen toegang**. - Sin saldo suficiente aparece **Saldo insuficiente**. Todos los mensajes de pantalla están en [Mensajes de pantalla](/controllers/troubleshooting/scherm). - Cada cargo o recarga aparece como línea en las [transacciones](/nfc/nfc-transacties). - Una etiqueta también es un método de acceso. La añades a un cliente en [Control de acceso](/toegangscontrole#een-toegangsmethode-toevoegen). ## Secciones [#onderdelen] ## Conceptos [#begrippen] - **Etiqueta**: la tarjeta, pulsera, pegatina o llavero. - **UID**: el número único de la etiqueta. - **Saldo**: el crédito de la etiqueta. - **Grupo de acceso**: determina en qué lectores vale una etiqueta. - **Transacción**: un cargo o una recarga del saldo. Encuentras más explicaciones en el [glosario](/begrippen). # Gestionar etiquetas (/es-ES/nfc/nfc-tags) Una etiqueta NFC solo se puede usar cuando está asociada a un cliente. Entonces ese cliente puede ducharse, abrir una puerta o cargar con ella, y tú puedes llevar el control del saldo. Todos los pasos de abajo los haces en el perfil del cliente. Qué ocurre en cada escaneo lo lees en [Transacciones](/nfc/nfc-transacties). Antes de empezar: - La etiqueta ya tiene que estar en Tillor. Eso ocurre solo en cuanto se acerca por primera vez a un lector. - La etiqueta no puede estar asociada todavía a otro cliente. Si no, no aparece en la lista. - Si no hay ninguna etiqueta libre, la lista dice **No se encontraron etiquetas disponibles**. ## Vincular una etiqueta a un cliente [#een-tag-koppelen-aan-een-klant] ### Abre la pestaña Etiquetas NFC [#open-het-tabblad-nfc-tags] Ve a Clientes > cliente > Etiquetas NFC. Ves todas las etiquetas de este cliente. Sobre la tabla filtras por **UID** y **Tipo** (**Tarjeta**, **Pulsera**, **Pegatina** o **Llavero**). ### Elige la etiqueta [#kies-de-tag] Haz clic en **Seleccione una tarjeta** y elige la etiqueta. Puedes buscar en la lista. ### Haz clic en Asignar [#klik-op-toewijzen] Tillor avisa con **Tarjeta asignada al cliente** y la etiqueta aparece en la tabla. En la tabla ves, por etiqueta, el **UID** (el icono indica el tipo), el **Estado**, el **Saldo**, cuándo se usó por última vez (**Último uso**) y los **Grupos de acceso**. ## ¿Qué puedes hacer con una etiqueta? [#wat-kun-je-met-een-tag-doen] Abre el menú de acciones (tres puntos) al final de la etiqueta. | Acción | Qué hace | |---|---| | **Editar saldo** | Añade un importe o establece el saldo, consulta más abajo. | | **Bloquear** / **Desbloquear** | Cambia el estado a **Bloqueado** o lo restablece. | | **Grupos de acceso** | Determina para qué grupos de acceso vale la etiqueta. | | **Enviar aviso de saldo bajo** | Envía al cliente un aviso de que el saldo es bajo. | | **Copiar URL personal** | Copia el enlace a la página propia de la etiqueta. | | **Quitar del cliente** | Desvincula la etiqueta del cliente. | | **Ver detalles** | Abre la página de detalle con transacciones y actividad. | ### Ajustar el saldo [#het-saldo-aanpassen] ### Elige Editar saldo [#kies-saldo-bewerken] Abre el menú de acciones y elige **Editar saldo**. ### Elige cómo cambiar el saldo [#kies-hoe-je-het-saldo-wijzigt] En **Opción** eliges **Añadir saldo** (sumar un importe) o **Establecer saldo** (un importe exacto). Abajo ves el resultado, por ejemplo **Actual: ... → Nuevo: ...**. ### Confirma [#bevestig] Introduce el importe y haz clic en **Añadir** o **Establecer**. El importe tiene que ser positivo. Tillor avisa con **Saldo actualizado** o **Saldo establecido**. ### Bloquear una etiqueta [#een-tag-blokkeren] Una etiqueta perdida o robada la bloqueas con **Bloquear**. El estado pasa a **Bloqueado** y la etiqueta deja de funcionar en los lectores. Con **Desbloquear** en el mismo menú levantas el bloqueo. El cliente también puede bloquear su etiqueta él mismo en la página personal. ### Elegir grupos de acceso [#toegangsgroepen-kiezen] Elige **Grupos de acceso** y marca o desmarca los grupos. El cambio se aplica enseguida. Si ves **No hay grupos de acceso disponibles**, es que todavía no se han configurado grupos para tu organización. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una etiqueta vinculada aparece en la tabla y en el cliente. Si el cliente la acerca a un lector, el lector le pregunta a Tillor si está permitido. - Cada cambio de saldo se convierte en una [transacción](/nfc/nfc-transacties), también cuando ajustas el saldo manualmente. El motivo es entonces **Ajuste manual**. - En **Actividad**, en la página de detalle, ves el antes y el después de cada cambio (saldo, bloqueo, vínculo con el cliente). - Con **Quitar del cliente** la etiqueta sigue existiendo. Queda libre para dársela a otro cliente. Las transacciones se conservan. - Con **Copiar URL personal** el cliente recibe una página propia. Allí puede bloquear su tarjeta y, si has configurado pagos en línea, recargarla él mismo. Eso genera una factura para el cliente. ## ¿Problemas? [#problemen] Tillor dice **No se encontraron etiquetas disponibles**. Solo aparecen etiquetas que todavía no pertenecen a nadie. Desvincula la etiqueta del otro cliente con **Quitar del cliente**, o acerca una etiqueta nueva a un lector para que aparezca en Tillor. No se pudo guardar el saldo o los grupos de acceso. Inténtalo de nuevo. Si no funciona, actualiza la página y comprueba si la etiqueta sigue asociada al cliente. Lee el motivo en la pantalla del controlador, consulta [Mensajes de pantalla](/controllers/troubleshooting/scherm). Normalmente la etiqueta está **Bloqueado**, no está asociada a un cliente, no tiene activado el grupo de acceso adecuado o el saldo es demasiado bajo. El importe tiene que estar rellenado y ser mayor que cero. Si no, Tillor avisa con **El importe es obligatorio**, **Importe no válido** o **El importe debe ser positivo**. Recargar desde la página personal solo funciona si tu organización ha configurado pagos en línea y si la etiqueta está asociada a un cliente. Consulta [Procesamiento de pagos](/betalingsverwerking). ## Véase también [#zie-ook] # Transacciones (/es-ES/nfc/nfc-transacties) Cada cambio de saldo en una etiqueta NFC se registra como transacción, también un ajuste manual. Así ves exactamente cuándo y por qué cambió el saldo. Las transacciones no se pueden editar ni eliminar. ## Ver transacciones [#transacties-bekijken] ### Abre la etiqueta [#open-de-tag] Ve a Clientes > cliente > Etiquetas NFC, abre el menú de acciones (tres puntos) de la etiqueta y elige **Ver detalles**. ### Mira en Transacciones [#kijk-bij-transacties] La tarjeta **Transacciones** está en la página de detalle. La más reciente aparece arriba. Si hay más de cinco transacciones, paginas al final. Sobre la tabla hay filtros por **Fecha**, **Estado**, **Origen** y **Motivo de cancelación**. Por defecto están activados **Pendiente** y **Confirmada**. Si quieres ver también las transacciones canceladas y caducadas, haz clic en **Borrar filtros**. ## Columnas [#kolommen] | Columna | Significado | |---|---| | **Importe** | El cambio de saldo. Positivo al recargar, negativo al usar. | | **Motivo** | La causa, por ejemplo **Uso de ducha en** un controlador, **Cargo POS**, **Recarga POS**, **Ajuste manual** o **Añadido porque se pagó la factura ...**. | | **Controlador** | El controlador que originó la transacción. Si aparece **Sistema**, no hubo controlador: un cambio manual, la app de recepción o una factura pagada. | | **Fecha** | Fecha y hora. | | **Estado** | Consulta más abajo. | | **Origen** | **En línea** o **Sin conexión**. | | **Descripción**, **Motivo de cancelación** | Explicación adicional y, en una transacción cancelada, el motivo. | ## Estados [#statussen] | Estado | Significado | |---|---| | Pendiente | El cargo está reservado y todavía hay que escribirlo en la etiqueta. | | Confirmada | La transacción está completada y el saldo se ha ajustado. | | Cancelada | La transacción no se ha realizado. El motivo está en **Motivo de cancelación**. | | Caducada | La etiqueta no se acercó al lector a tiempo. Una reserva queda abierta 2 minutos. | Los posibles motivos de cancelación son **Saldo insuficiente**, **No autorizada**, **No se pudo escribir en la tarjeta** y **Caducada**. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una transacción pendiente pasa a Confirmada en cuanto la etiqueta ha recibido el nuevo saldo. Si no lo consigue en 2 minutos, pasa a Caducada y el saldo no cambia. - En **Origen** aparece **Sin conexión** si la transacción no se ha realizado en directo a través de Tillor. - Un recepcionista puede hacer en la app de Tillor el mismo cargo o la misma recarga. El saldo solo se actualiza entonces en Tillor. Aparece como **Cargo POS** o **Recarga POS**, sin controlador. ## ¿Problemas? [#problemen] Abre las transacciones y mira el motivo y la fecha de las últimas líneas. Una línea con **Ajuste manual** la ha introducido un compañero. Si ves transacciones en **Caducada** o **Cancelada**, no se ha cobrado nada por ellas. Espera a que pasen los 2 minutos. La transacción pasa entonces a Caducada. Haz que el cliente acerque de nuevo la etiqueta al lector. La etiqueta todavía no se ha usado y el saldo no se ha ajustado. Entonces no hay nada que mostrar. ## Véase también [#zie-ook] # Notificaciones (/es-ES/notificaties) El resumen de notificaciones muestra cada mensaje que Tillor ha enviado a clientes y compañeros, por correo electrónico, SMS, correo postal, WhatsApp o push. De un vistazo ves qué mensajes han llegado, cuáles siguen en camino y cuáles han fallado. Cómo enviar tú mismo un mensaje de factura está en [Enviar una factura o un recordatorio de pago](/communicatie/e-mails). Abres el resumen en Comunicación > Notificaciones. - Si un mensaje se queda más de 5 minutos sin transmitirse, Tillor lo reintenta automáticamente - Si pasados 2 días todavía no se ha producido ningún envío, Tillor marca el mensaje como **Fallido**. Lo mismo ocurre con un SMS que se queda tanto tiempo en **Pendiente** - La lista **Comunicaciones recientes** muestra 50 mensajes por página de forma predeterminada - Un clic en un enlace de un correo o SMS solo cuenta si ocurre al menos aproximadamente un segundo y medio después del envío. Así, los programas de correo que abren los enlaces de antemano no cuentan como clic - Los mensajes de factura no salen solos al contabilizar una factura. El envío lo inicias tú - Una tarjeta con un aviso nuevo en Tillor desaparece al cabo de unos segundos. El aviso permanece en la campana hasta que lo lees - Los avisos que se envían siempre no se pueden desactivar ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Un mensaje empieza con un motivo. Después Tillor elige el canal y guarda el resultado en el resumen. ```mermaid flowchart LR A[Tú haces clic en Enviar notificación] --> D[Mensaje] B[Ocurre algo, como una alarma de contador] --> D C[Una automatización envía un mensaje] --> D D --> E{¿Para quién?} E -- Cliente --> F[Correo electrónico, SMS, correo postal o WhatsApp] E -- Compañero --> G[Push, correo electrónico o teléfono, según sus preferencias] F --> H[Notificaciones: estado por canal] G --> H G --> I[Campana en Tillor] H --> J[También visible en el cliente y en la factura] ``` - **A un cliente** normalmente eliges tú el canal, por ejemplo en la ventana **Enviar notificación** de una factura. Una [automatización](/begrippen#automatisering) también puede enviar un mensaje a un cliente. - **A un compañero**, es él mismo quien decide cómo le localiza Tillor, por tipo de aviso. Consulta [Avisos en la app](#meldingen-in-de-app). - **El resultado** lo ves aquí, y también en el cliente y en la factura a la que pertenece el mensaje. La columna **Origen** te lleva directamente allí. ## Consultar notificaciones [#notificaties-bekijken] Arriba hay cuatro estadísticas: - **Total de notificaciones**: todos los intentos de envío - **Notificaciones enviadas**: mensajes que se han entregado - **Notificaciones fallidas**: mensajes que no se pudieron entregar - **Notificaciones rebotadas**: mensajes que han rebotado, sobre todo correos electrónicos Debajo hay cuatro listas: **Notificaciones rebotadas**, **Notificaciones pendientes** (todavía en cola o en camino), **Comunicaciones recientes** (todos los estados) y **Notificaciones fallidas**. Con los filtros **Tipo** y **Canal** sobre cada lista limitas lo que ves. Qué tipos existen está en [Tipos de notificación](/communicatie/notificatietypes). Cada fila muestra: | Columna | Qué ves | |---|---| | **Tipo** | Qué clase de mensaje es, como Nueva factura o Alarma de contador o controlador | | **Origen** | La factura, el cliente o el pago al que pertenece el mensaje | | **Canal** | Correo electrónico, SMS, Correo postal, WhatsApp o Push | | **Estado** | El estado de entrega | | **Destinatario** | La dirección de correo, el número de teléfono, la dirección postal o el usuario | | **Fecha** | Cuándo se creó el intento de envío | ### Ver los detalles de la entrega [#leveringsdetails-bekijken] Haz clic en el canal de una fila para ver qué se envió exactamente y qué ocurrió. La ventana muestra el estado de entrega, un posible mensaje de error, el destinatario (**Para**), la dirección del remitente (**De**) y el **Asunto** en el caso del correo. Además ves cuándo estaba listo el mensaje (**Creado el**) y cuándo salió realmente (**Enviado el**). **Enviado por** muestra el usuario que inició el envío, o **Sistema** si ocurrió automáticamente. Abajo están el **Contenido** y los posibles **Adjuntos**. En correo y WhatsApp ves también **Leído el**, y en la lista un icono de ojo en los mensajes leídos. En correo y SMS aparece **Clic el** si el cliente hizo clic en un enlace. En el correo postal hay campos adicionales: **Referencia del transportista**, **Estado de seguimiento** y **Última actualización de seguimiento** (el último evento del servicio postal), **Coste de franqueo** en el momento del envío y, en un envío certificado, la etiqueta **Certificado** con el coste adicional y una explicación sobre cómo se repercute. ### Estados [#statussen] | Estado | Significado | |---|---| | Pendiente | El mensaje se está procesando o está en cola | | Enviado | El mensaje se ha entregado | | Fallido | La entrega ha fallado | | Omitido | El mensaje no se ha enviado (o ya no), por ejemplo porque el push no estaba disponible o porque una carta se canceló en el servicio postal | | Retrasado | El mensaje está programado y saldrá más tarde | | Rebotado | El mensaje no pudo llegar a la dirección de correo o al número | | Marcado como spam | El destinatario marcó el mensaje como spam | Una carta por correo postal empieza en **Pendiente**. En cuanto el servicio postal confirma que la carta está en camino o entregada, pasa a **Enviado**. El correo no entregable pasa a **Fallido**. Una carta cancelada pasa a **Omitido**. Esa fila la encuentras sobre todo en **Comunicaciones recientes**. ## Avisos en la app [#meldingen-in-de-app] Todo lo que Tillor te envía como compañero, como una tarea asignada, una mención en un comentario o una alarma de contador, lo encuentras también en el propio Tillor. Cada aviso aparece una sola vez, aunque se haya enviado por correo electrónico y por push. No tienes que configurar nada para ello. - **Campana**: arriba a la derecha en la barra y abajo a la izquierda en el menú (**Notificaciones**) hay una campana con el número de avisos sin leer. Haz clic para ver tus avisos más recientes. Con **Marcar todo como leído** actualizas la lista de una vez - **Ver el correo**: haz clic en un aviso para abrir el correo que recibiste por él, con un botón arriba hacia la página correspondiente (por ejemplo **Abrir tarea**). Un aviso sin correo te lleva directamente a esa página. Después el aviso queda leído - **Tarjeta abajo a la derecha**: si entra un aviso mientras tienes Tillor abierto, aparece como tarjeta abajo a la derecha, en el mismo sitio que una llamada entrante. Haz clic en la tarjeta o ciérrala con la cruz. Una tarjeta cerrada sigue sin leer en la campana. Si ya estás en la página a la que se refiere el aviso, no recibes tarjeta - **Se queda en pantalla**: los avisos por los que además te llaman por teléfono, como un conector que ya no está accesible, permanecen hasta que los cierras - **Bandeja de entrada**: los mensajes nuevos de la bandeja de entrada mantienen su propia tarjeta y contador en **Bandeja de entrada**. En la campana ya constan como leídos. Lo mismo ocurre con el resumen diario de contadores que necesitan atención - **Por día**: en la lista tus avisos aparecen por día, con la categoría al lado. Con los botones de arriba muestras una sola categoría Los avisos son personales: solo ves los tuyos, por organización. En una [automatización](/begrippen#automatisering) eliges, en el paso **Avisar a compañeros**, con **Mostrar en Tillor** si el aviso recibe una tarjeta y un contador de no leídos. Si está desactivado, el aviso consta como leído en la lista. ### Desactivar avisos [#meldingen-uitzetten] ### Abre tu cuenta [#open-je-account] Haz clic en tu nombre en el menú y elige **Cuenta**. ### Ve a Notificaciones [#ga-naar-meldingen] Activa o desactiva los canales por tipo de aviso. En la fila **Todas las notificaciones** desactivas un canal de una vez para todo. Un canal que desactivas en **Todas las notificaciones** permanece desactivado para todos los avisos de debajo, salvo los que se envían siempre. Un tipo cuyos canales desactivas todos tampoco aparece ya en la app. Para un compañero lo gestionas en Configuración > Usuarios, consulta [Configurar los avisos de un compañero](/gebruikers/gebruikers-en-rechten#meldingen-van-een-collega-instellen). ## Notificaciones externas [#externe-notificaties] Un sistema externo conectado, por ejemplo tu software de boletines o de reservas, puede hacer que Tillor registre los correos que él mismo envió a un cliente. Los encuentras en el cliente, en la factura y en **Comunicaciones recientes**, entre los mensajes de Tillor. Los reconoces por la etiqueta **Externa** con el nombre del sistema. - Tillor no ha enviado el mensaje y no puede comprobar el estado. El estado viene del sistema externo - Las notificaciones externas no cuentan en las estadísticas de arriba y no aparecen en las listas **Notificaciones rebotadas**, **Notificaciones pendientes** y **Notificaciones fallidas** - En la ventana de detalle las imágenes están bloqueadas de forma predeterminada. Así el remitente no se entera de que abres el mensaje. Haz clic en **Cargar imágenes** para mostrarlas de todos modos - El sistema externo puede actualizar o eliminar más tarde sus propias notificaciones. Lo ves reflejado en el [registro de actividad](/activiteitenlog) del cliente o de la factura Quién puede registrar notificaciones externas se gestiona con los permisos **Registrar notificaciones externas** y **Gestionar notificaciones externas de otros**. La explicación técnica para integradores está en [Desarrolladores > Notificaciones externas](/ontwikkelaars/externe-notificaties). ## ¿Problemas? [#problemen] La dirección de correo o el número del cliente no existe o no puede recibir mensajes. Abre el mensaje desde la lista **Notificaciones rebotadas** y lee el mensaje de error. Ve al perfil del cliente mediante la columna **Origen**, corrige la dirección de correo y vuelve a enviar el mensaje con **Enviar notificación** en la factura. Abre el mensaje desde **Notificaciones fallidas** y lee el mensaje de error. Normalmente el número de teléfono es incorrecto o falta el prefijo del país. Corrige el número en el perfil del cliente y vuelve a enviar. El operador de telefonía a veces comunica la entrega con retraso. Tras 2 días Tillor marca el SMS automáticamente como **Fallido**. Abre la ventana de detalle para ver el mensaje de error y comprueba el número. Abre el mensaje desde **Notificaciones pendientes** o **Notificaciones fallidas**. Comprueba la dirección postal en el perfil del cliente (calle, código postal y localidad) y vuelve a enviar la carta con **Enviar notificación** o **Enviar recordatorio** en la factura. La carta se ha cancelado en el servicio postal. Busca el envío en **Comunicaciones recientes** y mira en **Estado de seguimiento** qué ocurrió. Solo vuelve a enviarla si el cliente todavía tiene que recibir la carta. El botón solo aparece en una factura contabilizada, y solo si el cliente tiene una dirección de correo, un número de teléfono o una dirección postal completa. Completa uno de esos datos en el perfil del cliente. Comprueba en **Cuenta**, en **Notificaciones**, si has desactivado todos los canales de ese tipo. Un tipo sin canales tampoco aparece ya en la campana. ## Conceptos [#begrippen] - **[Notificación](/begrippen#notificatie)**: un mensaje que Tillor envía a un cliente o a un compañero, por correo electrónico, SMS, correo postal, WhatsApp o push. - **Canal**: la vía por la que sale un mensaje. Una notificación puede ir por varios canales. - **Entrega**: un intento de envío por un canal, con su propio estado. - **Rebotado**: el mensaje volvió porque la dirección o el número no existe. - **Aviso**: una notificación para un [usuario](/begrippen#gebruiker) de Tillor, visible en la campana. - **Externa**: un mensaje que un sistema conectado envió por su cuenta y que solo se ha registrado en Tillor. Más términos están en el [glosario](/begrippen). ## Ver también [#zie-ook] # Comentarios (/es-ES/notities) Con los comentarios, los compañeros colaboran en torno a clientes, facturas, reservas y otros registros, sin que el cliente vea nada. Escribes un comentario en la página de detalle del registro, mencionas a un compañero con @ y fijas los comentarios importantes. Empieza en [Añadir un comentario](#een-opmerking-toevoegen). - Los comentarios son siempre internos. Nunca se hacen visibles para los clientes, ni en facturas ni en correos. - Un compañero al que mencionas con @ recibe una notificación. - Un comentario resuelto ya no se puede editar ni fijar. - Resolver un comentario desfija automáticamente un comentario fijado. - Eliminar un comentario no se puede deshacer. - Un comentario fijado permanece visible en la parte superior del registro, sin que tengas que desplazarte hasta la tarjeta **Comentarios**. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] ```mermaid flowchart LR R[Registro: cliente, factura, reserva...] --> O[Comentario] O -->|@ mención| M[Aviso para el compañero] O -->|Fijar| P[Arriba en el registro] O -->|Recordatorio| T[Tarea de seguimiento] O -->|Resolver| X[Resuelto y plegado] ``` Todos los comentarios de tu organización están también juntos en Comunicación > Comentarios, con una referencia al registro al que pertenecen. ## ¿Dónde encuentras los comentarios? [#waar-vind-je-opmerkingen] En las páginas de detalle hay una tarjeta **Comentarios**. Según el registro: - Clientes > Resumen o Clientes > Comunicación: en el perfil del cliente - Administración > Facturas: en la página de detalle de la factura - Clientes > Reservas: en la página de detalle de la reserva - Parque > Parcelas: en la página de detalle de la parcela - Parque > Contadores: en la página de detalle del contador - Administración > Informes de pago: en el informe de pago ## Añadir un comentario [#een-opmerking-toevoegen] ### Abre el registro [#open-het-record] Abre por ejemplo un perfil de cliente o una factura y ve a la tarjeta **Comentarios**. ### Haz clic en Añadir comentario [#klik-op-reactie-toevoegen] Escribe tu comentario en el cuadro de texto **Escriba un comentario...**. - Escribe **@** y elige a un compañero de la lista para mencionarlo. Esa persona recibe una notificación. - Escribe **/** para vincular un cliente, una factura, un contador, una parcela u otro registro. - Añade un archivo adjunto con **Adjuntar archivo**, pegándolo o arrastrando archivos. ### Haz clic en Enviar [#klik-op-verzenden] Tu comentario aparece ahora en la tarjeta. Con **Responder** en un comentario existente inicias un hilo de discusión. ### ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El comentario aparece en el registro y en el resumen central. - Un compañero mencionado recibe una notificación. - Si quieres estar seguro de que alguien responde, haz clic en el relojito del comentario (**Establecer un recordatorio de seguimiento**). Tillor crea entonces una tarea, para que más tarde puedas comprobar si se ha atendido. ## Gestionar comentarios [#opmerkingen-beheren] En cada comentario hay botones de acción arriba a la derecha, siempre que tengas los permisos. ### Editar o eliminar un comentario [#opmerking-bewerken-of-verwijderen] - **Editar**: modifica el texto. Se puede en tus propios comentarios, y no en comentarios resueltos. - **Eliminar**: elimina el comentario, tras confirmación. Esto no se puede deshacer. ### Fijar un comentario [#opmerking-vastzetten] ¿Quieres mantener visible un comentario importante en la parte superior? 1. Haz clic en el icono de chincheta (**Fijar**). 2. El comentario recibe la etiqueta **Fijado** y queda arriba en la lista. 3. Haz clic de nuevo en el icono de chincheta para soltarlo (**Desfijar**). Los comentarios resueltos no se pueden fijar. #### Dónde aparece un comentario fijado [#waar-staat-een-vastgezette-opmerking] - En un perfil de cliente aparece justo debajo de los datos del cliente, arriba, encima de las pestañas. - En una factura, reserva, parcela o contador aparece en la tarjeta **De un vistazo**, arriba, junto con las tareas pendientes. Esa tarjeta se pliega si no hay nada dentro. ### Marcar un comentario como resuelto [#opmerking-als-opgelost-markeren] Para discusiones que han terminado: 1. Haz clic en la marca de verificación (**Resolver**). 2. El comentario se marca como **Resuelto** y desaparece de la lista abierta. 3. En una página de detalle, los comentarios resueltos aparecen abajo en una sección plegable. 4. Haz clic de nuevo en la marca de verificación para deshacerlo (**Reabrir**). ### Descargar comentarios como PDF [#opmerkingen-als-pdf-downloaden] Con el icono de impresora descargas todos los comentarios de un registro como PDF (**Descargar todos los comentarios como PDF**), o un solo hilo de discusión (**Descargar este hilo de comentarios como PDF**). ## Resumen de todos los comentarios [#overzicht-van-alle-opmerkingen] Ve a Comunicación > Comentarios para un resumen central. Arriba ves estadísticas (total, abiertos, resueltos y fijados). Debajo: - **Comentarios abiertos**: comentarios que siguen abiertos. - **Comentarios resueltos**: comentarios cerrados como referencia. Cada comentario muestra el **Origen** (por ejemplo cliente o factura), para que puedas ir directamente al registro. ### Filtrar [#filteren] - **Última semana**, **Último mes** o **Todo**: filtra por fecha de creación. - **Mostrar solo menciones**: solo comentarios en los que se te menciona. - Busca con **Buscar comentarios...**, o filtra por autor, mencionado, resuelto, fijado y comentario principal o respuesta. ## ¿Problemas? [#problemen] Tu comentario no se ha guardado. Comprueba que el cuadro de texto no esté vacío e inténtalo de nuevo con **Enviar**. Si aparece **No se encontraron usuarios**, prueba con otro nombre o con una dirección de correo. Solo aparecen en la lista los usuarios de tu organización. Un comentario resuelto está bloqueado. Haz clic primero en la marca de verificación para volver a abrirlo (**Reabrir**). Solo puedes editar tus propios comentarios. Resolver un comentario lo desfija. Vuelve a abrirlo con la marca de verificación y después fíjalo otra vez. El cambio no se ha realizado. Recarga la página e inténtalo de nuevo. Inténtalo de nuevo. Si el PDF no aparece, tu navegador está bloqueando una ventana emergente. Permite las ventanas emergentes para este sitio. ## Conceptos [#begrippen] - **Comentario**: un texto interno en un registro, con archivos adjuntos si quieres. Consulta [comentario](/begrippen#opmerking). - **Mención**: un compañero al que nombras con @. Esa persona recibe una notificación. - **Fijar**: mantener un comentario arriba en el registro. - **Resuelto**: un comentario terminado que desaparece de la lista abierta. - **Origen**: el registro al que pertenece un comentario. - **Tarea**: una to-do que puede surgir de un recordatorio en un comentario. Consulta [tarea](/begrippen#taak). ## Ver también [#zie-ook] # Parque (/es-ES/park) En **Parque** está todo lo que tiene que ver con el lugar físico: el mapa con la ocupación de hoy, la lista de parcelas, los contadores y armarios de contadores, y el tiempo. Empieza por las [Parcelas](/terreinen), porque una ocupación, un contador y una tarifa dependen todos de ellas. ## ¿Qué encuentras dónde? [#wat-vind-je-waar] | Menú | Para qué | Explicación | |---|---|---| | Parque > Mapa | El mapa de tu parque, coloreado por día según la ocupación | [Mapa](/kaart) | | Parque > Parcelas | Todas las parcelas, su tarifa y los contadores que tienen | [Parcelas](/terreinen) | | Parque > Contadores | Todos los contadores de agua, gas y electricidad | [Gestión de contadores](/meterbeheer) | | Parque > Armarios de contadores | Los armarios donde están los contadores y qué contadores tienen dentro | Gestiona tus armarios de contadores y sus contadores asignados | | Parque > Tiempo | El tiempo por día en la ubicación de tu parque | [Tiempo](/weer) | ## Armarios de contadores [#meterkasten] En Parque > Armarios de contadores gestionas los armarios de contadores y los contadores que tienen asignados. Con **Nuevo armario de contadores** añades un armario, con un nombre y una descripción. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] La **parcela** es el punto de anclaje. A una parcela le asignas los contadores. Un cliente llega a una parcela mediante una **ocupación**, y un huésped de estancia corta mediante una **reserva**. El consumo de los contadores de la parcela va al cliente con la ocupación activa. ```mermaid flowchart LR M[Contadores] --> T[Parcela] T --> K[Mapa] B[Ocupación
cliente por largo tiempo] --> T R[Reserva
estancia con fecha de entrada y de salida] --> T T --> V[Tarifa y consumo en la factura] ``` Una parcela solo recibe un color en el mapa cuando has dibujado su límite. Consulta [Dibujar los límites de las parcelas](/kaart#terreingrenzen-intekenen). - Una parcela tiene como máximo una ocupación activa a la vez. - Una parcela nueva no es reservable de forma predeterminada. Marca **Reservable** si los clientes pueden reservarla online. - La superficie no se puede escribir. Tillor la calcula en cuanto dibujas la parcela en el mapa, y la usa para la tarifa. - El mapa siempre se abre en hoy. Tus demás ajustes del mapa (estilo, etiquetas, capas) se conservan. - Las etiquetas con noches y salida solo aparecen a partir del nivel de zoom 17,5. - El tiempo se obtiene cada noche para el centro del mapa de tu organización. ## Conceptos [#begrippen] - **Parcela**: un lugar de tu parque con un nombre, una tarifa y, si procede, contadores. Consulta [Conceptos](/begrippen#terrein). - **Mapa**: el mapa interactivo de Parque. - **Armario de contadores**: un armario con contadores. Consulta [Conceptos](/begrippen#meterkast). - **Ocupación**: un cliente en una parcela durante un periodo. Consulta [Conceptos](/begrippen#bezetting). - **Reservable**: una parcela que los clientes pueden reservar online. ## Ver también [#zie-ook] # Ajustes de impresión (/es-ES/printer/afdrukinstellingen) Esta es la lista de todos los ajustes de Configuración > Impresión. Los ajustes se aplican a toda tu organización. Cómo configurarlo paso a paso está en [Configurar impresoras](/printer/printers-instellen). | Ajuste | Significado | | ---------- | --------- | | **Impresión PDF** | Activa la impresión de facturas y documentos en impresoras físicas. Sin esto, Tillor no imprime nada. | | **Imprimir factura automáticamente al pagar** | Las facturas pagadas van automáticamente a la cola de impresión. Por tipo de pago eliges si ocurre de inmediato, en la siguiente hora de corte o no. | | **Imprimir documento de identidad al vincular** | Si vinculas un escaneo de identidad a un cliente o contacto (también al crear un cliente a partir de un escaneo), el resumen va como PDF a la impresora A4. Requiere: **Impresión PDF** activada y una **IP de impresora PDF** rellenada. | | **IP de impresora PDF** | Dirección de red de la impresora A4 para facturas y documentos, por ejemplo `192.168.1.100`. | | **IP de impresora térmica** | Dirección de red de la impresora de tickets, por ejemplo `192.168.1.101`. | | **Ancho del papel de tickets** | Ancho del rollo de tickets: **80 mm** (predeterminado) o **58 mm**. Tillor adapta a ello la longitud de línea y el logotipo del ticket. | | **IP de impresora de etiquetas** | Dirección de red de la impresora de etiquetas, por ejemplo `192.168.1.102`. | | **Horario de cortes de impresión** | Por día de la semana, una o más horas al minuto, por ejemplo 09:00 y 13:30. Vacío significa que ese día no hay momentos de corte. | | **Momento de impresión automática por tipo de pago** | Por canal (terminal/mostrador, manual, online, mandato, transferencia): **Imprimir de inmediato**, **Siguiente hora de corte** o **No imprimir automáticamente**. De forma predeterminada, terminal y manual imprimen de inmediato. Online, mandato y transferencia esperan a la hora de corte. | | **Pausar impresión hasta** | Retiene la cola de impresión hasta el momento elegido. **Quitar pausa** elimina la pausa. También puedes pausar desde la [cola de impresión](/printer/printwachtrij). | Haz clic abajo en **Guardar configuración** para aplicar tus cambios. Se aplican de inmediato. Las impresoras deben estar en la misma red que el conector y tener una dirección IP fija. Asigna a la impresora una dirección fija en tu router, porque si no la dirección puede cambiar. ## Ver también [#zie-ook] # Imprimir una factura o un ticket (/es-ES/printer/documenten-afdrukken) Imprimes una factura desde la página de la factura, en la impresora A4 o en la impresora de tickets. En los pagos, Tillor también puede imprimir tickets por sí mismo. También puedes mostrar una factura en la tableta sin imprimirla. Antes de empezar: - Las impresoras están configuradas, consulta [Configurar impresoras](/printer/printers-instellen). - Hay un conector activo para tu organización. Sin él, las opciones **Enviar a impresora A4** y **Enviar a impresora de tickets** no aparecen en el menú. ## Imprimir una factura [#een-factuur-afdrukken] ### Abre la factura [#open-de-factuur] Ve a Administración > Facturas y abre la factura. ### Elige cómo imprimir [#kies-hoe-je-afdrukt] Haz clic en **Imprimir**. Tu navegador abre su propia ventana de impresión. Haz clic en la flechita junto a **Imprimir** y elige **Enviar a impresora A4** o **Enviar a impresora de tickets**. Tillor pone un trabajo en la cola de impresión. ## Tickets tras un pago [#bonnen-na-een-betaling] En Configuración > Impresión activa **Imprimir factura automáticamente al pagar**. Las facturas pagadas van entonces a la impresora A4 y, si procede, a la impresora de tickets, de inmediato o en la siguiente hora de corte, según el canal de pago. Por producto puedes además activar **Impresión térmica** e **Impresión A4** y configurar el número de copias en la página del producto. Esas copias salen adicionalmente en cuanto ese producto aparece en una factura pagada. ## Mostrar una factura en la tableta [#een-factuur-op-de-tablet-tonen] ¿Quieres enseñar una factura sin imprimirla? Elige **Vista previa en iPad** en el menú de los tres puntos de la factura, o haz clic en **Vista previa en iPad** en la ventana de pago de un pago en efectivo. El PDF aparece en la tableta vinculada y Tillor avisa con **PDF enviado al iPad**. Consulta [Tabletas y quioscos](/mobiele-app/tablets-en-kiosken). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Un trabajo para una impresora aparece en la [cola de impresión](/printer/printwachtrij) con un estado. En el momento de impresión pasa a la impresora. - Si la impresión falla, Tillor en la mayoría de los casos lo reintenta automáticamente. Después el trabajo queda en **Fallido** hasta que tú lo reintentas o lo cancelas. - La factura en sí no cambia: imprimir no contabiliza ni envía nada. ## ¿Problemas? [#problemen] No hay un conector activo para tu organización, o **Impresión PDF** está desactivada. Consulta [Configurar impresoras](/printer/printers-instellen). El aviso es **No se pudo enviar el documento a la impresora.** Abre la [cola de impresión](/printer/printwachtrij) para ver el motivo en **Último error**, por ejemplo una impresora desconectada o sin papel. No se pudo descargar el PDF. Inténtalo de nuevo. El PDF no pudo llegar a la tableta. Entonces no hay ninguna tableta accesible. Abre la app de Tillor en la tableta y comprueba si en Configuración > Tabletas y quioscos aparece como **Conectado**. ## Ver también [#zie-ook] # Resumen (/es-ES/printer) Con la conexión de impresoras imprimes facturas, tickets y etiquetas directamente desde Tillor en una impresora de tu parque, sin descargar antes el documento. Configuras las impresoras una sola vez en [Configurar impresoras](/printer/printers-instellen) y después imprimes con un clic o dejas que Tillor lo haga al recibir un pago. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Tillor no envía un trabajo de impresión directamente a tu impresora. El trabajo entra primero en la cola de impresión. En el momento de impresión, Tillor lo pasa al conector, un programa pequeño en un ordenador de tu red, y este hace que la impresora imprima. ```mermaid flowchart LR A[Imprimes una factura o
entra un pago] --> B[Cola de impresión en Tillor] B -- de inmediato o en el momento de impresión --> C[Conector en tu red] C --> D[Impresora] B -- falla --> E[Tillor lo reintenta] ``` Por eso el conector debe estar en línea y la impresora accesible en la misma red. Sin un conector activo no ves las opciones para enviar a una impresora. Consulta [Conector](/connector). - Hay tres tipos de impresoras: una impresora A4 para facturas y documentos, una impresora térmica para tickets de caja y una impresora de etiquetas. - El ancho del rollo de tickets es 80 mm (predeterminado) o 58 mm. - Un trabajo fallido lo reintenta Tillor automáticamente a los 10 segundos, a los 5 minutos y a los 15 minutos. Después queda en **Fallido**. Si se ha acabado el papel o la impresora está desconectada, queda de inmediato en **Fallido**. - Cada lunes por la mañana Tillor reintenta una vez más todos los trabajos que están en **Fallido**. - Pausar la impresión es posible durante 15 minutos, 1 hora, 4 horas, 6 horas, 1 día o hasta que la reanudes tú. - De forma predeterminada, los pagos con terminal y los pagos manuales se imprimen de inmediato. Los pagos online, los mandatos y las transferencias esperan al siguiente momento de impresión. ## ¿Qué quieres hacer? [#wat-wil-je-doen] ## Conceptos [#begrippen] - **Cola de impresión**: la lista de trabajos de impresión que Tillor todavía tiene que enviar. - **Momento de impresión**: una hora fija en un día de la semana en la que Tillor envía los trabajos agrupados, también llamada hora de corte. - **Impresora térmica**: la impresora de tickets de caja. - **Conector**: el programa de tu red que maneja la impresora. Consulta [Conector](/connector). - **Dirección IP**: la dirección de red de una impresora, por ejemplo `192.168.1.100`. Más explicaciones están en el [glosario](/begrippen). # Configurar impresoras (/es-ES/printer/printers-instellen) Para que Tillor pueda imprimir, tiene que saber qué impresoras tienes y dónde están en tu red. Lo configuras una sola vez para toda tu organización. Después puedes [imprimir documentos](/printer/documenten-afdrukken). Cada ajuste con su explicación está en [Ajustes de impresión](/printer/afdrukinstellingen). Antes de empezar: - El conector funciona en un ordenador de la misma red que las impresoras. Consulta [Conector](/connector). Si no está activo, más adelante no verás opciones para enviar a una impresora. - Conoces la dirección IP de cada impresora, es decir, la dirección de red, por ejemplo `192.168.1.100`. Asigna a la impresora una dirección fija en tu router, porque si no la dirección puede cambiar y la impresión se detiene. ## Añadir una impresora [#een-printer-toevoegen] ### Abre Impresión [#open-afdrukken] Ve a Configuración > Impresión. ### Activa Impresión PDF [#zet-pdf-afdrukken-aan] Sin este interruptor, Tillor no imprime nada. ### Rellena las direcciones de las impresoras [#vul-de-printeradressen-in] En **Direcciones IP de impresoras** rellena la dirección de la **IP de impresora PDF** (A4), la **IP de impresora térmica** (tickets) y la **IP de impresora de etiquetas**. Deja vacío lo que no tengas. En **Ancho del papel de tickets** elige 80 mm o 58 mm, según tu rollo de tickets. ### Elige cuándo se imprime [#kies-wanneer-er-afgedrukt-wordt] En **Horario de cortes de impresión** pon, por día de la semana, una o más horas (por ejemplo 09:00 y 13:30). En **Momento de impresión automática por tipo de pago** elige para cada canal de pago: **Imprimir de inmediato**, **Siguiente hora de corte** o **No imprimir automáticamente**. ### Haz clic en Guardar configuración [#klik-op-instellingen-opslaan] Los ajustes se aplican de inmediato a toda tu organización. ## Impresión automática al pagar [#automatisch-afdrukken-bij-betaling] Si quieres que una factura pagada salga en papel sin intervención, activa **Imprimir factura automáticamente al pagar**. Por canal de pago decides con el momento de impresión de arriba si ocurre de inmediato o en la siguiente hora de corte. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - En cada impresión, Tillor pone un trabajo en la [cola de impresión](/printer/printwachtrij), que el conector pasa a la impresora. - Las facturas pagadas van automáticamente a la impresora A4 y, si procede, a la impresora de tickets, si lo has activado. - Si en un canal eliges una hora de corte, Tillor agrupa los trabajos hasta ese momento. Si ese día no hay momento de impresión, no hay momento de corte. - Pruébalo con una factura, consulta [Imprimir documentos](/printer/documenten-afdrukken). ## ¿Problemas? [#problemen] Las opciones solo aparecen si **Impresión PDF** está activada y hay un conector activo para tu organización. Comprueba ambas cosas. La impresora está apagada, no tiene conexión de red o la dirección IP ya no es correcta. Comprueba la dirección en Configuración > Impresión y si el conector está en línea. Rellena la impresora e inténtalo de nuevo desde la cola de impresión. El conector no recibió respuesta de la impresora. Comprueba que el conector funciona y que la impresora es accesible. Mira en la cola de impresión si el trabajo se ha reintentado. Comprueba en **Momento de impresión automática por tipo de pago** si ese canal está en **Siguiente hora de corte**. Entonces el ticket espera a la hora que elegiste en **Horario de cortes de impresión**. Si has pausado la impresión, mira en la [cola de impresión](/printer/printwachtrij). Comprueba el **Ancho del papel de tickets**: 80 mm o 58 mm. ## Ver también [#zie-ook] # Gestionar la cola de impresión (/es-ES/printer/printwachtrij) En la cola de impresión ves qué trabajos de impresión esperan, están en proceso o han fallado. Aquí pausas la impresión, haces avanzar trabajos y resuelves los que no han salido bien. La lista se actualiza sola en cuanto un trabajo cambia de estado. Antes de empezar: las impresoras están configuradas, consulta [Configurar impresoras](/printer/printers-instellen). ## Ver la cola [#de-wachtrij-bekijken] Ve a Administración > Cola de impresión. Las listas son: - **En cola, programados y en proceso**: trabajos que todavía se están procesando. Un trabajo con el estado **Programado para más tarde** espera a su hora de **Programado** y entonces se imprime solo, salvo que la impresión esté pausada. - **Fallido**: trabajos que han fallado definitivamente, con el motivo en **Último error**. - **Todos los trabajos de impresión**. ## Pausar la impresión [#het-afdrukken-pauzeren] ### Elige Pausar impresión [#kies-afdrukken-pauzeren] Haz clic en **Pausar impresión** y elige una duración: 15 minutos, 1 hora, 4 horas, 6 horas, 1 día o **Hasta que lo volvamos a activar**. ### Reanuda cuando hayas terminado [#hervat-wanneer-je-klaar-bent] Haz clic en **Reanudar impresión**. Si no, se reanuda sola tras la duración elegida. Durante la pausa esperan tanto los trabajos inmediatos como los programados. Los trabajos nuevos se quedan en la cola. Junto al icono de la pausa aparece hasta cuándo dura. También puedes configurar la pausa en **Pausar impresión hasta** en Configuración > Impresión. ## Hacer avanzar o recuperar trabajos [#opdrachten-doorzetten-of-herstellen] Haz clic en **Procesar cola** en la barra de herramientas de la lista. Los trabajos programados se procesan entonces de inmediato. El botón está en gris mientras la impresión esté pausada, con la sugerencia **Reanuda la impresión para procesar la cola**. Abre el menú de los tres puntos de la fila y elige **Reintentar** para enviarlo otra vez, o **Cancelar**. Un trabajo cancelado recibe el estado **Cancelado** y ya no se imprime. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Un trabajo fallido lo reintenta Tillor por sí mismo a los 10 segundos, luego a los 5 minutos y luego a los 15 minutos. Si aun así no funciona, queda en **Fallido**. - Los errores que un nuevo intento no resuelve, Tillor no los reintenta: papel, tóner o tinta agotados, una impresora desconectada o en pausa, o una cola de impresión desactivada. Esos quedan de inmediato en **Fallido**. - Cada lunes por la mañana Tillor deja preparados una vez más todos los trabajos que están en **Fallido**. - Un trabajo que permanece en **Fallido** no hace nada hasta que tú lo reintentas o lo cancelas. ## ¿Problemas? [#problemen] Enciende la impresora, comprueba la conexión de red y que el conector esté en línea. Después elige **Reintentar**. Rellena la impresora y elige **Reintentar**. La propia impresora está en pausa, por ejemplo por un atasco de papel. Resuélvelo en la impresora e inténtalo de nuevo. El trabajo se envió a la impresora pero no se completó. Comprueba si ya ha salido algo antes de reintentar, porque si no saldrá duplicado. La cola de la propia impresora está desactivada. Actívala en la impresora e inténtalo de nuevo. La impresión está pausada. Elige **Reanudar impresión**. No se pudo hacer avanzar la cola. Inténtalo otra vez. Si sigue sin funcionar, comprueba que el conector esté en línea. Inténtalo de nuevo, o cancela el trabajo y vuelve a imprimir el documento desde la factura. ## Ver también [#zie-ook] # Vincular acciones a un producto (/es-ES/producten/acties-instellen) Con las acciones automatizas lo que ocurre tras contabilizar o pagar una factura: recargar una etiqueta NFC, prolongar una ocupación, imprimir un ticket o crear un método de acceso. Un producto puede tener varias acciones a la vez. Antes de empezar: el producto ya existe. Consulta [Crear un producto](/producten/product-aanmaken). Un esquema de lo que hace Tillor y cuándo está en [¿Cómo encaja todo?](/producten#hoe-hangt-dit-samen). ### Abre el producto [#open-het-product] Ve a Administración > Productos y abre el producto. ### Marca las acciones [#vink-de-acties-aan] Busca a la derecha la tarjeta **Acciones de línea de factura**. Marca las acciones que quieras. En algunas acciones aparecen después campos adicionales. Qué hace cada acción y qué campos le corresponden lo lees en [Acciones de producto](/producten/productacties). Deja todas las casillas sin marcar para una tarifa normal sin seguimiento. ### Guarda [#sla-op] Haz clic en **Guardar** abajo en la tarjeta **Líneas de factura adicionales**. Las acciones ya están en el producto y se aplican a las líneas de factura nuevas. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] Cuando eliges el producto en una línea de factura, Tillor copia a esa línea las acciones con los valores configurados. Qué acción hace algo y cuándo depende del tipo. Algunas acciones se ejecutan al contabilizar la factura, la mayoría al pagar. | Momento | Acciones | |--------|--------| | Al contabilizar | **Prolongar periodo de ocupación** (ajusta **Facturado hasta**), **Solicitar datos de contacto** (solo se puede contabilizar cuando los campos obligatorios están rellenados), crear una reserva con **Periodo** y **Pedir parcela** | | Al pagar | **Recargar etiqueta NFC**, **Periodo**, **Prolongar periodo de ocupación** (ajusta **Pagado hasta**), **Prolongar método de acceso**, **Crear método de acceso**, **Impresión térmica** e **Impresión A4** | | Sin efecto | **Consumo de contador** (determina la tarifa), **Mostrar alerta** (muestra un texto) | | Bloquea la contabilización | **Impedir reserva** | En la lista de productos ves en la columna **Acción** qué acciones tiene un producto. Un cambio en las acciones de un producto vale para las líneas de factura que añadas después. ## ¿Problemas? [#problemen] Los campos adicionales solo aparecen después de marcar la acción correspondiente. **Registrar entrada al reservar** y **Registrar la entrada al pagar** solo los ves si **Pedir parcela** está activado. Comprueba si la acción está rellenada en la propia línea de factura. En **Crear método de acceso**, por ejemplo, tiene que haberse elegido un tipo. Sin tipo, Tillor no crea nada, y en una línea que no es opcional no puedes contabilizar la factura. ## Ver también [#zie-ook] # Configurar líneas de factura adicionales (/es-ES/producten/bundel-instellen) Algunos productos son más que una línea en una factura: la cuota de parcela con recargos, una explicación, el alquiler de contador o etiquetas NFC. Para ello configuras en el producto principal un paquete de líneas adicionales. Cuando alguien elige ese producto como línea principal en una factura borrador, Tillor añade las líneas hijas bajo esa línea principal, en el orden que tú configures. ```mermaid flowchart TD hoofd[Línea principal: producto con paquete] --> stap1[Paso 1 del paquete] stap1 --> kind1[Línea hija en la factura] hoofd --> stap2[Paso 2 del paquete] stap2 --> kind2[Línea hija en la factura] ``` ## Crear o editar un paquete [#een-bundel-aanmaken-of-bewerken] ### Abre el producto principal [#open-het-hoofdproduct] Ve a Administración > Productos y abre el producto, por ejemplo la cuota de parcela. ### Inicia el paquete [#start-de-bundel] Busca la tarjeta **Líneas de factura adicionales** bajo **General**. Si el producto todavía no tiene paquete, haz clic en **Configurar paquete**. ### Añade pasos [#voeg-stappen-toe] Haz clic en **Paso de producto** para una línea con un producto y un importe, o en **Paso de información** para una línea solo con texto. Rellena los campos de cada paso. Qué hace cada campo está en [Pasos del paquete](/producten/bundel-velden). ### Pon los pasos en el orden correcto [#zet-de-stappen-in-de-juiste-volgorde] Con las flechas **Subir paso** y **Bajar paso** decides el orden en la factura. **Eliminar paso** quita un paso. ### Guarda [#sla-op] Haz clic en **Guardar** abajo en la tarjeta. **Guardar** bajo **Líneas de factura adicionales** guarda toda la página del producto, también los cambios en **General** y en **Acciones de línea de factura**. Cada paso de producto debe tener un producto y cada paso de información un texto. Si no, Tillor no guarda el paquete. Con **Eliminar paquete completo** desactivas el paquete. Un paquete puede tener como máximo 40 pasos. ## Ejemplo: un paquete de cuota de parcela [#voorbeeld-een-staangeld-bundel] Un paquete típico de cuota de parcela consta de cinco pasos. Los pasos con fórmula pegan en el campo **Fórmula** la fórmula de [Pasos del paquete](/producten/bundel-velden#voorbeelden). ### Explicación [#toelichting] Un **Paso de información** con el texto "Incluye las tasas turística, municipal y provincial". ### Primer NFC incluido [#eerste-nfc-inbegrepen] Un **Paso de producto** con el producto de recargo NFC y una fórmula que devuelve la primera etiqueta NFC activa del cliente con cantidad 0 y precio 0. Activa **Multiplicar por la cantidad de la fila principal** y **Una vez por factura**, elige **Estilo de línea** **INFO** y rellena en **Días extra tras el fin de la línea principal (métodos de acceso)**, por ejemplo, `20`. ### Etiquetas NFC adicionales [#extra-nfc-tags] El mismo paso de producto con una fórmula que devuelve la segunda, tercera, etcétera, etiqueta NFC activa a la tarifa del producto, con las mismas opciones de escala y de prolongación. Activa también aquí **Una vez por factura**. ### Alquiler de contador [#meterhuur] Un **Paso de producto** con el producto de alquiler de contador y una fórmula que elige de `{meters}` los contadores que cuentan, por ejemplo solo contadores de electricidad ICY con suministro activado, y devuelve por contador una línea con el nombre del contador en la descripción. ### Perros [#honden] Un **Paso de producto** con el producto de perros y una fórmula que lee el número de perros de un campo propio del cliente y devuelve una línea con ese número, o ninguna línea si no hay perros. ## Prolongar NFC mediante el paquete [#nfc-verlengen-via-de-bundel] Para la cuota de parcela con etiquetas NFC van juntas tres cosas: 1. En el producto principal está la acción **Prolongar periodo de ocupación**, y en la línea de factura se ha elegido una parcela. 2. En el paquete hay como mínimo un paso con **Días extra tras el fin de la línea principal (métodos de acceso)** rellenado, por ejemplo los pasos NFC del ejemplo anterior. 3. En el producto principal está la acción **Prolongar método de acceso** con los tipos y estados deseados y, si quieres, un día de la semana y una hora de fin. Al pagar una línea de uno de esos pasos, Tillor fija la validez de los métodos de acceso del cliente en la fecha de fin de la línea principal de cuota de parcela más los días extra. De forma predeterminada llega hasta las 23:59 en la zona horaria de la organización, o hasta el día de la semana y la hora que hayas configurado en **Prolongar método de acceso**. Si la línea principal no tiene fecha de fin, Tillor no prolonga nada. **Días extra tras el fin de la línea principal (métodos de acceso)** solo funciona si el producto tiene como acción **Prolongar periodo de ocupación**. Si bajo el campo aparece el aviso de que esto es necesario, marca a la derecha, en **Acciones de línea de factura**, **Prolongar periodo de ocupación**. ## ¿Qué ocurre en una factura borrador? [#wat-gebeurt-er-op-een-conceptfactuur] - Las líneas hijas solo aparecen bajo la línea principal después de elegir una parcela en **Prolongar periodo de ocupación**. - Tillor reconstruye las líneas hijas cuando en la línea principal cambias el producto, la cantidad o la parcela. En otros casos, las líneas hijas modificadas a mano se conservan. Si por ejemplo quitas una línea de contador, no vuelve sola. - En el editor de facturas ves una vista previa de las líneas hijas, incluido el efecto de **Una vez por factura**, para que coincida con lo que habrá tras guardar. - Una línea principal solo se mueve con las flechas como bloque completo. Las líneas hijas solo las desplazas dentro de su paquete. Si eliminas la línea principal, las líneas hijas desaparecen con ella. - En el PDF, las líneas hijas normales suelen llevar un **↳** delante de la descripción. Las líneas de información aparecen como líneas grises sin importes. - Los pasos sin producto elegido Tillor los omite. Un producto que ya se ha eliminado o falta, por tanto, no genera ninguna línea. ## ¿Problemas? [#problemen] En un producto principal con **Prolongar periodo de ocupación** tienes que elegir primero una parcela en la línea principal. Para la prolongación de NFC al pagar, la línea principal necesita además una fecha de fin. Si en una factura hay dos o más líneas principales con un paquete, cada línea principal recibe las líneas del paquete. Activa **Una vez por factura** en los pasos que solo pueden aparecer una vez. El paso pertenece entonces solo a la primera línea principal en el orden de la factura. Comprueba que cada paso de producto tiene un **Producto** y cada paso de información un **Texto de línea informativa**. ## Ver también [#zie-ook] # JSON del paquete (/es-ES/producten/bundel-json) La tarjeta **Líneas de factura adicionales** guarda un paquete como JSON en el producto, bajo la clave `invoiceBundle`. Para las importaciones se usa la misma estructura. Para el uso normal no necesitas esta página: los campos y su explicación están en [Pasos del paquete](/producten/bundel-velden). ## Estructura [#structuur] | Campo | Significado | |------|-----------| | `invoiceBundle.version` | Siempre `1` | | `invoiceBundle.steps` | Lista de pasos, máximo 40. El orden es el orden de las líneas hijas en la factura | Cada paso es un paso de producto o un paso de información. ### Paso de producto [#productstap] | Campo | Significado | |------|-----------| | `productId` | Un producto existente en tu organización. Obligatorio | | `quantity` | Número mayor que 0, por defecto `1`. La cantidad de la línea sin fórmula, o cuando la fórmula devuelve `true` | | `quantityScale` | Opcional. `"anchor_line_quantity"` multiplica cada cantidad calculada por la cantidad de la línea principal | | `description` | Opcional. Texto de la línea de factura en lugar del nombre del producto; una fórmula puede dar un `description` propio por línea | | `style` | Opcional. `DEFAULT` o `INFO` | | `billOncePerInvoice` | Opcional. `true` mantiene el paso, cuando hay varias líneas principales en una factura, en la primera línea principal | | `extendAccessMethod` | Opcional. `{ "daysAfterPeriodEnd": }`, consulta [Prolongación de NFC](#nfc-verlenging) | | `formula` | Opcional. TypeScript que determina qué líneas genera el paso, consulta [Fórmula](#formule) | ### Paso de información [#inforestap] ```json { "stepKind": "info", "description": "Inclusief toeristen-, gemeente- en provincietaksen" } ``` `description` es obligatorio y un paso de información no tiene `productId`. Con `style` (`DEFAULT` o `INFO`) eliges el estilo de la línea; por defecto es `INFO`. Una `formula` que devuelve `false` omite la línea de información. ## Fórmula [#formule] `formula` es TypeScript que, al guardar una factura, devuelve `true` (una línea con `quantity`), `false` (ninguna línea), un número (la cantidad) o una lista de líneas `{ "quantity", "description", "unitPrice", "accessMethodValue" }`. Qué campos y listas puedes leer y qué hace cada forma está en [Fórmula por paso](/producten/bundel-velden#formule-per-stap). Una fórmula que no compila se rechaza al guardar el producto. En JSON, la fórmula aparece como una sola cadena con `\n` para los saltos de línea. ```json "formula": "return {customer.customFields.exemptFromSurcharges} !== true;" ``` ## Prolongación de NFC [#nfc-verlenging] Solo tiene sentido si el producto principal tiene **Prolongar periodo de ocupación** como acción. ```json "extendAccessMethod": { "daysAfterPeriodEnd": 20 } ``` Cuando se paga una línea de un paso así, Tillor fija la validez de los métodos de acceso del cliente en la fecha de fin de la línea principal más `daysAfterPeriodEnd` días naturales. Por defecto llega hasta las 23:59 en la zona horaria de la organización, o hasta el día de la semana y la hora de **Prolongar método de acceso** en el producto principal. Qué tipos y estados cuentan también se configura allí. Sin fecha de fin en la línea principal no ocurre nada. Con **No acortar al prolongar** activado, Tillor omite los métodos cuya validez ya está en la nueva fecha o después. Un `accessMethodValue` en la línea nombra el método de esa línea; la prolongación en sí sigue los ajustes del producto principal. Tras una prolongación correcta, la cronología de la factura muestra una línea que remite al pago. ## Ejemplo: explicación, recargo NFC, alquiler de contador y perros [#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})` }];" } ] } } ``` Comprueba que todos los valores `productId` de los pasos de producto existen en tu catálogo. Tillor omite los pasos con un producto desconocido. ## Véase también [#zie-ook] # Pasos del paquete (/es-ES/producten/bundel-velden) Esta página describe los campos de la tarjeta **Líneas de factura adicionales** en la página del producto. Cómo construir un paquete está en [Configurar líneas de factura adicionales](/producten/bundel-instellen). ## Paso de producto [#productstap] Tillor convierte un paso de producto en cero, una o varias líneas de factura con ese producto. Sin fórmula es una sola línea con la cantidad configurada; con una [fórmula](#formule-per-stap) decides tú si hay líneas, cuántas y cuáles. | Campo | Qué hace | |------|--------------| | **Producto** | El producto que se añade a la línea hija, por ejemplo un recargo NFC o el alquiler de un contador. Obligatorio | | **Cantidad** | La cantidad de la línea si el paso no tiene fórmula, o si la fórmula devuelve `true`. Mayor que 0 | | **Multiplicar por la cantidad de la fila principal** | Multiplica cada cantidad calculada por la cantidad de la línea principal, por ejemplo 0,5 con medio año de tarifa de estancia. El resultado se redondea a dos decimales. Tillor omite las líneas que así quedan en 0; una línea que la propia fórmula devuelve con cantidad 0 se mantiene | | **Descripción (opcional)** | Sustituye el nombre del producto en la línea de factura. Una fórmula que devuelve líneas puede dar a cada línea su propia descripción | | **Estilo de línea** | **Predeterminado (producto)**, **DEFAULT** o **INFO**. Con **INFO**, la línea hija pasa a ser una explicación en gris en el PDF y en el editor | | **Una vez por factura** | Solo es relevante si hay dos o más líneas principales con un paquete en la misma factura. El paso pertenece entonces solo a la primera línea principal en el orden de la factura | | **Días extra tras el fin de la línea principal (métodos de acceso)** | Solo tiene sentido si el producto principal tiene **Prolongar periodo de ocupación** como acción. Cuando se paga una línea de este paso, Tillor prolonga los métodos de acceso del cliente hasta la fecha de fin de la línea principal más este número de días; los tipos y estados vienen de **Prolongar método de acceso** en el producto principal, consulta [Prolongar NFC mediante el paquete](/producten/bundel-instellen#nfc-verlengen-via-de-bundel) | | **Fórmula** | Opcional. TypeScript que determina si el paso aparece en la factura, con qué cantidad o qué líneas exactamente, consulta [Fórmula por paso](#formule-per-stap) | ## Paso de información [#inforestap] Un paso de información es solo texto, sin producto ni importe. Tillor lo muestra como línea de explicación. | Campo | Qué hace | |------|--------------| | **Texto de línea informativa** | El texto visible, por ejemplo "Inclusief toeristen-, gemeente- en provincietaksen". Obligatorio | | **Estilo de línea** | Por defecto **INFO**. Puedes elegir **DEFAULT** si quieres mostrar la línea como una línea normal | | **Fórmula** | Opcional. Si la fórmula devuelve `false`, la línea de información se omite | Si un paso de información está debajo de una línea principal, el PDF añade automáticamente **↳** delante del texto. ## Fórmula por paso [#formule-per-stap] Cada paso puede tener una **Fórmula**: TypeScript, igual que la [fórmula de tarifa](/terreinen#tariefformule), que Tillor ejecuta al guardar una factura con este paquete. Así, un paso depende del cliente, la ocupación, la parcela, los contadores o los métodos de acceso, por ejemplo mediante un [campo propio](/eigen-velden) en el que registras una excepción. ### Qué devuelve la fórmula [#wat-de-formule-teruggeeft] | Valor devuelto | Efecto | |---------------------|--------| | `true` | Una línea con la **Cantidad** configurada | | `false` o `null` | Ninguna línea | | Un número mayor que 0 | Una línea con ese número como cantidad | | Una lista de líneas | Exactamente esas líneas, en ese orden. Una lista vacía significa ninguna línea | Una línea de esa lista es un objeto con estos campos: | Campo | Significado | |------|-----------| | `quantity` | Obligatorio. La cantidad, 0 o más. Una línea con 0 se mantiene, también con **Multiplicar por la cantidad de la fila principal** | | `description` | Opcional. La descripción de esta línea; si no, la **Descripción** del paso, y si no, el nombre del producto | | `unitPrice` | Opcional. Precio unitario con IVA incluido, como la tarifa del producto; si no, la tarifa del producto. `0` crea una línea gratuita | | `accessMethodValue` | Opcional. El valor del método de acceso al que se refiere esta línea (el UID de la etiqueta NFC), para la prolongación al pagar | ### Qué puede leer la fórmula [#wat-de-formule-kan-lezen] Los campos se leen con llaves, como en las automatizaciones. El menú **Variable** junto al campo muestra todo lo disponible, incluidos tus campos propios. | Variable | Qué es | |-----------|------------| | `{customer.…}` | El cliente de la factura, por ejemplo `{customer.createdAt}` o `{customer.customFields.meterhuurVrijgesteld}` | | `{occupation.…}` | La ocupación de la línea principal. Si el producto principal no tiene **Prolongar periodo de ocupación**, es la única ocupación del cliente; vacío (`null`) si el cliente ocupa varias parcelas | | `{terrain.…}` | La parcela de esa ocupación | | `{anchor.…}` | La línea principal: `{anchor.quantity}` (por ejemplo 0,5 con medio año), `{anchor.terrainId}`, `{anchor.occupationId}` y `{anchor.endDate}` | | `{meters}` | La lista de contadores en el ámbito: en la parcela de la línea principal con **Prolongar periodo de ocupación**, si no en todas las parcelas que ocupa el cliente. Cada contador tiene `name`, `provider` (por ejemplo `ICY`), `type` (por ejemplo `ELECTRICITY`, `GAS`), los metadatos de su proveedor (por ejemplo `icyMetadata.switchState` para suministro activado), su `terrain` y `customFields` | | `{accessMethods}` | La lista de métodos de acceso del cliente, del más antiguo al más reciente, de cualquier tipo y estado. Cada método tiene `type` (por ejemplo `NFC`), `status` (por ejemplo `ACTIVE`), `value`, una `label` legible (el nombre conocido de la etiqueta NFC, si no el valor) y `customFields` | Tillor solo carga las listas `{meters}` y `{accessMethods}` si la fórmula las usa. ### Ejemplos [#voorbeelden] Omitir un paso para los clientes exentos: ```ts if ({customer.customFields.exemptFromSurcharges} === true) return false; return true; ``` Una línea por contador de electricidad ICY con suministro activado, y para los clientes desde 2026 también con suministro desactivado: ```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}` })); ``` La primera etiqueta NFC gratis como explicación, cada siguiente a la tarifa del producto (dos pasos con el mismo producto, o un paso que devuelve ambos tipos de línea): ```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}`, })); ``` Una línea con el número de perros de un campo propio del cliente, ninguna línea si no hay perros: ```ts const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0)); return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }]; ``` Con **Insertar ejemplo**, debajo del campo, obtienes un punto de partida con estas formas en comentario. ### Errores [#fouten] Una fórmula que no compila no se puede guardar; el aviso debajo del campo dice qué falla. Si una fórmula se bloquea al guardar una factura, o devuelve algo distinto de `true`, `false`, un número o líneas válidas, el guardado falla con el nombre del paso en el mensaje de error, de modo que una fórmula rota nunca añade u omite una línea en silencio. ## Véase también [#zie-ook] # Resumen (/es-ES/producten) Un producto es una tarifa o un servicio que añades a una línea de factura: una noche en una parcela, una suscripción mensual, una etiqueta NFC o un kWh de electricidad. Cada producto tiene un precio con IVA incluido. También puedes asociarle acciones que Tillor ejecuta automáticamente, como prolongar una ocupación o imprimir un ticket. Los usuarios con el permiso **Editar productos** pueden crear y modificar productos. Encuentras todos los productos en Administración > Productos. - El precio siempre incluye IVA. Eliges entre 0%, 6%, 9%, 12% o 21%. - Un cambio de precio, de cuenta contable o de acciones vale para las líneas que añadas después. Las facturas existentes no cambian. - Puedes programar un precio nuevo desde hoy o desde un día posterior, no para el pasado. - Un producto desactivado ya no se puede elegir en las facturas, pero permanece en las facturas existentes. - Un producto eliminado no se puede recuperar. Mejor desactívalo. - Por cada combinación de tipo de cliente y tipo de contador solo existe un producto con la acción **Consumo del contador**. - Una **Mostrar alerta** puede contener como máximo 4000 caracteres. - Por impresora configuras como máximo 10 copias en la impresión automática. - Con **Prolongar método de acceso** cuentas como máximo 3660 días tras la fecha de fin. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Un producto no hace nada mientras no esté en una factura. Si el producto tiene acciones, Tillor las copia a la línea de factura. Contabilizar y pagar inician esas acciones, y así el resultado llega a la ocupación, a la etiqueta o a la impresora. ```mermaid flowchart TD P[Producto con acciones] --> R[Línea de factura en una factura borrador] R -- Contabilizar --> G[Factura contabilizada] G --> G1[Ocupación: Facturado hasta avanza] G --> G2[Reserva creada con Pedir parcela] G --> G3[Contabilización bloqueada o datos de contacto solicitados] G -- Pagar --> B[Factura pagada] B --> B1[Ocupación: Pagado hasta avanza] B --> B2[Etiqueta NFC recargada] B --> B3[Método de acceso creado o prolongado] B --> B4[Ticket o A4 impreso] ``` Un ejemplo con **Prolongar periodo de ocupación**: facturas el alquiler mensual de un cliente. Al contabilizar, la ocupación figura como facturada hasta el final del mes. En cuanto el cliente paga, **Pagado hasta** avanza. Así ves en la ocupación qué está ya facturado y qué ya pagado. Más información en [Ocupaciones](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs). Una factura de abono lo revierte: contabilizar devuelve **Facturado hasta** al inicio de la línea, y pagar devuelve **Pagado hasta**. Consulta [Transferencia interna](/betalingsverwerking/interne-overboeking) para el caso en que una factura de abono solo se compensa con la factura original. ## Lo que ves en la lista [#wat-je-in-de-lijst-ziet] | Columna | Contenido | |-------|--------| | **Nombre** y **Descripción** | Nombre y explicación tal como los has rellenado en el producto | | **Info** | Tipo de cliente y tipo de contador, solo en productos con la acción **Consumo del contador** | | **Acción** | Las acciones que tiene el producto. Con varias acciones, la columna muestra un resumen | | **Precio (IVA incl.)** | Precio por unidad | | **IVA %** | El tipo de IVA | | **Cuenta contable** | El número de cuenta contable, si lo has rellenado | En la fila encuentras un icono de lápiz para abrir el producto y un icono de papelera para eliminarlo. Ambos están desactivados si no tienes el permiso **Editar productos**. ### Buscar y filtrar [#zoeken-en-filteren] Escribe en la barra de búsqueda para filtrar la lista al instante. Además puedes filtrar por **IVA**, **Tipo de cliente**, **Tipo de contador**, **Tipo de acción**, **Estado** (Activo o Desactivado) y **Cuentas**. Con **Restablecer** borras todos los filtros de una vez. ## Véase también [#zie-ook] ## Conceptos [#begrippen] - **Producto**: un precio y una descripción que pueden aparecer en una línea de factura. - **Acción**: algo que Tillor hace automáticamente cuando se contabiliza o se paga una línea de factura con este producto. - **Paquete**: una serie de líneas de factura adicionales que Tillor coloca bajo una línea principal, por ejemplo recargos sobre la tarifa de estancia. - **Línea principal y línea hija**: la línea principal es la línea con el producto del paquete; las líneas hijas son las que Tillor añade debajo. - **Facturado hasta** y **Pagado hasta**: hasta cuándo está facturada, respectivamente pagada, una ocupación. Consulta [Ocupación](/begrippen#bezetting). - **Cuenta contable**: el número de cuenta de tu contabilidad en el que contabiliza un producto. # Programar un cambio de precio (/es-ES/producten/prijzen-plannen) Si el precio de un producto cambia a partir de un día concreto, lo programas con antelación. Ese día, Tillor modifica por sí mismo el precio del producto. Las facturas existentes conservan sus precios. ## Programar un precio [#een-prijs-plannen] ### Abre el producto [#open-het-product] Ve a Administración > Productos y abre el producto. Al final de la página está la tarjeta **Precios programados**. ### Elige la fecha [#kies-de-datum] En **A partir del** elige el día en que entra en vigor el nuevo precio. Hoy también vale, un día del pasado no. ### Introduce el precio [#vul-de-prijs-in] Escribe el **Nuevo precio (IVA incl.)**. En **Tipo de IVA** deja **Tipo de IVA actual** o elige otro tipo que valga desde ese día. También puedes elegir un [régimen sin IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), como **Inversión del sujeto pasivo (servicios UE)**; el producto queda entonces al 0% bajo ese régimen desde ese día. ### Programa el precio [#plan-de-prijs] Haz clic en **Programar precio**. El precio aparece en la lista con el estado Programado. Si eliges hoy como fecha, el nuevo precio vale de inmediato. Para una fecha posterior, el precio vale desde el comienzo de ese día. Tillor usa para ello la zona horaria de tu organización. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] El producto recibe el nuevo precio y, en su caso, el nuevo tipo de IVA. La línea de la lista pasa al estado Aplicado. Tillor envía un correo a la dirección de soporte de tu organización, o a la dirección de correo general si falta. El aviso se llama **Precio de producto programado aplicado** y muestra el precio antiguo y el nuevo. Consulta también [Notificaciones](/notificaties). Las facturas que ya existen no cambian. Solo las líneas que añadas después reciben el nuevo precio. ## Modificar o eliminar un precio programado [#een-geplande-prijs-wijzigen-of-verwijderen] - Si programas de nuevo un precio para el mismo día mientras hay otro precio programado, el nuevo sustituye al antiguo. - Haz clic en el icono de papelera junto a un precio programado y confirma con **Eliminar precio programado**. El producto conserva su precio actual en esa fecha. - Un precio con el estado Aplicado permanece como historial y no se puede eliminar. ## La calculadora de IVA [#de-btw-calculator] Junto al campo del precio, tanto en **Nuevo precio (IVA incl.)** como en **Precio (IVA incl.)** en **General**, hay una pequeña calculadora. Con ella abres la **Calculadora de IVA**. En la calculadora puedes: - rellenar el importe **Sin IVA** o **Con IVA**. El otro importe y el IVA se calculan al instante. - elegir otro **Tipo de IVA**. El precio con IVA se vuelve a calcular entonces a partir del importe sin IVA. - en **Cambiar precio en %** escribir un porcentaje, por ejemplo 5 para añadir un cinco por ciento o -5 para restar un cinco por ciento, y hacer clic en **Aplicar**. Haz clic en **Usar este precio** para poner el precio y el tipo de IVA en el formulario. Después aún tienes que guardar o programar el precio. ## ¿Problemas? [#problemen] Un precio solo puede valer desde hoy o más adelante. Si quieres modificar un precio con efecto retroactivo, modifica las propias facturas. Para ello necesitas el permiso **Editar productos**. ## Véase también [#zie-ook] # Crear un producto (/es-ES/producten/product-aanmaken) Un producto nuevo está disponible de inmediato en las facturas. Las acciones y las líneas de factura adicionales las configuras después en la página del producto. ### Abre el cuadro de diálogo [#open-het-dialoogvenster] Ve a Administración > Productos y haz clic arriba a la derecha en **Nuevo producto**. ### Rellena los datos básicos [#vul-de-basisgegevens-in] | Campo | Qué rellenas | |------|---------------| | **Nombre** (obligatorio) | El nombre tal como aparece en las facturas | | **Descripción** | Una breve explicación (opcional) | | **Precio (IVA incl.)** | El importe por unidad, con IVA incluido | | **IVA %** | Elige entre 0%, 6%, 9%, 12% o 21%, o un régimen sin IVA como **Inversión del sujeto pasivo (servicios UE)**. Consulta [Inversión del sujeto pasivo y otros regímenes](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) | | **Cuenta contable** | El número de cuenta contable para tu contabilidad (opcional) | | **Vigilar el saldo del cliente en esta cuenta** | Para fianzas: rechaza facturas que dejarían el saldo del cliente por debajo de cero. Consulta [Vigilar el saldo del cliente](#het-saldo-van-de-klant-bewaken) | ### Crea el producto [#maak-het-product-aan] Haz clic en **Crear**. Tillor abre la página del producto, donde puedes añadir acciones y líneas de factura adicionales. El precio siempre incluye IVA. Tillor calcula el importe del IVA con el porcentaje elegido y lo muestra por separado en la factura. ## Número de cuenta contable [#grootboeknummer] Con el número de cuenta contable vinculas un producto a una cuenta de tu contabilidad. El número se usa al exportar a software de contabilidad. Deja el campo vacío si no quieres vincular el producto a una cuenta propia. Un cambio del número de cuenta contable vale para las líneas de factura nuevas. Las facturas contabilizadas no cambian. ## Vigilar el saldo del cliente [#het-saldo-van-de-klant-bewaken] Para fianzas, marca **Vigilar el saldo del cliente en esta cuenta**. Tillor suma entonces, por cliente, todas las líneas de factura contabilizadas en esa cuenta y rechaza cualquier factura que dejara ese saldo por debajo de cero. Así no puedes devolver una fianza dos veces por error. Esta opción requiere un número de cuenta contable. En la factura ves, debajo de la línea, el saldo del cliente en esa cuenta y cuál será después de esta factura. Los borradores no cuentan. Tampoco se puede devolver a borrador una factura de fianza contabilizada, ni moverla a otro cliente, si con ello el saldo quedara por debajo de cero. En la pestaña **Facturación** de un cliente, bajo **Facturas**, está la tabla **Cuentas**: cada cuenta contable en la que hay algo contabilizado para ese cliente o en la que figura un [saldo inicial](#beginsaldi-van-voor-tillor), con el saldo. También una cuenta que está neta en cero sigue visible. Una cuenta vigilada en la que el cliente aún no ha contabilizado nada no aparece. Si al menos un producto vigila una cuenta contable, el filtro **Protección** está por defecto en **Activada** y solo ves las cuentas vigiladas. Borra el filtro para ver también las demás cuentas, como tus cuentas de ingresos. Sin productos vigilados el filtro está desactivado y ves todas las cuentas de inmediato. Con el filtro **Saldo** te quedas solo con las cuentas que no están en cero. Un escudo junto al número muestra qué cuentas están vigiladas. Despliega una cuenta y verás las facturas contabilizadas con una línea en esa cuenta, de la más antigua a la más reciente, con el importe y el **Saldo acumulado**: el saldo tras esa factura. Si hay más de 100 facturas en la cuenta, ves las últimas 100. El saldo acumulado sí cuenta las facturas más antiguas. Con el permiso **Anular el saldo de la cuenta** puedes contabilizar de todos modos. Entonces indicas un motivo, que va a la cronología de la factura. Sin ese permiso, **Contabilizar factura** permanece en gris mientras el saldo quedara por debajo de cero. ## Saldos iniciales de antes de Tillor [#beginsaldi-van-voor-tillor] Una fianza que el cliente pagó antes de que empezaras con Tillor no está en una factura de Tillor. Registra ese importe como **saldo inicial** en la cuenta del cliente. Cuenta en el saldo y en la vigilancia, así que luego devuelves esa fianza sin más, sin motivo. Un saldo inicial no es una factura: no recibe número ni IVA, y no va a tu contabilidad, porque tu contabilidad anterior ya lo tiene. **Un cliente:** abre el cliente, pestaña **Facturación**, tarjeta **Cuentas**, y haz clic en **Saldo inicial**. Rellena la cuenta (p. ej. 428002), el importe, la fecha del saldo antiguo y una referencia, por ejemplo el documento de tu sistema antiguo. Un importe negativo es un importe que el cliente aún debe. Despliega la cuenta y verás el saldo inicial al principio del saldo acumulado, con botones para modificarlo o eliminarlo. Debajo del saldo figura cuánto de él es saldo inicial. **Todos los clientes de una vez:** ve a Administración > Facturas y haz clic en **Importar saldos iniciales**. Pega las filas de una hoja de cálculo o elige un archivo CSV, con una fila de encabezado y las columnas cliente (el número de cliente de Tillor), cuenta, importe, fecha, referencia y, si quieres, nota. Haz clic en **Comprobar**: ves qué filas son nuevas, cuáles actualiza Tillor y qué clientes no se han encontrado, además del total por cuenta. Compara ese total con el balance de tu contabilidad anterior y haz clic en **Importar**. Una fila con una referencia que el cliente ya tiene en esa cuenta actualiza ese saldo inicial en lugar de añadirlo por duplicado, así que puedes repetir una importación sin problema. Un saldo inicial que ya se ha devuelto normalmente ya no se puede eliminar ni reducir: el saldo quedaría por debajo de cero. Si tienes el permiso **Anular el saldo de la cuenta**, Tillor pide entonces un motivo y aplica el cambio de todos modos, por ejemplo para quitar un saldo inicial antiguo y combinado a un cliente que ya recibió su fianza en Tillor. Esto vale también para una importación que deja un saldo por debajo de cero. Cada cambio va a la cronología del cliente, con tu motivo si anulaste la vigilancia. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El producto aparece de inmediato en la lista y puedes elegirlo en facturas borrador. - En la página del producto configuras después las [acciones](/producten/acties-instellen), las [líneas de factura adicionales](/producten/bundel-instellen) y los [precios programados](/producten/prijzen-plannen). ## ¿Problemas? [#problemen] Crear y modificar requiere el permiso **Editar productos**. Pide a un administrador de tu organización que añada ese permiso a tu rol. Solo puedes elegir entre 0%, 6%, 9%, 12% y 21%. No se pueden configurar otros tipos. ## Véase también [#zie-ook] # Editar o eliminar un producto (/es-ES/producten/product-bewerken) En la página del producto modificas todo lo de un producto. Los cambios afectan a las nuevas líneas de factura. ## Editar un producto [#een-product-bewerken] ### Abre el producto [#open-het-product] Ve a Administración > Productos y haz clic en el nombre del producto o en el icono de lápiz de la fila. ### Modifica los datos [#pas-de-gegevens-aan] A la izquierda están las tarjetas **General** y **Líneas de factura adicionales**. A la derecha, **Acciones de línea de factura** y **Eventos**. En **General** están los mismos campos que al crear, además de la opción **Desactivar producto**. ### Guarda [#sla-op] Haz clic en **Guardar** al final de la tarjeta **Líneas de factura adicionales**. Ese botón guarda todos los cambios de la página, también los de **General** y **Acciones de línea de factura**. El botón solo está activo cuando has modificado algo. Si quieres que un precio nuevo valga solo a partir de una fecha posterior, usa la tarjeta **Precios programados**. Consulta [Programar un cambio de precio](/producten/prijzen-plannen). En **Eventos** ves una cronología de los cambios del producto, como precio, cuenta contable y acciones. Cada cambio muestra la hora, el usuario y, cuando es posible, la diferencia entre antes y después. ## Desactivar un producto [#een-product-uitschakelen] Marca **Desactivar producto** y guarda. Un producto desactivado ya no se puede elegir en las facturas, pero permanece en la lista y en las facturas existentes. En la lista y en la página del producto lo ves como Desactivado. Así conservas el historial sin seguir usando el producto. ## Eliminar un producto [#een-product-verwijderen] ### Elige eliminar [#kies-verwijderen] En la lista, haz clic en el icono de papelera junto al producto. En la página del producto abre el menú de los tres puntos de la cabecera y elige **Eliminar producto**. ### Confirma [#bevestig] Haz clic en **Eliminar** en el cuadro de diálogo. Eliminar no se puede deshacer. Las facturas en las que ya figura el producto no cambian. Si el producto es un paso en el paquete de otro producto, Tillor omitirá ese paso en adelante. Si solo quieres dejar de usar el producto, mejor desactívalo. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Un precio nuevo, otra cuenta contable u otra acción valen para las líneas que añadas después. Las facturas existentes quedan como estaban. - Un producto desactivado desaparece de la lista de selección en las facturas, pero sigue visible en la lista de productos. - Cada cambio va a la cronología **Eventos** del producto, con usuario y hora. ## ¿Problemas? [#problemen] El botón solo funciona después de que hayas modificado algo, y solo con el permiso **Editar productos**. Cada paso de producto del paquete debe tener un producto y cada paso de información debe tener un texto. Complétalo y guarda de nuevo. Consulta [Configurar líneas de factura adicionales](/producten/bundel-instellen). Por cada combinación de tipo de cliente y tipo de contador solo puede existir un producto con la acción **Consumo del contador**. Si esa combinación ya está en otro producto, se rechaza el guardado. Modifica ese otro producto o elige otra combinación. ## Véase también [#zie-ook] # Acciones de producto (/es-ES/producten/productacties) Activas las acciones en la página del producto, en la tarjeta **Acciones de línea de factura**. Cómo hacerlo está en [Asociar acciones a un producto](/producten/acties-instellen). Esta página describe cada acción. Cómo se relacionan las acciones al contabilizar y pagar con ocupaciones, etiquetas e impresoras lo ves en [¿Cómo encaja todo?](/producten#hoe-hangt-dit-samen). ## Recargar etiqueta NFC [#nfc-tag-opladen] Cuando se paga una factura con este producto, Tillor recarga automáticamente una etiqueta NFC. Úsalo para productos con los que los clientes reciben saldo o acceso en una etiqueta. No hay campos adicionales en el producto. ## Periodo [#periode] El producto representa un servicio durante un periodo de tiempo, como una tarifa diaria, una suscripción semanal o una tarifa mensual. | Campo | Significado | |------|-----------| | **Por unidad** | Número de unidades por periodo, mínimo 1 | | **Unidad de periodo** | **Día**, **Semana** o **Mes** | | **Prolongar métodos de acceso automáticamente** | Al pagar, Tillor prolonga todos los métodos de acceso del cliente hasta la fecha de fin del periodo | | **Pedir parcela** | En la línea de factura eliges una parcela. Al contabilizar, Tillor crea una reserva para esa estancia | | **Registrar entrada al reservar** | Solo con **Pedir parcela**. En cuanto la factura está contabilizada, Tillor pone la reserva en Entrada registrada | | **Registrar la entrada al pagar** | Solo con **Pedir parcela**. En cuanto la factura está pagada, Tillor pone la reserva en Entrada registrada | | **Adultos incluidos** | Solo con **Pedir parcela**. Número de adultos de la reserva, por defecto 2. Puedes rellenar de 0 a 99 | ### Reservas con Pedir parcela [#reserveringen-bij-terrein-vragen] - La reserva recibe la misma llegada y salida que la línea de factura y la parcela elegida como preferencia. El grupo lo modificas después en la propia reserva. - Si devuelves la factura a borrador y modificas las fechas o la parcela, al volver a contabilizar Tillor actualiza la misma reserva. - Si quitas la parcela o desactivas **Pedir parcela**, la reserva se cancela. Una reserva que ya ha hecho la salida permanece. - Una nota de abono cancela la reserva de la factura original. - Sin registrar la entrada, la reserva permanece en Reservada. Así funciona un anticipo de reserva: una parcela y fechas en el futuro, sin llegada. - Si ambas opciones de entrada están activadas, cuenta la de contabilizar. - Si la factura ya está pagada en el momento en que vuelves a contabilizar, Tillor vuelve a registrar la entrada. En la cronología de la factura y de la reserva ves la creación, la modificación, la cancelación y el registro de entrada, con una referencia al otro. ## Prolongar periodo de ocupación [#bezetting-verlengen] Con esta acción, una factura prolonga la ocupación de un cliente en una parcela, por ejemplo para la tarifa de estancia. - Al **contabilizar**, Tillor ajusta **Facturado hasta** de la ocupación. - Al **pagar**, Tillor ajusta **Pagado hasta**. En la línea de factura eliges una parcela. Al contabilizar y pagar, Tillor vincula la ocupación activa del cliente en esa parcela. Tillor guarda también una copia de esa ocupación en la línea, de modo que después ves qué ocupación se pretendía, aunque se haya eliminado más tarde. Con **Redondear al límite del periodo siguiente** en la línea de factura alineas a los clientes con pagos aplazados en el mismo ciclo, según la **Frecuencia de alquiler** de la ocupación. Si eliges una parcela en la que el cliente aún no tiene ocupación, haces un presupuesto. Una línea así solo se puede contabilizar cuando el cliente tiene la parcela en ocupación. | Campo | Significado | |------|-----------| | **Fecha de vencimiento desde el inicio de la ocupación** | Al contabilizar, Tillor pone la fecha de vencimiento en la fecha de inicio del periodo de ocupación en la línea de tarifa de estancia, en lugar del plazo de pago estándar o el plazo del cuadro de contabilización. Al volver a contabilizar se conserva la fecha de vencimiento original | Si el producto tiene líneas de factura adicionales, Tillor añade líneas hijas bajo la línea principal. Consulta [Configurar líneas de factura adicionales](/producten/bundel-instellen). ## Prolongar método de acceso [#toegangsmethode-verlengen] Con esta acción, el pago de una factura prolonga la validez de los métodos de acceso del cliente. Funciona de dos maneras: - **Junto con Periodo** en la misma línea, por ejemplo alquiler mensual. Tillor prolonga los métodos elegidos hasta la fecha de fin del periodo. - **Mediante un paquete** con una línea principal de tarifa de estancia y pasos NFC. La fecha de fin de la línea principal de tarifa de estancia es entonces la base. Los ajustes de abajo vienen del producto principal, no del producto de recargo del paso NFC. Consulta [Prolongar NFC mediante el paquete](/producten/bundel-instellen#nfc-verlengen-via-de-bundel). | Campo | Significado | |------|-----------| | **Días después de la fecha de fin** | Días naturales sobre la fecha de fin. 0 significa la propia fecha de fin, máximo 3660. En los paquetes lo configuras por paso NFC | | **Día de la semana** | Opcional. La validez termina en la ocurrencia más cercana de ese día de la semana en torno a la fecha objetivo. Por defecto **Cada día** | | **Hora** | Opcional. Hora del reloj en la zona horaria de la organización. Vacío significa 23:59 | | **Tipos de método de acceso** | Elige al menos un tipo entre NFC, código QR, reconocimiento de matrículas y código PIN. Solo ves los tipos activados para tu organización | | **Estados** | Solo se prolongan los métodos con uno de estos estados: Activo o Bloqueado parcialmente. Por defecto solo **Activo** | | **No acortar al prolongar** | Se omiten los métodos cuyo **Válido hasta** ya está en la nueva fecha o después. Al revertir con una nota de abono, Tillor pone siempre la fecha calculada | Debajo del campo hay una línea **Resultado** que explica en qué momento termina la validez, por ejemplo "martes más cercano en torno a la fecha de fin + 10 días, a las 13:00". Esto no es lo mismo que **Prolongar métodos de acceso automáticamente** en **Periodo**. Ese interruptor prolonga al pagar un producto con solo **Periodo**, sin la acción aparte **Prolongar método de acceso**. ## Crear método de acceso [#toegangsmethode-aanmaken] Al pagar la factura, Tillor crea un nuevo método de acceso para el cliente. El empleado de caja elige el tipo en la línea de factura. Si la línea tiene también la acción **Periodo**, el periodo pasa a ser la validez del método de acceso. | Campo | Significado | |------|-----------| | **Tipos de método de acceso** | Tipos entre los que elige el empleado de caja: código QR, reconocimiento de matrículas o código PIN. Con un solo tipo, Tillor lo elige automáticamente | | **El método de acceso es opcional** | Esta línea nunca bloquea la contabilización. Sin un tipo elegido, Tillor no crea nada | | **Método de acceso predeterminado** | Solo con varios tipos. Este tipo aparece seleccionado por defecto en las líneas de factura nuevas, modificable por línea. **Sin predeterminado (elegir por línea)** deja la elección abierta | | **Imprimir código QR automáticamente** | Solo con código QR. Tillor imprime el ticket de acceso con QR en la impresora de tickets en cuanto se crea | | **Convertir códigos automáticamente en matrícula** | Los códigos QR y PIN nuevos se sustituyen por la matrícula detectada cuando se usan en una barrera con cámara. Modificable por línea | Una línea solo se puede contabilizar cuando se ha elegido un tipo, salvo que la acción sea opcional. Con reconocimiento de matrículas también hay que rellenar la matrícula. ## Solicitar datos de contacto [#contactgegevens-vragen] En la línea de factura aparecen campos para el correo electrónico y el teléfono. Tillor los pide al contabilizar. | Campo | Significado | |------|-----------| | **Pedir dirección de correo electrónico** | Muestra un campo de correo en la línea de factura | | **Correo electrónico obligatorio** | Solo si pides un correo electrónico. La contabilización queda bloqueada hasta rellenar el campo | | **Pedir número de teléfono** | Muestra un campo de teléfono en la línea de factura | | **Número de teléfono obligatorio** | Solo si pides un número de teléfono. La contabilización queda bloqueada hasta rellenar el campo | ## Impedir reserva [#boeken-blokkeren] Úsalo para productos que solo deben estar en facturas borrador. Si una línea así está en una factura borrador, no puedes hacer definitiva la factura. No hay campo adicional. Tillor bloquea la contabilización mientras la línea esté ahí. ## Mostrar alerta [#melding-tonen] Muestra un aviso bajo la línea de factura, por ejemplo "Atención: usar solo para turistas de día". No ocurre nada al contabilizar ni al pagar. | Campo | Significado | |------|-----------| | **Estilo de alerta** | **Información**, **Advertencia**, **Error**, **Correcto** o **Neutro** | | **Texto de la alerta** | El texto, máximo 4000 caracteres. Se admite Markdown (negrita, listas, enlaces) | Debajo del texto ves enseguida una vista previa de la alerta. El texto se copia a la línea de factura. Los cambios posteriores en el producto no modifican las facturas existentes. ## Consumo del contador [#meterverbruik] Con esta acción, el producto pasa a ser la tarifa del consumo de contador. Tillor lo usa con el consumo pendiente y al facturar automáticamente las lecturas de contador. Eliges dos campos. | Campo | Opciones | |------|--------| | **Tipo de cliente** | **Estándar**, **Caravana de alquiler para trabajador**, **Caravana de remolque para trabajador** | | **Tipo de contador** | **Electricidad**, **Agua**, **Gas** | Por cada combinación de tipo de cliente y tipo de contador solo puede existir un producto. En la lista, ambos valores aparecen en la columna **Info**. Si un cliente no tiene un producto propio para su tipo de cliente, Tillor usa el producto de **Estándar** con el mismo tipo de contador. ## Impresión térmica e impresión A4 [#thermisch-printen-en-a4-printen] Marca **Impresión térmica** e **Impresión A4** por separado. En cuanto al menos una de las dos está activada, aparece el bloque **Impresión automática**. Ahí configuras por impresora qué se imprime al pagar la factura. | Campo | Significado | |------|-----------| | **Copias de impresión térmica** | Número de ejemplares en la impresora térmica (impresora de tickets). 0 apaga esa impresora | | **Copias de impresión A4** | Número de ejemplares en la impresora A4. 0 apaga A4 | | **Momento de impresión** | **Usar configuración (por tipo de pago)** (por defecto), **Imprimir de inmediato** o **Siguiente hora de corte** | Puedes configurar como máximo 10 copias por impresora. Con **Usar configuración (por tipo de pago)** vale el ajuste de tu organización por tipo de pago. ## Véase también [#zie-ook] # Reservas (/es-ES/reserveringen) Con las reservas llevas el control de las estancias en tu parque: quién llega cuándo, en qué parcela y con cuántos huéspedes. Desde una reserva también gestionas la entrada y la salida. Ves todas las reservas en una cronología en **Reservas** y, por cliente, en la pestaña **Reservas**. Empieza por [Crear una reserva](#een-reservering-aanmaken). - Cada reserva pertenece a un cliente y recibe automáticamente un **Número de reserva** único. Ese número no se puede modificar. - La fecha de salida debe ser posterior a la fecha de entrada. Tillor rechaza el mismo día o una fecha anterior. - Una matrícula consta de letras y cifras, máximo 10 caracteres, sin espacios ni guiones. - Registrar la entrada y cancelar solo se pueden hacer desde el estado **Reservada**. Ya no se puede cancelar después de registrar la entrada. - Una reserva no es lo mismo que una ocupación: una reserva es una reserva para una estancia, una ocupación vincula a un cliente con una parcela durante un periodo, consulta [Ocupaciones](/bezettingen). - Las notas de una reserva son internas y nunca se comparten con el cliente. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] ```mermaid flowchart LR K[Cliente] --> R[Reserva] R -->|Registrar entrada| I[Huésped en la parcela] I -->|Registrar salida| U[Estancia finalizada] R -->|Cancelar reserva| A[Cancelada] R --> F[Facturas del cliente] ``` Las facturas del cliente las encuentras en el perfil del cliente, en **Facturación**. ## La cronología [#de-tijdlijn] Ve a **Reservas** en el menú principal. La cronología muestra las reservas por parcela sobre un calendario. Con la vista eliges día, semana, mes, trimestre o año, y saltas a una fecha con **Ir a la fecha**. - Haz clic o arrastra sobre un tramo libre para añadir una reserva. Arriba a la derecha también está **Nueva reserva**. - Si arrastras una reserva a otras fechas, Tillor pregunta **¿Actualizar fechas de la reserva?** Solo tras tu confirmación cambia la reserva. - El menú contextual de una reserva tiene **Ver reserva**, **Copiar enlace** y **Cancelar reserva**. ## Crear una reserva [#een-reservering-aanmaken] Antes de empezar: - Necesitas un cliente. Si todavía no existe, lo creas al empezar, consulta [Gestión de clientes](/klantenbeheer). - ¿Sabes qué parcela quiere el huésped? Entonces la eliges. Si no, deja el campo vacío. ### Inicia la reserva [#start-de-reservering] Haz clic arriba a la derecha en **Nueva reserva**. Elige un cliente existente o crea uno nuevo. Abre el cliente en **Clientes**, ve a la pestaña **Reservas** y haz clic en **Nueva reserva**. ### Rellena el formulario [#vul-het-formulier-in] Consulta [El formulario de reserva](#het-reserveringsformulier) más abajo para ver todos los campos. ### Crea la reserva [#maak-de-reservering-aan] Haz clic en **Crear reserva**. ### ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La reserva recibe el estado Reservada y un número de reserva. - Si **Correo de confirmación automático** está activado, el cliente recibe una confirmación. - Encuentras la reserva en la cronología y en la pestaña **Reservas** del cliente. - Si quieres que una automatización reaccione a una reserva nueva o modificada, usa un disparador, consulta [Disparadores](/automatiseringen/triggers). ## El formulario de reserva [#het-reserveringsformulier] ### Fechas y duración de la estancia [#datums-en-verblijfsduur] - **Entrada**: elige la fecha de llegada. - **Salida**: elige la fecha de salida. Tras la fecha de entrada, el selector de salida se abre solo. La fecha de salida debe ser posterior a la de llegada. - **Número de noches**: Tillor lo calcula por sí mismo. ### Cantidades y animales [#aantallen-en-dieren] Indica el número de **Adultos** (mínimo 1), **Niños**, **Bebés** y **Animales** con los botones de más y menos. ### Parcela [#terrein] - **Parcela**: elige una parcela si el huésped tiene una preferencia. La lista solo muestra parcelas reservables sin ocupación activa que estén libres en el periodo elegido. Tillor excluye las reservas activas que se solapan en la misma parcela. Si modificas las fechas, la lista se actualiza. ¿Sin preferencia? Deja el campo vacío. - **Incluir parcelas no reservables**: muestra también parcelas que no se pueden reservar en línea, por ejemplo plazas fijas anuales. Si la reserva ya está en una parcela así, esta casilla se marca sola. - **Incluir parcelas ocupadas**: muestra también parcelas que ya tienen una ocupación. ### Matrículas [#nummerplaten] Escribe una matrícula, pulsa **Intro** y repite para cada matrícula. Una cruz en una matrícula la elimina. Las matrículas solo pueden contener letras y cifras, máximo 10 caracteres. Las matrículas de una reserva se pueden encontrar con la búsqueda. El acceso en la barrera lo gestionas aparte, en el cliente, en la pestaña **Control de acceso**, consulta [Control de acceso](/toegangscontrole). ### Notas [#notities] Usa el campo de notas para observaciones internas, como deseos especiales o acuerdos. ### Preferencias de comunicación [#communicatievoorkeuren] - **Correo de confirmación automático**: envía una confirmación tras crear la reserva. - **Pago en línea**: permite que el cliente pague la reserva en línea. ## Ver y editar una reserva [#een-reservering-bekijken-en-bewerken] Haz clic en una reserva en la cronología o en el perfil del cliente para abrir la página de detalle. - **Datos de la reserva** (izquierda): el formulario completo. Modifica lo que quieras y haz clic en **Guardar**. Con **Cancelar** restauras los valores originales. Junto al título está **Copiar enlace de reserva**, útil para pegar un enlace en un documento. - **Acciones de reserva** (derecha): los botones de abajo. - **Comentarios** (derecha): debate interno sobre esta reserva. - **Actividad** (derecha): una cronología con creación, entrada, salida, cancelación, reversión y datos modificados, con hora y usuario. En un cambio ves qué campos se han modificado (antes / después). ## Registrar entrada, salida y cancelar [#inchecken-uitchecken-en-annuleren] En la página de detalle están las acciones en **Acciones de reserva**. Cada acción pide una confirmación. | Acción | Se puede cuando | Resultado | |---|---|---| | **Registrar entrada** | Estado Reservada | Estado Entrada registrada | | **Registrar salida** | Estado Entrada registrada | Estado Salida registrada | | **Cancelar reserva** | Solo antes de registrar la entrada | Estado Cancelada | | **Deshacer cancelación** | Solo antes de registrar la entrada | Vuelve a Reservada | | **Deshacer entrada** | Ante una entrada registrada por error. Si el huésped ya había hecho la salida, deshaz primero la salida | Vuelve a Reservada | | **Deshacer salida** | Ante una salida registrada por error | Vuelve a Entrada registrada | Además están **Enviar formulario de confirmación al cliente (SMS)** y **Crear tarea**. Con esta última creas una tarea a partir de esta reserva. En una reserva cancelada no puedes registrar entrada ni salida. Deshaz primero la cancelación. ## ¿Problemas? [#problemen] El aviso es **No se pudo crear la reserva.** Comprueba que hayas elegido un cliente y que la fecha de salida sea posterior a la de entrada. El mismo día o una fecha anterior se rechaza. Tus cambios no se han guardado. Comprueba las fechas (la salida debe ser posterior a la entrada), las matrículas y el número de adultos, y haz clic de nuevo en **Guardar**. La reserva debe tener el estado Reservada. Si ya tiene la entrada o la salida registrada, o está cancelada, no se puede registrar la entrada. Recarga la página y mira cuál es ahora el estado. Si está cancelada, haz primero **Deshacer cancelación**. Registrar la salida solo se puede en una reserva con la entrada registrada. Si el huésped aún no ha registrado la entrada o ya ha hecho la salida, no funciona. Cancelar solo se puede antes de registrar la entrada. Si el huésped ya tiene la entrada registrada, deshaz primero **Deshacer entrada** y cancela después. La lista solo muestra parcelas reservables sin ocupación que estén libres en el periodo elegido. Comprueba las fechas. Marca **Incluir parcelas no reservables** o **Incluir parcelas ocupadas** si te refieres a una parcela así. Una matrícula solo puede contener letras y cifras y tener como máximo 10 caracteres. Quita espacios y guiones. ## Conceptos [#begrippen] - **Reserva**: una reserva para una estancia. Consulta [reserva](/begrippen#reservering). - **Reservada, Entrada registrada, Salida registrada, Cancelada**: los cuatro estados de una reserva. - **Número de reserva**: el número automático con el que encuentras una reserva. - **Ocupación**: un cliente en una parcela durante un periodo, independiente de una reserva. Consulta [ocupación](/begrippen#bezetting). - **Cronología**: el resumen de reservas por parcela sobre un calendario. ## Véase también [#zie-ook] # Compartir tareas (/es-ES/taken/delen) ¿Quieres mostrar tareas a alguien que no trabaja en Tillor, o verlas en tu propio calendario? Entonces crea un enlace para compartir. Hay dos tipos. | Tipo | Qué es | |---|---| | **Página para compartir** | Un tablero de solo lectura con lo que hay que hacer. Sigue las tareas, así que los cambios hechos en Tillor se ven reflejados | | **Calendario (ICS)** | Una suscripción de calendario para, por ejemplo, Google Calendar, Outlook o el Calendario de Apple | ## Crear un enlace [#een-link-maken] 1. Haz clic en el icono de compartir, arriba a la derecha de la página de tareas (tooltip **Compartir esta vista**). Encontrarás el mismo icono en la tarjeta del panel **Tareas para usted** 2. En **Tipo de enlace**, elige una **Página para compartir** o **Calendario (ICS)** 3. En **Contenido**, elige qué compartes: **Mis tareas asignadas** o una de tus vistas. Si abres la ventana desde una vista, ya aparece seleccionada 4. Si quieres, limita el contenido con **Filtros**: **Estado**, **Prioridad**, **Asignado a**, **Etiqueta**, **Vista**, **Vinculado a** y **Bloqueada**. Los filtros se guardan en el enlace y solo reducen lo que ya muestra el origen 5. Haz clic en **Crear enlace** En **Enlaces anteriores** aparecen todos los enlaces que creaste para este origen. Por cada enlace puedes: - **Copiar enlace** - En un enlace de calendario, **Añadir al calendario**, que abre la suscripción directamente en tu aplicación de calendario - **Invalidar** (tras confirmar). El enlace deja de funcionar. Los demás enlaces siguen siendo válidos. Un enlace invalidado permanece en la lista con la marca **Invalidado** Un enlace para compartir es privado, pero cualquiera que lo tenga puede ver las tareas, incluso sin iniciar sesión. Compártelo solo con personas que pueden verlas e invalídalo en cuanto ya no lo necesites. ## La página para compartir [#de-deelbare-pagina] La página muestra las tareas por grupo y, de cada tarea, el nombre, el estado, la prioridad, la fecha de vencimiento, las etiquetas y los nombres de los compañeros asignados. No hay botones para modificar nada. En un grupo grande verás **[número] de [total]** tareas. De forma predeterminada solo aparecen las tareas abiertas, salvo que establezcas tú mismo un filtro de estado o compartas una vista. Si no hay nada que hacer, verás **Ahora mismo no hay nada que hacer.** ## El calendario [#de-agenda] En el calendario aparecen las tareas con una **fecha de vencimiento** o un **recordatorio**. Las tareas sin fecha no aparecen. - Los recordatorios periódicos aparecen como una serie y recibes un aviso en cada recordatorio - Sin recordatorio, recibes un aviso una hora antes de la fecha de vencimiento - Las tareas completadas siguen visibles dos semanas más, como completadas, y después desaparecen - En una vista, el calendario sigue la vista, sin importar a quién estén asignadas las tareas. Si quien creó el enlace ya no puede ver la vista, el enlace deja de funcionar En Google Calendar, para un calendario suscrito también debes activar las notificaciones predeterminadas; de lo contrario, los avisos no llegan. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El enlace funciona de inmediato y sigue funcionando hasta que lo invalides. Cualquiera que tenga el enlace puede ver las tareas, incluso sin iniciar sesión. - Una página para compartir sigue las tareas: los cambios hechos en Tillor se ven reflejados. - Una suscripción de calendario se actualiza sola en tu aplicación de calendario y avisa una hora antes de la fecha de vencimiento o en cada recordatorio. - Si invalidas un enlace, solo deja de funcionar ese enlace. Los demás siguen siendo válidos y el enlace invalidado permanece en la lista con la marca **Invalidado**. ## ¿Problemas? [#problemen] El enlace no se ha creado. Comprueba que hayas elegido un origen en **Contenido** e inténtalo de nuevo. El aviso **No se pudieron cargar los enlaces.** significa que la lista de enlaces anteriores no se abrió. Abre la ventana de nuevo. No hay tareas que cumplan el origen y los filtros. Una página para compartir muestra de forma predeterminada solo las tareas abiertas. Solo aparecen en el calendario las tareas con fecha de vencimiento o recordatorio. Si quien creó el enlace ya no puede ver la vista, el enlace tampoco funciona. Activa también las notificaciones predeterminadas del calendario suscrito en Google Calendar. En el enlace, elige **Invalidar** y confirma en **¿Invalidar este enlace?**. Si falla, verás **No se pudo invalidar el enlace**: inténtalo de nuevo. # Filtrar (/es-ES/taken/filteren) Encima de las tareas hay una barra de búsqueda con los botones de filtro al lado. Los filtros pertenecen a la vista: si los guardas, determinan qué tareas muestra la vista. En una vista filtrada son las tareas que cumplen los filtros. En una lista son las tareas añadidas manualmente que además cumplen los filtros. ## Filtros siempre visibles [#altijd-zichtbare-filters] | Filtro | Qué eliges | |---|---| | **Estado** | Uno o varios estados | | **Prioridad** | Una o varias prioridades | | **Asignado a** | Uno o varios compañeros, o **Yo** para ti mismo | | **Etiqueta** | Una o varias etiquetas | | **Vista** | Tareas que están en otra vista (manual) | | **Bloqueada** | **Bloqueada** o **No bloqueada** | | **Vinculado a** | El tipo de registro al que está vinculada la tarea, como un cliente, parcela, factura o reserva | | **Texto** | Palabras que el nombre o la descripción contiene o, justo al contrario, no contiene, véase más abajo | | **Vencimiento** | Un periodo, véase más abajo | En los filtros con una lista, arriba eliges **Incluir** (tareas con los valores elegidos) o **Excluir** (tareas sin esos valores). En **Vinculado a** eliges el tipo de elemento: **Cliente**, **Factura**, **Reserva**, **Contador**, **Parcela**, **Comentario**, **Conversación**, **Llamada telefónica**, **Transacción bancaria** o **Producto**. ## Filtrar por texto [#filteren-op-tekst] Con **Texto** muestras solo las tareas cuyo nombre o descripción contiene, o justo no contiene, un fragmento de texto. Las mayúsculas y minúsculas no importan. 1. Haz clic en **Texto** 2. Elige **Contiene** o **No contiene** 3. Escribe el texto en **Texto en el nombre o la descripción**, por ejemplo `Verzekering vervallen:` 4. Haz clic en **Añadir** o pulsa Intro Repite esto para cada texto que quieras añadir. Cada texto es un filtro aparte, así que puedes combinar **Contiene** y **No contiene**: por ejemplo `caravan`, pero no `Verzekering vervallen:`. Con la cruz junto a un texto lo quitas. El botón muestra el propio texto, o el número de textos si hay más de uno. Que una tarea deba cumplir **todos** los textos o **uno** de ellos depende de la opción elegida en [Combinar varios filtros](#meerdere-filters-combineren). Si quieres excluir varios textos, déjala en **Cumplir todos los filtros**. ## Filtrar por fecha [#filteren-op-datum] **Vencimiento** funciona con opciones fijas que se mueven con el día, o con un periodo propio. - **Vencidas**, **Hoy**, **Mañana**, **Esta semana**, **Próxima semana**, **Este mes** - **Sin fecha** (tareas sin fecha de vencimiento) y **Con fecha** - **Periodo personalizado**: elige una fecha de inicio y una de fin en el calendario y haz clic en **Aplicar periodo**. El último día cuenta completo Si vuelves a hacer clic en una opción elegida, el filtro desaparece. ## Combinar varios filtros [#meerdere-filters-combineren] En cuanto tienes dos o más filtros, aparece un menú de selección: - **Cumplir todos los filtros** - una tarea debe encajar con cada filtro - **Cumplir algún filtro** - basta con que una tarea encaje con uno de los filtros Con **Borrar filtros** eliminas todos los filtros de una vez. ## Ejemplos [#voorbeelden] - *Todo lo que debe estar listo hoy y sigue abierto*: filtra **Vencimiento** por **Hoy** y **Estado** por todo excepto **Completada** - *Tareas en las que tengo que esperar*: filtra **Estado** por **Esperando respuesta** y **Asignado a** por **Yo** - *Todo menos los avisos de seguros vencidos*: filtra **Texto** por **No contiene** `Verzekering vervallen:` - *Todo lo relacionado con un cliente*: abre el cliente. En la pestaña **Tareas** de la página del cliente están todas las tareas vinculadas a ese cliente ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Los filtros en tu pantalla reducen lo que ves. Solo cuando los guardas con **Guardar vista** pasan a formar parte de la vista y tus compañeros ven la misma selección. - También puedes guardar filtros en la vista integrada **Todas**. Entonces se aplican a todos en tu organización. Para ello necesitas el permiso **Gestionar etiquetas y vistas compartidas**. - En una vista filtrada, las tareas aparecen y desaparecen solas según cumplan o no los filtros. - La barra de búsqueda nunca se guarda. ## ¿Problemas? [#problemen] Comprueba si hay un filtro activo, como un filtro de estado que excluye **Completada**, o **Cumplir todos los filtros** cuando querías decir uno de los filtros. Con **Borrar filtros** empiezas de nuevo. No lo habías guardado. Elige **Guardar vista** en la barra **Cambios sin guardar**. **Guardar vista** aparece en gris si no tienes el permiso **Gestionar etiquetas y vistas compartidas**, porque **Todas** se aplica a toda la organización. Pídeselo a un administrador o crea una vista propia con los mismos filtros. Solo ves las tareas que puedes ver. Una tarea en una vista personal de un compañero es invisible para ti. Véase [Tareas privadas](/taken/prive-taken). Después de elegir una fecha de inicio y una de fin, haz clic en **Aplicar periodo**. # Tabla, tablero y calendario (/es-ES/taken/indelingen) Puedes ver las mismas tareas de tres maneras. Arriba a la derecha abres **Visualización** para elegir: - **Diseño** - **Tabla**, **Tablero** o **Calendario**. Esta opción solo aparece en las vistas guardadas, no en **Todas** - **Agrupar por** - cómo se reparten las tareas en grupos o columnas - **Ordenar por** y **Orden** - **Ascendente** o **Descendente** - **Tipo** - si la vista es una **Lista** o una **Vista filtrada**, véase [Vistas](/taken/weergaven#twee-soorten-weergaven). Esto también solo aparece en las vistas guardadas - **Completadas** - cuánto tiempo siguen visibles las tareas completadas Los cambios siguen siendo una propuesta hasta que los guardas, véase [Guardar o descartar cambios](/taken/weergaven#wijzigingen-opslaan-of-verwerpen). ## Ocultar tareas completadas [#voltooide-taken-verbergen] En **Completadas**, dentro del menú **Visualización**, decides cuánto tiempo permanece una tarea completada en la vista: | Opción | Qué ves | |---|---| | **Mostrar todas** | Todas las tareas completadas (predeterminado) | | **Ocultar** | Ninguna tarea completada | | **Último día** | Tareas completadas en el último día | | **Última semana** | Tareas completadas en la última semana | | **Último mes** | Tareas completadas en el último mes | El cómputo empieza desde el momento en que la tarea se puso en **Completada**. Un comentario o un nuevo nombre no lo cambia. Si vuelves a abrir una tarea, vuelve a estar en la vista de inmediato. Si la vista ya tiene un filtro de estado que excluye las tareas completadas, ese filtro sigue vigente. ## Agrupar [#groeperen] | Agrupación | Resultado | |---|---| | **Sin agrupación** | Todas las tareas en una lista | | **Estado** | Un grupo por estado | | **Prioridad** | Un grupo por prioridad | | **Asignado a** | Un grupo por compañero | | **Etiqueta** | Un grupo por etiqueta | | **Cliente** | Un grupo por cliente | | **Vencimiento** | Grupos como **Vencido**, **Hoy**, **Esta semana**, **Más tarde** y **Sin vencimiento** | | **Columnas propias** | Columnas que creas tú mismo, solo en vistas guardadas | Una tarea con varios compañeros o etiquetas asignados aparece en el grupo de cada uno de ellos. ## Ordenar [#sorteren] Puedes ordenar por **Manual**, **Vencimiento**, **Prioridad**, **Estado**, **Nombre**, **Creado** o **Actualizado**. Con **Manual** decides tú el orden arrastrando tarjetas. Con las demás opciones el campo determina el orden y arrastrar dentro de una columna no tiene efecto, salvo en las columnas propias. ## Tabla [#tabel] La tabla muestra una fila por tarea. Con una agrupación obtienes un bloque por grupo. En **Columnas**, en el menú de visualización, activas o desactivas columnas: **Tarea**, **Estado**, **Prioridad**, **Vencimiento**, **Vistas**, **Asignado a**, **Vinculado** y **Etiqueta**. La columna **Vinculado** muestra todos los elementos a los que está vinculada la tarea. La columna **Tarea** siempre permanece visible. Si hay muchas tareas, Tillor carga primero una parte. Desplázate hacia abajo o haz clic en **Cargar más** para ver el resto. ## Tablero [#bord] El tablero muestra cada grupo como una columna, al estilo kanban. Haz clic en **Nueva tarea** en la parte superior de una columna para crear allí una tarea. Esta recibe automáticamente el valor de la columna, como el estado o el compañero asignado. Arrastra una tarjeta de tarea a otra columna y la tarea adopta el valor de esa columna: - en un tablero por **Estado** cambia el estado - en **Prioridad** cambia la prioridad - en **Asignado a** cambia el compañero asignado - en **Etiqueta** y **Cliente** cambia la etiqueta o el cliente - en **Columnas propias** la tarea pasa a esa columna En un tablero por **Vencimiento** no puedes arrastrar tarjetas a otra columna, porque habría que inventar una fecha de vencimiento. Modifica la fecha de vencimiento en la propia tarea. Si hay más tareas en una columna de las que se muestran, abajo aparece **[número] más**. Una tarjeta que está bloqueada por otras tareas o las bloquea lo muestra también, por ejemplo **Bloqueada por 1 tarea**. ### Columnas propias [#eigen-kolommen] Con **Columnas propias** creas tú mismo las columnas, como *Por planificar*, *Pedido* y *Listo*: 1. En **Visualización**, en **Agrupar por**, elige la opción **Columnas propias** (o elígela ya al crearla) 2. Haz clic a la derecha del tablero en **Nueva columna** y ponle un nombre 3. En el menú de una columna eliges **Editar** para cambiar el nombre o **Eliminar** 4. Arrastra las columnas por su título para cambiar el orden Las nuevas columnas propias empiezan vacías. Cada tarea de la vista está entonces primero en **Sin columna** hasta que la asignas a una. En una lista puedes ocultar esas tareas con la casilla **Mostrar tareas sin columna**. En una vista filtrada siguen visibles; de lo contrario nunca podrías asignarlas. Si pasas de **Columnas propias** a otra agrupación y lo guardas, se eliminan las columnas propias de esa vista, junto con el lugar que ocupa en ellas cada tarea. Esto no se puede deshacer. Tillor muestra antes una advertencia. ### Asignar tareas a una lista [#taken-toewijzen-aan-een-lijst] En el tablero de una lista aparece, mientras haya tareas que todavía no están en ella, el botón **Asignar tareas**. Con él se abre una columna adicional **No está en esta vista** con las tareas que cumplen los filtros de la vista pero todavía no están en ella. Busca con **Filtrar tareas...** y arrastra una tarea a una columna para añadirla a la vista. Haz clic de nuevo en el botón para cerrar la columna. ## Calendario [#kalender] El calendario muestra una cuadrícula mensual con las tareas en su **fecha de vencimiento**. La semana empieza el lunes y los días siguen la zona horaria de tu organización. Las tareas sin fecha de vencimiento no aparecen en el calendario. - Con las flechas vas al mes anterior o al siguiente; con **Hoy** vuelves al mes actual - De cada día ves como máximo tres tareas. Haz clic en **+[número] más** para ver el resto del día - Haz clic en una tarea para abrir los detalles - Arrastra una tarea a otro día para mover la fecha de vencimiento. La hora se mantiene, solo cambia el día - Las tareas completadas aparecen tachadas, están debajo de las tareas abiertas de ese día y no se pueden arrastrar La agrupación no influye en el calendario: todas las tareas están en la misma cuadrícula. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tus cambios en **Visualización** son primero una propuesta en tu pantalla. Solo tras **Guardar vista** rigen para todos los que ven la vista. - Si arrastras una tarjeta a otra columna, la propia tarea se modifica. En un tablero por **Estado** cambia el estado, y tus compañeros lo ven al instante. - Arrastrar una tarjeta en un calendario mueve la fecha de vencimiento a ese día. La hora se mantiene. ## ¿Problemas? [#problemen] En un tablero por **Vencimiento** no se puede, porque Tillor tendría que inventar una fecha de vencimiento. Modifica la fecha de vencimiento en la tarea. Las tareas de un calendario se arrastran a otro día, salvo las tareas completadas. Ves **No se pudo mover la tarea**. La tarjeta vuelve a su sitio anterior. Inténtalo de nuevo. Solo aparecen en las vistas guardadas, no en **Todas**. El calendario muestra las tareas en su fecha de vencimiento. Una tarea sin fecha de vencimiento no aparece. Con columnas propias nuevas, todas las tareas empiezan en **Sin columna** hasta que las asignas. Arrástralas a la columna correcta. Pasaste a otra agrupación y lo guardaste. Al hacerlo, Tillor elimina las columnas propias y no se puede deshacer. Tillor avisa antes. # Resumen (/es-ES/taken) Con el sistema de tareas registras lo que hay que hacer en tu parque y quién lo hace. Una tarea puede tener una fecha de vencimiento, un recordatorio, uno o varios compañeros o grupos asignados, etiquetas, archivos adjuntos, subtareas, tiempo dedicado y clientes, parcelas, facturas, reservas, contadores, conversaciones o transacciones bancarias vinculados. Ves las tareas mediante **vistas**. Una vista es una forma guardada de mirar tus tareas, por ejemplo *Tareas abiertas*, *Mis tareas* o *Mantenimiento*. Cada vista aparece como una pestaña en la parte superior de la página. ## Dónde encontrar las tareas [#waar-vind-je-taken] - **Tareas** en el menú lateral: la página principal con todas tus vistas - **Panel**: la tarjeta **Tareas para usted** muestra las tareas asignadas a ti, o tu vista favorita - **Clientes > [cliente] > Tareas**: todas las tareas vinculadas a un cliente - **Tareas abiertas**: un bloque en la página de un cliente, reserva, factura, parcela y contador Arriba están las vistas como pestañas. Debajo están la barra de búsqueda y los filtros, y a la derecha los botones **Visualización**, **Seguir** y compartir. Debajo ves las tareas, aquí como tablero por estado. Pasa el cursor sobre las marcas ℹ para ver una explicación. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Una tarea es una sola cosa, y las vistas son formas de ver tareas. Las tareas las crean compañeros o automatizaciones. Una automatización también puede esperar a una tarea. ```mermaid flowchart LR A["Un compañero crea una tarea
en la página de tareas o desde un cliente, factura o contador"] --> T["Tarea"] B["Una automatización crea una tarea
paso Crear tarea, a nombre de Workflow"] --> T T --> L["Lista
solo muestra las tareas que le añades tú mismo"] T --> G["Vista filtrada
muestra toda tarea que cumpla los filtros"] L --> Z["La visibilidad de la vista
determina quién ve la tarea"] T -- "Un compañero elige un botón en la tarea" --> W["La automatización deja de esperar
y continúa"] T -- "Cambia el estado o la asignación" --> S["Una automatización puede iniciarse con ello"] ``` - Si pones una tarea en una vista, la tarea en sí no cambia. Solo la vista la incorpora. - Una vista filtrada no saca tareas: aparecen o desaparecen solas según cumplan o no los filtros. - Una tarea que crea una automatización es una tarea normal. Si tiene botones de opción (paso **Pedir una decisión**), la automatización espera hasta que alguien elige un botón. Véase [Tareas con botones de opción](/taken/taakdetails#taken-met-keuzeknoppen) y [Tareas en automatizaciones](/automatiseringen/acties/taken). ## Empezar rápido [#snel-aan-de-slag] 1. Abre **Tareas** en el menú lateral 2. Haz clic en **Nueva vista**. Rellena un **Nombre** y elige en **Visibilidad**, **Contenido**, **Columnas** y **Empezar con** lo que quieras. Después haz clic en **Nueva vista** al final del cuadro de diálogo 3. Haz clic en **Nueva tarea** en la parte superior de una columna, ponle un nombre a la tarea y haz clic en **Crear** 4. Haz clic en una tarea para abrir los detalles: estado, prioridad, fecha de vencimiento, compañeros asignados y más 5. Marca la casilla a la izquierda de una tarea en cuanto esté terminada Sin vistas propias, siempre puedes recurrir a la vista integrada **Todas**, que muestra todas las tareas que puedes ver. Los filtros guardados en **Todas** se aplican a toda la organización. ## Estados [#statussen] | Estado | Significado | |---|---| | **Pendiente** | La tarea está planificada pero todavía no se ha empezado | | **En progreso** | Se está trabajando activamente en la tarea | | **Esperando respuesta** | Solo puedes continuar cuando otra persona, como un cliente o proveedor, haya hecho algo o respondido | | **Completada** | La tarea está terminada | Así se ve el mismo tipo de tarea antes y después de marcarla. Arriba hay una tarea abierta, debajo una completada: el título está tachado y el estado es **Completada**. Una tarea completada baja al final de una lista o columna ordenada manualmente. Si pones una tarea superior en **Completada**, también se completan las subtareas abiertas. Si luego vuelves a abrir la tarea, las subtareas siguen completadas. Una vista puede ocultar las tareas completadas pasado un tiempo, véase [Ocultar tareas completadas](/taken/indelingen#voltooide-taken-verbergen). ## Prioridades [#prioriteiten] Una tarea tiene la prioridad **Baja**, **Media**, **Alta** o **Urgente**. ## Componentes [#onderdelen] - No hay permisos aparte para las tareas. Quien trabaja en Tillor puede crear y editar tareas. Qué tareas ves depende de las vistas en las que están. Véase [Tareas privadas](/taken/prive-taken) - Una tarea nueva puede tener hasta 50 subtareas. Las subtareas solo tienen un nivel - Si pones una tarea en **Completada**, las subtareas abiertas también se completan - Quien sigue una vista recibe cada mañana a las 07:00 un resumen, con un máximo de 15 tareas por lista - Un temporizador en marcha se pausa tras diez minutos sin ratón ni teclado - Una etiqueta con un **Plazo objetivo (días)** da automáticamente una fecha de vencimiento a las tareas que no la tienen - Una tarea que eliminas no se puede restaurar ## Conceptos [#begrippen] - **Tarea**: un trabajo que registras, con estado, prioridad, fecha de vencimiento y, opcionalmente, compañeros asignados - **Vista**: una pestaña de la página de tareas con una forma propia de mostrar las tareas, véase [Vistas](/taken/weergaven) - **Lista**: una vista que solo muestra las tareas que le añades tú mismo - **Vista filtrada**: una vista que muestra toda tarea que cumple los filtros - **Subtarea**: una parte de una tarea, como lista de comprobación - **Bloqueo**: una tarea que debe estar terminada antes de que otra tarea pueda empezar - **Workflow**: el usuario a cuyo nombre una [automatización](/begrippen#automatisering) crea tareas Encontrarás más términos en el [glosario](/begrippen). # Etiquetas (/es-ES/taken/labels) Con las etiquetas das a las tareas una categoría, por ejemplo *Mantenimiento*, *Quejas* o *Temporada*. Puedes filtrar y agrupar por etiquetas. Una etiqueta tiene un nombre, un color y, opcionalmente, una descripción. ## Gestionar etiquetas [#labels-beheren] Ve a Configuración > Etiquetas de tareas. Ves esa página si puedes ver o editar la configuración general de tu organización. La vista general tiene las columnas **Etiqueta**, **Descripción** y **Tareas** (el número de tareas con esa etiqueta). - **Nueva etiqueta** crea una etiqueta con un **Nombre**, **Descripción**, **Color** y, opcionalmente, un **Plazo objetivo (días)** - **Editar etiqueta** modifica esos datos más adelante - **Eliminar etiqueta** quita la etiqueta y muestra antes en cuántas tareas está. La etiqueta desaparece de todas esas tareas También puedes crear una etiqueta mientras editas una tarea: escribe el nombre en el campo **Etiquetas** y elige **Crear [nombre]**. ## Establecer una fecha de vencimiento automáticamente [#een-deadline-automatisch-instellen] En una etiqueta puedes rellenar el **Plazo objetivo (días)**, por ejemplo *7*. Una tarea sin fecha de vencimiento que recibe esa etiqueta obtiene entonces una fecha de vencimiento propia: tantos días después del momento en que se creó la tarea o se añadió la etiqueta. - Esto ocurre al crear una tarea con la etiqueta, o si añades la etiqueta más tarde - Si la tarea ya tiene una fecha de vencimiento, esta se queda como está - Si una tarea tiene varias etiquetas con un plazo, se aplica el menor número de días - Si dejas el campo vacío, la etiqueta no establece ninguna fecha de vencimiento Esto es útil para etiquetas como *Queja* (en 2 días) o *Seguimiento de presupuesto* (en 7 días). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una etiqueta nueva puedes asignarla de inmediato a tareas, en la propia tarea y en el menú rápido. - Una etiqueta con un **Plazo objetivo (días)** da a partir de ese momento una fecha de vencimiento automática a las tareas que no la tienen. - Si eliminas una etiqueta, desaparece de todas las tareas en las que estaba. Las tareas se conservan. ## ¿Problemas? [#problemen] No tienes permiso para ver la configuración general de tu organización. Pide a un administrador que ajuste tus permisos. Rellena un **Nombre** (como máximo 50 caracteres) e inténtalo de nuevo. Al editar y eliminar, los avisos se llaman **No se pudo actualizar la etiqueta** y **No se pudo eliminar la etiqueta**. Una fecha de vencimiento de la etiqueta solo se pone en tareas sin fecha de vencimiento. Si la tarea ya tiene una, se queda. Con varias etiquetas con un plazo, se aplica el menor número de días. # Notificaciones (/es-ES/taken/meldingen) Tillor te mantiene al día de las tareas por correo electrónico y notificaciones push. ## Recordatorios y fechas de vencimiento [#herinneringen-en-deadlines] Si una tarea tiene un **Recordatorio** o una **Fecha de vencimiento**, en la ventana de detalle, en **Notificaciones**, eliges si quieres **Correo electrónico** y/o **Notificación push**. Ambas están activadas de forma predeterminada. Si desactivas las dos, nadie recibe una notificación de esa tarea. - Un recordatorio salta en el momento establecido, con el título *Recordatorio de tarea* - Un aviso de vencimiento salta en cuanto se alcanza la fecha de vencimiento y la tarea todavía no está completada - Las tareas completadas ya no generan recordatorio ni aviso de vencimiento - Un recordatorio periódico salta en cada repetición, hasta que la tarea se completa o termina la pauta La notificación va a los compañeros asignados, también a los miembros de un grupo asignado. Si no hay nadie asignado, va a quien creó la tarea. El correo muestra una vista previa de la tarea, con el estado y un botón para abrirla. ## Asignar, desvincular y completar [#toewijzen-ontkoppelen-en-voltooien] - Si te asignan una tarea, también a través de un grupo al que perteneces, recibes una notificación (**Nueva tarea asignada**). Si te asignas una tarea a ti mismo, no recibes ninguna notificación - Si alguien te quita de una tarea, recibes una notificación de que la tarea se ha **desvinculado** (**Tarea desasignada**) - Cuando se completa una tarea, los compañeros asignados y quien la creó reciben una notificación, salvo quien completó la tarea. La notificación se envía con un retraso de aproximadamente un minuto. Si alguien vuelve a abrir la tarea en ese tiempo, ya no se envía ## Seguir una vista [#een-weergave-volgen] Con **Seguir** (arriba a la derecha en una vista guardada) recibes cada mañana a las 07:00 un correo con un resumen de esa vista. El correo tiene el asunto *Resumen diario* con el nombre de la vista, y contiene tres listas: - **Vencidas** - tareas abiertas cuya fecha de vencimiento ya pasó - **Vencen hoy** - tareas abiertas que deben estar listas hoy - **Modificadas desde el último resumen** - tareas abiertas que se han modificado desde tu resumen anterior Cada lista muestra como máximo 15 tareas con su fecha de vencimiento. Abajo está el botón **Abrir vista**, que salta directamente a la vista. - Si no hay nada en ninguna de las tres listas, ese día no recibes ningún correo - El botón cambia a **Siguiendo**. Haz clic en él para dejar de seguir. Puedes seguir cualquier vista que puedas ver, también las vistas de tus compañeros - Si pierdes el acceso a la vista, por ejemplo porque su propietario la hace solo para sí mismo o la elimina, dejas de seguirla automáticamente - Solo ves las tareas que tú mismo puedes ver La vista integrada **Todas** no se puede seguir, porque no es una vista guardada. ## ¿Problemas? [#problemen] Comprueba en la tarea, en **Notificaciones**, si **Correo electrónico** o **Notificación push** están activados. Una notificación va a los compañeros asignados, o a quien creó la tarea si no hay nadie asignado. Las tareas completadas ya no generan notificación. Es correcto. Una notificación **Nueva tarea asignada** solo la recibes si otra persona te asigna la tarea. No sigues la vista (el botón **Seguir** debe mostrar **Siguiendo**), o no hay nada en **Vencidas**, **Vencen hoy** y **Modificadas desde el último resumen**. En ese caso no enviamos ningún correo ese día. También dejas de seguir automáticamente si ya no puedes ver la vista. El cambio no se ha guardado. Haz clic de nuevo en **Seguir**. # Tareas privadas (/es-ES/taken/prive-taken) Una tarea es privada si solo está en vistas personales. No tienes que configurar nada para ello: las vistas en las que está una tarea determinan quién la ve. ## Las reglas [#de-regels] | Dónde está la tarea | Quién la ve | |---|---| | En ninguna vista | Todos los usuarios de la organización | | En al menos una vista **Público** | Todos los usuarios de la organización | | Solo en vistas personales (**Solo tú** o **Compartido**) | Quien creó la tarea, los compañeros y grupos asignados, y el propietario y las personas y grupos elegidos de esas vistas | Las subtareas siguen a su tarea superior. Una tarea que no puedes ver no aparece en ningún sitio: ni en listas, resultados de búsqueda, filtros, el panel, en un cliente, en el calendario ni en notificaciones, y tampoco puedes abrirla mediante un enlace. ## Ejemplo [#voorbeeld] Jan crea la vista personal *Mis ideas* con visibilidad **Solo tú**. Añade la tarea *Pedir presupuesto de la nueva barrera* a esa lista. - Solo Jan ve la tarea. Sus compañeros no la ven en ningún sitio - Jan asigna la tarea a Piet. Ahora Piet también ve la tarea, aunque nunca haya visto la vista de Jan - Jan comparte *Mis ideas* con Els (**Compartido**). Ahora Els también ve la tarea - Jan añade la tarea a la vista *Mantenimiento*, que es **Público**. Desde ahora todo el equipo ve la tarea - Si Jan vuelve a quitar la tarea de *Mantenimiento* y no está en ninguna otra vista pública, vuelve a ser privada Si Jan no hubiera puesto la tarea en ninguna vista, todos la habrían visto. ## Quién determina la visibilidad de una vista [#wie-bepaalt-de-zichtbaarheid-van-een-weergave] Solo el propietario de una vista personal puede cambiar con quién se comparte la vista, o hacerla **Público**. Un compañero con quien compartes la vista puede editar tareas en ella, pero no cambiar la visibilidad ni eliminar la vista. Véase [Vistas](/taken/weergaven#wie-ziet-een-weergave). Añadir una tarea privada a una vista pública la hace visible para todos. Tillor pide confirmarlo antes con **¿Hacer pública esta tarea?**. Entonces puedes elegir **Mantener privada** o **Hacer pública**. Aparece la misma pregunta si quitas la tarea de su última vista pública. Si haces **Público** una vista personal que contiene tareas, esas tareas se hacen visibles para todos sin una pregunta aparte. ## Consejos [#tips] - Si quieres traspasar una tarea privada, asígnala a un compañero o comparte la vista con ese compañero - Una tarea cuenta como "en una vista" en cuanto la añades a una lista o la pones en una columna propia de la vista. Mostrarla solo mediante un filtro no hace que esté en la vista - Las notificaciones sobre una tarea privada, como una fecha de vencimiento, solo van a las personas que pueden ver la tarea ## ¿Problemas? [#problemen] La tarea solo está en vistas personales. Asígnala al compañero, comparte la vista con él o pon la tarea en una vista pública. Estás añadiendo una tarea privada a una vista pública, o quitándola de su última vista pública. Elige **Mantener privada** o **Hacer pública**. Quizá la tarea esté vinculada a otra vista, o la vista en la que estaba ya no es visible para ti. Pregunta a quien creó la tarea o al propietario de la vista. ## Véase también [#zie-ook] # Detalles de la tarea (/es-ES/taken/taakdetails) En la ventana de detalles de una tarea registras todo: quién la hace, cuándo debe estar terminada, cuánto tiempo lleva y a qué está vinculada. Haz clic en una tarea para abrir la ventana. A la izquierda están el nombre, la descripción y partes como las subtareas y los comentarios. A la derecha están las propiedades, como el estado, la prioridad y la fecha de vencimiento. Los cambios en una tarea existente se guardan al instante. Solo la descripción la guardas tú con **Guardar**. También puedes abrir una tarea directamente con un enlace. Cópialo desde el menú de los tres puntos, arriba a la derecha de la ventana, consulta [El menú de la tarea](#het-menu-van-de-taak). ## Crear una tarea [#een-taak-aanmaken] Las tareas se crean en varios sitios: arriba de una columna de un tablero (**Nueva tarea**), en la tarjeta **Tareas para usted** del panel, en la página del cliente, o desde una conversación, una factura u otro elemento, consulta [Tareas en otras páginas](/taken/taken-op-andere-paginas). 1. Haz clic en **Nueva tarea** 2. Rellena un **Nombre**. El resto es opcional 3. Si quieres, añade subtareas en **Añadir una subtarea**: escribe un nombre y pulsa Intro. Puedes añadir hasta 50 4. Haz clic en **Crear**, o pulsa Cmd o Ctrl junto con Intro Arriba de la ventana aparece la vista en la que se coloca la tarea. Si creas la tarea desde una columna de un tablero, recibe automáticamente esa vista y esa columna. Puedes elegir otra o quitar la vista. Tú apareces como persona asignada. Si te quitas y no eliges a nadie, la tarea no tiene a nadie asignado. Los bloqueos y el tiempo dedicado los añades después de crear la tarea. ## Propiedades [#eigenschappen] - **Estado** y **Prioridad** - consulta la [vista general](/taken#statussen) - **Asignado a** - uno o más compañeros o [grupos](/gebruikers/groepen). Busca con **Buscar personas o grupos...**. Si asignas un grupo, la tarea vale para todos los que estén en el grupo en ese momento - **Clientes** - vincula uno o más clientes con **Añadir un cliente** - **Etiquetas** - consulta [Etiquetas](/taken/labels). Una etiqueta que falta la creas al momento escribiendo el nombre y eligiendo **Crear [nombre]** - **Fecha de vencimiento** - la fecha límite, con la hora. Si la fecha de vencimiento ya ha pasado, el tiempo relativo se muestra en rojo - **Recordatorio** - una fecha y hora en la que quieres recibir un aviso, que puede repetirse - **Notificaciones** - en cuanto hay un recordatorio o una fecha de vencimiento, eliges si quieres un **Correo electrónico** y/o una **Notificación push**. Ambos están activados por defecto - **Creada por** - quién creó la tarea - **Campos personalizados** - campos que tu organización ha añadido a las tareas. Los cambios se guardan al instante. Consulta [Campos personalizados](/eigen-velden) - **Vista** - haz clic arriba a la izquierda en el nombre de la vista para elegir en qué listas está la tarea y en qué columna. En una vista filtrada solo eliges una columna - **Privada** - si ves un candado con **Privada**, la tarea solo está en vistas personales, consulta [Tareas privadas](/taken/prive-taken) Una tarea también puede tener una **Descripción**. Admite Markdown para el formato. ## Recordatorios repetitivos [#herhalende-herinneringen] Un recordatorio puede repetirse hasta que la tarea esté completada: 1. Establece primero un **Recordatorio** (fecha y hora) 2. Haz clic en el campo de repetición que hay debajo (por defecto **No se repite**) 3. Elige **Diaria**, **Cada día laborable (lun – vie)**, **Semanal**, **Mensual**, **Anual** o **Personalizado…** Con **Personalizado…** montas tu propio calendario: - **Repetir cada** - un número de días, semanas, meses o años - **Repetir el** - en un calendario semanal, los días de la semana en que puede llegar el recordatorio - **Termina** - **Nunca**, **En una fecha** o **Después** de un número de veces Si un recordatorio cae en un día que has excluido, pasa sin aviso al siguiente día permitido. La repetición se detiene en cuanto la tarea está en **Completada** o el calendario termina. ## Elementos vinculados [#gekoppelde-items] En **Elementos vinculados** ves a qué está unida la tarea. Puedes vincular varios de cada tipo: parcelas, facturas, reservas, contadores, llamadas telefónicas, transacciones bancarias, productos y conversaciones del buzón. Una tarea también puede estar vinculada a un comentario. Una tarea sobre una transacción bancaria la creas desde el menú de la transacción en **Transacciones bancarias** con **Crear tarea**. Una tarea sobre un producto, como revisar la cuenta contable, la creas en la página del producto desde el menú **⋯** con **Crear tarea**; las tareas abiertas del producto aparecen arriba de esa página. Un elemento adicional lo vinculas con el signo más junto a **Elementos vinculados** (tooltip **Vincular elemento**). Busca un cliente, parcela, contador, factura, reserva o producto. Si el elemento elegido pertenece a un cliente, Tillor pregunta **¿Vincular también a [cliente]?**: - **Vincular ambos** - la tarea aparece también en el cliente - **Solo este elemento** - el cliente no se vincula a la tarea Con **Desvincular** quitas de nuevo un vínculo. Las tareas vinculadas que siguen abiertas aparecen en la página del elemento en **Tareas abiertas**. ## Adjuntos [#bijlagen] En **Adjuntos** añades archivos a la tarea. Haz clic en el signo más, o pega un archivo con Cmd o Ctrl y V en cualquier punto de la ventana. ## Subtareas [#subtaken] Una tarea puede tener subtareas, una lista de comprobación en la ventana de detalles. Solo hay un nivel: una subtarea no puede tener a su vez subtareas. 1. Abre la tarea principal, o rellénalas ya mientras creas una tarea 2. En **Añadir una subtarea** escribe un nombre y pulsa Intro 3. Marca una subtarea para ponerla en **Completada**. Márcala de nuevo para revertirlo 4. Haz clic en el nombre para renombrarla, o en la papelera para eliminarla 5. Arrastra una subtarea por el asa para cambiar el orden. Con **Añadir descripción** también le das una descripción a una subtarea En una tarea nueva, las subtareas se crean junto con la tarea, en el orden en que las rellenaste. Las subtareas no aparecen como tarjeta aparte en los tableros, las tablas ni el calendario. En la tarea ves un contador como **2/5**. Si pones la tarea principal en **Completada**, todas las subtareas abiertas se completan también. A la inversa no hace falta: puedes terminar la tarea principal aunque queden subtareas abiertas. ## Bloqueos y dependencias [#blokkades-en-afhankelijkheden] A veces una tarea solo puede empezar o terminarse cuando otra está lista. En la ventana de detalles lo registras así: - **Bloqueada por** - tareas que deben estar listas primero. Añádelas con **Añadir tarea bloqueante** - **Bloquea otras tareas** - tareas que esperan a esta. Añádelas con **Añadir tarea bloqueada** En cada grupo ves cuántas tareas siguen abiertas (por ejemplo **2 abiertas**). Busca tareas con **Buscar tareas...** y quita un vínculo con **Quitar vínculo**. En la tarjeta de la tarea, bajo el nombre, aparece una línea como **Bloqueada por 1 tarea**. Puedes filtrar por tareas bloqueadas, consulta [Filtrar](/taken/filteren). Un bloqueo no te detiene. Si intentas marcar una tarea bloqueada, Tillor pregunta **¿Completar una tarea bloqueada?** y solo la completa cuando eliges **Completar igualmente**. Un bloqueo también lo añades desde el menú de los tres puntos, arriba a la derecha de la ventana, con **Añadir tarea bloqueante** y **Añadir tarea bloqueada**. ## Tiempo dedicado [#bestede-tijd] Junto a **Tiempo dedicado** en la ventana de detalles aparece el total. Haz clic en él para registrar tiempo. Tienes dos formas: - Un **temporizador**. Haz clic en **Empezar**, trabaja en la tarea y haz clic en el botón de parada cuando termines. El tiempo se anota en la tarea con los segundos incluidos - **Rellenarlo después**. Indica la duración, por ejemplo **1:30**, **90** (minutos), **1u 30m** o **1.5h**. Las cuatro significan hora y media. Si quieres, añade una nota en **¿Qué hiciste? (opcional)** y haz clic en **Registrar** El tiempo se registra en el día de hoy. En la lista ves por registro quién lo hizo, la fecha, la nota y la duración. Los compañeros ven los registros de los demás, pero solo puedes eliminar los tuyos, con la papelera que aparece al pasar el ratón por la línea. ### El temporizador [#de-timer] - Un temporizador en marcha sigue contando si vas a otra página. Entonces aparece como una tarjeta abajo a la derecha, con botones para pausar (**Pausar**), reanudar (**Reanudar**), **Apuntar** y detener (**Terminar**). Haz clic en el nombre de la tarea para volver - Con **Apuntar** guardas el tramo hasta ahora, con una breve nota sobre lo que estabas haciendo, y el temporizador sigue después - Solo puedes llevar el tiempo de una tarea a la vez. Mientras tu temporizador esté en marcha, **Empezar** está desactivado en las demás tareas - Si pasas diez minutos sin usar el ratón ni el teclado, el temporizador se pausa en el último momento en que estuviste activo - Los compañeros ven en la ventana de la tarea que estás trabajando (**En curso**) o en pausa (**En pausa**). Ese tiempo solo cuenta en el total una vez guardado ## Comentarios y actividad [#opmerkingen-en-activiteit] Abajo de la ventana está la sección **Comentarios**. Con **Añadir comentario** escribes un comentario. Puedes mencionar a compañeros en un comentario para que reciban un aviso. Debajo está la **actividad**: una cronología de la creación y los cambios, con lo que había antes y después en cada cambio. ## El menú de la tarea [#het-menu-van-de-taak] Arriba a la derecha de la ventana hay un menú de tres puntos. - **Añadir tarea bloqueante** y **Añadir tarea bloqueada** registran una dependencia - **Imprimir** tiene tres opciones. **Imprimir (A4)** abre el diálogo de impresión de tu navegador con un pdf de la tarea. **Enviar a la impresora A4** y **Enviar a la impresora térmica (POS)** envían la tarea a tu impresora, por ejemplo una impresora de tickets. Esas dos solo puedes elegirlas si tu organización tiene un [conector](/connector) con impresora, consulta [Impresora](/printer) - **Copiar enlace** copia un enlace que abre la tarea directamente. Quien abra el enlace debe poder ver la tarea - **Eliminar** está al final, consulta [Eliminar una tarea](#een-taak-verwijderen) La impresión muestra el nombre, el estado, la prioridad, la fecha de vencimiento y la descripción, y en **Elementos vinculados** los clientes, facturas, reservas, parcelas y contadores a los que está unida la tarea. Si la tarea tiene bloqueos, también aparecen las tareas que la bloquean y las tareas que ella misma bloquea. Un grupo sin elementos se omite. ## Tareas con botones de elección [#taken-met-keuzeknoppen] Algunas tareas, por ejemplo de una [automatización con el paso Pedir una decisión](/automatiseringen/logica#vraag-om-een-beslissing), piden una decisión. En lugar de una casilla hay botones en la tarea, con encima **Elige una acción para terminar esta tarea**. Haces clic en un botón y la tarea queda terminada. - Si la elección requiere un motivo, Tillor abre primero una ventana con **¿Por qué esta elección?** donde rellenas una nota - Si la elección requiere una confirmación, Tillor muestra primero una ventana. Una elección hecha ya no se puede deshacer desde la tarea - Después, en la tarea aparece qué elección se hizo y quién la hizo - Pueden elegir quien esté asignado a la tarea y un administrador. Si no hay nadie asignado, puede elegir cualquiera que vea la tarea Así se relacionan la tarea y la automatización: ```mermaid flowchart TD A["La automatización llega al paso
Pedir una decisión"] --> B["Tillor crea una tarea con tus botones
y la automatización espera"] B --> C{"Un compañero elige un botón"} C -- "Una opción" --> D["La tarea queda en Completada
la automatización sigue por esa opción"] C -- "Nadie elige dentro del plazo" --> E["La automatización sigue por Caducada
la tarea se mantiene"] C -- "Se elimina la tarea" --> E ``` Una tarea creada por una automatización y que solo el flujo puede terminar muestra, en lugar de una casilla, el texto **La termina su automatización**. Entonces no puedes completarla y en el menú no tiene **Eliminar**. ## Cambiar el estado rápido y marcar [#status-snel-wijzigen-en-afvinken] Sin abrir la ventana puedes: - Marcar la casilla a la izquierda del nombre de la tarea para ponerla en **Completada**. Si la desmarcas, vuelve a **Pendiente** - Hacer clic en los tres puntos de la tarjeta de la tarea, o con el botón derecho en la tarjeta, para un menú rápido con **Editar**, **Estado**, **Prioridad**, **Recordatorio**, **Fecha de vencimiento**, **Etiquetas**, **Vistas** y **Eliminar**. **Etiquetas** solo aparece si hay etiquetas y **Vistas** solo si hay listas a las que añades tareas tú mismo ## Eliminar una tarea [#een-taak-verwijderen] Elige **Eliminar** en el menú rápido de la tarea, o en el menú de los tres puntos de la ventana de la tarea, y confirma. Esto no se puede deshacer y las subtareas, si las hay, desaparecen con ella. La eliminación queda registrada en el [registro de actividad](/activiteitenlog). En una tarea que solo una automatización puede terminar, **Eliminar** no aparece en el menú. Si una tarea así se elimina de otra forma, falla la automatización que esperaba su finalización. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Los cambios en una tarea existente se guardan al instante. Solo la descripción la guardas tú con **Guardar**. - Si asignas la tarea, ese compañero (o los miembros del grupo) recibe un aviso. Consulta [Notificaciones](/taken/meldingen). - Si pones la tarea en Completada, las subtareas abiertas también se completan y los compañeros asignados y el creador reciben un aviso, salvo tú. La tarea baja al final en una lista ordenada manualmente. - Un recordatorio o una fecha de vencimiento genera un aviso hasta que la tarea está completada. - Una tarea creada por una [automatización](/automatiseringen/acties/taken) puede hacer que arranque otra automatización, por ejemplo con un cambio de estado o cuando alguien elige un botón de elección. - Eliminar no se puede deshacer. La eliminación queda en el [registro de actividad](/activiteitenlog). ## ¿Problemas? [#problemen] La tarea aún espera a una o más tareas sin terminar (consulta **Bloqueada por**). Termina primero esas tareas, o elige **Completar igualmente**. Con **La termina su automatización** no puedes completar la tarea tú mismo. La termina la automatización. Si la tarea tiene botones bajo **Elige una acción para terminar esta tarea**, haces clic en un botón. Pueden elegir quien esté asignado a la tarea y un administrador. Si no hay nadie asignado, puede elegir cualquiera que vea la tarea. Si aparece el error **No se pudo guardar la elección**, inténtalo de nuevo. Tu temporizador ya está en marcha en otra tarea. Solo puedes llevar el tiempo de una tarea a la vez. Detén primero ese temporizador. Tras diez minutos sin ratón ni teclado, el temporizador se pausa en el último momento en que estuviste activo. Usa **Reanudar** para continuar. Indica una duración que Tillor entienda, como **1:30**, **90**, **1u 30m** o **1.5h**. Si aun así falla, ves el aviso **No se pudo registrar el tiempo** y lo intentas de nuevo. Solo puedes eliminar tus propios registros. **Enviar a la impresora A4** y **Enviar a la impresora térmica (POS)** solo puedes elegirlas si tu organización tiene un conector con impresora. **Imprimir (A4)** funciona siempre. Si algo sale mal, ves el aviso **No se pudo generar el PDF de la tarea**. El cambio no se ha guardado. Inténtalo de nuevo o actualiza la página. En una tarea que solo una automatización puede terminar, **Eliminar** no aparece en el menú. Por lo demás, cualquier compañero que vea la tarea puede eliminarla. ## Ver también [#zie-ook] # Tareas en otras páginas (/es-ES/taken/taken-op-andere-paginas) Las tareas no están aisladas. Las creas desde el elemento del que tratan, y también las ves allí. ## Crear una tarea desde otro elemento [#een-taak-maken-vanuit-een-ander-item] La tarea se vincula automáticamente al elemento. Si hay un cliente implicado, también puedes vincularlo. Por defecto la tarea se te asigna a ti. | Dónde | Botón | |---|---| | Página del cliente | **Crear tarea** en el menú de acciones del cliente | | Factura | **Crear tarea** en el menú de acciones | | Contador | **Crear tarea** en el menú de acciones | | Reserva | **Crear tarea** | | Parcela | **Crear tarea** | | Conversación del buzón | **Crear tarea** | | Llamada telefónica | **Crear tarea** | | Comentario | El icono de tarea junto al comentario (tooltip **Crear una tarea a partir de este comentario**) | | Transacción bancaria | **Crear tarea** en el menú de acciones de la transacción en Administración > Transacciones bancarias | ## Un recordatorio de seguimiento en un comentario [#een-opvolgherinnering-bij-een-opmerking] En un comentario también hay un reloj para recordarte a ti (o a los compañeros mencionados) que hagas el seguimiento del comentario. Con él creas una tarea como *Hacer seguimiento de este comentario* o *Comprueba si [nombre] ha visto esto*. Si más tarde marcas el comentario como resuelto, esa tarea de seguimiento se completa automáticamente. ## Tareas abiertas en un elemento [#openstaande-taken-bij-een-item] En la página de un cliente, una reserva, una factura, una parcela y un contador hay un bloque **Tareas abiertas** con las tareas que aún no están completadas y que están unidas a ese elemento. Si no hay tareas abiertas, el bloque no aparece. En la página Clientes > [cliente] > Tareas están todas las tareas del cliente. La abres desde la pestaña **Tareas** de la página del cliente. Las tareas completadas están plegadas bajo **Tareas completadas**, con el número al lado. ## En el panel [#op-het-dashboard] La tarjeta **Tareas para usted** muestra las tareas que se te han asignado. Con la estrella eliges una vista favorita que quieres ver allí en su lugar, consulta [Vistas](/taken/weergaven#een-favoriete-weergave-voor-het-dashboard). También puedes crear una tarea directamente allí o compartir las tareas. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La tarea está unida al elemento desde el que la creaste. La ves en **Elementos vinculados** dentro de la tarea. - Mientras la tarea no esté completada, aparece en el bloque **Tareas abiertas** de la página de ese elemento y del cliente vinculado. - Una tarea de seguimiento de un comentario se completa sola cuando marcas el comentario como resuelto. ## ¿Problemas? [#problemen] En algunas páginas el botón está en el menú de acciones, como en un cliente, una factura o un contador. Busca allí los tres puntos. El bloque solo aparece si hay tareas sin terminar unidas al elemento. La tarea no se ha guardado. Rellena un nombre e inténtalo de nuevo. ## Ver también [#zie-ook] # Vistas (/es-ES/taken/weergaven) Arriba de la página **Tareas** hay una fila de pestañas. Cada pestaña es una vista. La primera pestaña, **Todas**, es integrada: muestra todas las tareas y no puedes editarla, moverla ni eliminarla. Sí puedes guardar en ella filtros y ajustes de la vista para toda la organización. Las demás vistas las creas tú. ## Dos tipos de vistas [#twee-soorten-weergaven] Al crear una vista eliges el tipo en **Contenido**. | Tipo | Qué hace | |---|---| | **Vista filtrada** | Muestra todas las tareas que cumplen los filtros, como una búsqueda guardada. Las tareas nuevas que encajan aparecen solas | | **Lista** | Muestra solo las tareas que añades tú mismo | Una lista es útil para un conjunto fijo, por ejemplo *Preparación de la temporada*. Una vista filtrada es útil para todo lo que cumple una regla, por ejemplo *Todas las tareas urgentes que esperan al cliente*. Puedes cambiar el tipo después en **Vista** (arriba a la derecha) en **Tipo**. En **Todas** no. Si conviertes una lista en una vista filtrada, las tareas que añadiste a mano se desvinculan de ella. Tillor pide confirmarlo antes, porque no se puede deshacer. ## Crear una vista [#een-weergave-aanmaken] 1. Haz clic en **Nueva vista**, a la derecha de las pestañas 2. Rellena un **Nombre** y, si quieres, una **Descripción** 3. En **Visibilidad** elige quién ve la vista: **Público**, **Solo tú** o **Compartido**. Con **Compartido** eliges en **Compartir con** los compañeros y grupos 4. En **Contenido** elige una **Vista filtrada** o una **Lista** 5. En **Columnas** elige cómo se organizan las tareas: **Columnas propias**, **Estado**, **Asignado a** o **Sin agrupación** 6. En **Empezar con** elige un filtro inicial: **Todas las tareas**, **Tareas abiertas** o **Mis tareas** 7. Haz clic en **Nueva vista** abajo en el diálogo De entrada la vista está en **Público**, **Vista filtrada**, **Estado** y **Tareas abiertas**. Si eliges **Sin agrupación**, obtienes una tabla. Con las otras opciones empiezas con un tablero. Lo cambias después, consulta [Tabla, tablero y calendario](/taken/indelingen). Una vista filtrada configurada como tabla tiene este aspecto. Los filtros están encima de la tabla y aquí ya están guardados. ## Quién ve una vista [#wie-ziet-een-weergave] | Opción | Quién ve la vista | |---|---| | **Público** | Todos los usuarios de la organización (una vista de organización) | | **Solo tú** | Solo tú (una vista personal). En la pestaña hay un candado | | **Compartido** | Tú y los compañeros y grupos que elijas en **Compartir con**. En la pestaña hay un icono de varias personas | En **Compartir con** eliges personas y grupos de la misma lista. Un [grupo](/gebruikers/groepen) cuenta tal como está formado en ese momento: quien entre más tarde en el grupo también ve la vista, y quien salga del grupo ya no la ve. Solo el propietario de una vista personal puede cambiar con quién está compartida o hacerla visible para todos. Los compañeros con quienes compartes la vista pueden trabajar en ella, pero no deciden quién más la ve ni pueden eliminarla. Si haces una vista **Público**, la lista de personas y grupos elegidos desaparece. La visibilidad de una vista también determina quién ve las tareas de esa vista. Lee [Tareas privadas](/taken/prive-taken) antes de poner tareas en una vista personal. ## Editar, duplicar o eliminar una vista [#een-weergave-bewerken-dupliceren-of-verwijderen] Haz clic con el botón derecho en la pestaña de la vista y elige: - **Editar** - cambia el nombre, la descripción, la visibilidad y las columnas. Los filtros, la ordenación y la disposición se quedan como estaban guardados. **Contenido** y **Empezar con** solo los eliges al crear; el tipo lo cambias después en **Vista** - **Duplicar** - crea una copia con el nombre *[nombre] (copia)* y la abre enseguida - **Eliminar** - tras confirmar, la vista desaparece. Las tareas en sí se conservan y solo pierden esta vista Arrastra las pestañas para cambiar el orden. El nuevo orden se guarda al instante. ## Guardar o descartar cambios [#wijzigingen-opslaan-of-verwerpen] Si cambias filtros o ajustes de la vista, primero solo están en tu pantalla. Arriba a la derecha aparece una barra con **Cambios sin guardar** y dos botones: - **Guardar vista** conserva los cambios en la vista - **Descartar** devuelve todo a la versión guardada En la vista integrada **Todas** guardas los cambios para todos en tu organización, igual que en una vista pública. Para ello necesitas el permiso **Gestionar etiquetas y vistas compartidas**. Sin ese permiso, en **Todas** solo puedes **Descartar** los cambios. La barra de búsqueda (**Buscar tareas...**) nunca se guarda con la vista: solo acota lo que ves ahora. ## Una vista favorita para el panel [#een-favoriete-weergave-voor-het-dashboard] En el panel, la tarjeta **Tareas para usted** muestra por defecto las tareas que se te han asignado. Puedes vincularle una vista en su lugar: 1. Haz clic en la estrella arriba a la derecha de la tarjeta 2. Elige una vista de la lista. Elige **Tareas para usted** para volver a tus propias tareas asignadas Solo puedes tener una vista favorita a la vez, y vale solo para ti. Si la vista se elimina más tarde o ya no es visible para ti, el panel vuelve a mostrar tus propias tareas. ## Seguir una vista [#een-weergave-volgen] Con el botón **Seguir** de arriba a la derecha recibes cada mañana un correo con lo que requiere atención en esa vista. Cómo funciona está en [Notificaciones](/taken/meldingen#een-weergave-volgen). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La nueva vista aparece como pestaña arriba de la página de tareas. Una vista filtrada muestra enseguida todas las tareas que encajan, y las tareas nuevas que encajan se añaden solas. - Con **Público**, todos los usuarios de tu organización ven la vista. Con **Solo tú**, solo la ves tú, y con **Compartido**, tú y los compañeros y grupos elegidos. - Si eliminas una vista, las tareas se conservan. Solo pierden esa vista. - Si conviertes una lista en una vista filtrada, las tareas que añadiste a mano se desvinculan. - Una vista que sigues te envía un resumen cada mañana. Consulta [Notificaciones](/taken/meldingen#een-weergave-volgen). ## ¿Problemas? [#problemen] Ves **No se pudo crear la vista**. Comprueba que hayas rellenado un **Nombre** e inténtalo de nuevo. Si sigue sin funcionar, comprueba que tu conexión a internet sea buena. Al duplicar, el aviso es **No se pudo duplicar la vista** y vale lo mismo. **Todas** es integrada y muestra todas las tareas que puedes ver. El nombre, la posición y la visibilidad son fijos. Sí puedes guardar en ella filtros y ajustes de la vista, para toda la organización. Crea una vista propia si quieres una selección solo para ti. Solo el propietario de una vista personal decide con quién está compartida, y puede hacerla pública o eliminarla. Los compañeros con quienes la compartes sí pueden editar tareas en ella. Has cambiado filtros o ajustes de la vista, y siguen solo en tu pantalla. Elige **Guardar vista** para conservarlos o **Descartar** para volver atrás. En **Todas** necesitas para ello el permiso **Gestionar etiquetas y vistas compartidas**; sin ese permiso allí solo puedes descartar. Una lista solo muestra las tareas que añades tú mismo. Si quieres que todo lo que cumple una regla entre solo, elige en **Tipo** una vista filtrada. Entonces Tillor muestra **No se pudo reordenar las vistas**. Arrastra de nuevo las pestañas. ## Ver también [#zie-ook] # Parcelas (/es-ES/terreinen) Una parcela es un lugar de tu parque: un solar, un chalet, una plaza de autocaravanas o una plaza fija. Aquí creas tus parcelas, les das un tipo y una tarifa y les vinculas contadores. Después colocas clientes en ellas con una [ocupación](/bezettingen) o una [reserva](/reserveringen). Las encuentras en Parque > Parcelas. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] ```mermaid flowchart LR T[Terrein] --> M[Meters] T --> Tar[Berekend tarief] K[Klant] -->|bezetting| T Tar --> F[Facturen] M --> V[Verbruik van de klant] V --> F ``` De una parcela cuelga todo lo que pertenece a ese lugar. La tarifa se deriva de la superficie y de los campos personalizados de la parcela. Los contadores de la parcela aportan el consumo, y ese consumo va al cliente con una ocupación activa. Consulta también [Gestión de contadores](/meterbeheer#hoe-hangt-dit-samen). - El nombre es obligatorio y puede tener un máximo de 255 caracteres. - **Reservable** está desactivado por defecto en una parcela nueva. - Tillor calcula la superficie en cuanto dibujas la parcela en el mapa. No la escribes tú. - **Parcelas recientes** cuenta las parcelas de los últimos 7 días. - Una parcela tiene como máximo una ocupación activa a la vez. - La tarifa calculada se vuelve a calcular en cuanto guardas una parcela, y para todas las parcelas en cuanto guardas la fórmula de tarifa. - Si eliminas un tipo de parcela, las parcelas se conservan, pero entonces no tienen tipo. ## Crear una parcela nueva [#een-nieuw-terrein-aanmaken] Antes de empezar: si necesitas tipos de parcela (como **Parcela** o **Chalet**) o campos personalizados, créalos primero. Consulta [Tipos de parcela](#terreintypes) y [Campos personalizados](/eigen-velden). ### Haz clic en Crear nuevo terreno [#klik-op-nieuw-terrein-aanmaken] Encuentras el botón arriba a la derecha en Parque > Parcelas. ### Rellena los datos [#vul-de-gegevens-in] Solo el **Nombre** es obligatorio. Además puedes rellenar: - **Descripción**, una explicación. - **Tipo de parcela**, o deja **Sin tipo**. - **Campos personalizados** que tu organización ha añadido, como un suplemento o un número de contador de gas. - **Reservable**, si los clientes pueden reservar la parcela en línea. - **Ubicación**, para señalar la parcela en el mapa enseguida. ### Haz clic en Crear parcela [#klik-op-terrein-aanmaken] La parcela aparece en la lista. Si no has dibujado la ubicación, lo haces después en el plano, consulta [Mapa](/kaart#terreingrenzen-intekenen). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La parcela aparece en la lista y en las estadísticas de arriba: **Total de parcelas**, **Parcelas recientes**, **Parcelas reservables**, **Parcelas no reservables** y **Superficie total** (solo de parcelas con una ubicación dibujada). - Tillor calcula la **Tarifa calculada** a partir de la fórmula de tarifa de tu organización. - En la página de detalles puedes vincular contadores, añadir comentarios y ver el historial. ## Ver y editar una parcela [#een-terrein-bekijken-en-bewerken] Haz clic en una parcela de la lista. Arriba aparecen el nombre, la descripción, la superficie, el número de contadores, si es reservable, el **Cliente** con una ocupación activa y las fechas de creación y modificación. En el formulario **Actualizar parcela** cambias: - **Nombre**, **Tipo de parcela**, **Descripción**, **Reservable** y los **Campos personalizados**. - **Superficie** y **Tarifa calculada** son de solo lectura. Guarda con **Actualizar parcela**. Junto al formulario están **Ubicación**, **Contadores** e **Historial de ocupación**. Debajo están **Comentarios** (solo visibles para tus compañeros), **Eventos** con un resumen de antes y después por cada campo modificado, y **Reservas**. ## Vincular contadores a una parcela [#meters-aan-een-terrein-hangen] En la tarjeta **Contadores** eliges **Añadir contador** y después **Asignar contador**. Solo los contadores sin parcela aparecen en la lista. Por cada contador ves el tipo, un indicador de estado y la última lectura. Con el menú (...) eliges **Desvincular de la parcela**; esa opción solo está aquí. La ruta completa hasta el cliente está en [Vincular un contador a un cliente](/meterbeheer/meter-koppelen). ## Tipos de parcela [#terreintypes] Con los tipos de parcela clasificas las parcelas, por ejemplo **Parcela**, **Chalet** o **Plaza de autocaravanas**. El tipo lo ves en la lista de parcelas (columna **Tipo**, con un filtro), puedes colorear el mapa según él y aparece en la exportación. Los gestionas en Soporte > Configuración > Tipos de parcela. La tabla **Todos los tipos de parcela** muestra por tipo el **Nombre**, el **Color del mapa**, la **Descripción** y el número de **Parcelas**. Busca con **Buscar tipos de parcela...**. Con el lápiz editas un tipo, con la papelera lo eliminas. ### Haz clic en Nuevo tipo de parcela [#klik-op-nieuw-terreintype] ### Rellena los datos [#vul-de-gegevens-in-1] Indica un **Nombre**, si quieres una **Descripción**, y elige un **Color del mapa**. El azul viene preseleccionado. ### Haz clic en Crear [#klik-op-aanmaken] Un tipo lo vinculas a una parcela mediante el campo **Tipo de parcela**. El color del mapa lo ves en el plano cuando en **Capas** pones los colores en **Tipo de parcela**, consulta [Mapa](/kaart#lagen-en-kleuren). ## Exportar parcelas [#terreinen-exporteren] Haz clic en **Exportar todas las parcelas** (arriba a la derecha) para descargar un archivo de Excel. Contiene por parcela los datos básicos, el tipo de parcela, los campos personalizados y el cálculo de la tarifa (subtotal, suplementos y total). Úsalo, por ejemplo, para el control anual de tarifas. ## Cómo se determina la tarifa [#hoe-het-tarief-tot-stand-komt] La **Tarifa calculada** se deriva de la fórmula de tarifa de tu organización. La fórmula calcula con la superficie y con los campos personalizados de la parcela. Qué campos personalizados son los decides tú. La fórmula estándar usa los campos con las claves `locationSurcharge`, `gasMeterNumber`, `electricityMeterSurcharge` y `staticPrice`. Si los has creado en Soporte > Configuración > Campos personalizados, funcionan así: 1. **Superficie**: la superficie dibujada, en tramos por m². 2. **Suplemento de contador de gas**: se añade si el campo con el número de contador de gas está rellenado. 3. **Suplemento por ubicación**: el importe que indiques. 4. **Suplemento de electricidad**: el importe que indiques. 5. **Precio fijo**: si este campo está rellenado, ese importe sustituye a la tarifa calculada y Tillor omite la fórmula. Si quieres cambiar la tarifa de un año, modifica los campos personalizados, comprueba en **Tarifa calculada** que sea correcta y guarda con **Actualizar parcela**. ### Fórmula de tarifa [#tariefformule] En Configuración > Tarifa de parcela decides tú cómo se calcula la tarifa. Quien ya podía editar la configuración ha recibido el permiso **Editar la fórmula de tarifa de parcela**. La fórmula es un fragmento de TypeScript (un lenguaje de programación) que devuelve la tarifa anual en euros, o partes con nombre que juntas forman la tarifa, como `Subtotaal` y `Toeslag gasmeter`. Cada parte recibe su propia columna en la exportación. - Los campos de la parcela se leen con `{terrain.veld}`, como `{terrain.surfaceArea}` o `{terrain.customFields.locationSurcharge}`. Con el botón **Variable** o escribiendo `{` eliges entre todos los campos, también los tuyos. - A la derecha de la fórmula la pruebas al momento en una de tus parcelas. Un error lo ves allí con el número de línea. Una fórmula que no funciona no se puede guardar. - Con **Restablecer la predeterminada** vuelves a la fórmula con la que empezó cada organización. - En las automatizaciones lees la tarifa como `{terrain.calculatedTariff.total}`. La fórmula se ejecuta aislada: solo puede calcular con los campos de la parcela, sin otros datos ni internet. Una fórmula que tarda demasiado se interrumpe y entonces no produce tarifa. ## ¿Problemas? [#problemen] La parcela no se ha guardado. Comprueba que el **Nombre** esté rellenado y no tenga más de 255 caracteres, e inténtalo de nuevo. La superficie solo sale de la ubicación en el mapa. Dibuja la parcela en Parque > Mapa, consulta [Mapa](/kaart#terreingrenzen-intekenen). Las parcelas sin ubicación no cuentan en **Superficie total**. Comprueba los campos personalizados de la parcela (suplementos y número de contador de gas). Si hay un **Precio fijo** rellenado, sustituye a la tarifa calculada. Si se ha modificado la fórmula, mira en Tarifa de parcela si la prueba en esta parcela es correcta. Necesitas el permiso **Editar la fórmula de tarifa de parcela**. Pídeselo a tu administrador. Ese contador ya está vinculado a otra parcela. Desvincúlalo primero allí. Una parcela con una ocupación activa no aparece en la lista de selección. Termina primero la ocupación en curso. ## Conceptos [#begrippen] - **Parcela**: un lugar de tu parque. Consulta [Conceptos](/begrippen#terrein). - **Tipo de parcela**: una clasificación como **Parcela** o **Chalet**, con un color del mapa. - **Reservable**: los clientes pueden reservar la parcela en línea. - **Tarifa calculada**: la tarifa que Tillor calcula con la fórmula. - **Campo personalizado**: un campo que tu organización añade. Consulta [Conceptos](/begrippen#eigen-veld). - **Ocupación**: un cliente en una parcela durante un periodo. Consulta [Conceptos](/begrippen#bezetting). ## Ver también [#zie-ook] # Control de acceso (/es-ES/toegangscontrole) Con Control de acceso decides quién puede entrar en tu parque y sigues quién está dentro. Das a un cliente un método de acceso (matrícula, tag NFC, código QR o PIN), manejas las barreras desde tu pantalla y consultas quién pasó, cuándo y por qué punto de acceso. Un método de acceso se crea en el perfil del cliente, consulta [añadir un método de acceso](#een-toegangsmethode-toevoegen). Las cifras de arriba cuentan todos los accesos, las últimas 24 horas, los intentos permitidos y bloqueados y tus puntos de acceso activos. Debajo están las acciones rápidas, los vehículos del parque, el registro de accesos y las operaciones del controlador. - Un vehículo pasa a ser **Fantasma** si no se ha visto en ningún punto de acceso durante 7 días mientras figuraba como **Dentro**. - Un método de acceso QR se crea de una vez hasta 100 unidades, cada una con su propio código. - Un PIN consta de 4 a 8 cifras y debe ser único dentro de tu organización. - Cada matrícula, cada tag NFC y cada código QR solo puede aparecer una vez en tu organización. - Un método de acceso que no esté dentro del periodo de **Fecha de inicio** y **Fecha de fin** no da acceso. - Una matrícula con el estado **Bloqueado parcialmente** solo está bloqueada durante el horario de apertura de la recepción. - Una matrícula caducada puede salir todavía, por defecto, 2 días fuera del horario de apertura (como máximo 30). Consulta [Ajustes de control de acceso](/gebruikers/instellingen-toegangscontrole). - Un vehículo aparece en el perfil del cliente a través de una matrícula registrada, o a través de la tag NFC o el código QR con los que el cliente entró. ## ¿Cómo se relaciona todo? [#hoe-hangt-dit-samen] Un método de acceso es la llave de un cliente. El punto de acceso (la barrera o la puerta) es la cerradura. Entre ambos hay equipos en tu parque: una cámara que lee matrículas o una cajita que lee tags y códigos QR (un controlador de acceso), y el [conector](/connector). El conector es la cajita que conecta Tillor con los dispositivos de tu parque. ```mermaid flowchart TD K[Cliente] --> M[Método de acceso
matrícula, tag NFC, código QR o PIN] M -->|Tillor envía la lista| C[Conector en tu parque] C --> L[Cámara o lector de tarjetas
en la entrada] L -->|permitido| P[El punto de acceso se abre] L -->|rechazado| W[El punto de acceso sigue cerrado] L -->|cada intento se registra| LOG[Registro de accesos en Tillor] ``` Qué significa esto para ti: - Si cambias o eliminas un método de acceso en Tillor, Tillor lo envía a los equipos a través del conector. El resultado lo ves en **Operaciones del controlador**. - Si el conector está sin conexión, los métodos de acceso nuevos o modificados se quedan en **Pendiente** hasta que vuelva a conectarse. - También una barrera que abres desde Tillor suele recibir su orden a través del conector. Si está sin conexión, la barrera no se abre. La sección Controladores del menú principal trata de otra cosa: las pequeñas pantallas con lector de tags junto a duchas, puertas y puntos de carga. Consulta [Controladores](/controllers). Los equipos de las barreras los configura el soporte de Tillor durante la puesta en marcha. ## Manejar los puntos de acceso [#toegangspunten-bedienen] En **Acciones rápidas** hay un botón para cada punto de acceso activo. Este bloque solo lo ves si hay al menos un punto de acceso o un controlador de acceso configurado. ### Haz clic en el botón del punto de acceso [#klik-op-de-knop-van-het-toegangspunt] El rótulo es **Abrir [nombre]**. ### Confirma [#bevestig] Se abre un cuadro de diálogo que pregunta si de verdad quieres abrir el punto de acceso. Haz clic en **Sí, abrir [nombre]**. Tillor muestra **Punto de acceso abierto**. Cerrar solo es posible si el punto de acceso lo admite. Entonces hay una flecha hacia abajo junto al botón de abrir: elige ahí **Cerrar [nombre]** y confirma con **Sí, cerrar [nombre]**. ### Botones de gestión en Acciones rápidas [#beheerknoppen-in-snelle-acties] Junto a los puntos de acceso hay, según tus equipos, botones de mantenimiento. Úsalos solo si algo no cuadra. | Botón | Qué hace | Cuándo | |---|---|---| | **Restablecer APB** | Borra la memoria de quién entró o salió por última vez, por tipo: **Para pases NFC…** o **Para códigos QR…**. | La gente ya no pasa porque la puerta cree que ya están dentro (o fuera). APB significa anti-passback. | | **Sincronizar registros del dispositivo** | Hace que el conector obtenga todas las líneas nuevas de los controladores de acceso. | Faltan pasos recientes en el registro de accesos. | | **Restablecer caché del conector** | El conector borra sus datos locales y vuelve a obtenerlo todo de Tillor. | Los equipos se comportan de forma distinta a los métodos de acceso de Tillor. | | **Limpiar lecturas LPR basura** | Elimina solo las filas fantasma seguras de la lista de matrículas. Las matrículas registradas y vinculadas se conservan. | Hay matrículas en la lista que no pertenecen a nada. | ## Gestionar métodos de acceso desde el perfil del cliente [#toegangsmethoden-beheren-via-het-klantprofiel] Los métodos de acceso se añaden, se modifican y se eliminan en el perfil del cliente. ### Añadir un método de acceso [#een-toegangsmethode-toevoegen] Un método de acceso pertenece a un cliente y da a ese cliente acceso al parque. Los gestionas en el perfil del cliente. Antes de empezar: - El cliente existe en Tillor. - Para NFC necesitas una tag que todavía no pertenezca a nadie. Si no hay ninguna tag libre, la lista dice **No se encontraron tarjetas NFC disponibles, todas las tarjetas ya están asignadas.** - El tipo **Código PIN** solo aparece en la lista si está activado para tu organización. ### Abre la pestaña Control de acceso [#open-het-tabblad-toegangscontrole] Ve a Clientes > cliente > Control de acceso. Arriba está la tabla **Métodos de acceso** (marca **1** en la captura de abajo). ### Haz clic en Añadir y elige el tipo [#klik-op-toevoegen-en-kies-het-type] El tipo no se puede cambiar después. Si necesitas otro tipo, añade un nuevo método de acceso. ### Rellena los datos [#vul-de-gegevens-in] Lo que rellenas depende del tipo: En **Matrícula** introduce la matrícula. Tillor la convierte a mayúsculas. Marca, modelo y color son opcionales. En **Tarjetas NFC** elige una tag libre de la lista. Puedes buscar por el número de la tag. El código lo crea Tillor. Con **Cantidad** creas de una vez hasta 100 métodos de acceso QR distintos, cada uno con su propio código. Marca **Imprimir ticket térmico inmediatamente** para enviar cada QR nuevo al instante a la impresora térmica como ticket de entrada. La dirección de la impresora se define en los ajustes de la organización. En el ticket aparecen **Válido desde** y **Válido hasta** en la zona horaria de tu organización. Introduce de 4 a 8 cifras, o haz clic en **Generar**. El PIN debe ser único dentro de tu organización. En un PIN no está la acción **Sincronizar con el sistema de puertas**. Para cada tipo puedes rellenar además: | Campo | Significado | |---|---| | **Fecha de inicio**, **Fecha de fin** | El periodo en el que funciona el método de acceso. Vacío significa sin límite. | | **Estado** | **Activo**, **Inactivo**, **Bloqueado** o **Bloqueado parcialmente** (consulta [estados](#statussen-van-toegangsmethoden)). | | **Convertir automáticamente a matrícula** | Solo en código QR y PIN. Si alguien usa el código en una puerta con cámara, Tillor sustituye el código por la matrícula leída. Por defecto está desactivado. | | **No renovar automáticamente** | La fecha de fin no cambia cuando se paga una factura con renovación automática. | | **Notas** | Notas internas. | Después haz clic en **Añadir** para guardar. #### ¿Qué pasa después? [#wat-gebeurt-er-daarna] - El método de acceso aparece en la tabla y Tillor lo envía a los equipos a través del conector. Lo sigues en **Operaciones del controlador**, con el estado Pendiente, Procesando, Completado o Fallido. - Un método de acceso modificado o eliminado se transmite del mismo modo. - Cada intento de entrar aparece en el registro de accesos, también los rechazados. - Un vehículo se vincula al cliente a través de una matrícula registrada, o porque el cliente entró con una tag NFC o un código QR mientras la cámara leía también la matrícula. Esto último funciona incluso si la matrícula no está registrada. #### Editar, enviar o eliminar un método de acceso [#een-toegangsmethode-bewerken-versturen-of-verwijderen] Haz clic en los tres puntos a la derecha del método de acceso. | Acción | Para qué | |---|---| | **Editar** | Ajustar el periodo, el estado o los datos del vehículo. | | **Sincronizar con el sistema de puertas** | Volver a enviarlo a los equipos. Tillor muestra **Sincronización solicitada**. No en un PIN. | | **Enviar notificación** | Envía al cliente el enlace QR personal por correo electrónico, SMS o WhatsApp (cuadro **Enviar código QR**). | | **Copiar URL personal** | Copia el enlace al pase del cliente, consulta [Wallet digital](#digitale-wallet-qr-code). | | **Descargar código QR**, **Imprimir ticket térmico** | Solo en un código QR. | | **Eliminar** | Quita el método de acceso. No se puede deshacer. Con las casillas de la tabla eliminas varios a la vez. | #### Estados de los métodos de acceso [#statussen-van-toegangsmethoden] | Estado | Significado | |---|---| | Activo | Da acceso, mientras el periodo sea correcto. | | Inactivo | No da acceso. Funciona como Bloqueado, con un nombre más claro. | | Bloqueado | No da acceso. | | Bloqueado parcialmente | En una matrícula, solo bloqueada durante el horario de apertura de la recepción. Fuera de ese horario el vehículo todavía puede entrar y salir. | ## Wallet digital (código QR) [#digitale-wallet-qr-code] En un método de acceso QR copias un enlace personal para el huésped. Abre la página **Pase de acceso** con el código QR. Si Apple Wallet o Google Wallet están configurados para tu entorno, también hay botones para guardar el pase. ### Copia el enlace [#kopieer-de-link] Abre los tres puntos del método de acceso QR y haz clic en **Copiar URL personal**. Tillor muestra **Enlace copiado**. ### Envía el enlace al huésped [#stuur-de-link-naar-de-gast] El huésped ve el código QR, la validez y, si están disponibles, **Añadir a Apple Wallet** y **Añadir a Google Wallet**. El pase de wallet usa el mismo código QR, validez y estado que en Tillor. En un iPhone con iOS 27, el pase aparece como Poster Generic, con un fondo propio opcional y un código QR cuadrado. Los iPhone más antiguos muestran el diseño clásico. En iOS 27 también hay accesos directos en el pase: **Cómo llegar** abre Apple Maps con la ubicación del punto de acceso (o el centro del mapa del parque) y, si has indicado un sitio web en los datos de tu empresa, se añade un botón a ese sitio. El fondo y la ubicación se definen en **Configuración**, consulta [Organización](/gebruikers/organisaties). En un iPhone, el pase puede aparecer en la pantalla de bloqueo cuando el huésped está cerca. En Android, el huésped guarda el pase en Google Wallet. ### Ver dónde está guardado el pase [#zien-waar-de-pas-is-opgeslagen] Si un huésped ha añadido el pase, junto al valor QR aparece un pequeño icono de wallet, con un número si hay más de un dispositivo. Pasa el ratón por encima para ver: - si el pase está en **Apple Wallet en iPhone** o **Google Wallet en Android**, y en cuántos dispositivos - cuándo fue **Último añadido** y **Pase actualizado**, y en Apple también **Última sincronización** - si el pase fue **Emitido mediante** un **Empleado** o un **Enlace personal** Google no avisa cuando un huésped elimina el pase. En Google Wallet, el pase sigue figurando como guardado. ### Volver a enviar un pase de wallet [#een-wallet-pas-opnieuw-versturen] Si un pase QR cambia, por ejemplo su validez, Tillor envía la actualización por sí mismo a las wallets. Si aun así aparece una versión antigua, elige **Sincronizar pase de Wallet** en el menú. Tillor indica a cuántos dispositivos llegó la actualización. Si el pase todavía no está registrado en ningún sitio, ves **Todavía no hay ningún dispositivo registrado para actualizaciones.** El elemento de menú solo aparece cuando el pase se ha añadido a una wallet. ## Vehículos en el parque [#voertuigen-in-het-park] La tabla **Vehículos en el parque** registra, por matrícula, si un vehículo está dentro. Una lectura en una entrada pone el vehículo en **Dentro**, una lectura en una salida en **Salido**. Cada fila muestra la matrícula, el estado, el cliente, el momento de entrada, el último momento en que se vio el vehículo en un punto de acceso y ese punto de acceso. La tabla muestra por defecto los vehículos que están **Dentro** o son **Fantasma**. Con los filtros muestras también los vehículos que ya salieron, filtras por punto de acceso o buscas por matrícula o nombre del cliente. | Estado | Significado | |---|---| | Dentro | Entró por una entrada y todavía no ha salido. | | Fantasma | Figuraba como Dentro, pero hace 7 días que no se ve en ningún punto de acceso. | | Salido | Salió por una salida. | Un vehículo fantasma suele aparecer porque la cámara no leyó la matrícula al salir, o la leyó mal al entrar. Si la matrícula se vuelve a ver más tarde en una entrada, vuelve a figurar como **Dentro**. ### Ocupación del parque [#parkbezetting] La tarjeta **Ocupación del parque** muestra cuántos vehículos hay dentro: **Actualmente dentro**, el **Pico** en el periodo elegido, y el número de **Entradas** y **Salidas**. El primer gráfico muestra la evolución, por hora hasta una semana y por día en un periodo más largo. **Horas más concurridas** muestra, por hora del día, el número medio de vehículos y de llegadas. Así ves, por ejemplo, cuándo hay suficiente gente para abrir la restauración. Con el selector de periodo de arriba a la derecha eliges hoy, 7 días, 30 días, 90 días, todo o un rango propio. ## Registro de accesos [#toegangslogboek] El registro de accesos muestra cada intento de entrar, con fecha, método de acceso, cliente (si se conoce), punto de acceso y estado. Filtra y busca por matrícula o valor (en NFC también por etiqueta de la tarjeta), rango de fechas, estado, tipo de método de acceso, punto de acceso o cliente. Con **Exportar**, a la derecha de la barra de herramientas, descargas el registro como archivo de Excel. | Estado | Significado | |---|---| | Permitido | Se ha concedido el acceso. | | Bloqueado | Se ha rechazado el acceso. | | Inactivo | El método de acceso está inactivo. | | Caducado | El método de acceso ha caducado. | | No válido | El método de acceso no es válido. | | Denegado | El acceso se ha denegado de forma activa. | | Bloqueado parcialmente | El acceso está bloqueado parcialmente. | | Error del dispositivo | Hubo un problema con el dispositivo. | | Sin vehículo | No se detectó ningún coche. | | APB - Dirección incorrecta | La puerta bloquea el paso porque la dirección no es correcta (anti-passback). | | Desconocido | No se pudo determinar el estado. | | Mensaje del sistema | Un mensaje del propio sistema. | ## Historial de estado de los puntos de acceso [#hekstatusgeschiedenis] Bajo el registro de accesos también está el **Historial de estado de punto de accesos**: cuándo un punto de acceso estuvo **Abierto**, **Cerrado** o **En movimiento**, con el **Origen** del aviso. Si no se conoce la posición, aparece **Desconocido**. Filtra por estado o punto de acceso. Si la lista está vacía, todavía no se han recibido avisos de estado. ## Operaciones del controlador [#controller-operaties] Debajo están las **Operaciones del controlador**. Son las órdenes que Tillor envía a los controladores de acceso, como **Crear**, **Actualizar**, **Eliminar** y **Sincronizar**. Así ves cuándo ha llegado al punto de acceso un pase o un código QR. Una orden está en Pendiente, Procesando, Completado o Fallido. Con el icono del ojo, a la derecha de la fila, abres los detalles. ## ¿Problemas? [#problemen] El bloque solo aparece si hay un punto de acceso o un controlador de acceso configurado. Si no hay nada, el soporte de Tillor todavía no ha vinculado los equipos. El punto de acceso no respondió. Normalmente el conector está sin conexión o no se puede alcanzar el dispositivo. Comprueba el conector, consulta [Conector no conectado](/connector#problemen), e inténtalo de nuevo. Cada matrícula, cada tag NFC y cada código QR solo puede aparecer una vez en tu organización. En el caso de una matrícula, Tillor indica a qué cliente ya está asignada. Elimina o modifica antes ese método de acceso. Mira en el registro de accesos qué estado recibió el intento. **Caducado** o **Inactivo**: comprueba **Fecha de inicio**, **Fecha de fin** y **Estado** del método de acceso. **Bloqueado parcialmente**: la matrícula está bloqueada durante el horario de apertura de la recepción. **Error del dispositivo** o **Sin vehículo**: la cámara no leyó nada, comprueba los equipos. Si el método de acceso está bien pero la puerta sigue rechazando, mira en **Operaciones del controlador** si el último cambio está **Completado**. Mira en **Operaciones del controlador** si la orden está Completado. Si está en **Pendiente**, el conector probablemente esté sin conexión. Si está en **Fallido**, elige **Sincronizar con el sistema de puertas** en el método de acceso. La puerta cree que ya están dentro (o fuera). Haz clic en **Restablecer APB** en Acciones rápidas y elige **Para pases NFC…** o **Para códigos QR…**. Confirma con **Restablecer**. En la lista solo aparecen las tags que todavía no pertenecen a nadie. Quita primero la tag del otro cliente, consulta [Gestionar tags](/nfc/nfc-tags#wat-kun-je-met-een-tag-doen). Hace 7 días que no se ve el vehículo. Normalmente se ha ido sin que la cámara lo viera. Vuelve a estar **Dentro** por sí solo cuando la matrícula se lea de nuevo en una entrada. ## Conceptos [#begrippen] - **Método de acceso**: la llave de un cliente, una matrícula, tag NFC, código QR o PIN. - **Punto de acceso**: la barrera, puerta o portón que se abre. - **Controlador de acceso**: la cajita junto al punto de acceso que lee tags y códigos QR. - **Conector**: la cajita de tu parque que conecta Tillor con los equipos. Consulta [Conector](/connector). - **APB (anti-passback)**: la regla de que no puedes pasar dos veces en la misma dirección por una puerta. - **Vehículo fantasma**: un vehículo que figura como dentro pero que hace 7 días que no se ve. Encontrarás más explicaciones en la [lista de conceptos](/begrippen). ## Ver también [#zie-ook] # Tiempo (/es-ES/weer) En la página **Tiempo** ves, día a día, el tiempo en la ubicación de tu parque, para que puedas comparar un pico de consumo o de afluencia con el tiempo que hacía. Tillor también usa estos datos en los contadores y en las reservas. - El tiempo depende del centro del mapa de tu organización. Si está mal situado, el tiempo no será el correcto. - Tillor obtiene el tiempo cada noche y completa los días pasados que falten. - Por defecto ves los últimos 14 días. - Un día con **Archivo** es definitivo. Un día con **Previsión** todavía puede cambiar. ## Abrir la página [#de-pagina-openen] Ve a Parque > Tiempo. Bajo **Previsión diaria** aparece la ubicación, por ejemplo **Centro del mapa: 50.8503, 4.3517**. Es el centro del mapa de tu parque. Lo defines en Configuración > Mapa. Si lo mueves, el tiempo sigue la nueva ubicación. Consulta [Mapa](/kaart). Verás: - una tarjeta grande para el día más reciente, con la temperatura, el estado del cielo, las temperaturas máxima y mínima y la cantidad de lluvia. Junto al día aparece **Archivo** si el día ya es definitivo, o **Previsión** si todavía puede actualizarse - debajo, una tarjeta por día, con el estado del cielo (**Despejado**, **Parcialmente nublado**, **Nublado**, **Niebla**, **Llovizna**, **Lluvia**, **Chubascos**, **Nieve** o **Tormenta**), las temperaturas máxima y mínima y la lluvia en mm. Hoy tiene un borde de color - **Sin datos para este día** en un día del que Tillor no tiene nada ## Elegir otro periodo [#een-andere-periode-kiezen] Por defecto ves los últimos 14 días. Haz clic arriba a la derecha en **Seleccione un periodo** para elegir otro: **Hoy**, **Ayer**, **Últimos 7 días**, **Último mes**, **Últimos 3 meses**, **Todo** o un **Rango personalizado** en el calendario. Confirma un rango propio con **Aplicar**. ## Aún no hay datos [#nog-geen-weergegevens] Si aparece **Aún no hay datos meteorológicos**, el tiempo todavía no se ha obtenido. Tillor lo obtiene cada noche para el centro del mapa de tu organización y también completa los días pasados que falten. Prueba con otro periodo o vuelve al día siguiente. Comprueba además que el centro del mapa sea correcto. ## Dónde más ves el tiempo [#waar-zie-je-het-weer-nog-meer] - En la página del contador, en **Consumo y tendencias**: en un día pico aparece la temperatura y, si el consumo es elevado, un resumen de los últimos 7 días. Consulta [Gestión de contadores](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen). - En la línea de tiempo de las reservas y en los gráficos de los vehículos del parque, con el tiempo de ese día. ## ¿Problemas? [#problemen] El tiempo todavía no se ha obtenido. Prueba con otro periodo o vuelve al día siguiente, y comprueba que el centro del mapa sea correcto. El centro del mapa está en otro lugar. Muévelo en Configuración > Mapa, consulta [Mapa](/kaart#kaartstandaard-instellen). El tiempo seguirá la nueva ubicación. Tillor no tiene nada de ese día. Se completará solo cuando los datos estén disponibles. ## Ver también [#zie-ook] # Resumen (/es-ES/api-referentie) Esta referencia se genera directamente a partir de la API de Tillor. Cada endpoint tiene su propia página con parámetros, cuerpo de la solicitud, posibles respuestas y ejemplos de código. En la barra lateral, los endpoints están agrupados por tema. ## Enviar una solicitud [#een-request-versturen] Cada solicitud necesita tu clave API en la cabecera `x-api-key`. Los endpoints bajo `/orgs/{organizationId}` funcionan dentro de una organización. ```http GET https://api.tillor.eu/orgs/org_abc123/customers x-api-key: tkn_xxx ``` Una clave API se crea en la aplicación, en tu cuenta. Cómo funciona, qué límites de uso se aplican y cómo guardar las claves de forma segura lo encuentras en [API HTTP](/ontwikkelaars/http). ## Quién puede llamar a un endpoint [#wie-mag-een-endpoint-aanroepen] Cada página de endpoint muestra arriba, en **Acceso**, quién puede llamarlo. En la mayoría de los endpoints es un miembro de la organización con un permiso concreto, como `customers:read`. Una clave API funciona con los permisos de la persona que la creó; si la clave tiene scopes, el permiso también debe estar entre ellos. Si no, la API responde `403`. La especificación lleva la misma información por endpoint en `x-tillor-access`, con `access` (quién) y `permissions` (basta con uno). ## Probar en el playground [#uitproberen-in-de-playground] En cada página de endpoint puedes enviar la solicitud al instante. Si has iniciado sesión en Tillor en el mismo navegador, el playground usa tu sesión y no necesitas una clave API. Si no, introduce tu clave API en **Authorization**. Ajusta los parámetros y haz clic en **Send**. El playground se comunica con la API real de tu organización: un `POST`, `PUT` o `DELETE` modifica por tanto datos reales. Prueba los endpoints de escritura en una organización de prueba, no en tu parque en uso. ## Descargar la especificación [#specificatie-downloaden] La especificación completa está disponible como OpenAPI 3.1 en [tillor.eu/api/openapi.json](https://tillor.eu/api/openapi.json). Impórtala en Postman o Insomnia, o genera un cliente a partir de ella. ## Ver también [#zie-ook] # Gestionar un controlador (/es-ES/controllers/controller-beheren) En la página de un controlador ajustas sus datos y realizas el mantenimiento. Ajustes como ACL, red y actualizaciones están por separado en [Configuración del controlador](/controllers/settings). Antes de empezar: - El controlador está aprobado, consulta [Vincular un controlador](/controllers/controller-koppelen). ## Cambiar nombre, tipo y grupo [#naam-type-en-groep-wijzigen] ### Abre el controlador [#open-de-controller] Ve a Controladores > Resumen y haz clic en el controlador. ### Ajusta el formulario [#pas-het-formulier-aan] En **Configuración del controlador** eliges el **Nombre**, el **Tipo** (**Ducha**, **Acceso** o **Punto de carga**) y el **Grupo**. ### Haz clic en Guardar [#klik-op-opslaan] Tillor muestra **Controlador actualizado** y envía los ajustes al controlador. ## Reiniciar un controlador [#een-controller-herstarten] Si un controlador no responde bien, reinícialo desde Tillor. Abre el menú de acciones (los tres puntos) y elige **Reiniciar controlador**. Haz clic en el icono de reinicio en la fila del controlador. La pantalla muestra **Reiniciando** y después el controlador se vuelve a conectar. El menú de acciones también tiene **Ver registros en Grafana**. Abre los registros del controlador en otro programa, pensado para el soporte. En la propia página del controlador, los registros recientes están en la tarjeta **Consola**. ## Actualizar a una nueva versión [#bijwerken-naar-een-nieuwe-versie] Si junto al número de versión hay una flecha hacia arriba, hay un firmware (software) más reciente disponible. Pasa el cursor por encima para ver la versión (**Actualización disponible**) y haz clic para iniciar la actualización. Tillor muestra **Actualización OTA iniciada**. Cuándo se actualizan los controladores por sí solos, lo lees en [Actualizaciones de firmware](/controllers/updates). ## Eliminar un controlador [#een-controller-verwijderen] En el menú de acciones elige **Eliminar controlador** y confirma en **Eliminar controlador**. El controlador desaparece de tu lista. Después puede volver a solicitar su adopción. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - Tras un reinicio, el controlador se vuelve a conectar con Tillor. Tarda un momento. - Tras la actualización, el controlador se reinicia solo. Deja la corriente conectada mientras la pantalla muestra **Actualizando** con un porcentaje. - Un controlador eliminado ya no da acceso. ## ¿Problemas? [#problemen] No se pudo reiniciar el controlador, normalmente porque está sin conexión. Comprueba la corriente y la red, consulta [Problemas de conexión](/controllers/troubleshooting/verbinding). No se pudo iniciar la actualización. Comprueba que el controlador esté en línea y que **Omitir actualizaciones OTA** esté en **No**, consulta [Actualizaciones de firmware](/controllers/updates). No se pudo guardar el formulario. Inténtalo de nuevo y comprueba que el nombre esté rellenado. ## Ver también [#zie-ook] # Vincular un controlador (/es-ES/controllers/controller-koppelen) Un controlador nuevo solo funciona para tu organización después de que lo hayas aprobado. Esto se llama adopción: le dices a Tillor que esta cajita pertenece a tu parque. Después puedes asignarle un tipo y un grupo, consulta [Gestionar un controlador](/controllers/controller-beheren). Antes de empezar: - Tienes corriente y una red (cable o wifi) en el lugar donde irá el controlador. - Si usas wifi, tienes a mano el nombre de la red y la contraseña. - Abre Tillor preferiblemente en la misma red que el controlador. De lo contrario, a veces no verás su solicitud. ## Conectar y aprobar el controlador [#de-controller-aansluiten-en-goedkeuren] ### Conecta el controlador [#sluit-de-controller-aan] Enchufa la corriente. La pantalla muestra **Conectando...** y después lo que todavía falta. ### Dale una red [#geef-hem-een-netwerk] Conecta el cable de red. El controlador se conecta solo, no tienes que configurar nada. Toca en la pantalla **Configurar Wi-Fi**, elige tu red, escribe la contraseña y confirma. La pantalla muestra **Conectado**. Consulta [Configurar el wifi en la pantalla](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). ### Abre Controladores en Tillor [#open-controllers-in-tillor] Ve a Controladores > Resumen. En cuanto el controlador tenga conexión, aparece en la lista con el aviso **Pendiente de aprobación**. La pantalla del controlador muestra **Activar controlador** con el número del dispositivo. Ese número es el eFuse ID, el número de serie de la cajita. Comprueba que sea el mismo que en la lista. ### Haz clic en Aprobar [#klik-op-goedkeuren] Haz clic en la marca de verificación (**Aprobar**) de la fila. Tillor muestra **Aprobado** y el controlador queda añadido a tu organización. ## ¿Qué pasa después? [#wat-gebeurt-er-daarna] - La pantalla del controlador muestra **Escanear QR** y **Escanea tu tag**. Ya está listo para usarse. - Tillor envía automáticamente al controlador los datos de conexión y los ajustes. No tienes que rellenar nada. - Su primer escaneo crea el tag en Tillor, si todavía no existía. - Con la cruz (**Rechazar**) rechazas una solicitud. Entonces el controlador no obtiene acceso a tu organización. - Si más adelante retiras o sustituyes un controlador, elimínalo, consulta [Gestionar un controlador](/controllers/controller-beheren#een-controller-verwijderen). Después puede volver a enviar una solicitud. ## ¿Problemas? [#problemen] La pantalla debe mostrar **Activar controlador** antes de que aparezca. Si todavía muestra **Configurar Wi-Fi** o **Conectando...**, aún no está en línea. Abre también Tillor desde la misma red que el controlador y actualiza la página. Más pasos en [El controlador no aparece en Tillor](/controllers/troubleshooting/verbinding#controller-verschijnt-niet-in-tillor). No se pudo aprobar la adopción. Inténtalo de nuevo. Si sigue fallando, comprueba que el reloj del controlador sea correcto y ponte en contacto con el soporte. Consulta [Adopción fallida](/controllers/troubleshooting/verbinding#adoptie-mislukt-of-credentials-worden-geweigerd). Espera de 1 a 2 minutos. Si sigue igual, comprueba el cable o la señal wifi. Consulta [La pantalla se queda en Conectando...](/controllers/troubleshooting/verbinding#scherm-blijft-op-verbinden). ## Ver también [#zie-ook] # Resumen (/es-ES/controllers) Un controlador es una pequeña caja con una pantalla táctil redonda en tu parque, junto a una ducha, una puerta o un punto de carga. Un huésped acerca una tag NFC, o escanea el código QR de la pantalla, y Tillor decide si se permite. Aquí lees qué hace un controlador y cómo se relaciona con los clientes y el saldo. Un controlador nuevo se pone en marcha en [Vincular un controlador](/controllers/controller-koppelen). Los controladores están en el menú principal, en **Controladores**. Las barreras y los controladores de acceso de tu entrada no forman parte de ellos, consulta [Control de acceso](/toegangscontrole). - Un controlador se comunica con Tillor cada 15 segundos. Tras unos 35 segundos sin contacto, Tillor lo muestra como sin conexión. - Tras 5 minutos sin contacto, el equipo de Tillor recibe un aviso. - Un controlador recuerda como máximo 8 redes wifi. - El control de acceso mediante el controlador (ACL) está desactivado por defecto. Activa **ACL habilitado** en los [ajustes](/controllers/settings) para que se compruebe la tag. - Por defecto comprueba cada día si hay una nueva versión del software. Una actualización solo empieza dentro de la ventana de actualización, si la has definido. - Por defecto espera 1000 milisegundos (1 segundo) a Tillor antes de cambiar de método, en el ajuste **Tiempo de espera API ACL**. - Con una interrupción breve, el pago con una tag sigue funcionando. El pago mediante el código QR deja de funcionar durante un momento. ## ¿Cómo se relaciona todo? [#hoe-hangt-dit-samen] El controlador no decide por sí mismo quién puede pasar. Lee la tag y se lo pregunta a Tillor. Allí consta a qué cliente pertenece la tag, para qué grupos de acceso vale y cuánto saldo tiene. ```mermaid flowchart TD G[El huésped acerca la tag a la pantalla] --> C[Controlador] C -->|pregunta si se permite| T[Tillor] T --> K[Cliente de la tag] T --> A[Grupos de acceso y saldo] T -->|permitir o rechazar| C C -->|muestra el resultado| G T --> TR[Transacción en el historial de la tag] ``` - Cada controlador tiene un **Tipo** (**Ducha**, **Acceso** o **Punto de carga**) y, si quieres, un **Grupo**. Qué tags pueden usarlo lo regulas con los grupos de acceso de la tag, consulta [Gestionar tags](/nfc/nfc-tags). - Si el controlador no puede alcanzar Tillor por un momento, con **Local primero** usa los datos que ha recordado él mismo, consulta [Configuración](/controllers/settings). - Una tag que todavía no está en Tillor se crea en cuanto se acerca por primera vez a un controlador. ## ¿Qué ves en Tillor? [#wat-zie-je-in-tillor] - **Resumen de controladores**: todos los controladores con su versión, tipo, grupo, uso y cuándo fueron **Visto por última vez**. Los controladores que quieren vincularse aparecen como **Pendiente de aprobación**. - **Detalle del controlador**: estado, red, cuánta carga tiene el controlador, las redes wifi, los eventos y la tarjeta **Consola** con los registros. - **Gestión**: reiniciar, actualizar y eliminar, consulta [Gestionar un controlador](/controllers/controller-beheren). ## Componentes [#onderdelen] ## Conceptos [#begrippen] - **Controlador**: la cajita con pantalla y lector de tags. - **Tag**: la tarjeta, pulsera o llavero de un huésped. Consulta [NFC](/nfc). - **Adopción**: vinculas un controlador nuevo a tu organización. - **ACL**: la lista que determina si una tag puede pasar. Consulta [el glosario](/controllers/lexicon). - **Firmware**: el software de la cajita. Encontrarás más explicaciones en la [lista de conceptos](/begrippen). # Glosario (/es-ES/controllers/lexicon) Un resumen de los términos que te encuentras al trabajar con controladores. Cada término tiene una explicación y, en una cita, lo que queremos decir con él en lenguaje sencillo. ## A [#a] ## C [#c] ## E [#e] ## F [#f] ## N [#n] ## O [#o] ## R [#r] ## P [#s] ## T [#t] ## V [#u] # Configuración del controlador (/es-ES/controllers/settings) Esta es una página de consulta sobre los ajustes de un controlador. Los encuentras en Controladores > Resumen > [nombre del controlador], en el formulario bajo la cabecera. Haz clic en **Guardar** para aplicar los cambios. Después, Tillor envía los ajustes al controlador. Nombre, tipo y grupo se cambian en [Gestionar un controlador](/controllers/controller-beheren). ## Configuración de ACL [#acl-configuratie] La ACL (Access Control List) determina cómo comprueba el acceso el controlador. *Es decir: cómo comprueba la cajita si una tarjeta puede pasar.* | Ajuste | Significado | | ---------- | --------- | | **ACL habilitado** | Ponlo en **Sí** para usar el control de acceso mediante el controlador. En **No**, las tarjetas se escanean pero no se validan. Por defecto está en **No**. | | **Prioridad ACL** | **Local primero**: el controlador comprueba primero su propia memoria y después Tillor. *Útil si internet se cae un momento.* **API primero**: preguntar siempre directamente a Tillor. Por defecto **Local primero**. | | **Tiempo de espera API ACL** | Cuánto tiempo (en milisegundos) espera el controlador a Tillor antes de cambiar de método. Por defecto 1000 ms (1 segundo). | Elige **Local primero** si quieres que el controlador funcione también durante cortes temporales de internet. El controlador guarda los derechos de acceso en local. ## Configuración de internet [#internetconfiguratie] | Ajuste | Significado | | ---------- | --------- | | **Conexión de red principal** | **WiFi** o **Ethernet** (cable de red). Es la conexión que el controlador intenta primero. Por defecto **WiFi**. | | **Redes Wi-Fi** | La lista de redes wifi que conoce el controlador, con un máximo de 8. Consulta [Configurar redes wifi](/controllers/wifi-netwerken). | ## Configuración de actualizaciones [#updateconfiguratie] Consulta [Actualizaciones de firmware](/controllers/updates) para una explicación detallada sobre la frecuencia de actualización, la ventana de actualización y cómo omitir las actualizaciones OTA. | Ajuste | Significado | | ---------- | --------- | | **Frecuencia de actualización** | Cada cuánto mira la cajita si hay una versión nueva: **Cada hora**, **Diaria** o **Semanal**. | | **Período de actualización desde/hasta** | *¿Cuándo puede actualizarse la cajita?* Por ejemplo, 02:00-04:00 = solo de noche. | | **Omitir actualizaciones OTA** | Ponlo en **Sí** si la cajita ya no debe obtener actualizaciones. *Útil de forma temporal, pero normalmente lo dejas en No.* | ## Control del relé [#relais-aansturing] El relé es un interruptor de la cajita. *Puedes usarlo, por ejemplo, para abrir o cerrar un punto de acceso.* | Ajuste | Significado | | ---------- | --------- | | **Tipo de relé** | Actualmente solo se admite **Interno**. | | **Puerto del relé** | Número de puerto del relé. Por defecto 1. | ## Ver también [#zie-ook] # Avisos en pantalla (/es-ES/controllers/troubleshooting/scherm) El controlador tiene una pantalla táctil redonda. Muestra en lenguaje sencillo lo que hace el controlador: un título, una línea de explicación debajo y un borde de color. *Así que ya no tienes que memorizar colores: simplemente lo pone.* A continuación encuentras cada aviso y lo que debes hacer. ## Listo para usar [#klaar-voor-gebruik] | En la pantalla | Significado | | ------------- | --------- | | **Escanear QR** y **Escanea tu tag**, con **A pagar** y un importe | El controlador está listo. El huésped acerca una tag a la pantalla o escanea el código QR con el móvil. | | Código QR en gris y tachado | El controlador no tiene conexión con Tillor por el momento. El pago con una tag sigue funcionando; el pago en línea mediante el código QR no, durante un momento. | ## Escanear una tag [#een-tag-scannen] Una tag NFC se escanea acercándola brevemente a la pantalla, como en un pago sin contacto. | En la pantalla | Significado | | ------------- | --------- | | **Un momento** - Procesando pago | La tag se ha leído y el controlador pregunta a Tillor si se permite. Mantén la tag un poco más junto a la pantalla. | | **¡Pago exitoso!** con el importe cargado y el saldo | Pagado. La ducha o el aparato se pone en marcha. | | **Bienvenido** con el nombre del huésped | Acceso concedido, en una puerta o instalación sin pago. | Si se rechaza una tag, el motivo aparece en la pantalla: | En la pantalla | Qué ocurre | Qué debes hacer | | ------------- | --------------------- | ---------- | | **Tag no reconocida** - Esta tag no pertenece aquí | La tag no es de tu parque. | Dale al huésped una tag del parque. | | **Tag no reconocida** - Esta no es una tag válida | El controlador no puede leer este tipo de tag. | Usa una tag que hayas recibido a través de Tillor. | | **Error de escaneo** - Tag mal leída | La tag se retiró demasiado rápido. | Vuelve a acercar la tag a la pantalla, un poco más de tiempo. | | **Pago rechazado** - Sin acceso | La tag no puede usar este controlador. | Comprueba en Tillor el grupo de acceso de la tag. | | **Pago rechazado** - Tag no vinculada | La tag todavía no está asociada a un cliente. | Vincula la tag al cliente en Tillor. | | **Pago rechazado** - Saldo insuficiente | Hay muy poco saldo en la tag. Se indica el saldo. | Recarga la tag en la recepción. | | **Servidor no disponible** | No se pudo procesar el pago. | Inténtalo más tarde; consulta [Problemas de conexión](/controllers/troubleshooting/verbinding). | | **Error al actualizar la tag** | No se pudo guardar el saldo en la tag. | Vuelve a acercar la tag a la pantalla y déjala ahí hasta que desaparezca el aviso. | Dejar la tag apoyada en la pantalla no tiene efecto: cada presentación cuenta como un solo escaneo. Si quieres escanear de nuevo, retira la tag y vuelve a acercarla a la pantalla. ## Arranque y conexión [#opstarten-en-verbinden] | En la pantalla | Borde | Significado | Qué debes hacer | | ------------- | ---- | --------- | ---------- | | **Conectando...** | Azul | El controlador arranca y busca conexión con internet y con Tillor. | Espera 1-2 minutos. | | **Configurar wifi** - Elige una red wifi en la pantalla | Morado | El controlador todavía no tiene red. | Toca **Configurar Wi-Fi** y elige tu red; consulta [Configurar el wifi en la pantalla](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). | | **Configurar wifi** - Credenciales wifi rechazadas | Morado | La contraseña (ya) no es correcta. | Vuelve a introducir la contraseña en la pantalla. | | **Activar controlador** - Activa el dispositivo … en Tillor | Morado | El controlador espera la adopción. | En Tillor ve a **Controladores** y haz clic en **Aprobar** (✓). | | **Conexión perdida** - reintentando | Rojo | Se ha perdido la conexión a internet. El controlador lo vuelve a intentar solo. | Consulta [Problemas de conexión](/controllers/troubleshooting/verbinding#verbinding-verbroken). | | **Conexión perdida** - Demasiado tiempo sin conexión | Rojo | El controlador lleva demasiado tiempo sin conexión. Los pagos están desactivados hasta que se recupere la conexión. | Restablece la conexión de red. | ## Actualizaciones y reinicios [#updates-en-herstarten] | En la pantalla | Borde | Significado | | ------------- | ---- | --------- | | **Actualizando** con un porcentaje | Ámbar | Se está descargando e instalando una actualización de firmware. Deja la corriente conectada. | | **Reiniciando** | Amarillo | El controlador se reinicia, tras una actualización o porque hiciste clic en **Reiniciar controlador** en Tillor. | ## Averías [#storingen] | En la pantalla | Significado | Qué debes hacer | | ------------- | --------- | ---------- | | **Lector de tags no disponible** | El lector de tags no arranca. El controlador intenta repararlo por sí mismo. | Espera un minuto. Si el aviso sigue, [reinicia el controlador](/controllers/controller-beheren#een-controller-herstarten). | | **Sin conexión** - Conectando con el controlador | La pantalla no recibe señal del resto del controlador. | Reinicia el controlador. Si sigue igual, ponte en contacto con el soporte de Tillor. | | La pantalla sigue en negro | El controlador no tiene corriente. | Comprueba la alimentación y el cableado. | ## Ver también [#zie-ook] # Problemas de conexión (/es-ES/controllers/troubleshooting/verbinding) Si el controlador no se conecta bien, su pantalla te dice dónde falla. A continuación encontrarás, para cada aviso, qué ocurre y qué hacer. Todos los avisos están en [Avisos en pantalla](/controllers/troubleshooting/scherm). ## Configurar el Wi-Fi en la pantalla [#wifi-instellen-op-het-scherm] Si en la pantalla aparece **Configurar Wi-Fi**, el controlador todavía no tiene red. Con un cable de red (Ethernet) no tienes que hacer nada; para el Wi-Fi, configura la red en el propio controlador: 1. Toca **Configurar Wi-Fi** 2. Elige tu red en la lista. Junto a cada red aparece la intensidad de la señal: verde es buena, naranja es regular, rojo es débil 3. Escribe la contraseña con el teclado de la pantalla y confirma 4. La pantalla muestra **Conectado** - el Wi-Fi está configurado Si tu red no aparece, toca buscar de nuevo. Si más adelante quieres cambiar la red, mantén el dedo pulsado en la pantalla mientras el controlador está listo, o cámbiala en los [ajustes](/controllers/settings#internetconfiguratie) de Tillor. | Aviso | Solución | | ------- | --------- | | **Conexión fallida** - Comprueba la contraseña | Vuelve a escribir la contraseña; fíjate en las mayúsculas. | | **Conexión fallida** - Red no encontrada | Acerca el controlador al punto de acceso o elige otra red. | | **Conexión fallida** - Ha fallado la búsqueda de redes | Toca buscar de nuevo. Si sigue igual, reinicia el controlador. | | **Configurar Wi-Fi** - Credenciales wifi rechazadas | La contraseña guardada ya no es correcta. Vuelve a introducirla en la pantalla. | ## Activar controlador [#controller-activeren] **Significado:** El controlador está esperando la adopción: todavía no está vinculado a Tillor. *El aparato está listo, pero aún no sabe a qué organización pertenece.* En la pantalla aparece **Activar controlador** con el número del dispositivo. **Solución:** 1. En Tillor, ve a **Controladores** 2. Busca la fila **Pendiente de aprobación** con el mismo número (el eFuse ID) 3. Haz clic en **Aprobar** (✓) para vincular el controlador a tu organización ## Conexión perdida [#verbinding-verbroken] **Significado:** Se ha perdido la conexión a internet. El controlador intenta volver a conectarse automáticamente. *El aparato ha perdido el contacto con Tillor e intenta recuperarlo.* Mientras la interrupción sea breve, los huéspedes pueden seguir pagando con su tag; el código QR aparece entonces en gris y tachado. Si aparece **Demasiado tiempo sin conexión**, los pagos quedan desactivados hasta que vuelva la conexión. En Tillor, el controlador aparece como sin conexión tras unos 35 segundos sin contacto. Pasados 5 minutos, el equipo de Tillor recibe un aviso. **Posibles causas:** - **Se ha perdido el Wi-Fi** - comprueba que la red wifi está disponible - **Avería de internet** - el controlador no puede llegar a Tillor - **Tillor no está disponible temporalmente** **Solución:** - Espera unos minutos - el controlador intenta volver a conectarse por sí solo - Comprueba si otros dispositivos de la misma red tienen internet - Revisa los [ajustes de wifi](/controllers/settings) del controlador (nombre de la red, contraseña) - Asegúrate de que el controlador está al alcance del punto de acceso wifi, o usa un cable de red ## La pantalla se queda en Conectando... [#scherm-blijft-op-verbinden] **Significado:** El controlador todavía se está iniciando o conectando. Debajo del título aparece el paso en el que está, por ejemplo *Estableciendo la conexión a internet* o *Buscando actualizaciones*. **Solución:** - Espera 1-2 minutos - el arranque tarda un poco - Si se queda en *Estableciendo la conexión a internet*: comprueba el cable de red o [vuelve a configurar el wifi](#wifi-instellen-op-het-scherm) - Comprueba que la señal wifi es lo bastante fuerte ## El controlador no aparece en Tillor [#controller-verschijnt-niet-in-tillor] **Significado:** El controlador todavía no es visible para la adopción. **Posibles causas:** - El controlador no tiene conexión a internet (no puede llegar a Tillor) - El controlador todavía se está iniciando - Abres Tillor desde una red distinta de aquella a la que está conectado el controlador - en ese caso, a veces las solicitudes de adopción no se ven **Solución:** 1. Comprueba que el controlador tiene corriente y que la pantalla está encendida 2. Mira qué muestra la pantalla: con **Configurar Wi-Fi** o **Conectando...** todavía no está en línea 3. Espera a que la pantalla muestre **Activar controlador** y a que aparezca la fila **Pendiente de aprobación** en la lista - puede tardar un poco 4. Abre Tillor desde la misma red que el controlador, o ponte en contacto con soporte 5. Actualiza la página Controladores en Tillor (las solicitudes nuevas también aparecen automáticamente) ## La adopción falla o se rechazan las credenciales [#adoptie-mislukt-of-credentials-worden-geweigerd] La adopción es la vinculación del controlador a tu organización; las credenciales son los datos de conexión que forman parte de ella. **Significado:** No se ha podido vincular con Tillor. *El aparato no se ha podido vincular a tu organización.* **Solución:** - Comprueba que el reloj del controlador es correcto (una gran desviación horaria puede bloquear la vinculación) - Tras flashear el firmware o cambiar la clave, hay que volver a aprobar el controlador - Vuelve a intentar la adopción con **Aprobar** (✓) - Ponte en contacto con soporte si el problema persiste - tienen acceso a los registros ## La actualización OTA se queda colgada o falla [#ota-update-blijft-hangen-of-faalt] Una actualización OTA es una actualización del firmware a través de internet. Durante una actualización, la pantalla muestra **Actualizando** con un porcentaje. **Significado:** La actualización del firmware no se ha completado. *El aparato intentó instalar software nuevo, pero no salió bien.* **Solución:** - Espera a que esté activa la [ventana de actualización](/controllers/updates) - las actualizaciones solo se hacen dentro de esa ventana - Comprueba que el controlador tiene una conexión a internet estable - Activa temporalmente [Omitir actualizaciones OTA](/controllers/updates#ota-updates-overslaan) si primero quieres que el controlador quede estable ## Véase también [#zie-ook] # Actualizaciones de firmware (/es-ES/controllers/updates) Un controlador descarga por sí mismo el software nuevo a través de internet, como tu teléfono. Ese software se llama firmware. Tú decides **cuándo** y **con qué frecuencia** puede hacerlo. Por defecto, comprueba a diario si hay algo nuevo. Si quieres iniciar una actualización de inmediato, hazlo desde la página del controlador, consulta [Gestionar un controlador](/controllers/controller-beheren#bijwerken-naar-een-nieuwe-versie). ## Frecuencia de actualización [#updatefrequentie] El controlador comprueba periódicamente si hay una versión nueva del firmware: | Opción | Significado | | ----- | --------- | | **Cada hora** | Comprueba si hay actualizaciones cada hora. | | **Diariamente** | Comprueba una vez al día (por defecto). | | **Semanalmente** | Comprueba una vez a la semana. | Tras la comprobación, solo se ejecuta una actualización si hay una versión más reciente. Si has configurado una ventana de actualización, la hora actual también tiene que estar dentro de esa ventana. *Es decir: el aparato mira si hay algo nuevo, pero solo lo instala en los horarios que tú hayas configurado.* ## Ventana de actualización [#updatevenster] La ventana de actualización es el intervalo de tiempo en el que el controlador puede actualizarse. Si has rellenado **Período de actualización desde** y **Período de actualización hasta**, las actualizaciones solo se ejecutan dentro de ese horario. *En pocas palabras: tú eliges cuándo puede actualizarse el aparato, por ejemplo solo por la noche.* **Ejemplo:** Si pones **Período de actualización desde** a las 02:00 y **Período de actualización hasta** a las 04:00, una actualización solo se realiza entre las 02:00 y las 04:00. Así evitas que el controlador se reinicie a mediodía, en las horas de más actividad. ### Configurar [#instellen] 1. Ve a Controladores > Resumen > [nombre del controlador] 2. Desplázate hasta **Configuración de actualizaciones** 3. Elige **Frecuencia de actualización** (Cada hora, Diariamente o Semanalmente) 4. Rellena **Período de actualización desde** (p. ej. 02:00) 5. Rellena **Período de actualización hasta** (p. ej. 04:00) 6. Haz clic en **Guardar** ## Omitir actualizaciones OTA [#ota-updates-overslaan] OTA significa Over-The-Air: actualizaciones a través de internet. Si pones **Omitir actualizaciones OTA** en **Sí**, el controlador deja de instalar firmware nuevo. El controlador se queda en la versión actual. *Es decir: el aparato ya no se actualiza por OTA.* **¿Cuándo usarlo?** - Temporalmente, si no quieres cambios durante un periodo de mucha actividad - Para controladores de prueba o de demostración que deben quedarse en una versión fija Deja **Omitir actualizaciones OTA** en **No** por defecto. Las actualizaciones suelen incluir mejoras y correcciones de seguridad. ## ¿Qué ocurre durante una actualización? [#wat-gebeurt-er-tijdens-een-update] 1. El controlador detecta una versión nueva del firmware 2. Se descarga el firmware 3. La pantalla muestra **Actualizando** con un porcentaje - el controlador se está actualizando 4. El controlador se reinicia automáticamente; la pantalla muestra **Reiniciando** 5. Tras el reinicio, la versión nueva está activa ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Una actualización solo empieza si hay una versión más reciente y la hora está dentro de tu ventana de actualización. - Durante la actualización y el reinicio, la pantalla muestra **Actualizando** y **Reiniciando**. Por eso conviene programar la ventana por la noche. - Si pones **Omitir actualizaciones OTA** en **Sí**, el controlador se queda en su versión actual hasta que lo vuelvas a cambiar. ## ¿Problemas? [#problemen] Comprueba que **Omitir actualizaciones OTA** está en **No** y que la hora está dentro de tu ventana de actualización. Comprueba también la conexión a internet del controlador. Encontrarás más en [La actualización OTA se queda colgada o falla](/controllers/troubleshooting/verbinding#ota-update-blijft-hangen-of-faalt). Deja el controlador enchufado y espera unos minutos. Si sigue igual, reinicia el controlador y ponte en contacto con soporte. No se ha podido iniciar la actualización. Comprueba que el controlador está en línea e inténtalo de nuevo. ## Véase también [#zie-ook] # Configurar redes Wi-Fi (/es-ES/controllers/wifi-netwerken) Un controlador puede conocer varias redes Wi-Fi y cambia por sí solo a la mejor. Es útil si tu parque tiene un punto de acceso propio en distintos lugares. Las configuras en la página del controlador. Si el controlador todavía no tiene red, es mejor configurar el wifi en la propia pantalla, consulta [Configurar el Wi-Fi en la pantalla](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). Antes de empezar: - El controlador está aprobado, consulta [Vincular un controlador](/controllers/controller-koppelen). - Conoces el nombre (SSID) y la contraseña de cada red. Una red abierta no tiene contraseña. ## Añadir redes [#netwerken-toevoegen] ### Abre el controlador [#open-de-controller] Ve a Controladores > Resumen y haz clic en el controlador. Desplázate hasta **Redes Wi-Fi**. ### Añade una red [#voeg-een-netwerk-toe] Haz clic en **Añadir red** y rellena el **Nombre de la red (SSID)** y la **Contraseña**. Deja la contraseña vacía para una red abierta. Repite el proceso con cada red. ### Ponlas en orden [#zet-ze-in-volgorde] Arrastra una fila por el asa de la izquierda. El orden es la prioridad: el controlador prueba las redes que tiene al alcance de arriba abajo. ### Haz clic en Guardar [#klik-op-opslaan] El botón **Guardar** está al final del formulario. Después, Tillor envía la lista al controlador. Para quitar una red, usa el botón de menos (**Eliminar red**). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - El controlador comprueba cada red por separado. Si la primera red desaparece o la contraseña no es correcta, usa la siguiente. - En la página de detalle, en **Redes Wi-Fi conocidas, por prioridad**, ves cómo va cada red: | Estado | Significado | |---|---| | Conectado | El controlador usa esta red ahora. | | Verificado | La red funciona, pero el controlador usa ahora otra red. | | Aún sin verificar | El controlador todavía no ha podido probar esta red. | | Fallido | La red no funciona. Aparece el motivo, por ejemplo contraseña incorrecta, red no encontrada o sin acceso a internet. | - Para cada red se indica si está **al alcance** o **fuera de alcance**, a veces con la intensidad de la señal en dBm. Las redes introducidas en la pantalla llevan la indicación **añadida en la pantalla**. - Si la lista está vacía, no hay redes configuradas en Tillor. Las redes que alguien añadió en la pantalla se conservan en el controlador. - Los controladores más antiguos, que solo conocen una red, muestran en su lugar un único aviso sobre el último cambio, como **Cambio de wifi aún no confirmado** o **Credenciales wifi rechazadas**. El controlador sigue conectado a la red anterior. ## ¿Problemas? [#problemen] Un controlador recuerda como máximo 8 redes. Tillor lo indica con **Un controlador recuerda hasta 8 redes.** Elimina primero una red que ya no necesites. Una fila no tiene nombre de red. Rellena el nombre o elimina la fila. Cada nombre de red solo puede aparecer una vez. Quita la fila duplicada. Lee el motivo junto a la red. Comprueba el nombre y la contraseña. El controlador lo vuelve a intentar por sí solo y las demás redes siguen funcionando. ## Véase también [#zie-ook] # Manual de Tillor (/es-ES) Explicaciones por tarea para la recepción, la administración y el servicio técnico. Busca lo que quieres hacer, o empieza por tu función. }> - [Buscar o crear un cliente](/klantenbeheer) - [Crear una reserva](/reserveringen) - [Registrar la entrada de un huésped con una ocupación](/bezettingen#een-bezetting-aanmaken) - [Responder mensajes en la bandeja de entrada](/inbox) }> - [Crear y contabilizar una factura](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken) - [Registrar un pago](/facturen/betalingen-registreren) - [Prorrogar una ocupación mediante factura](/bezettingen#facturatie-bezetting-verlengen) - [Informes de pago para tu contabilidad](/boekhouden/betalingsrapporten) }> - [Abrir o cerrar un punto de acceso](/toegangscontrole#toegangspunten-bedienen) - [Vincular un contador a una parcela](/meterbeheer/meter-koppelen) - [¿Qué significa el aviso en la pantalla?](/controllers/troubleshooting/scherm) - [Configurar un quiosco](/mobiele-app/kiosk-inrichten) }> - [Crear una clave de API](/ontwikkelaars/http) - [Recibir webhooks](/ontwikkelaars/webhooks) - [Eventos en tiempo real con SSE](/ontwikkelaars/sse) - [Conectar herramientas de IA con MCP](/ontwikkelaars/mcp) } /> } /> } /> } /> } /> } /> # Enviar una orden a una tableta (/es-ES/mobiele-app/acties-op-afstand) A la derecha de la página del dispositivo está el panel **Acciones remotas**, sea cual sea la pestaña que tengas abierta. Desde ahí envías una orden al dispositivo y solicitas una captura de pantalla. Lo que el propio dispositivo comunica lo lees en [Diagnóstico e historial](/mobiele-app/diagnose-en-geschiedenis). Antes de empezar: - El dispositivo debe estar conectado. Una orden viaja por la conexión en directo con la aplicación. Si el dispositivo está sin conexión, el panel dice **El dispositivo está sin conexión: los comandos solo llegan cuando vuelva a estar conectado.** Tillor indica entonces que la orden se ha enviado, pero la tableta no la ve. - **Reiniciar el dispositivo** solo funciona si Tillor es el propietario de la tableta. Consulta [Configurar un quiosco](/mobiele-app/kiosk-inrichten). ## Enviar una orden [#een-opdracht-versturen] ### Abre el dispositivo [#open-het-toestel] Ve a Ajustes > Tabletas y quioscos y haz clic en la fila del dispositivo. ### Elige la orden [#kies-de-opdracht] En el panel **Acciones remotas**, haz clic en la orden. Recibirás el aviso **Enviado al dispositivo**, o **No se pudo contactar con el dispositivo** si no se ha podido enviar. Las órdenes: - **Mostrar el nombre en pantalla** muestra el nombre del dispositivo en grande durante un momento. Es útil si hay dos tabletas una al lado de la otra y quieres saber cuál tienes abierta. - **Reproducir sonido de prueba** reproduce el sonido de aviso, con el volumen de la pestaña **Tiques y sonido**. - **Activar la pantalla** saca el dispositivo del descanso nocturno o de **Poner la pantalla en reposo**. - **Poner la pantalla en reposo** deja la pantalla en negro, también fuera del descanso nocturno. - **Dormir 30 segundos** hace lo mismo y después despierta solo. Así compruebas que la pantalla vuelve a encenderse, sin esperar a la mañana. - **Reiniciar el dispositivo** reinicia la tableta. En una tableta de la que Tillor no es propietario, el botón queda en gris. - **Instalar actualización** instala una actualización de la aplicación que ya está preparada. - **Reiniciar la aplicación** reinicia solo la aplicación de Tillor, no la tableta. ## Solicitar una captura de pantalla [#een-schermafbeelding-opvragen] ### Haz clic en Solicitar captura de pantalla [#klik-op-schermafbeelding-opvragen] En el bloque **Captura de pantalla**, esto envía la solicitud a la tableta. ### Espera la imagen [#wacht-op-het-beeld] Tillor espera un momento y actualiza la imagen en cuanto la tableta la ha subido. Debajo de la foto aparece cuándo se tomó. La imagen es lo que la aplicación muestra en ese momento: pantalla de inicio, presentación, tique o la pantalla de reposo. No es vídeo en directo. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La tableta ejecuta la orden de inmediato. Todas las órdenes, salvo las de reposo, también despiertan la pantalla. - Cada orden queda registrada en el [historial del dispositivo](/mobiele-app/diagnose-en-geschiedenis#geschiedenis). - Una captura de pantalla permanece en el panel hasta que pidas una nueva. ## ¿Problemas? [#problemen] La orden no ha podido llegar al dispositivo. Normalmente está sin conexión. Espera a que el estado vuelva a ser **Conectado** y envíala de nuevo. Tillor no es propietario de la tableta. Configúrala primero como se describe en [Configurar un quiosco](/mobiele-app/kiosk-inrichten). Hasta entonces solo puedes usar **Reiniciar la aplicación**. El dispositivo está sin conexión o la aplicación es demasiado antigua. En este último caso, Tillor lo avisa de antemano: **La aplicación de este dispositivo es demasiado antigua para capturas de pantalla.** Instala una versión más reciente. Mientras no hayas pedido nunca una imagen, aparece **Aún no se ha solicitado ninguna captura de pantalla.** Despertar a distancia solo funciona si la aplicación también está en la excepción de batería. Consulta [Batería](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). ## Véase también [#zie-ook] # Diagnóstico e historial (/es-ES/mobiele-app/diagnose-en-geschiedenis) Debajo del panel **Acciones remotas** hay dos bloques que te ayudan a controlar una tableta: **Diagnóstico** (lo que el dispositivo comunicó la última vez) e **Historial** (el registro). Puedes enviar una orden desde el mismo panel, consulta [Enviar una orden a una tableta](/mobiele-app/acties-op-afstand). ## Diagnóstico [#diagnose] **Diagnóstico** es el último aviso del dispositivo, no una medición en directo. Un guion significa que la aplicación no ha enviado ese dato. | Dato | Significado | |---|---| | **Visto por última vez** | Cuándo tuvo contacto el dispositivo por última vez | | **Conexión** | Wi-Fi o móvil | | **Pantalla** | **Encendida** o **En reposo** | | **Almacenamiento libre** | Espacio libre en la tableta, en GB | | **Idioma del dispositivo** y **Zona horaria** | El idioma y la zona horaria de Android o iOS. No es el idioma que has elegido para la aplicación en la pestaña **Dispositivo** | | **Compilación**, **Versión del runtime** | Qué versión de la aplicación hay en la tableta | | **Última actualización de la aplicación** y **Última comprobación de actualizaciones** | Cuándo se actualizó o se comprobó la aplicación por última vez | | **Error de actualización** | Aparece si la última comprobación o instalación ha fallado | | **Registrado** | Cuándo entró este dispositivo por primera vez en la lista | ## Historial [#geschiedenis] **Historial** muestra, por dispositivo: - cuándo se registró el dispositivo - cuándo enviaste ajustes o una orden - cuándo se actualizó la aplicación - cuándo el dispositivo se quedó sin conexión y cuándo volvió a estar en línea El registro se actualiza solo. **Aún no hay eventos.** significa que todavía no se ha registrado nada. ## Avisos [#meldingen] Un aviso de sin conexión o de batería solo llega si **Avisos** está activado en la pestaña **Dispositivo**, y no durante el descanso nocturno. - Aviso de sin conexión: el dispositivo lleva 10 minutos sin comunicar nada. - Aviso de batería: por debajo del 15 % sin cargador. Tillor no los vuelve a enviar hasta que el dispositivo haya vuelto a estar conectado al cargador o se haya cargado claramente. El aviso llega a las personas que gestionan los ajustes. Consulta [Notificaciones](/notificaties). ## Véase también [#zie-ook] # Resumen (/es-ES/mobiele-app) La aplicación de Tillor funciona en una tableta, quiosco o teléfono de tu parque, para **iOS** y **Android**. Los huéspedes y los compañeros ven en ella la pantalla de inicio, los tiques y las solicitudes de firma. Desde Tillor en tu navegador envías ajustes y órdenes a esos dispositivos. Una tableta que debe quedarse como quiosco la configuras en [Configurar un quiosco](/mobiele-app/kiosk-inrichten). La aplicación no sustituye a Tillor en tu navegador. Gestionar reservas, crear facturas o registrar pagos se hace en el navegador. ## ¿Cómo encaja todo? [#hoe-hangt-dit-samen] Un dispositivo aparece solo en Tillor en cuanto alguien abre la aplicación e inicia sesión. Lo que configures después en Tillor llega al dispositivo por la conexión en directo. A la inversa, el dispositivo se comunica con regularidad con Tillor, de modo que ves si sigue conectado. ```mermaid flowchart LR A[Alguien abre la app
e inicia sesión] --> B[El dispositivo aparece en
Ajustes > Tabletas y quioscos] B --> C[Tú eliges ajustes
y haces clic en Guardar y enviar] C --> D[La tableta los aplica] E[Tú envías un tique,
PDF o solicitud de firma] --> D D --> F[El dispositivo informa de batería,
conexión y versión] F --> B ``` Si un dispositivo está sin conexión, los ajustes y las órdenes solo llegan cuando vuelve a estar conectado. Consulta [Tabletas y quioscos](/mobiele-app/tablets-en-kiosken). - Un dispositivo nuevo aparece en la lista en menos de un minuto después de que alguien inicie sesión. - Tillor marca un dispositivo como sin conexión tras 10 minutos sin mensaje. Eso solo ocurre si **Avisos** está activado y no durante el descanso nocturno. - El aviso de batería llega por debajo del 15 % sin cargador. - Una presentación tiene como máximo 20 fotos. Puedes poner seis botones adicionales en la pantalla de inicio. - No hay una contraseña aparte para la aplicación. Inicias sesión como en el navegador, con Microsoft, Google o Apple. ## Instalar la aplicación e iniciar sesión [#de-app-installeren-en-inloggen] Tu organización comparte el archivo de instalación o el enlace (versión interna, TestFlight o la tienda de aplicaciones, según vuestro despliegue). Si todavía no tienes acceso, pídeselo a tu administrador o al soporte de Tillor. 1. Abre la aplicación tras instalarla. 2. Inicia sesión con **Microsoft**, **Google** o **Apple**. Es la misma cuenta que en el navegador, consulta [Iniciar sesión](/inloggen). 3. Elige tu organización si tienes más de una. ## Qué puede hacer la aplicación [#wat-de-app-kan] - **Mostrar PDF e imágenes**: directamente en la pantalla de inicio en cuanto Tillor envía un documento al dispositivo. - **Escanear tarjetas de prepago**: leer una tarjeta NFC y ver los datos de la tarjeta y del cliente. - **Hacer oír los pagos**: una señal sonora cuando se paga una factura. - **Quiosco**: mantener la pantalla encendida, regular el brillo y mostrar el logotipo de tu organización. ## Qué ve Tillor del dispositivo [#wat-tillor-van-het-toestel-ziet] La aplicación envía con regularidad a Tillor el nombre, el modelo, el sistema operativo, la versión de la aplicación, la batería y la conexión de red (wifi o móvil). Lo ves en la lista de dispositivos y en la página del dispositivo. En **Cuenta** > **Sesiones activas** encuentras los mismos dispositivos como sesiones de la aplicación, con **Metadatos de la aplicación**. Ahí también puedes cerrar una sesión. ## ¿Problemas? [#problemen] Comprueba el wifi o la red móvil, y que has iniciado sesión en la organización correcta. Actualiza la aplicación a la última versión. Si no ayuda, cierra sesión y vuelve a iniciarla. Si sigue fallando, ponte en contacto con tu administrador. Abre la aplicación, inicia sesión y elige la organización correcta. El dispositivo aparece en menos de un minuto en **Ajustes** > **Tabletas y quioscos**. Si ves **Aún no hay dispositivos**, ningún dispositivo se ha registrado todavía. ## Conceptos [#begrippen] - **Tableta**: una tableta con la aplicación de Tillor, por ejemplo en la recepción. - **Quiosco**: una tableta fijada en la aplicación de Tillor, para que los huéspedes no puedan salir de ella. - **Dispositivo**: cada instalación de la aplicación que aparece en Tillor, sea del tipo que sea. - **Descanso nocturno**: las horas en las que la pantalla se apaga o se pone en negro. - **Bloqueo de pantalla**: un patrón o PIN en la propia tableta, algo distinto del bloqueo de quiosco. Encontrarás más explicaciones en la [lista de conceptos](/begrippen). ## Véase también [#zie-ook] # Configurar un quiosco (/es-ES/mobiele-app/kiosk-inrichten) Con un quiosco fijas una tableta Android en la aplicación de Tillor. Los huéspedes ven la pantalla de inicio, una presentación o un tique, y no acceden a los ajustes de Android. Tras un corte de corriente, la tableta vuelve a arrancar en Tillor. Esta página recorre la configuración, que se hace una sola vez. Los interruptores que activas después están en [Ajustes del dispositivo](/mobiele-app/toestelinstellingen#kiosk). Sin los pasos siguientes puedes activar **Bloquear la aplicación**, pero entonces Android solo usa la fijación de pantalla. Eso exige una confirmación en la tableta y un huésped puede salir. El estado en la pestaña **Quiosco** dice entonces **Fijación de pantalla. Esta tableta no es un quiosco configurado.** El bloqueo completo solo se aplica cuando Tillor es el propietario del dispositivo. En la pestaña **Quiosco** lo lees como **Quiosco configurado: el bloqueo es completo.** Esto funciona en Android. En iOS puedes usar la aplicación como quiosco para tiques y la pantalla de inicio, pero no puedes establecerla como propietaria del dispositivo. Los botones de **Gestión de Android** permanecen cerrados, con el aviso **Disponible cuando esta tableta esté configurada como quiosco.** ## Antes de empezar [#voor-je-begint] Necesitas un ordenador con `adb`. Es un programa gratuito de Google con el que controlas una tableta Android por cable USB. Es una tarea que se hace una sola vez por tableta, pensada para quien tenga algo de nivel técnico. Si no lo consigues, pide ayuda al soporte de Tillor. Antes de empezar: - Restablece la tableta a los ajustes de fábrica, o usa una tableta que todavía no tenga ninguna cuenta de Google adicional. Android rechaza una aplicación como propietaria en cuanto hay una cuenta en el dispositivo. - La aplicación de Tillor debe estar instalada y con la sesión iniciada en tu organización. - En los ajustes de Android, activa **Depuración por USB** (Opciones de desarrollador). - Conecta la tableta al ordenador con un cable. `adb devices` debe mostrar la tableta como `device`, no como `unauthorized`. ## Tillor como propietario de la tableta [#tillor-als-eigenaar-van-de-tablet] El propietario de un dispositivo Android puede hacer cosas que una aplicación normal no puede, como fijar de verdad la tableta. Dale a Tillor ese papel con este comando en el ordenador: ```bash adb shell dpm set-device-owner eu.tillor.app/expo.modules.tillorkiosk.KioskAdminReceiver ``` Si el comando funciona, Android responde que el propietario se ha establecido. Si falla con un aviso sobre cuentas, borra las cuentas o empieza de nuevo desde un restablecimiento de fábrica. Este comando solo puede ejecutarse una vez. Otro propietario exige un nuevo restablecimiento. Después, en Tillor abre **Ajustes** > **Tabletas y quioscos**, pon el tipo en **Quiosco** y guarda. En la pestaña **Quiosco**, el mosaico **Dispositivo quiosco** debería estar en verde. Los otros dos mosaicos lo estarán cuando hayas enviado **Aplicación como pantalla de inicio** y **Quitar el bloqueo de pantalla**. La explicación de esos mosaicos está en [Quiosco](/mobiele-app/toestelinstellingen#kiosk). ## Batería: que la aplicación no se duerma [#batterij-de-app-niet-laten-inslapen] Android, y sobre todo Xiaomi con HyperOS, corta la conexión de una aplicación que según el sistema "duerme". El quiosco se queda entonces sin conexión en plena noche, aunque la pantalla debería estar apagada por el descanso nocturno. Si Tillor es el propietario, la aplicación pide por sí misma que se desactive la optimización de batería. En la mayoría de las tabletas aparece una ventana en la que tocas **Permitir**. En Xiaomi, HyperOS abre en su lugar la página de batería de Tillor: elige ahí **Sin restricciones**. Si lo omites, la aplicación lo vuelve a pedir tras el siguiente reinicio, y la conexión durante la noche sigue siendo poco fiable. Ninguna aplicación puede establecer esta excepción por sí misma, ni siquiera como propietaria del dispositivo. Así que es un toque por tableta, o el comando de abajo. Si no aparece esa ventana, establece la excepción desde el ordenador durante la configuración: ```bash adb shell dumpsys deviceidle whitelist +eu.tillor.app ``` Después, la aplicación debería seguir comunicándose con Tillor en segundo plano, aunque la pantalla esté apagada. ## Quitar el bloqueo de pantalla [#schermvergrendeling-weghalen] Un patrón o PIN en la tableta significa que, tras cada reinicio, Android espera en la pantalla de bloqueo. El quiosco se queda entonces en negro hasta que alguien pase por allí. El mosaico **Bloqueo de pantalla** avisa de ello: **Hay un patrón o PIN configurado.** 1. Abre la pestaña **Quiosco**. 2. En **Gestión de Android**, pon **Quitar el bloqueo de pantalla** en **Activado**. 3. Elige **Guardar y enviar**. La tableta no lo pide por sí misma. El bloqueo desaparece la próxima vez que alguien introduce el patrón o el PIN, por ejemplo tras un reinicio. Después, un reinicio termina en Tillor. Si no quieres esperar, quita tú mismo el patrón en los ajustes de Android de la tableta. El mosaico pasa a **Sin patrón ni PIN: un reinicio termina en Tillor.** Mientras Tillor sea la pantalla de inicio, HyperOS cambia la navegación de gestos a botones. Tillor oculta esa barra hasta que alguien toca tres veces en la pantalla de inicio. Si eliges **Desbloquear temporalmente** en la aplicación, vuelves a la pantalla de inicio de Xiaomi. Si quieres volver a los gestos allí, actívalos en los ajustes de Android. ## Qué activar después [#wat-je-daarna-aanzet] Para una tableta en una carcasa en la recepción o en la entrada, este es un conjunto útil. Todo está en la pestaña **Quiosco**, salvo que se indique otra cosa. | Ajuste | Valor | Por qué | | --- | --- | --- | | **Aplicación como pantalla de inicio** | Activado | El botón de inicio abre Tillor. El reloj y la batería siguen visibles. | | **Bloquear la aplicación** | Activado | Los huéspedes no pueden salir de la aplicación. | | **Ocultar la interfaz del sistema** | Activado | Sin notificaciones, sin aplicaciones recientes, sin menú de apagado. | | **Blindar el dispositivo** | Activado | Sin restablecimiento de fábrica, sin modo seguro, sin transferencia por USB, sin poder desinstalar. | | **Seguir encendida al cargar** | Activado | La pantalla sigue encendida durante el horario de apertura mientras el cargador esté conectado. El descanso nocturno tiene prioridad. | | **Hora automática** | Activado | El descanso nocturno sigue el reloj de la organización, no un reloj de tableta desajustado. | | **Orientación de la pantalla** | Vertical u horizontal | En **Pantalla y reposo**, según la carcasa. **Estándar** es giro automático. | **Bloquear el volumen** mantiene el volumen de la pestaña **Tiques y sonido**, de modo que un huésped no pueda usar los botones laterales. Guarda y comprueba los tres mosaicos de la parte superior de **Quiosco**. Verde significa que la tableta lo comunica así. Una advertencia significa que ese paso todavía no se ha completado. ## Una versión nueva de la aplicación por USB [#een-nieuwe-app-versie-over-usb] **Blindar el dispositivo** desactiva la depuración por USB y la transferencia de archivos. **Bloquear la aplicación** mantiene la tableta en la aplicación, por lo que no se puede confirmar una ventana de instalación. Antes de instalar una compilación por cable: 1. Pon **Bloquear la aplicación** en **Desactivado**. 2. Pon **Blindar el dispositivo** en **Desactivado**. 3. Elige **Guardar y enviar** y espera a que la tableta suelte el bloqueo. 4. Instala la versión nueva. En Xiaomi, HyperOS pide en la tableta confirmar la instalación por USB: toca **Instalar**. 5. Vuelve a poner ambos ajustes en **Activado** y guarda de nuevo. Si dejas **Blindar el dispositivo** activado, `adb` ya no ve la tableta. La excepción de batería y la propiedad se conservan en una actualización normal. Un restablecimiento de fábrica no: entonces empiezas de nuevo en el comando `dpm`. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tras un reinicio o un corte de corriente, la tableta vuelve a arrancar en Tillor, en la pantalla de inicio. - Los huéspedes no pueden salir de la aplicación y no ven notificaciones ni aplicaciones recientes. - Los tres mosaicos de la parte superior de la pestaña **Quiosco** muestran lo que comunica la propia tableta. Tras un cambio, los mosaicos pueden tardar en ponerse en verde, porque la tableta se comunica cada 30 a 60 segundos. - Una actualización normal de la aplicación conserva la propiedad y la excepción de batería. Un restablecimiento de fábrica no. ## ¿Problemas? [#problemen] Android rechaza un propietario en cuanto hay una cuenta en la tableta. Elimina las cuentas o empieza de nuevo desde un restablecimiento de fábrica. Confirma en la tableta la ventana que pide permiso para el ordenador, y comprueba que **Depuración por USB** está activada. Si **Blindar el dispositivo** está activado, `adb` ya no ve la tableta: desactívalo como en la actualización por USB de arriba. Tillor todavía no es propietario de la tableta, así que Android solo usa la fijación de pantalla. Ejecuta el comando de propietario y después elige **Guardar y enviar**. Aparece el aviso **Disponible cuando esta tableta esté configurada como quiosco.** Configura la tableta como se explica arriba, o usa una tableta Android: en iOS no es posible. Hay un patrón o PIN en la tableta. Activa **Quitar el bloqueo de pantalla** e introduce el patrón o el PIN una vez, o quita el bloqueo en los ajustes de Android. Android ha dejado que la aplicación se duerma. Desactiva la optimización de batería para Tillor, como en el apartado Batería de arriba. ## Véase también [#zie-ook] # Configurar un descanso nocturno para la pantalla (/es-ES/mobiele-app/nachtrust-instellen) Una tableta que está encendida toda la noche consume electricidad y puede quemar la pantalla. Con un descanso nocturno, la pantalla se apaga o se pone en negro durante las horas en que el parque está cerrado. Las demás opciones de pantalla, como atenuar, están en [Ajustes del dispositivo](/mobiele-app/toestelinstellingen#scherm-en-slaap). Antes de empezar: - Si quieres que la pantalla se apague de verdad y pueda despertarse a distancia, configura primero la tableta como quiosco y pon la aplicación en la excepción de batería. Consulta [Configurar un quiosco](/mobiele-app/kiosk-inrichten). - Si eliges el horario de apertura de tu organización, rellénalo primero. Consulta [Organización](/gebruikers/organisaties#openingsuren). ## Configurar el descanso nocturno [#de-nachtrust-instellen] ### Abre la pestaña Pantalla y reposo [#open-het-tabblad-scherm-en-slaap] Abre el dispositivo en Ajustes > Tabletas y quioscos y haz clic en el mosaico **Pantalla y reposo**. Busca el grupo **Descanso nocturno**. ### Elige el Modo nocturno [#kies-de-nachtstand] Elige **Horario fijo** y rellena **De** y **Hasta**. Se permite un horario que pase de la medianoche, como de 22:00 a 07:00. La pantalla sigue el horario de apertura de tu organización. Lo cambias en un solo lugar y todos los dispositivos lo siguen. Con **Desactivado**, Tillor no programa reposo. ### Elige el Estilo de sueño [#kies-de-slaapstijl] **Capa negra** pone una capa negra sobre la imagen, y un toque la despierta al instante. **Pantalla apagada** apaga realmente el panel. ### Haz clic en Guardar y enviar [#klik-op-opslaan-en-versturen] En la parte superior derecha del grupo aparece cuándo es el próximo reposo. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Durante el descanso nocturno, la pantalla se apaga o se pone en negro, incluso si **Mantener la pantalla encendida** está activado. El descanso nocturno tiene prioridad. - Al tocarla, la pantalla se despierta un momento. - Al terminar el horario, la pantalla vuelve a la normalidad. - Durante el descanso nocturno, Tillor no envía ningún aviso de que el dispositivo está sin conexión. - Si quieres despertar la pantalla o ponerla en reposo fuera del horario, usa [Acciones remotas](/mobiele-app/acties-op-afstand). ## ¿Problemas? [#problemen] **Pantalla apagada** funciona por completo en una tableta configurada como quiosco. Despertar a distancia solo funciona si la aplicación también está en la excepción de batería. Consulta [Batería](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). Un reloj desajustado en la tableta desplaza el horario. En la pestaña **Quiosco**, activa **Hora automática** para que la tableta siga el reloj de la organización. Android deja que la aplicación se duerma. Desactiva la optimización de batería para Tillor, consulta [Configurar un quiosco](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). ## Véase también [#zie-ook] # Configurar la pantalla de inicio y una presentación (/es-ES/mobiele-app/startscherm-en-diavoorstelling) La pantalla de inicio es lo que ven los huéspedes cuando no hay ningún tique en la pantalla: un texto de bienvenida, tu logotipo, botones y, si quieres, una presentación con carteles o fotos del parque. Aquí lo configuras. Cada ajuste por separado, con sus límites, está en [Ajustes del dispositivo](/mobiele-app/toestelinstellingen#startscherm). Antes de empezar: - El dispositivo aparece en Ajustes > Tabletas y quioscos, consulta [Gestionar una tableta o quiosco](/mobiele-app/tablets-en-kiosken). - Las fotos son archivos JPEG, PNG o WebP, o un enlace `https` a una imagen. ## Cambiar el texto de bienvenida [#de-welkomsttekst-aanpassen] ### Abre la pestaña Pantalla de inicio [#open-het-tabblad-startscherm] Abre el dispositivo y haz clic en el mosaico **Pantalla de inicio**. El campo **Título de bienvenida** (máximo 60 caracteres) y **Subtítulo de bienvenida** (máximo 120) están al principio. ### Rellena el texto y envía [#vul-de-tekst-in-en-verstuur] Deja un campo vacío si la aplicación puede mantener su propio texto. Haz clic en **Guardar y enviar**. ## Añadir una presentación [#een-diavoorstelling-toevoegen] ### Abre la pestaña Presentación y botones [#open-het-tabblad-diavoorstelling-en-knoppen] Haz clic en ese mosaico. En **Presentación** eliges cómo aparecen las fotos. ### Elige la visualización [#kies-de-weergave] Las fotos cambian detrás del logotipo y los botones, en lugar del fondo de tu organización. Los huéspedes pueden tocar los botones al mismo tiempo. Las fotos ocupan toda la pantalla en cuanto nadie la toca. Un toque devuelve la pantalla de inicio. Cuánto tiempo se espera lo configuras en **Iniciar después de**. ### Añade fotos [#voeg-fotos-toe] Haz clic en **Subir foto**, o pega una dirección `https` con **Añadir enlace**. Puedes añadir hasta 20 fotos. Si quieres, pon a una foto un pie de máximo 80 caracteres. ### Configura los tiempos [#stel-de-timing-in] **Tiempo por foto** va de 3 a 600 segundos. **Iniciar después de**, de 10 a 3600 segundos. En **Ajuste** eliges **Rellenar la pantalla** (se recortan los bordes) o **Mostrar la foto entera** (con bordes negros). ### Haz clic en Guardar y enviar [#klik-op-opslaan-en-versturen] La tableta muestra la presentación en cuanto recibe los ajustes. ## Añadir botones adicionales [#extra-knoppen-toevoegen] Los botones adicionales son accesos directos en la pantalla de inicio, por ejemplo a un plano o a la red wifi para huéspedes. Puedes tener seis. ### Haz clic en Añadir botón [#klik-op-knop-toevoegen] Aparece una fila vacía. ### Rellena el botón [#vul-de-knop-in] Indica un texto, una descripción breve y una dirección web (solo `https`). Elige un icono de la fila y, en **Cuándo mostrar**, si el botón está siempre visible o solo después de un toque. ### Haz clic en Guardar y enviar [#klik-op-opslaan-en-versturen-1] El icono de la papelera elimina un botón. **Dejar que decida el dispositivo** descarta la lista de Tillor, de modo que la tableta usa sus propios botones. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La tableta adapta la pantalla de inicio en cuanto recibe los ajustes. Una tableta sin conexión lo hace cuando vuelve a estar conectada. - Si has puesto **Botón de prepago** o **Botón de ajustes** en **Tras un toque**, el botón se oculta tras los segundos que hayas indicado en **Ocultar tras**. - Un tique, documento o solicitud de firma que Tillor envía a la tableta aparece sobre la pantalla de inicio y vuelve a desaparecer. ## ¿Problemas? [#problemen] El archivo no es JPEG, PNG ni WebP, o la subida se ha interrumpido. Prueba con otra foto, o usa **Añadir enlace** con la dirección de la imagen. Los botones solo aparecen si **Presentación** no está en **Desactivada**. Si la lista ya tiene 20 fotos, elimina primero una con **Eliminar foto**. Con **Pantalla completa en inactividad**, solo se inicia tras los segundos indicados en **Iniciar después de** sin ningún toque. El valor por defecto de una presentación nueva es 60 segundos. Comprueba también si la tableta ya tiene los ajustes nuevos. La dirección debe empezar por `https`. Comprueba que el enlace funciona en un navegador. ## Véase también [#zie-ook] # Gestionar una tableta o quiosco (/es-ES/mobiele-app/tablets-en-kiosken) Cada tableta, quiosco o teléfono en el que alguien abre la aplicación de Tillor y elige una organización aparece en Tillor. Desde ahí ves si el dispositivo sigue conectado y le envías la pantalla de inicio, el sonido y el bloqueo de quiosco. Lo que puedes configurar, pestaña por pestaña, está en [Ajustes del dispositivo](/mobiele-app/toestelinstellingen). Antes de empezar: - El dispositivo debe tener la aplicación de Tillor y alguien debe haber iniciado sesión en tu organización. Si no es así, verás **Aún no hay dispositivos**. - Enviar ajustes solo se permite con el permiso **Editar configuración**. ## Enviar ajustes a un dispositivo [#instellingen-naar-een-toestel-sturen] ### Abre la lista [#open-de-lijst] Ve a Ajustes > Tabletas y quioscos. Cada fila es una instalación de la aplicación. Ves el nombre, el tipo (**Tableta**, **Quiosco** o **Teléfono**), el modelo, la versión de la aplicación, el porcentaje de batería y si el dispositivo está conectado. **Visto por última vez** significa que la aplicación lleva un rato sin comunicar nada. ### Abre el dispositivo [#open-het-toestel] Haz clic en la fila del dispositivo. Arriba están el nombre y el estado. Debajo hay un cuadro de búsqueda y una fila de mosaicos, uno por pestaña. En un mosaico aparece cuántos ajustes proceden de Tillor. **Todo queda en el dispositivo** significa que en esa pestaña todavía no has fijado nada. A la derecha permanece el panel **Acciones remotas**, consulta [Acciones remotas](/mobiele-app/acties-op-afstand). ### Cambia los ajustes [#pas-de-instellingen-aan] Elige una pestaña y cambia lo que quieras. Casi cada interruptor tiene tres posiciones: **Dispositivo**, **Activado** y **Desactivado**. **Dispositivo** conserva la opción elegida en la propia tableta. **Activado** y **Desactivado** sobrescriben esa opción en cuanto guardas. Bajo la descripción figura lo que hace la aplicación si nadie ha elegido nada, por ejemplo **Predeterminado: Activado**. ### Haz clic en Guardar y enviar [#klik-op-opslaan-en-versturen] No se envía nada al dispositivo mientras no hagas clic aquí. Mientras haya algo cambiado, en la barra aparece **Cambios sin enviar** y la pestaña tiene un punto verde. **Descartar cambios** devuelve el formulario a lo que hay ahora en el dispositivo. Antes y después de un cambio que todavía no has enviado: ## Lo mismo para todos los dispositivos [#hetzelfde-voor-alle-toestellen] Si tienes varios dispositivos del mismo tipo, no hace falta configurarlos uno por uno. Haz clic en **Guardar y enviar**. Solo este dispositivo recibe los ajustes. Haz clic en **Aplicar a todos los quioscos** (o **Aplicar a todas las tabletas**, o **Aplicar a todos los teléfonos**, según el tipo). Tillor copia los ajustes de este dispositivo a los demás dispositivos del mismo tipo y los envía enseguida, con el aviso **Ajustes copiados a los demás dispositivos**. El nombre, el tipo y los avisos siguen siendo los de cada dispositivo. El idioma sí se copia. ## Buscar en todas las pestañas [#zoeken-over-alle-tabbladen] ¿No sabes en qué pestaña está un ajuste? El cuadro **Buscar ajustes** busca en todas las pestañas a la vez. Los mosaicos se quedan, pero debajo aparece una lista de resultados, agrupados por pestaña. Una búsqueda como `brillo` muestra las líneas de brillo de **Pantalla y reposo**, y debajo otras pestañas que también contienen la palabra. **Abrir pestaña** cierra la búsqueda y abre esa pestaña, para que veas también el resto del grupo. Si no encuentras nada, aparece **Ningún ajuste coincide con** tu término de búsqueda. ## Olvidar un dispositivo [#een-toestel-vergeten] El menú de los tres puntos arriba a la derecha de la página del dispositivo contiene **Olvidar dispositivo**. Úsalo para una tableta que ya no se utiliza. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Tillor avisa con **Ajustes enviados**. La tableta los aplica enseguida si está conectada. Si está sin conexión, los recibe en cuanto vuelve a contactar con Tillor. La aplicación se comunica cada 30 a 60 segundos. - En la página del dispositivo y en la lista figura si el dispositivo está conectado. El dispositivo también informa de batería, versión de la aplicación y conexión, consulta [Diagnóstico e historial](/mobiele-app/diagnose-en-geschiedenis). - Cada cambio queda en el historial del dispositivo y en el [registro de actividad](/activiteitenlog) de tu organización. - Un dispositivo olvidado desaparece de la lista y los ajustes enviados se van con él. Si la aplicación sigue funcionando en él y hay alguien con la sesión iniciada, vuelve en menos de un minuto, sin esos ajustes. Tendrás que volver a configurarlos. - Si activas **Avisos** en la pestaña **Dispositivo**, las personas que gestionan los ajustes reciben un mensaje cuando el dispositivo lleva 10 minutos sin conexión o la batería baja del 15 % sin cargador. ## ¿Problemas? [#problemen] Todavía no se ha registrado ninguna tableta. Abre la aplicación de Tillor en la tableta, inicia sesión y elige la organización correcta. El dispositivo aparece en menos de un minuto. No se ha podido guardar, a menudo por una conexión inestable o porque te falta el permiso **Editar configuración**. Inténtalo de nuevo. Si sigue sin funcionar, pide el permiso a tu administrador. **Aplicar a todos los quioscos** no ha funcionado. Haz clic otra vez. Si sigue sin funcionar, guarda el dispositivo con **Guardar y enviar** y abre los demás dispositivos uno por uno. Comprueba que el dispositivo esté **Conectado**. Si está sin conexión, aplica los ajustes en cuanto vuelva a contactar. Si el interruptor está en **Dispositivo**, decide la propia tableta. Elige **Activado** o **Desactivado** para imponerte. La aplicación sigue funcionando y alguien tiene la sesión iniciada, así que se registra de nuevo. Cierra la sesión en la tableta si de verdad quieres deshacerte del dispositivo. En **Cuenta** > **Sesiones activas** puedes finalizar la sesión de la aplicación. El **Código de ajustes** de la pestaña **Pantalla de inicio** debe tener de 4 a 6 dígitos, o estar vacío. Solo entonces puedes guardar. ## Véase también [#zie-ook] # Ajustes del dispositivo (/es-ES/mobiele-app/toestelinstellingen) Aquí encuentras todos los ajustes de un dispositivo, pestaña por pestaña, con su valor predeterminado y sus límites. Son seis, cada una un mosaico encima de los formularios. Cómo llegar a ellos, cómo funciona la búsqueda y cuándo algo llega al dispositivo está en [Gestionar una tableta o quiosco](/mobiele-app/tablets-en-kiosken). La pantalla de inicio paso a paso está en [Configurar la pantalla de inicio y una presentación](/mobiele-app/startscherm-en-diavoorstelling) y el descanso nocturno en [Configurar un descanso nocturno para la pantalla](/mobiele-app/nachtrust-instellen). Cada línea tiene un icono, una breve explicación y, donde tiene sentido, el valor predeterminado de la aplicación. Elige **Dispositivo** (o deja un número vacío en **Predeterminado**) si la tableta puede conservar su propia elección. **Activado** y **Desactivado** sobrescriben esa elección. Las líneas que solo funcionan en un quiosco configurado muestran una advertencia mientras la tableta todavía no lo es: **Disponible cuando esta tableta esté configurada como quiosco.** Esos pasos están en [Configurar un quiosco](/mobiele-app/kiosk-inrichten). ## Pantalla de inicio [#startscherm] Texto de bienvenida, fondo y los botones que ven los huéspedes cuando no hay ningún tique en la pantalla. ### Texto de bienvenida [#welkomsttekst] **Título de bienvenida** (máximo 60 caracteres) y **Subtítulo de bienvenida** (máximo 120) aparecen arriba en la pantalla de inicio. Deja un campo vacío si la aplicación puede mantener su propio texto. ### Aspecto [#uiterlijk] **Aspecto** (marca **1**): - **Foto de fondo** muestra el fondo de la organización detrás del logotipo. Activada de forma predeterminada. - **Oscurecer el fondo** es un porcentaje de 0 a 90. Predeterminado 45, para que el logotipo y los botones se lean bien sobre una foto clara. - **Estilo del logotipo** es **Silueta blanca** (el predeterminado) o **En color sobre una tarjeta**. ### Botones [#knoppen] **Botones** (marca **2**): - **Botón de prepago** abre el saldo, la recarga y el pago con una tarjeta NFC. Activado de forma predeterminada. - **Botón de ajustes** muestra un botón hacia los ajustes en el propio dispositivo. Si está desactivado, llegas tocando tres veces la pantalla de inicio. - **Cuándo mostrar** es **Siempre**, o **Tras un toque**. Con **Tras un toque** rellenas **Ocultar tras**, en segundos. Después el botón vuelve a esconderse hasta que alguien toca la pantalla. - **Código de ajustes** tiene de 4 a 6 dígitos. El dispositivo pide ese código antes de abrir sus propios ajustes. Vacío significa sin código. Algo distinto de 4 a 6 dígitos no se puede guardar. ## Presentación y botones [#diavoorstelling-en-knoppen] Fotos que alterna la pantalla de inicio y botones adicionales hacia una página web. ### Presentación [#diavoorstelling] **Visualización** (marca **1**) tiene tres posiciones: - **Desactivada** no muestra fotos. - **Como fondo** alterna las fotos detrás del logotipo y los botones, en lugar del fondo de la organización. - **Pantalla completa en inactividad** ocupa toda la pantalla en cuanto nadie la toca. En cuanto la visualización no está en **Desactivada**, puedes añadir hasta 20 fotos. **Subir foto** acepta JPEG, PNG o WebP. **Añadir enlace** pega una dirección `https` de una imagen. A cada foto puedes ponerle un pie de máximo 80 caracteres. - **Tiempo por foto** es cuánto se queda cada foto, de 3 a 600 segundos. Una presentación nueva empieza en 10. - **Iniciar después de** solo vale para pantalla completa: segundos sin tocar la pantalla antes de que empiece la presentación, de 10 a 3600. Una presentación nueva empieza en 60. - **Ajuste**: **Rellenar la pantalla** recorta los bordes, **Mostrar la foto entera** conserva toda la foto con bordes negros. Una presentación nueva empieza en **Mostrar la foto entera**. Un toque sobre una presentación a pantalla completa devuelve la pantalla de inicio. ### Botones adicionales [#extra-knoppen] **Botones adicionales** (marca **2**) son accesos directos en la pantalla de inicio, por ejemplo un mapa o la red para huéspedes. Puedes tener seis. Por cada botón rellenas el texto del botón, una breve descripción, la dirección web y un icono. El icono lo eliges de la fila: mapa, sitio web, información, calendario, comer y beber, wifi, teléfono o entradas. **Cuándo mostrar** funciona igual que en el botón de prepago: siempre, o solo tras un toque y luego volver a ocultarse. **Añadir botón** crea una fila vacía. El icono de la papelera elimina ese botón. **Dejar que decida el dispositivo** descarta la lista de Tillor, de modo que la tableta use sus propios botones. Mientras todavía no hayas guardado botones, aparece también esa frase: no hay botones configurados desde Tillor. ## Pantalla y reposo [#scherm-en-slaap] Brillo, orientación, colores y cuándo se apaga la pantalla por la noche. ### Brillo [#helderheid] Si buscas un ajuste, prueba `brillo` en el cuadro de búsqueda, consulta [Buscar en todas las pestañas](/mobiele-app/tablets-en-kiosken#zoeken-over-alle-tabbladen). - **Modo quiosco** mantiene la pantalla encendida, con recibos, firma y control del brillo. Activado de forma predeterminada en una tableta o quiosco, desactivado en un teléfono. - **Mantener la pantalla encendida** evita que la pantalla se duerma. Activado de forma predeterminada, en un teléfono desactivado. - **Atenuar en inactividad** pasa a brillo completo con un toque y después atenúa. Activado de forma predeterminada, en un teléfono desactivado. - **Atenuar tras** es el número de segundos sin tocar la pantalla, de 5 a 3600. Predeterminado 15. - **Brillo atenuado** es el porcentaje en esa posición atenuada, de 0 a 100. Predeterminado 0,5 %. El descanso nocturno de más abajo tiene prioridad sobre **Mantener la pantalla encendida**: durante las horas de reposo la pantalla se apaga o se pone en negro igualmente. ### Apariencia [#weergave] - **Orientación de la pantalla** es **Girar automáticamente** (el predeterminado), **Vertical** u **Horizontal**. Fija un quiosco en su carcasa; si no, la imagen gira cuando alguien inclina la tableta. - **Apariencia** es **Seguir al dispositivo**, **Claro** u **Oscuro**. ### Descanso nocturno [#nachtrust] **Modo nocturno** (marca **1**) tiene tres posiciones: - **Desactivado** no programa reposo. - **Horario fijo** usa **Desde** y **Hasta**. Se admite un horario que cruza la medianoche, como de 22:00 a 07:00. La pantalla se apaga en ese tramo, aunque el resto del día deba seguir encendida. Tocarla la despierta un momento. - **Cuando la organización está cerrada** sigue el horario de apertura de la organización. Arriba a la derecha del grupo figura cuándo es el próximo reposo. **Estilo de sueño**: - **Capa negra** pone una capa negra sobre la imagen. La pantalla sigue respondiendo al tacto, así que un toque la despierta al instante. - **Pantalla apagada** apaga el panel de verdad. Vuelve a despertar al final del horario, o desde **Activar la pantalla** en [Acciones remotas](/mobiele-app/acties-op-afstand). Esto funciona por completo en una tableta configurada como quiosco. Despertar a distancia solo funciona si la aplicación también está en la excepción de batería, consulta [Batería](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen). ## Tiques y sonido [#kassabonnen-en-geluid] Lo que hace la tableta cuando Tillor le envía un documento y qué sonidos reproduce. ### Recibos y documentos [#kassabonnen-en-documenten] Marca **1**: - **Mostrar recibos y documentos** muestra PDF, imágenes y solicitudes de firma en este dispositivo. Activado de forma predeterminada, en un teléfono desactivado. Desactívalo en una tableta que solo deba ser una pantalla de inicio y no deba mostrar recibos. - **Borrar tras** es el número de segundos que se queda un recibo antes de que el propio dispositivo lo retire, de 5 a 900. Déjalo vacío para esperar a que Tillor borre la pantalla. ### Sonido [#geluid] Marca **2**. Todo lo de abajo está activado de forma predeterminada, con el volumen al 100 %. - **Sonido al iniciar** suena cuando la aplicación arranca o se reinicia. - **Sonido para recibos y documentos** suena cuando llega un recibo, una imagen o una solicitud de firma. - **Sonido para pagos en línea** suena cuando una factura se ha pagado en línea, o mediante una transferencia automática. - **Sonido de batería baja** reproduce una advertencia cuando la batería está casi vacía y el cargador no está conectado. - **Volumen** va de 0 a 100. En un quiosco puedes fijarlo con **Bloquear el volumen** en la pestaña **Quiosco**. **Reproducir sonido de prueba** está en [Acciones remotas](/mobiele-app/acties-op-afstand), no en esta pestaña. ## Quiosco [#kiosk] Solo tiene sentido en Android. La configuración (propietario del dispositivo, batería, USB) está en [Configurar un quiosco](/mobiele-app/kiosk-inrichten). En esta pestaña pones después los interruptores. ### Estado [#status] Tres mosaicos (marca **1**) muestran lo que dijo la tableta en su último aviso. No son ajustes. - **Dispositivo quiosco** es verde con **Quiosco configurado: el bloqueo es completo.** Una advertencia significa fijar la pantalla (la aplicación no es la propietaria) o que la aplicación no está bloqueada en absoluto. Un guion significa que esta versión de la aplicación todavía no comunica el estado. - **Pantalla de inicio** es verde si Tillor es la pantalla de inicio. Si no, indica que Tillor todavía no lo es, o que la aplicación aún no lo ha comunicado. - **Bloqueo de pantalla** advierte si la tableta tiene un patrón o un PIN. Después de un reinicio, el dispositivo se queda esperando en la pantalla de bloqueo. Verde significa que un reinicio termina en Tillor. ### Bloqueo [#vergrendeling] Marca **2**. Estos tres están desactivados de forma predeterminada, hasta que los actives tú. - **Aplicación como pantalla de inicio** convierte Tillor en la pantalla de inicio. El reloj y la batería siguen visibles. Solo Android, y solo con una versión de la aplicación que lo permita. - **Bloquear la aplicación** mantiene la tableta en la aplicación de Tillor. En un quiosco configurado, un huésped no puede salir. Sin esa configuración, Android recurre a fijar la pantalla: alguien en la tableta debe confirmarlo, y se puede abandonar. - **Ocultar la interfaz del sistema** quita las notificaciones, las aplicaciones recientes y el menú de encendido. El reloj y la batería se quedan. Esto solo funciona cuando la tableta está configurada como quiosco. ### Gestión de Android [#android-beheer] Todo lo de este grupo (marca **1**) solo vale para un quiosco configurado. En otro dispositivo ves la advertencia en cada línea y los botones están desactivados. De forma predeterminada los interruptores están desactivados. Los dos números están vacíos: la tableta conserva entonces su propio brillo y tiempo de espera. - **Blindar el dispositivo** bloquea el restablecimiento de fábrica, el modo seguro, los usuarios nuevos, la transferencia por USB, la desinstalación y la detención forzada. Desactívalo antes de instalar una actualización por USB. - **Quitar el bloqueo de pantalla** elimina el patrón o el PIN. Se aplica en cuanto ese patrón o PIN se haya introducido una vez más. - **Seguir encendida al cargar** mantiene la pantalla encendida durante el horario de apertura mientras el cargador esté conectado. El descanso nocturno la apaga igualmente. - **Bloquear el volumen** mantiene fijo el volumen de **Sonido**. - **Actualizaciones durante el sueño** instala las actualizaciones del sistema mientras la pantalla duerme, y las aplaza mientras la tableta está en uso. - **Hora automática** exige fecha, hora y zona horaria automáticas, para que el reposo siga el horario de apertura. - **Brillo de la pantalla** es un brillo fijo de la propia tableta, de 1 a 100, con el brillo automático desactivado. Si lo dejas vacío, se conserva el ajuste de la tableta. - **Tiempo de espera de la pantalla** es el número de segundos (de 15 a 3600) tras los cuales Android apaga la pantalla si la aplicación no la mantiene encendida. Si lo dejas vacío, se conserva el ajuste de la tableta. ## Dispositivo [#toestel] Nombre, tipo, idioma y avisos. **Aplicar a todos los quioscos** copia el idioma a los demás dispositivos del mismo tipo, y deja el nombre, el tipo y los avisos como están. Marca **1**: - **Nombre** es lo que ves en la lista y en el dispositivo, por ejemplo `Quiosco de autoservicio`. Máximo 80 caracteres. - **Tipo** es **Tableta**, **Quiosco** o **Teléfono**. El tipo determina el texto de **Aplicar a todos …** y algunos valores predeterminados: en un teléfono empiezan desactivados el modo quiosco, los recibos, mantener la pantalla encendida y atenuar. - **Idioma** es la única lista que se pliega, porque hay más opciones de las que caben en una fila de botones. **Predeterminado** sigue el idioma de la tableta. Si no, eliges un idioma de la aplicación de Tillor. Los nombres figuran en el propio idioma. - **Avisos** avisa a las personas que gestionan los ajustes si este dispositivo lleva 10 minutos sin conexión, o si la batería baja del 15 % sin cargador. Durante el descanso nocturno no llega ningún aviso de falta de conexión. Desactivado de forma predeterminada. El idioma aquí es el de la aplicación en la tableta. El idioma del sistema Android lo ves en **Diagnóstico**, como **Idioma del dispositivo**. # Automatizaciones (/es-ES/ontwikkelaars/automatiseringen) Las automatizaciones hacen que Tillor ejecute acciones por sí mismo, como crear tareas o llamar a tu sistema. La explicación para usuarios está en [Automatizaciones](/automatiseringen). Esta página describe lo que ve un integrador: el mensaje del paso **Enviar webhook**, la **Solicitud API** a una URL propia o a la API de Tillor, y cómo está construido un flujo si lo gestionas mediante la API. ## Enviar webhook [#webhook-versturen] El paso **Enviar webhook** entrega un mensaje propio a uno de los [webhooks](/ontwikkelaars/webhooks) de la organización. Es la misma entrega que con los eventos de webhook normales, con la misma firma. ### El mensaje [#het-bericht] El paso hace un `POST` con `Content-Type: application/json` y estas cabeceras: | Cabecera | Contenido | |---|---| | `X-Webhook-Event-ID` | Un ID único para esta entrega. En los reintentos el valor se mantiene igual, así que puedes deduplicar con él | | `X-Webhook-Signature` | `sha256=`, el HMAC-SHA256 del cuerpo con el signing secret del webhook | El cuerpo tiene el mismo sobre que la carga útil del webhook: ```json { "event": "automation.invoice_unpaid", "data": { "invoice": "2026-0042", "amountOutstanding": 125.5 }, "timestamp": 1735689600000, "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d", "triggeredBy": null } ``` | Campo | Descripción | |---|---| | `event` | El **Nombre del evento** que rellenaste en el paso. Se permite cualquier texto, el nombre no tiene que estar en la lista de claves de evento | | `data` | La **Carga útil** del paso, una vez rellenadas las variables, como JSON | | `timestamp` | Hora Unix en milisegundos de la entrega | | `traceId` | Un UUID aleatorio por entrega. A diferencia de los eventos del sistema, no es el ID de traza de una acción de Tillor | | `triggeredBy` | Siempre `null` | No hay `spanId`. El webhook no tiene que estar suscrito a una clave de evento: un mensaje de una automatización siempre se entrega en el endpoint elegido, mientras exista y esté activado. Cómo verificar la firma está en [Verificar la firma](/ontwikkelaars/webhooks#handtekening-verifiëren). ### Intentos y resultado [#pogingen-en-uitkomst] Dentro del paso, Tillor hace hasta 5 intentos, con 1, 2, 4 y 8 segundos de espera entre ellos. Un intento cuenta como correcto con un estado 2xx. También un destino bloqueado, por ejemplo una dirección interna, cuenta como intento fallido. - Si uno de los intentos tiene éxito, el flujo continúa por la salida **Correcto** - Si los cinco fallan, el flujo continúa por **Fallido**. Después, el mensaje se sigue reintentando en segundo plano según el calendario de [Comportamiento de entrega y reintentos](/ontwikkelaars/webhooks#leveringsgedrag-en-retries). Si uno de esos intentos posteriores tiene éxito, ya no se refleja en la ejecución, porque esta ya ha continuado Si el webhook ya no existe o está desactivado, el paso no sale por **Fallido**. La ejecución se detiene entonces con el estado **Fallido**. ## Solicitud API a una URL propia [#api-verzoek-naar-een-eigen-url] Con **Solicitud API** y **Enviar a** en **URL personalizada**, una automatización envía una solicitud HTTP a tu servidor. | Parte | Comportamiento | |---|---| | Método | `GET`, `POST`, `PUT`, `PATCH` o `DELETE` | | URL | Debe empezar por `https://`. Las variables se rellenan codificadas | | Cuerpo | JSON. No se envía con `GET` y `DELETE`. Con cuerpo, Tillor pone `Content-Type: application/json` | | Cabeceras | Libres. Los valores pueden contener variables. `Host`, `Content-Length`, `Transfer-Encoding` y `Connection` se ignoran | | Destino | Las direcciones privadas e internas se rechazan, incluso si un nombre de dominio normal apunta a ellas | | Redirecciones | No se siguen. Una respuesta 3xx cuenta como fallida | | Tiempo de espera | 15 segundos | A diferencia de **Enviar webhook**, Tillor no firma esta solicitud. Si quieres comprobar que una solicitud procede de tu automatización, pon un secreto en una cabecera y compruébalo por tu lado. Las cabeceras se guardan cifradas, así que una clave o un token ahí dentro está seguro. Una respuesta con estado 2xx continúa por **Correcto**, cualquier otro estado por **Fallido**. Si no se puede alcanzar el servidor, o supera el tiempo de espera, la ejecución se detiene con el estado **Fallido**. ## Solicitud API a la API de Tillor [#api-verzoek-naar-de-tillor-api] Con **Enviar a** en **Tillor API**, la automatización llama a la API de la propia organización. Solo indicas una ruta, por ejemplo `/tasks`, y Tillor la coloca detrás de `/api/orgs/{orgId}`. Tu referencia de API está en [OpenAPI](https://tillor.eu/api/openapi.json). - **Identidad**: la solicitud se ejecuta como el usuario Workflow de la organización. Tiene todos los permisos dentro de esa organización y en ningún otro sitio. Los cambios figuran, pues, a nombre de **Workflow** - **No hace falta clave**: Tillor ejecuta la llamada por sí mismo, sin clave de API y sin pasar por internet - **Ruta**: debe empezar por una sola `/`. No se permiten `//`, `..` ni `\`. Se admite una cadena de consulta, por ejemplo `/tasks?terrainId=…&limit=1`. Las variables en la ruta se rellenan codificadas - **Bloqueado**: las rutas `/automations` y `/automation-runs` se rechazan, también con cadena de consulta, mayúsculas, una `/` final o codificación porcentual. Una automatización no puede gestionar automatizaciones - **Cuerpo**: JSON, para `POST`, `PUT` y `PATCH`. Con `GET` y `DELETE` no se envía - **Menú de selección**: en el editor figura **Elige un endpoint de la API** con las operaciones de la especificación OpenAPI. Las operaciones internas no aparecen. Si eliges una, Tillor rellena el método, la ruta y un cuerpo de ejemplo - **Fallos**: una respuesta 2xx continúa por **Correcto**. Un estado de error, también un 404 para una ruta que no existe, sale por **Fallido** ### La respuesta en pasos posteriores [#het-antwoord-in-latere-stappen] Tras la solicitud están disponibles estas variables: | Variable | Contenido | |---|---| | `{response.status}` | El código de estado HTTP | | `{response.body}` | Los primeros 4000 caracteres de la respuesta como texto | | `{response.data}` | La respuesta como JSON. `null` si no es JSON, o si tiene más de 100.000 caracteres. Las listas se direccionan con un índice, por ejemplo `{response.data.items.0.id}` | Una segunda solicitud API en el mismo flujo sustituye a `response`. Las variables funcionan como en [Variables y plantillas](/automatiseringen/variabelen). ## La estructura de un flujo [#de-opbouw-van-een-flow] También puedes crear y modificar automatizaciones mediante la API. Las operaciones están en [OpenAPI](https://tillor.eu/api/openapi.json) bajo la etiqueta `automations`. Leer requiere el permiso `automations:read`, crear y modificar `automations:write` (o todos los permisos). El propio usuario Workflow nunca puede llamarlas. Puede ser más práctico construir un flujo en el editor y leerlo como ejemplo. Una automatización nueva siempre está desactivada. Activarla mediante `enabled` no funciona mientras el flujo tenga problemas abiertos, y un flujo activado no se puede guardar con problemas. La `definition` consta de pasos (`nodes`), líneas (`edges`) y, opcionalmente, notas (`notes`). Máximo 100 pasos, 200 líneas y 50 notas. ```json { "nodes": [ { "id": "trigger", "type": "trigger", "label": "", "position": { "x": 0, "y": 0 }, "config": { "source": "event", "eventKey": "occupation:ended" } }, { "id": "task", "type": "taskCreate", "label": "", "position": { "x": 0, "y": 190 }, "config": { "title": "Controleer {occupation.terrain.name}", "priority": "HIGH" } } ], "edges": [ { "id": "trigger:out:task", "source": "trigger", "target": "task", "sourceHandle": "out" } ], "notes": [ { "id": "note_1", "text": "Maakt na elk vertrek een controletaak.", "position": { "x": 340, "y": 0 }, "width": 240, "height": 140 } ] } ``` Una nota (`notes`) es una explicación en el lienzo. Nunca se ejecuta y no tiene líneas. `text` tiene como máximo 2000 caracteres, `width` y `height` están en píxeles. Una línea tiene un `sourceHandle`: la salida del paso de la que parte. | Paso (`type`) | Salidas (`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` | El `id` de cada rama, más `default` | | `openingHours` | `open`, `closed` | | `throttle` | `pass`, `blocked` | | `taskFind`, `documentFind`, `recordLookup` | `found`, `notFound` | | `forEach` | `each`, `done` | | `waitUntil` | `met`, `timeout` | | `waitForEvent` | `received`, `timeout` | | `approval` | `approved`, `rejected`, `timeout` | | `webhookSend`, `httpRequest` | `success`, `failed` | Cada acción, salvo `webhookSend` y `httpRequest`, recibe una salida adicional `error` en cuanto `continueOnError` está en `true` en el `config`. Sin ese ajuste, una acción fallida detiene la ejecución. Con él, el flujo continúa por `error`, con `{error.message}` y `{error.step}` como variables para los pasos siguientes. La salida `skipped` se usa cuando un paso no tenía nada que hacer, y `out` es entonces la salida normal. En `forEach`, la salida `each` inicia por cada elemento una ejecución propia para los pasos siguientes, y la salida `done` es el camino normal de continuación del propio flujo. Una salida puede llevar a varios pasos. La ejecución sigue por sí misma con la primera línea e inicia, por cada otra línea, una ejecución propia con los mismos datos, que corre en paralelo (como la salida `each` de `forEach`). Las líneas que forman un bucle se rechazan en el editor. Un flujo tiene exactamente un `trigger`. ### Ajustes por paso [#instellingen-per-stap] Los campos de `config` son los campos del editor. Los campos de texto aceptan variables entre llaves. | Paso | Campos en `config` | |---|---| | `trigger` | `source` (`event`, `webhook`, `invoiceOverdue`, `dateReached`, `daily` o `cron`), `webhookVersion` (con `webhook`: texto, auméntalo para sustituir la dirección), `eventKey`, `date` (con `dateReached`: una ruta `record.campo` a una columna `DateTime` de un modelo que envía un evento completo, como `reservation.checkIn` o `contact.birthday`, o a una clave de fecha declarada en una columna JSON, como `document.userMetadata.insuranceExpiryDate`; los nombres antiguos como `reservationCheckIn` siguen funcionando), `dateOffset` (`{ "amount", "unit" }`), `dateDirection` (`before` o `after`), `dateTime` (`exact`: la hora de la fecha, o `fixed`: el día natural de la fecha en la zona horaria de la organización, con `dateHour` y `dateMinute`, texto como `"9"` y `"0"`; el desplazamiento cuenta en el reloj, es decir, atravesando el horario de verano e invierno), `repeatYearly` (booleano: solo cuentan día y mes, cada año), `hour` y `minute` (texto, por ejemplo `"8"` y `"0"`, minuto de 0 a 59), `cron` (cinco campos; el día de la semana puede ser `1#2` o `1L`, un sexto campo `W2:2026-10-05` repite cada dos semanas), `conditions`, `oncePerRecord` (booleano) | | `condition` | `conditions` | | `switch` | `field` (una ruta de variable sin llaves), `cases`: una lista de `{ "id", "key", "value" }` con `key` como nombre de la rama y `value` como valor al que debe ser igual el campo. Máximo 8 ramas | | `delay` | `mode` (`duration` o `untilDate`), `duration` y `offset` como `{ "amount", "unit" }` con `unit` igual a `seconds`, `minutes`, `hours`, `days` o `weeks`, `dateField` (ruta de variable), `direction` (`before` o `after`) | | `taskCreate` | `title`, `description`, `assigneeIds`, `labelIds`, `assignActor`, `priority` (`LOW`, `MEDIUM`, `HIGH` o `URGENT`), `viewId`, `laneId`, `subtasks` (una por línea), `dueIn` (`{ "amount", "unit" }`), `linkRecords` | | `taskSetStatus` | `taskId`, `status` (`PENDING`, `IN_PROGRESS`, `WAITING` o `COMPLETED`) | | `taskFind` | `title` (título exacto), `linkedToRecords`, `onlyOpen`, `onlyTopLevel` (booleanos) | | `documentFind` | `customerId` (plantilla), `documentType` (`INSURANCE_POLICY`, `INSURANCE_PAYMENT_PROOF`, `IDENTITY_CARD`, `SEPA_MANDATE`, `OTHER` o vacío), `onlyActive`, `onlyValid` (booleanos). Resultado bajo `foundDocument` | | `documentUpdate` | `documentId` (plantilla), `documentType` (vacío mantiene el tipo), `status` (`ACTIVE`, `ARCHIVED` o vacío) | | `taskSetPriority` | `taskId`, `mode` (`raise`, `lower` o `set`), `priority` (con `set`), `maxPriority` (con `raise`) | | `taskUpdate` | `taskId`, `title`, `assigneeIds`, `assignActor`, `assigneeMode` (`add` o `replace`), `labelIds`, `dueIn` (`{ "amount", "unit" }` con `unit` igual a `minutes`, `hours`, `days` o `weeks`) | | `invoiceReminderSend`, `invoiceSend`, `invoiceBook` | `invoiceId` | | `invoicePrint` | `invoiceId`, `printer` (`a4`, `pos` o `tablet`) | | `paymentLinkCreate` | `invoiceId`, `method` (`any`, `BANCONTACT`, `IDEAL`, `CREDITCARD` o `PAYCONIQ`) | | `mandateRequest` | `customerId`, `mode` (`request` o `reminder`) | | `mandateCollect` | `invoiceId`, `delayDays` (texto, predeterminado `"0"`, como máximo 7) | | `consumptionInvoice` | `customerId`, `sendEmail`, `sendSms` | | `occupationExtendInvoice` | `occupationId`, `includeConsumption` | | `customerMessageSend` | `customerId`, `subject`, `body`, `sendEmail`, `sendSms`, `sendWhatsApp` | | `staffNotify` | `userIds`, `notifyActor`, `title`, `body`, `sendPush`, `sendEmail` | | `commentCreate` | `content`, `target` (`event` o `task`), `taskId` (con `task`) | | `inboxReply` | `threadId`, `body`, `keepAssistant` | | `inboxTag` | `threadId`, `tagIds`, `archive` | | `customerUpdate` | `customerId`, `status` (`keep`, `DEFAULT`, `PREFERRED`, `VIP`, `WARNING` o `BLACKLISTED`), `notes` | | `reservationSetStatus` | `reservationId`, `action` (`checkIn`, `checkOut` o `cancel`) | | `accessMethodCreate` | `customerId`, `type` (`QR_CODE`, `LPR`, `PIN_CODE` o `NFC`), `value`, `periodFrom`, `periodTo` (variables con una fecha, vacío significa sin límite) | | `accessMethodUpdate` | `scope` (`one` o `customer`), `accessMethodId` (con `one`), `customerId` (con `customer`), `status` (`keep`, `ACTIVE`, `SOFT_BLOCKED`, `BLOCKED` o `INACTIVE`), `periodTo` | | `accessMethodSendQr` | `accessMethodId`, `sendEmail`, `sendSms`, `sendWhatsApp`, `print` (`none`, `label` o `thermal`) | | `accessPointControl` | `accessPointId`, `action` (`open` o `close`) | | `meterSwitch` | `target` (`terrain` o `meter`), `terrainId` (con `terrain`), `meterId` (con `meter`), `state` (`on` u `off`) | | `nfcTagUpdate` | `customerId`, `action` (`block`, `unblock`, `topUp` o `lowBalance`), `amount` (con `topUp`, en euros por tag) | | `deviceCommand` | `deviceId`, `command` (`wake`, `sleep`, `reload`, `identify`, `testSound` o `playSound`), `url` (con `playSound`: la ruta de un sonido subido, tal como la rellena el editor, o un enlace https a un archivo mp3, wav o m4a) | | `deviceDisplay` | `kind` (`pdf` o `image`), `url` (enlace https). Aparece en cada tableta configurada como pantalla, como un PDF de factura | | `controllerRelay` | `target` (`controller` o `event`: el controlador del evento `controller:input:changed` que inició el flujo), `controllerId` (con `controller`), `relay` (texto `"1"` a `"6"`), `action` (`pulse`, `on` u `off`), `durationSeconds` (con `pulse`, texto, de 0.001 a 3600 con decimales como `"0.5"`; el relé vuelve a soltarse solo) | | `controllerCommand` | `target` y `controllerId` como en `controllerRelay`, `command` (`reboot`, `rebootExtension`, `otaUpdate`, `forceOtaUpdate`, `extensionOtaUpdate` o `refreshSettings`) | | `deviceSlideshow` | `scope` (`displays` o `device`), `mode` (`screensaver` o `background`), `source` (`feed` o `urls`). Con `feed`: `itemsPath`, `imageField`, opcionalmente campos de filtro y ordenación | | `openingHours`, `waitUntilOpen`, `waitUntilClosed` | Sin campos | | `throttle` | `window` (`{ "amount", "unit" }` con `unit` igual a `minutes`, `hours`, `days` o `weeks`), `key` (vacío es por registro que inició el flujo) | | `recordLookup` | `model` (`Customer`, `Reservation`, `Occupation`, `Invoice`, `Payment`, `Terrain`, `Task`, `Document`, `AccessMethod`, `NfcTag`, `Meter`, `InboxThread` o `InboxMessage`), `recordId`. El resultado está bajo `found` más el modelo, como `foundCustomer` | | `forEach` | `source` (`customerAccessMethods`, `customerNfcTags`, `customerOpenInvoices`, `customerUpcomingReservations`, `customerOccupations`, `customerDocuments` (solo `ACTIVE`) o `terrainMeters`), `parentId` (id del cliente o del terreno). Como máximo 100 elementos, el elemento está bajo `item` | | `waitUntil` | `conditions`, `interval` y `timeout` (`{ "amount", "unit" }` con `unit` igual a `minutes`, `hours`, `days` o `weeks`; el intervalo es de al menos 5 minutos) | | `waitForEvent` | `eventKey`, `sameRecord` (booleano), `timeout` (`{ "amount", "unit" }`) | | `approval` | `title`, `description`, `assigneeIds`, `timeout` (`{ "amount", "unit" }`). La tarea está bajo `approvalTask.id` | | Cada acción salvo `webhookSend` y `httpRequest` | `continueOnError` (booleano) | | `webhookSend` | `webhookId`, `event`, `payload` (JSON como texto) | | `httpRequest` | `target` (`tillor` o `custom`), `method`, `path` (con `tillor`), `url` (con `custom`), `headers` (lista de `{ "id", "key", "value" }`), `body` (JSON como texto) | `conditions` tiene la forma `{ "match": "all" o "any", "rules": [...] }`. Cada regla es `{ "id", "field", "operator", "value", "values" }`. `operator` es `is`, `isNot`, `contains`, `greaterThan`, `lessThan`, `isOneOf`, `isEmpty` o `isNotEmpty`. `values` solo se usa con `isOneOf`. Una lista de reglas vacía deja pasar todo. ## Iniciar una automatización con un webhook [#een-automatisering-starten-met-een-webhook] Una automatización con trigger `webhook` se inicia con un `POST` a su propia dirección: ```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"}' ``` - La dirección completa está en el editor, en el trigger, o mediante `GET /automations/{id}/webhook-url` (con `automations:read`). El token es el secreto; no hace falta una cabecera para autenticar - El cuerpo JSON pasa a ser la variable `body`, la cadena de consulta `query` y el momento `receivedAt` - Respuesta `200` con `{ "accepted": true }` en cuanto se inicia la ejecución. Una dirección incorrecta, sustituida o desactivada da `404`, un cuerpo de más de 100 KB da `400` - Muchas llamadas seguidas en poco tiempo no se rechazan: cada llamada válida inicia una ejecución. Usa **Ignorar repeticiones** en el trigger si la misma llamada puede llegar dos veces, consulta [Ignorar repeticiones](/automatiseringen/triggers#herhalingen-negeren) Una automatización no puede llamar a su propio webhook mediante una **Solicitud API** a la API de Tillor. ## Elegir una decisión mediante la API [#een-beslissing-kiezen-via-de-api] La tarea de un paso **Pedir una decisión** tiene una acción por cada opción que configuraste en el paso. Obtén la tarea para ver las `actions` con su `id`, y elige una con `POST /tasks/{id}/actions/{actionId}/choose`. Si la opción pide una nota, envíala como `{ "note": "..." }`. La elección es definitiva: cierra la tarea y continúa la automatización por la salida de esa opción. Pueden elegir los compañeros asignados (también mediante un grupo) y los administradores. Consulta [OpenAPI](https://tillor.eu/api/openapi.json) para los detalles. ## Leer más [#meer-lezen] - [Webhooks](/ontwikkelaars/webhooks) para la firma, los reintentos y la lista de eventos - [API HTTP](/ontwikkelaars/http) para la autenticación y el contexto de la organización - [Variables y plantillas](/automatiseringen/variabelen) para la explicación para usuarios # Event-index (/es-ES/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" } } ``` # Notificaciones externas (/es-ES/ontwikkelaars/externe-notificaties) ¿Tu sistema envía por su cuenta correos a clientes (boletín, confirmación de reserva, recordatorio)? Regístralos entonces en Tillor. El personal los ve en el cliente, en la factura y en el resumen **Notificaciones**, junto a las notificaciones que envía el propio Tillor. Tillor **no envía nada**: registras un mensaje que ya se ha enviado. Las notificaciones externas llevan siempre en la aplicación la etiqueta **Externa** con el nombre de tu fuente, para que nunca se confundan con una notificación de Tillor. ## Acceso [#toegang] El usuario detrás de la [clave de API](/ontwikkelaars/http) necesita en la organización uno de estos permisos. Un administrador los concede en los permisos de usuario de la organización, en el grupo **Notificaciones** (**Registrar notificaciones externas** y **Gestionar notificaciones externas de otros**). | Permiso | Qué puedes hacer | |-----------|------------| | `notifications:external:write` | Registrar notificaciones y actualizar o eliminar tus **propios** registros | | `notifications:external:manage-others` | También actualizar o eliminar registros de otros usuarios o integraciones | La propiedad depende del usuario de la clave de API. Usa para cada integración un usuario (de servicio) propio, y así una integración nunca podrá modificar las notificaciones de otra. ## Endpoints [#endpoints] Todas las rutas están bajo `/api/orgs/:orgId`. Esquemas exactos: [OpenAPI](https://tillor.eu/api/openapi.json), etiqueta `notifications`. | Method | Ruta | Descripción | |--------|-----|--------------| | POST | `/notifications/external` | Registrar una notificación | | PATCH | `/notifications/external/{id}` | Actualizar el estado, las marcas de tiempo o el contenido | | DELETE | `/notifications/external/{id}` | Eliminar definitivamente | | GET | `/notifications?source=EXTERNAL` | Listar las notificaciones registradas (filtra también por `externalSource`, `externalReference`, `customerId`, `invoiceId`) | | GET | `/notifications/{id}` | Obtener una notificación | Las notificaciones que envió el propio Tillor no se pueden modificar ni eliminar con estos endpoints; devuelven `404`. ## Registrar [#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 }] } }' ``` Todos los campos y límites están en [OpenAPI](https://tillor.eu/api/openapi.json). Estos campos tienen reglas que debes conocer de antemano: | Campo | Regla | |------|-------| | `externalSource` | Nombre de tu sistema en minúsculas, cifras, `.`, `_` o `-` (p. ej. `mailchimp`). El personal ve este nombre en la notificación | | `externalReference` | Tu propio ID para este mensaje, único dentro de `externalSource` | | `name` | Etiqueta breve para el personal (p. ej. "Confirmación de reserva"). Se puede buscar por ella | | `customerId` / `invoiceId` | Al menos uno de los dos. Determina dónde aparece la notificación. Si solo envías `invoiceId`, Tillor vincula también al cliente de esa factura. Un ID desconocido, o una factura de otro cliente, da `400` | | `status` | `SENT`, `FAILED`, `BOUNCED` o `COMPLAINED`. Sin `sentAt` con `SENT`, Tillor usa el momento del registro | | `sentAt`, `readAt`, `clickedAt` | ISO 8601 con zona horaria, p. ej. `2026-09-19T08:15:00Z`. Se rechazan otros valores | | `email.attachments` | Solo metadatos (`filename`, `contentType`, `size`). Los archivos en sí no se guardan | ### Reintentar con seguridad [#veilig-opnieuw-proberen] `POST` es idempotente en `externalSource` + `externalReference`. Si envías de nuevo la misma combinación (por ejemplo tras un tiempo de espera agotado), recibes la notificación **existente** y no se modifica nada. Si quieres cambiar algo, usa `PATCH`. `externalSource`, `externalReference` y `name` se guardan sin cifrar porque se busca por ellos. Usa un ID técnico, no una dirección de correo ni un nombre. Un `externalReference` con `@` se rechaza. El destinatario, el asunto, el contenido y los adjuntos sí se guardan cifrados. ## Actualizar y eliminar [#bijwerken-en-verwijderen] Con `PATCH` envía solo los campos que cambian, por ejemplo cuando un correo rebota a posteriori: ```bash curl -X PATCH "https://tillor.eu/api/orgs/org_abc123/notifications/external/NOTIFICATION_ID" \ -H "x-api-key: tkn_xxx" \ -H "Content-Type: application/json" \ -d '{ "status": "BOUNCED", "errorMessage": "Mailbox bestaat niet" }' ``` `DELETE` elimina la notificación definitivamente, incluido su contenido. Úsalo también para atender una solicitud de eliminación (RGPD). Un `PATCH` que no cambia nada no hace nada: ni cambio ni evento. Si modificas el contenido (etiqueta, destinatario, remitente, asunto, texto, HTML o adjuntos) o eliminas una notificación, queda en el registro de actividad del cliente o de la factura, con el usuario que lo hizo. Las actualizaciones de estado, `readAt` o `clickedAt` no aparecen ahí, para que puedas seguir sincronizando aperturas y clics. ## HTML y privacidad [#html-en-privacy] Tillor muestra el HTML al personal tal como lo recibió el cliente, pero lo trata como contenido no fiable: - Al guardar se eliminan scripts, formularios, iframes, embeds y atributos de evento (`onclick`, ...). Los enlaces se abren en una pestaña nueva - La vista previa se ejecuta en un marco aislado, sin scripts y sin acceso a la sesión de Tillor - Las imágenes y fuentes externas **no se cargan automáticamente**, para que abrir una notificación no active un píxel de seguimiento. El empleado puede cargar las imágenes por notificación Por tanto, no cuentes con que el seguimiento de "abierto" salte en tu sistema cuando un empleado mira la notificación. ## Lo que Tillor no hace con las notificaciones externas [#wat-tillor-niet-doet-met-externe-notificaties] - No las (re)envía ni reintenta automáticamente - No recupera actualizaciones de estado de tu proveedor de correo: tú mantienes el estado al día con `PATCH` - No las cuenta en las listas **Notificaciones fallidas**, **Notificaciones rebotadas** y **Notificaciones pendientes** ni en los contadores de arriba del resumen de notificaciones, porque Tillor no puede verificar tu estado. Sí aparecen en **Comunicaciones recientes** ## Webhooks y SSE [#webhooks-en-sse] | Evento | Cuándo | |-------|-------| | `notification-delivery:updated` | Al registrar y en cada `PATCH` que cambia algo. Contiene la notificación completa | | `notification-delivery:deleted` | Con `DELETE`. Contiene solo `id`, `source`, `externalSource`, `externalReference`, `customerId` y `invoiceId` | El campo `source` es `EXTERNAL` para tus registros e `INTERNAL` para las notificaciones de Tillor. Filtra por él si quieres saltarte tus propios eventos. Consulta [Webhooks](/ontwikkelaars/webhooks) y [SSE](/ontwikkelaars/sse). ## Relacionado [#gerelateerd] - [API HTTP](/ontwikkelaars/http) - Claves de API, cabeceras y rate limits - [Webhooks](/ontwikkelaars/webhooks) - Recibir eventos mediante HTTP POST - [OpenAPI](https://tillor.eu/api/openapi.json) - Esquemas completos # API HTTP (/es-ES/ontwikkelaars/http) La API de Tillor es una REST API. Autentícate con una clave de API y envía las cabeceras correctas en cada request. Las claves de API son **por cuenta**: una clave funciona para todas las organizaciones a las que tienes acceso. ## Referencia de la API y OpenAPI [#api-referentie-en-openapi] - **[Referencia de la API](/api-referentie)** - Cada endpoint con parámetros y ejemplos; prueba requests directamente en el navegador - **[Especificación OpenAPI](https://tillor.eu/api/openapi.json)** - Documentación completa de la API en formato JSON para generar código o importarla en Postman/Insomnia --- ## Claves de API [#api-sleutels] ### Crear [#aanmaken] Las claves de API las creas en la aplicación de Tillor mediante el menú de usuario, en **Cuenta > Claves API** (marca **1** = menú, marca **2** = Claves API en la captura). También puedes crearlas mediante la API con una sesión iniciada (sin clave de API). Consulta la [especificación OpenAPI](https://tillor.eu/api/openapi.json) bajo la etiqueta `api-keys` para las rutas y los esquemas de request y response. La clave en bruto se devuelve **una sola vez** al crearla o regenerarla. Guárdala de forma segura; después ya no se puede recuperar. ### Limitar los permisos [#rechten-beperken] De forma predeterminada, una clave puede todo lo que puedes tú, en cada organización de la que eres miembro. En la ventana de la clave activa **Limitar a los permisos seleccionados** y elige los permisos que necesita la integración, por ejemplo solo leer facturas. Una clave limitada obtiene en cada organización la intersección de sus permisos y tu pertenencia allí: una clave nunca puede más que tú. Una llamada fuera de los permisos elegidos recibe `403 Forbidden`, igual que un usuario sin ese permiso. Un cambio de los permisos vale en un minuto. Mediante la API: `scopes` (lista de ids de permisos como `invoices:read`, o `null` para todo) al crear y actualizar una clave. ### Uso [#gebruik] Envía la clave de API en la cabecera `x-api-key`: ```http x-api-key: tkn_xxx ``` Las claves usan el prefijo `tkn_`. En los endpoints de organización, el ID de la organización va en la ruta (`/orgs/org_abc123/...`); no hace falta una cabecera aparte. ### Rate limits [#rate-limits] - **Predeterminado:** 5000 requests por 60 segundos por clave - Al superarlo: `429 Too Many Requests` con `Retry-After` - Cada respuesta con clave de API contiene cabeceras IETF `RateLimit-*`: ```http RateLimit-Limit: 5000 RateLimit-Remaining: 4999 RateLimit-Reset: 58 RateLimit-Policy: 5000;w=60 ``` `RateLimit-Reset` es el número de segundos hasta que empieza de nuevo la ventana actual. Los clientes de navegador pueden leer estas cabeceras mediante CORS (`Access-Control-Expose-Headers`). ### Seguridad [#beveiliging] - **Nunca** expongas claves de API en código del lado del cliente ni en repositorios públicos - Regenera las claves periódicamente con **Regenerar** en la aplicación (OpenAPI: `POST /api/api-keys/:id/renew`) - Elimina las claves sin uso con `DELETE /api/api-keys/:id` --- ## Base URL y contexto de la organización [#base-url-en-organisatie-context] **Base URL:** `https://tillor.eu` (o la URL de tu despliegue; OpenAPI menciona `{APP_URL}/api`) **Rutas de organización:** añade el ID de la organización en la ruta: ``` /api/orgs/:orgId/... ``` **Ejemplo:** ``` GET https://tillor.eu/api/orgs/org_abc123/customers ``` **Cabecera obligatoria para los endpoints de organización:** `x-api-key: tkn_xxx`. El ID de la organización va en la ruta. --- ## Ejemplo: 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" ``` --- ## Integraciones (marketplace) [#integraties-marketplace] Las integraciones de la organización (antes "apps" en la API) usan un recurso por tipo bajo `/api/orgs/:orgId/integrations/{integrationType}`. Los permisos necesarios son `organization:integrations:read` y `organization:integrations:write` (sustituye a `organization:apps:*`). | Method | Ruta | Descripción | |--------|------|-------------| | GET | `/integrations/{integrationType}` | Estado (`installed`, `available`) y `settings` censurados | | POST | `/integrations/{integrationType}` | Instalar (`settings` opcional en el cuerpo; OAuth puede devolver `redirectUrl`) | | PUT | `/integrations/{integrationType}` | Actualizar ajustes (`settings` en el cuerpo) | | DELETE | `/integrations/{integrationType}` | Desinstalar | Con `GET` y tras `PUT`, `settings` contiene solo campos **públicos** más, por cada campo secreto, `{ configured: true }`. Las contraseñas, claves de API y tokens OAuth no se devuelven. Deja vacíos los campos secretos en `PUT` para conservar el valor existente. Consulta la [especificación OpenAPI](https://tillor.eu/api/openapi.json) (etiqueta `integrations`) para los esquemas exactos. --- ## Relacionado [#gerelateerd] - [Referencia de la API](/api-referentie) - Cada endpoint, para probar en el navegador - [OpenAPI](https://tillor.eu/api/openapi.json) - Especificación de la API (JSON) - [MCP](/ontwikkelaars/mcp) - Conectar Cursor, Claude, ChatGPT o Gemini mediante OAuth - [Notificaciones externas](/ontwikkelaars/externe-notificaties) - Registra los correos que envió tu propio sistema - [Webhooks](/ontwikkelaars/webhooks) - Recibe eventos mediante HTTP POST - [Webhook entrante de una automatización](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - Inicia una automatización con un POST, sin clave de API - [SSE](/ontwikkelaars/sse) - Transmite eventos mediante Server-Sent Events - [Ejemplos](/ontwikkelaars/voorbeelden) - Ejemplos de código y de carga útil # Resumen (/es-ES/ontwikkelaars) La API de Tillor ofrece acceso programático a los datos de tu organización. Usa claves de API para autenticarte, webhooks para eventos salientes, SSE o MQTT para streaming en tiempo real, o MCP para conectar herramientas de IA como Cursor, Claude, ChatGPT y Gemini con Tillor. ## ¿Qué puedes construir? [#wat-kun-je-bouwen] - **Integraciones** - Conecta Tillor con tus propios sistemas mediante la REST API - **Webhooks** - Recibe mensajes HTTP POST cuando ocurren eventos (factura pagada, cliente creado, etc.) - **Iniciar automatizaciones** - Inicia una automatización desde tu propio sistema con un POST a su [webhook entrante](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - **Paneles en tiempo real** - Transmite eventos mediante SSE o MQTT para actualizaciones en directo en tu aplicación - **Herramientas de IA** - Deja que Cursor, Claude, ChatGPT o Gemini llamen a la API mediante [MCP](/ontwikkelaars/mcp) (`https://mcp.tillor.dev`) ## Primeros pasos [#snel-aan-de-slag] 1. **Crea una clave de API** en Tillor en *Cuenta > Claves API* 2. **Envía la clave** en la cabecera `x-api-key` en cada request 3. **Pon el ID de tu organización en la ruta** de los endpoints de organización: `/orgs/org_abc123/...` Los webhooks y SSE entregan exactamente los mismos eventos. La diferencia: los webhooks envían un HTTP POST a tu URL; SSE es una conexión larga por la que recibes eventos. **Enlaces útiles:** [Referencia de la API](/api-referentie) - [OpenAPI](https://tillor.eu/api/openapi.json) **Alcance:** las claves de API son por cuenta (todas las organizaciones); los webhooks son por organización. También puedes usar este sitio como texto para herramientas de IA: [`/llms.txt`](/llms.txt) (índice), [`/llms-full.txt`](/llms-full.txt) (todas las páginas juntas) y, por página, añadiendo `.mdx` a la ruta (por ejemplo [`/ontwikkelaars/http.mdx`](/ontwikkelaars/http.mdx)). **Pregunta a la IA (local)** en el diseño de la documentación carga esa exportación completa (`/llms-full.txt`) en la IA integrada de Chrome, para que no tengas que estar en una página concreta. ## Véase también [#zie-ook] # MCP (/es-ES/ontwikkelaars/mcp) Con MCP (Model Context Protocol), herramientas como Cursor, Claude, ChatGPT y Gemini pueden llamar a la API de Tillor por ti. Inicias sesión una vez mediante OAuth; no hace falta que haya ninguna clave de API en tu configuración. **URL:** `https://mcp.tillor.dev` ## Qué puedes hacer con ello [#wat-je-ermee-kunt] Una vez conectada, en la herramienta de IA puedes: 1. Consultar categorías de API y endpoints (a partir de la especificación OpenAPI) 2. Llamar a endpoints con tus permisos en la organización elegida Todo pasa por la misma API REST que la [API HTTP](/ontwikkelaars/http). Lo que puedes hacer depende de tu cuenta de Tillor y de tus permisos en esa organización. Conectar mediante OAuth requiere el permiso **Autorizar aplicaciones OAuth** (`oauth:consent`) en al menos una organización. Sin ese permiso, el consentimiento falla y los tokens OAuth existentes dejan de funcionar. ## Autenticación [#authenticatie] 1. La herramienta se conecta a `https://mcp.tillor.dev` sin token 2. El descubrimiento y el registro de OAuth se hacen en el host MCP; el inicio de sesión y el consentimiento, en Tillor 3. Apruebas el acceso en el navegador 4. Después, la herramienta envía un token Bearer en las llamadas MCP Envía tu organización como encabezado cuando la herramienta lo admita (Cursor, Gemini CLI): ```http X-Tillor-Org-Id: org_abc123 ``` Sin ese encabezado (ChatGPT, la app de Gemini, Claude) indicas `organizationId` en `call_api_endpoint`. Las rutas de organización están bajo `/orgs/{organizationId}`; la API rellena entonces el encabezado por sí misma. Para el servidor MCP alojado usas OAuth (Connect / Authorize en la herramienta). Para scripts e integraciones propias sigues usando [claves de API](/ontwikkelaars/http). ## Conectar [#koppelen] Elige tu herramienta: O abre el [selector de instalación](https://install.apicommons.org/?config=eyJuYW1lIjoiVGlsbG9yIiwiZGVzY3JpcHRpb24iOiJUaWxsb3IgUkVTVCBBUEkgdmlhIE9BdXRoIiwicmVtb3RlIjp7InR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudGlsbG9yLmRldi9tY3AiLCJoZWFkZXJzIjp7IlgtVGlsbG9yLU9yZy1JZCI6Ijxvcmdhbml6YXRpb25JZD4ifX19) para Cline, Zed, Warp, Codex y el resto. ## Herramientas [#tools] | Herramienta | Finalidad | |------|------| | `list_api_categories` | Lista las categorías de API | | `list_api_endpoints` | Endpoints de una categoría, con esquema de entrada | | `get_api_endpoint_schema` | Esquema de un endpoint por nombre | | `call_api_endpoint` | Llama a un endpoint | Los nombres de endpoint no son herramientas independientes: usa `call_api_endpoint`. La referencia REST completa sigue siendo [OpenAPI](https://tillor.eu/api/openapi.json). MCP es una capa sobre ella, no una API de producto aparte. ## Relacionado [#gerelateerd] - [API HTTP](/ontwikkelaars/http) - claves de API, encabezados y URL base - [OpenAPI](https://tillor.eu/api/openapi.json) - especificación completa de la API - [Referencia de la API](/api-referentie) - cada endpoint, para probar en el navegador # Metadatos de Mollie (/es-ES/ontwikkelaars/mollie-metadata) Mollie guarda metadatos en cada pago. Tillor lee y escribe campos en el espacio de nombres `tillor`. Conexión en la app: [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie). Hay tres tipos: 1. **Metadatos de conexión** - Tillor los escribe de vuelta en Mollie para que el pago sea reconocible 2. **Pistas de ingestión** - las pones tú al crear el pago en Mollie 3. **Metadatos contables directos** - saltan Tillor y van directamente a la contabilidad ## Metadatos de conexión [#koppelingsmetadata] ```json { "tillor": { "paymentId": "clx123...", "invoiceId": "clx456...", "customerId": "clx789...", "paymentGroupId": "clxgrp..." } } ``` Tillor escribe `paymentId`, `invoiceId`, `customerId` y `paymentGroupId` en Mollie en cuanto un pago está vinculado a una factura, a un cliente o a un [grupo de pagos](/betalingsverwerking/groepen). Los metadatos existentes que no son de Tillor se conservan. | Campo | Descripción | |------|---------------| | `paymentId` | Pago de Tillor | | `invoiceId` | Factura de Tillor | | `customerId` | Cliente de Tillor | | `paymentGroupId` | Grupo de pagos, incluso si ese grupo aún no está vinculado a una factura | ## Pista de ingestión: `descriptionSuffix` [#ingestie-hint-descriptionsuffix] La pones tú al crear el pago en Mollie. Tillor la usa para la descripción del pago en cuanto hay una factura vinculada. ```json { "tillor": { "descriptionSuffix": "Parkeerplaats P1" } } ``` Formato en Tillor: `INV/XXXX/XXXX - {suffix}`. ## Pistas de ingestión para grupos de pagos [#ingestie-hints-voor-betalingsgroepen] Útil para turnos de TPV o actividades: agrupa varios pagos antes de contabilizar una factura. ```json { "tillor": { "paymentGroupName": "Yoga sunrise - Lake Como", "paymentGroupExternalId": "act_42" } } ``` Basta con uno de los dos campos. Usar ambos es mejor si la etiqueta puede cambiar pero el ID se mantiene estable. | Campo | Descripción | |------|---------------| | `paymentGroupName` | Etiqueta visible en Tillor. Coincide por nombre con grupos abiertos existentes, o se convierte en la etiqueta de un grupo nuevo | | `paymentGroupExternalId` | Clave estable de tu sistema. Se busca por ella en lugar de por nombre; la etiqueta sigue a `paymentGroupName` | 1. Tillor busca un grupo **abierto** con este ID externo (o, sin ID, con este nombre). 2. ¿No hay coincidencia? Se crea un grupo abierto nuevo. El nombre es `paymentGroupName`; si no, `paymentGroupExternalId`. 3. El pago entra en el grupo en cuanto está **pagado** en Tillor. 4. Los grupos que ya están vinculados a una factura no se reutilizan. ¿Las pistas no estaban aún en el pago de Mollie cuando Tillor lo vio por primera vez? El grupo se rellena igualmente en cuanto el pago está **pagado**, **no** está vinculado a una factura y **todavía** no está en ningún grupo. Esto ocurre en la siguiente sincronización o con una notificación entrante de Mollie. Etiqueta de antemano cada pago de Mollie desde tu TPV. El grupo aparece en *Administración > Pagos*, sección *Grupos de pago*. Un pago agrupado no puede vincularse por separado a una factura. Si envías tanto pistas de grupo como `invoiceId`, gana el grupo. ## Metadatos contables directos (`tillor.bookkeeping`) [#directe-boekhoudmetadata-tillorbookkeeping] Los pagos de Mollie desconocidos van por defecto a la cuenta de espera **499000**. Con `tillor.bookkeeping`, Tillor los contabiliza en el cliente indicado: ```json { "tillor": { "bookkeeping": { "customerCode": "100001", "documentType": "INV", "department": "a", "fiscalYear": "2026", "documentNumber": "00042" } } } ``` | Campo | Descripción | |------|---------------| | `customerCode` | Código de cliente en la contabilidad - obligatorio | | `documentType` | P. ej. INV, UF | | `department` | Departamento | | `fiscalYear` | Ejercicio contable | | `documentNumber` | Número de documento | Si `bookkeeping` está presente, el pago **no** entra como un pago normal de Tillor. Los metadatos se usan al generar el informe contable. ## Véase también [#zie-ook] # MQTT (/es-ES/ontwikkelaars/mqtt) Las credenciales MQTT dan a las integraciones acceso pub/sub dentro del espacio de nombres de topics de tu organización. Las credenciales se crean en Tillor en **Cuenta > Desarrolladores** (por organización). El acceso a los topics se limita a `tillor/{env}/{orgId}/integration` y sus subtopics (`{env}` = `prod`, `staging` o `local`), salvo que una credencial estática tenga `topicPrefix: null`. Para los mismos eventos en tiempo real que con [webhooks](/ontwikkelaars/webhooks) y [SSE](/ontwikkelaars/sse), usa esos canales, no MQTT. ## Gestión [#beheer] | Método | Ruta | Descripción | |--------|------|---------------| | POST | `/api/orgs/:orgId/mqtt/credentials` | Generar credenciales JWT (temporales) | | GET | `/api/orgs/:orgId/mqtt/static-credentials` | Obtener credenciales estáticas | | POST | `/api/orgs/:orgId/mqtt/static-credentials` | Crear una credencial estática | | DELETE | `/api/orgs/:orgId/mqtt/static-credentials/:id` | Eliminar una credencial estática | Autenticación: `x-api-key`, con el ID de la organización en la ruta (igual que en la [API HTTP](/ontwikkelaars/http)). Consulta la [especificación OpenAPI](https://tillor.eu/api/openapi.json) para los esquemas completos de petición y respuesta. ## Credenciales [#credentials] Hay dos variantes: ### JWT (temporal) [#jwt-tijdelijk] - **Uso:** Sesiones cortas, acceso temporal - **Caducidad:** Por defecto 1 hora; configurable de 1 minuto a 24 horas mediante `expiresInSeconds` - **Ideal para:** Pruebas, conexiones temporales, o cuando obtienes los tokens de forma dinámica - **Creación:** En Tillor en **Cuenta > Desarrolladores**, o mediante `POST /api/orgs/:orgId/mqtt/credentials` con, opcionalmente, `{ "clientId": "...", "expiresInSeconds": 3600 }` - **Respuesta:** `token` (úsalo como contraseña MQTT), `clientId`, `brokerUrl`, `topicPrefix`, `expiresAt` - **Nombre de usuario:** Déjalo vacío al conectar; la autenticación JWT solo usa el token como contraseña. - **Client ID:** Usa exactamente el `clientId` de la respuesta al conectar (incluido el prefijo de entorno, p. ej. `prod-`). Una conexión al broker mediante **mqtts** comprueba el certificado del servidor. Si usas un certificado de CA **privada** (no la cadena pública estándar), pon el PEM de esa CA en el entorno de tu cliente. ### Credenciales estáticas [#statische-credentials] - **Uso:** Integraciones de larga duración, conexiones siempre activas - **Forma:** userName, clientId y password fijos - **Ideal para:** Integraciones de producción que permanecen conectadas de forma continua - **Creación:** En Tillor en **Cuenta > Desarrolladores**, o mediante `POST /api/orgs/:orgId/mqtt/static-credentials` con, opcionalmente, `{ "name": "mijn-integratie", "topicPrefix": null }` - **Respuesta:** `userName`, `clientId`, `password` (una sola vez), `topicPrefix` (`null` = sin prefijo, ACL `#`), opcionalmente `brokerUrl` - **Atención:** La contraseña se muestra una sola vez en la respuesta y después ya no se puede recuperar --- ## Acceso a topics [#topic-toegang] Las suscripciones a topics están **estrictamente limitadas**, salvo que `topicPrefix` sea `null` (ACL `#`). Por defecto solo puedes publicar y suscribirte a `tillor/{env}/{orgId}/integration` y `tillor/{env}/{orgId}/integration/#`. - **Topics permitidos** - Solo `tillor/{env}/{orgId}/integration` y sus subtopics (p. ej. `tillor/{env}/{orgId}/integration/connector/access-point-operation`) - **Sin saltarse el límite con comodines** - Incluso con `#` o `+` solo obtienes acceso al espacio de nombres de tu organización - **Por organización** - Las credenciales son por organización; no tienes acceso a los topics de otras organizaciones --- ## Relacionado [#gerelateerd] - [OpenAPI](https://tillor.eu/api/openapi.json) - especificación completa de la API - [API HTTP](/ontwikkelaars/http) - API REST y claves de API - [Webhooks](/ontwikkelaars/webhooks) - los mismos eventos mediante HTTP POST - [SSE](/ontwikkelaars/sse) - recibe eventos en streaming mediante Server-Sent Events # OAuth-clients (/es-ES/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) (/es-ES/ontwikkelaars/sse) SSE ofrece un flujo de larga duración con los mismos eventos que reciben los [webhooks](/ontwikkelaars/webhooks). Usa SSE si prefieres una conexión persistente a las llamadas HTTP de retorno. ## Endpoint [#endpoint] ``` GET /api/orgs/:orgId/realtime/subscribe ``` ## Autenticación [#authenticatie] SSE usa la misma autenticación que los demás endpoints de la API: - **x-api-key** - Tu clave de API El ID de la organización va en la ruta de la URL. ## Filtrado de eventos [#event-filtering] Usa el parámetro de consulta `events` para filtrar por tipo de evento: ``` GET /api/orgs/:orgId/realtime/subscribe?events=invoice:created&events=invoice:paid ``` Usa `events=*` para recibir todos los eventos (igual que omitir el parámetro). Consulta el [índice de eventos](/ontwikkelaars/events) para ver todos los eventos, el permiso de cada uno y un ejemplo de payload. Unos pocos eventos tienen su propio canal (logs del controlador y E/S del controlador). Solo los recibes con `?channel=controller-logs` o `?channel=controller-io`; el índice de eventos indica el canal. Tillor solo entrega eventos para los que el miembro de la organización con sesión iniciada tiene permiso. Sin `bank-transactions:read` (o sync), por ejemplo, no recibes eventos `bankAccountTransaction:*`, ni siquiera si no envías ningún filtro `events`. Los datos vinculados de otro dominio siguen las mismas reglas que la API: sin `customers:read` llega un `reservation:updated` con `customer: null`, y sin `payments:read` un `invoice:paid` con `payment: null`. Una lista pasa entonces a ser `[]`. --- ## Formato del evento [#event-formaat] El payload tiene la misma estructura que las [entregas de webhook](/ontwikkelaars/webhooks#webhook-payload): | Campo | Tipo | Descripción | |------|------|--------------| | `event` | string | Clave del evento (p. ej. `invoice:created`) | | `data` | object | Payload específico del evento | | `timestamp` | number | Marca de tiempo Unix (ms) del momento en que se emitió el evento | | `traceId` | string | ID de traza de OpenTelemetry de la acción de Tillor que provocó este evento (igual que en los [webhooks](/ontwikkelaars/webhooks#webhook-payload)) | | `spanId` | string (opcional) | Span dentro de esa traza | En el flujo SSE, este objeto JSON va en la línea `data:`; la clave del evento también va en la línea `event:`. Consulta los [ejemplos de SSE](/ontwikkelaars/voorbeelden/sse) para un ejemplo en el cable. --- ## Ejemplo: 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); } } } ``` --- ## Ejemplo: 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" ``` --- ## Reconexión [#herverbinding] Si la conexión se interrumpe, vuelve a conectarte con la misma URL y los mismos encabezados. El flujo no admite reanudación; después de reconectar solo recibes eventos nuevos. --- ## Relacionado [#gerelateerd] - [OpenAPI](https://tillor.eu/api/openapi.json) - especificación completa de la API - [API HTTP](/ontwikkelaars/http) - claves de API y autenticación - [Webhooks](/ontwikkelaars/webhooks) - los mismos eventos mediante HTTP POST - [Ejemplos](/ontwikkelaars/voorbeelden) - ejemplos de código y de payload # Ejemplos HTTP (/es-ES/ontwikkelaars/voorbeelden/http) Horario de apertura y festivos para un sitio público: [API de horario de apertura](/ontwikkelaars/voorbeelden/opening-hours). ## Petición a la API con 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" ``` ## Crear una clave de API [#api-sleutel-aanmaken] ```bash curl -X POST "https://tillor.eu/api/api-keys" \ -H "Cookie: session=..." \ -H "Content-Type: application/json" \ -d '{"name": "Mijn integratie", "description": "Optionele beschrijving"}' ``` ## Crear un 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 }' ``` # Resumen (/es-ES/ontwikkelaars/voorbeelden) Ejemplos listos para empezar. Cada ejemplo usa los marcadores `org_abc123` y `tkn_xxx`; sustitúyelos por el ID de tu organización y tu clave de API. # API de horario de apertura (/es-ES/ontwikkelaars/voorbeelden/opening-hours) Usa la API de horario de apertura **resuelto** si muestras en un sitio público horarios de temporada (por ejemplo **Zomer** / **Winter**) o los próximos **festivos**. Tillor ya aplica las excepciones, los periodos de temporada y el horario semanal normal, y añade los festivos legales dentro del rango solicitado. No necesitas volver a implementarlo. **Permiso:** `organization:settings:read` u `organization:settings:write` Llama a Tillor solo desde un servidor (Route Handler de Next.js, Server Component o backend). Guarda la clave en variables de entorno. No la envíes nunca al navegador. Autenticación: consulta la [API HTTP](/ontwikkelaars/http). Prueba el endpoint en la [referencia de la API](/api-referentie) o mediante [OpenAPI](https://tillor.eu/api/openapi.json) (etiqueta `organization-settings`). ## Endpoint [#endpoint] ``` GET https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours ``` Encabezados: ```http x-api-key: tkn_xxx ``` Sustituye `org_abc123` por el ID de tu organización. ### Parámetros de consulta [#queryparameters] Usa `date` **o** `from`/`to`. No los combines. | Parámetro | Significado | |-----------|-----------| | *(ninguno)* | Hoy, en la zona horaria de la organización | | `date` | Un solo día natural (`YYYY-MM-DD`) | | `from` | Día de inicio (incluido). Sin `to`: solo ese día | | `to` | Día final (incluido). Requiere `from`. Máximo **366** días | | `languageIsoCode` | Idioma de los nombres de los festivos (`NL`, `FR`, …). Por defecto: el idioma de la organización | ## Respuesta [#response] Cada elemento es un día natural, ya resuelto: | Campo | Significado | |-------|-----------| | `timeZone` | Zona horaria IANA de la organización | | `from` / `to` | Rango solicitado | | `holidays` | Festivos legales que se solapan con `from`–`to` | | `items[].date` | Día natural `YYYY-MM-DD` | | `items[].weekday` | `monday` … `sunday` | | `items[].source` | `exception`, `period` o `regular` | | `items[].periodLabel` | Solo con `source: "period"`: la etiqueta de Tillor, por ejemplo `"Zomer"` o `"Winter"` | | `items[].holiday` | Solo si ese día es un festivo legal: `{ id, name, startDate, endDate }` | | `items[].blocks` | Franjas horarias en minutos desde la medianoche | | `items[].closed` | `true` si `blocks` está vacío | Prioridad: **excepción** (festivo o rango personalizado) → último **periodo de temporada** que coincida → horario semanal **normal**. Las etiquetas de temporada provienen de *Configuración > Horario de apertura*. Los periodos pueden cruzar el cambio de año (por ejemplo del 1 de noviembre al 31 de marzo). Los días fuera de todo periodo recurren al horario semanal normal (`source: "regular"`, sin `periodLabel`). ### De minutos a hora del reloj [#minuten-naar-kloktijd] `startMinutes` / `endMinutes` son minutos desde las 00:00. | Minutos | Hora | |--------:|------| | 540 | 09:00 | | 600 | 10:00 | | 720 | 12:00 | | 780 | 13:00 | | 1020 | 17:00 | | 1140 | 19:00 | ```ts function formatMinutes(minutes: number): string { const hour = Math.floor(minutes / 60); const minute = minutes % 60; return `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`; } ``` ## Ejemplos [#voorbeelden] ### Día dentro de un periodo de temporada [#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, horario de verano. ### Día fuera de los periodos de temporada [#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 y 13:00–17:00. ### Rango que cruza el límite de un periodo [#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" ``` | Fecha | `source` | `periodLabel` | |-------|----------|---------------| | 2026-03-30 | `regular` | - | | 2026-03-31 | `regular` | - | | 2026-04-01 | `period` | `Zomer` | | 2026-04-02 | `period` | `Zomer` | ## Próximos festivos [#komende-feestdagen] Los festivos legales vienen en la misma respuesta: `holidays` para una lista (nombre + fechas), `items[].holiday` si ese día natural es festivo. Las horas siguen siendo el horario resuelto; un festivo sin excepción rellenada en Tillor sigue el horario de temporada o el semanal (`source` no es entonces `"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 } ] } ``` El ejemplo de `items` anterior está abreviado; la respuesta real contiene cada día del rango. Las vacaciones escolares no están en este endpoint; siguen siendo `GET /holidays?kind=school`. ## Next.js (servidor) [#nextjs-server] Para un widget semanal o un “abierto ahora” en un sitio público: ```ts const TILLOR_API_URL = "https://tillor.eu"; const ORGANIZATION_ID = process.env.TILLOR_ORG_ID ?? ""; type OpeningHoursBlock = { startMinutes: number; endMinutes: number; }; type OpeningHoursHoliday = { id: string; name: string; startDate: string; endDate: string; }; type OpeningHoursItem = { date: string; weekday: string; source: "exception" | "period" | "regular"; periodLabel?: string; holiday?: OpeningHoursHoliday; blocks: OpeningHoursBlock[]; closed: boolean; }; type OpeningHoursResponse = { timeZone: string; from: string; to: string; holidays: OpeningHoursHoliday[]; items: OpeningHoursItem[]; }; export async function getOpeningHours( from: string, to: string, ): Promise { 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` es la lista para un bloque de “próximos festivos”. `items[].holiday` es útil en un calendario semanal. `items[].periodLabel` es el texto de temporada (por ejemplo `"Zomer"` o `"Winter"`). Una caché de 1 hora suele bastar. ## Invalidar la caché (webhook) [#cache-ongeldig-maken-webhook] En cada cambio de los ajustes de la organización, Tillor envía `organizationSettings:updated` (webhook y SSE). Suscríbete a él y vuelve a obtener el horario de apertura. El payload es pequeño a propósito (sin IP de impresoras ni el horario completo): ```json { "event": "organizationSettings:updated", "data": { "openingHoursChanged": true }, "timestamp": 1787829600000 } ``` `openingHoursChanged` es `true` si cambia el horario de apertura, la zona horaria o el país por defecto, que es lo que afecta a `GET .../opening-hours`. Con `false` puedes dejar la caché del horario de apertura como está. Ejemplo de Route Handler de 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 }); } ``` Crear un webhook: consulta [Webhooks](/ontwikkelaars/webhooks). Clave de evento: `organizationSettings:updated` (permiso `organization:settings:read` u `organization:settings:write`). ## Horario completo (opcional) [#volledig-rooster-optioneel] Solo es necesario si quieres mostrar tú mismo el calendario de temporadas (etiquetas + `fromMonth`/`untilDay`), sin resolverlo por día: ``` GET https://tillor.eu/api/orgs/org_abc123/organization-settings ``` Lee `openingHoursSchedule.periods` (etiquetas como `"Zomer"`) y `openingHoursSchedule.weekdays` (horario normal). Para el propio sitio web, `GET .../opening-hours` sigue siendo la fuente más sencilla. ## MCP [#mcp] En Cursor o Claude: endpoint `organizationSettings_listOpeningHours` (categoría `organizationSettings`), argumentos `organizationId`, opcionalmente `date` o `from`/`to`, opcionalmente `languageIsoCode`. ## Relacionado [#gerelateerd] - [API HTTP](/ontwikkelaars/http) - autenticación y encabezados - [Ejemplos HTTP](/ontwikkelaars/voorbeelden/http) - ejemplos generales de cURL - [Webhooks](/ontwikkelaars/webhooks) - `organizationSettings:updated` para revalidar la caché - [Ajustes de la organización](/gebruikers/organisaties) - configurar el horario de apertura en Tillor # Ejemplos de SSE (/es-ES/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); } } } ``` ## Mensaje SSE [#sse-bericht] Un mensaje SSE (`text/event-stream`) tiene este aspecto: ``` 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} ``` La línea SSE `event` es `message`. Analiza la línea `data` como JSON: contiene el evento de Tillor (`event`), el payload (`data`) y `timestamp` (ms). Recibes el mismo objeto JSON mediante [webhooks](/ontwikkelaars/webhooks). # Ejemplos de webhooks (/es-ES/ontwikkelaars/voorbeelden/webhooks) Los mismos eventos que con [SSE](/ontwikkelaars/voorbeelden/sse). La estructura del payload es idéntica. ## Estructura del envoltorio [#wrapper-structuur] ```json { "event": "entity:action", "data": {}, "timestamp": 1735689600000, "traceId": "4bf92f3577b34da6a3ce929d0e0e4736", "spanId": "00f067aa0ba902b7" } ``` `traceId` corresponde a la acción de Tillor que provocó el evento (p. ej. una llamada a la API o un procesamiento interno), no a un reintento posterior del webhook. ## Ejemplo de POST de webhook [#webhook-post-voorbeeld] Una petición POST de webhook completa tiene este aspecto: ```http POST /webhooks/tillor HTTP/1.1 Host: your-server.com Content-Type: application/json { "event": "invoice:paid", "data": { "invoice": { "id": "inv_def456uvw", "displayId": "2025-00123", "status": "BOOKED", "paymentStatus": "PAID", "amountTotal": 200.0, "paidDate": "2025-03-09T12:15:00.000Z", "customerId": "cust_abc123xyz" }, "payment": { "id": "pay_ghi789rst", "amount": 200.0, "status": "PAID", "method": "BANCONTACT", "channel": "ONLINE", "provider": "MOLLIE", "paidAt": "2025-03-09T12:15:00.000Z" } }, "timestamp": 1735811700000, "traceId": "4bf92f3577b34da6a3ce929d0e0e4736", "spanId": "00f067aa0ba902b7" } ``` ## Payloads de eventos [#event-payloads] ### customer:created [#customercreated] ```json { "event": "customer:created", "data": { "id": "cust_abc123xyz", "displayId": 1042, "firstName": "Jan", "lastName": "Jansen", "email": "jan.jansen@voorbeeld.nl", "phone": "+31612345678", "address": "Hoofdstraat 42", "city": "Amsterdam", "zipCode": "1012 AB", "country": "NL", "customerType": "STANDARD", "status": "DEFAULT", "createdAt": "2025-03-09T10:30:00.000Z", "updatedAt": "2025-03-09T10:30:00.000Z" }, "timestamp": 1735806600000 } ``` ### invoice:paid [#invoicepaid] ```json { "event": "invoice:paid", "data": { "invoice": { "id": "inv_def456uvw", "displayId": "2025-00123", "status": "BOOKED", "paymentStatus": "PAID", "amountTotal": 200.0, "paidDate": "2025-03-09T12:15:00.000Z", "customerId": "cust_abc123xyz" }, "payment": { "id": "pay_ghi789rst", "amount": 200.0, "status": "PAID", "method": "BANCONTACT", "channel": "ONLINE", "provider": "MOLLIE", "paidAt": "2025-03-09T12:15:00.000Z" } }, "timestamp": 1735811700000 } ``` ### controller:adoption:requested [#controlleradoptionrequested] ```json { "event": "controller:adoption:requested", "data": { "adoptionId": "adopt_jkl012mno", "efuseId": "a1b2c3d4e5f6", "requestedFromIp": "192.168.1.42", "isNew": true }, "timestamp": 1735809000000 } ``` ### nfc-tag:presented [#nfc-tagpresented] ```json { "event": "nfc-tag:presented", "data": { "id": "nfc_123abc456", "uid": "04A1B2C3D4E5F6", "type": "CARD", "balance": 25.5, "blockedAt": null, "customerId": "cust_abc123xyz" }, "timestamp": 1735807500000 } ``` ### organizationSettings:updated [#organizationsettingsupdated] ```json { "event": "organizationSettings:updated", "data": { "openingHoursChanged": true }, "timestamp": 1787829600000 } ``` Consulta la [API de horario de apertura](/ontwikkelaars/voorbeelden/opening-hours) para revalidar la caché en un sitio público. ## Enums [#enums] | Entidad | Enum | Valores | |--------|------|---------| | Customer | `customerType` | `STANDARD`, `WORKER_RENTAL_CARAVAN`, `WORKER_TOWING_CARAVAN` | | Invoice | `status` | `DRAFT`, `BOOKED` | | Invoice | `paymentStatus` | `UNPAID`, `PARTIALLY_PAID`, `PENDING`, `PAID` | | Payment | `status` | `PENDING`, `AUTHORIZED`, `PAID`, `CANCELED`, `FAILED`, `EXPIRED`, `REFUNDED`, `PARTIALLY_REFUNDED`, `CHARGED_BACK` | | Payment | `method` | `UNKNOWN`, `BANCONTACT`, `IDEAL`, `CREDITCARD`, `CASH`, … (lista completa en OpenAPI) | | Payment | `channel` | `MANUAL`, `BANK_TRANSFER`, `TERMINAL`, `ONLINE`, `MANDATE` | | Payment | `provider` | `MOLLIE`, `MANUAL`, `PONTO` | | Controller | `type` | `ACCESS`, `SHOWER`, `CHARGE_POINT` | | NfcTag | `type` | `CARD`, `BRACELET`, `STICKER`, `KEY_FOB` | # Webhooks (/es-ES/ontwikkelaars/webhooks) Los webhooks reciben eventos en tiempo real mediante HTTP POST a una URL que configuras tú. Los mismos eventos también están disponibles mediante [SSE](/ontwikkelaars/sse). Los webhooks se configuran **por organización**: cada organización tiene los suyos. ## Gestión [#beheer] Consulta la [especificación OpenAPI](https://tillor.eu/api/openapi.json) para los esquemas completos de petición y respuesta. | Método | Ruta | Descripción | |--------|------|-------------| | GET | `/api/orgs/:orgId/webhooks` | Obtener webhooks | | GET | `/api/orgs/:orgId/webhooks/delivery-stats` | Obtener estadísticas de entrega | | POST | `/api/orgs/:orgId/webhooks/retry-deliveries` | Reintentar entregas. Body: `mode` (`failed` o `force`) y, opcionalmente, `id` para un solo webhook. `failed`: solo entregas fallidas de forma definitiva, de inmediato. `force`: entregas pendientes y fallidas de forma definitiva, en segundo plano, ignorando los tiempos de espera. | | GET | `/api/orgs/:orgId/webhooks/:id` | Obtener un webhook por ID | | POST | `/api/orgs/:orgId/webhooks` | Crear un webhook | | PATCH | `/api/orgs/:orgId/webhooks/:id` | Actualizar un webhook | | DELETE | `/api/orgs/:orgId/webhooks/:id` | Eliminar un webhook | ## Crear un webhook [#webhook-aanmaken] ```http POST /api/orgs/org_abc123/webhooks Content-Type: application/json x-api-key: tkn_xxx ``` ```json { "url": "https://jouw-server.com/webhooks/tillor", "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"], "enabled": true } ``` - **url** - Endpoint HTTPS que acepta peticiones POST - **subscribedEventKeys** - Array de claves de evento o `["*"]` para todos los eventos. La lista completa está en Tillor en **Menú de perfil → Desarrolladores**, en **Añadir webhook** → **Eventos suscritos**. Algunos eventos son tan frecuentes que no puedes elegirlos y tampoco llegan mediante `*`, como el estado físico de las barreras, la escritura en la bandeja de entrada, los logs del controlador y la presencia de vehículos. No aparecen en la lista de abajo. Qué eventos puedes elegir depende también de tus permisos. - **enabled** - `true` para activar la entrega Solo puedes elegir eventos para los que tu miembro de la organización tenga el permiso adecuado (p. ej. transacciones bancarias para `bankAccountTransaction:*`). El comodín `*` solo está disponible para miembros con acceso total (`*`). Con una combinación no válida, la API devuelve un mensaje de error. Un webhook envía el payload completo, con los datos vinculados (como el cliente en una reserva). Por eso también debes poder leer esos dominios para crear un webhook, cambiar la URL o los eventos, o volver a activarlo. --- ## Payload del webhook [#webhook-payload] Cada entrega de webhook es un POST con: **Encabezados:** - `Content-Type: application/json` - `X-Webhook-Event-ID` - ID único y estable de esta entrega lógica (mismo valor en los reintentos) - `X-Webhook-Signature` - firma HMAC-SHA256 del body, formato `sha256=` (consulta [Verificar la firma](#handtekening-verifiëren)) **Body:** ```json { "event": "invoice:created", "data": {}, "timestamp": 1735689600000, "traceId": "4bf92f3577b34da6a3ce929d0e0e4736", "spanId": "00f067aa0ba902b7", "triggeredBy": { "id": "usr_63x8jp68is", "name": "Niels" } } ``` | Campo | Tipo | Descripción | |------|------|--------------| | `event` | string | Clave del evento (p. ej. `invoice:created`) | | `data` | object | Payload específico del evento | | `timestamp` | number | Marca de tiempo Unix (ms) del momento en que se emitió el evento | | `traceId` | string | ID de traza de OpenTelemetry de la acción de Tillor que provocó este evento. Facilítalo al soporte; no es un secreto. | | `spanId` | string (opcional) | Span dentro de esa traza | | `triggeredBy` | object \| null | Usuario que realizó la acción (`id`, `name`). `null` en acciones del sistema (cron, sincronización bancaria, …) | Consulta [Ejemplos](/ontwikkelaars/voorbeelden) para ver ejemplos completos de payload. --- ## Verificar la firma [#handtekening-verifiëren] Cada webhook tiene su propio **secreto de firma** (64 caracteres hexadecimales, visible en la tabla de webhooks mediante **Mostrar secreto de firma** en *Menú de perfil → Desarrolladores*). Tillor firma cada POST con ese secreto para que puedas comprobar que la petición viene realmente de Tillor y que el body no se ha modificado. **Cómo firma Tillor:** 1. Calcula `HMAC-SHA256(signingSecret, raw_request_body)` (hex en minúsculas). 2. Lo envía como `X-Webhook-Signature: sha256=`. **Cómo verificas tú:** 1. Lee el body **en bruto** de la petición (antes de analizar el JSON; si no, el hash no coincidirá). 2. Calcula tú mismo `HMAC-SHA256(signingSecret, raw_body)` en hex. 3. Compara con el valor que sigue a `sha256=` en el encabezado `X-Webhook-Signature` con una comparación de **tiempo constante**. ```js import crypto from "node:crypto"; function verifyTillorWebhook(rawBody, headerSignature, signingSecret) { const expected = crypto.createHmac("sha256", signingSecret).update(rawBody).digest("hex"); const received = headerSignature.replace(/^sha256=/, ""); const a = Buffer.from(expected, "hex"); const b = Buffer.from(received, "hex"); return a.length === b.length && crypto.timingSafeEqual(a, b); } ``` Puedes mostrar el secreto de firma en Tillor mediante **Mostrar secreto de firma** en la tabla de webhooks. Guárdalo como secreto (variable de entorno, vault) y no lo registres nunca en logs. ¿Sospechas una fuga? Elimina el webhook y crea uno nuevo; así obtienes un secreto nuevo. --- ## Comportamiento de entrega y reintentos [#leveringsgedrag-en-retries] - Responde con un **estado 2xx** para confirmar el éxito. - Si una entrega falla (no 2xx, error de red o destino bloqueado), Tillor la reintenta automáticamente con intervalos cada vez más largos. Cada intento reutiliza el mismo payload, la misma firma y el mismo ID de evento (idempotente). | Intento | Tiempo de espera desde el intento anterior | |---|---| | 1 | inmediato | | 2 | 1 segundo | | 3 | 2 segundos | | 4 | 4 segundos | | 5 | 8 segundos | | 6 | 5 minutos | | 7 | 30 minutos | | 8 | 2 horas | | 9 | 6 horas | | 10 | 24 horas | - Si uno de los intentos tiene éxito (2xx) → la entrega queda completada. - Si tampoco tiene éxito el intento 10 (tras 24 h) → la entrega se **marca definitivamente como fallida** y no se reintenta más. - Si mientras tanto el webhook se **desactiva**, Tillor deja de reintentar. ```mermaid flowchart TD A[Evento emitido] --> B[Entrega a tu endpoint] B -- 2xx --> Z[Completada] B -- fallida --> C[Reintentada
1s, 2s, 4s, 8s,
5m, 30m, 2h, 6h, 24h] C -- 2xx --> Z C -- todos los intentos fallidos --> F[Fallida definitivamente] ``` Cada reintento reutiliza el mismo `X-Webhook-Event-ID` y `X-Webhook-Signature`. Deduplica de tu lado con ese encabezado para que un reintento exitoso tras un 200 lento no provoque un procesamiento duplicado. ### Avisos por fallos persistentes [#meldingen-bij-aanhoudende-fouten] Si las entregas a un endpoint de webhook siguen fallando, Tillor envía **como máximo dos avisos por incidente** (por endpoint): 1. **Tras 5 minutos de fallos persistentes** - correo electrónico a la dirección de correo de la organización (`supportEmail`, o si no `email`) y a los miembros de la organización con permiso para modificar los ajustes de la organización, además de una notificación push (si está activada) para esos miembros. El correo indica desde cuándo fallan las entregas. Las fechas del correo usan la **zona horaria** de *Configuración > General* (por defecto `Europe/Brussels`). 2. **Al fallar definitivamente** - los mismos destinatarios reciben un aviso cuando el primer evento de ese incidente se marca como fallido de forma definitiva tras todos los intentos. **No** recibes un aviso por cada evento fallido. En cuanto todas las entregas fallidas de un endpoint se resuelven (entregadas con éxito), un nuevo incidente empieza de nuevo con las mismas reglas. En **Menú de perfil → Desarrolladores**, la tabla de webhooks muestra por endpoint un estado de entrega compacto (cantidades pendientes de reintento y fallidas de forma definitiva). Haz clic en el icono **ℹ** para ver los detalles, incluido el mensaje de error completo y el payload del intento más reciente. - **Reintentar entregas fallidas** (↻): solo las entregas fallidas de forma definitiva de ese webhook. - **Forzar reintento** (⚡): todas las entregas pendientes y fallidas de forma definitiva de ese webhook, independientemente de los tiempos de espera programados. Tillor lo inicia en segundo plano para que las colas grandes (p. ej. miles de eventos) se procesen con seguridad. - **Forzar reintento de todos**, arriba a la derecha junto a **Añadir webhook**: lo mismo para todos los webhooks activados de la organización. --- ## Tipos de evento [#event-types] Las claves de evento usan el formato `entity:action` o `entity:subresource:action`. La lista completa, con el permiso de cada evento y un ejemplo de payload, está en el [índice de eventos](/ontwikkelaars/events). Esa página se genera a partir del código y por tanto siempre está completa. Las mismas claves están en Tillor en [Menú de perfil → Desarrolladores](https://tillor.eu/orgs/org_abc123/developers), en **Añadir webhook** → **Eventos suscritos**. --- ## Webhooks frente a SSE [#webhooks-vs-sse] | Caso de uso | Recomendación | |----------|-------------| | Integración en el servidor | **Webhooks** - Tu servidor recibe los POST | | Registro sencillo | **Webhooks** - Configuración mínima | | Panel en tiempo real, actualizaciones en vivo en una app | [SSE](/ontwikkelaars/sse) - Una conexión, baja latencia. | | Muchos tipos de evento, filtrado en el cliente | [SSE](/ontwikkelaars/sse) - Usa el parámetro de consulta `events` para limitar el tráfico. | --- ## Relacionado [#gerelateerd] - [OpenAPI](https://tillor.eu/api/openapi.json) - especificación completa de la API - [API HTTP](/ontwikkelaars/http) - API REST y claves de API - [SSE](/ontwikkelaars/sse) - los mismos eventos mediante Server-Sent Events - [Automatizaciones](/ontwikkelaars/automatiseringen) - enviar mensajes propios desde una automatización # API de chat web (/es-ES/ontwikkelaars/website-chat) El widget oficial se instala en la app: consulta [Poner el chat en tu sitio web](/inbox/website-chat). Las opciones del snippet están en [Ajustes del chat web](/inbox/website-chat-instellingen). Esta página es para desarrolladores: el SDK del widget para un formulario propio y la capa REST para una **interfaz de chat propia**. Consulta [OpenAPI](https://tillor.eu/api/openapi.json), etiqueta `inbox`. ## SDK del widget [#widget-sdk] Tras cargar el script del widget, `window.TillorInbox` está disponible. Con él pasas datos de contacto desde tu propio formulario (página de contacto, detalle de venta, solicitud de presupuesto). Todos los métodos esperan a que se haya cargado la configuración del widget. | Método | Descripción | |---------|--------------| | `ready()` | Promise que se resuelve cuando el widget está cargado | | `getVisitor()` | Lee los datos de contacto guardados en `localStorage` y los campos del widget rellenados; síncrono, sin red | | `setVisitor({ name?, firstName?, lastName?, email?, phone?, message?, customFields? }, options?)` | Rellena los campos del chat sin enviar | | `open()` | Abre la ventana del chat | | `close()` | Cierra la ventana del chat | | `toggle()` | Abre o cierra la ventana del chat | | `send({ body, name?, firstName?, lastName?, email?, phone?, message?, customFields?, open?, silent?, markSubmitted?, metadata? })` | Envía un mensaje con datos de contacto | `getVisitor()` devuelve este objeto: | Campo | Descripción | |-------|--------------| | `visitorId` | ID de este visitante en este navegador (`localStorage`) | | `name` | Nombre completo (un solo campo en el widget) | | `firstName` / `lastName` | Derivados de `name` (primera palabra / resto) | | `email`, `phone` | Datos de contacto | | `customFields` | Campos adicionales de los ajustes del widget | | `message` | Borrador en el campo de mensaje | | `detailsSubmitted` | Si el formulario del visitante se considera rellenado | Usa `getVisitor()` para rellenar de antemano un formulario propio desde `localStorage` (mismo navegador, también tras recargar la página). Opciones de `setVisitor` (segundo argumento): | Opción | Por defecto | Explicación | |-------|-----------|--------| | `open` | `false` | Abrir la ventana del chat directamente | | `markSubmitted` | `false` | Ocultar el formulario del visitante si todos los campos obligatorios están rellenados | | `onlyEmpty` | `false` | Sobrescribir solo los campos vacíos | | `persist` | `false` | Guardar los datos en `localStorage` (mismo navegador, también en una pestaña nueva) | Opciones de `send`: | Opción | Por defecto | Explicación | |-------|-----------|--------| | `open` | `false` | Abrir la ventana del chat antes de enviar | | `silent` | `true` si `open` es false | Sin sonido ni mensaje de error en el widget; usa la Promise para el éxito o el error | | `markSubmitted` | `true` | Los datos de contacto no hace falta volver a introducirlos en el widget | | `metadata` | - | Pistas opcionales para Tillie (no visibles en la ventana del chat); consulta [metadata](#metadata-boekingsformulier) | Con `open: false` (por defecto) el botón del chat sigue cerrado. El mensaje sí llega a Tillor; tu propio formulario puede dar las gracias o mostrar un error. Con `open: true` se abre la ventana del chat y el visitante ve el comportamiento de envío normal (sonido, ticks, posibles errores del widget). ¿Quieres usar un botón propio en lugar del botón flotante del chat? Pon `data-launcher="false"` en el snippet y llama a `TillorInbox.open()`. ### `metadata` (formulario de reserva) [#metadata-boekingsformulier] Usa `metadata` cuando tengas un formulario propio en el sitio web y Tillie deba enviar **solo una confirmación**, sin preguntas de seguimiento (por ejemplo porque la pestaña se cierra después). | Clave | Tipo | Explicación | |---------|------|--------| | `forceHandover` | `boolean` | Mensaje de confirmación y traspaso a un compañero, sin preguntas de admisión. También ignora la pausa de la IA tras un mensaje del equipo (consulta `ignoreAiPause`) | | `ignoreAiPause` | `boolean` | Tillie responde también cuando está en pausa en modo **Automático** tras un mensaje del equipo (30 minutos). Útil para un envío silencioso de formularios; combínalo con `forceHandover` o deja que Tillie haga la admisión normal | | `handoverIntent` | `"reservation"` \| `"caravan_rental"` \| `"sale"` \| `"other"` | Opcional: flujo para el traspaso (por defecto: se deduce automáticamente del mensaje) | | `source` | `string` | Etiqueta de integración opcional para tu equipo (minúsculas, cifras, `-`, `_`; máx. 64 caracteres) | ```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", }, }); ``` ### Sustituir el formulario de contacto (envío silencioso) [#contactformulier-vervangen-stille-verzending] Úsalo cuando quieras mantener el formulario de contacto existente, pero hacer que los mensajes pasen por Tillor sin abrir la ventana del chat. ```html ``` No hace falta que pongas `open` ni `silent`: sin `open: true` la ventana permanece cerrada y Tillor trata la llamada como un envío silencioso. ### Conectar el formulario de contacto (abrir el chat) [#contactformulier-koppelen-chat-openen] Pasar los campos y abrir la ventana del chat, para que el visitante vea la conversación: ```html ``` O solo rellenar campos y abrir la ventana, sin enviar de inmediato: ```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 }, ); ``` Una página de venta con envío directo y apertura del chat: ```javascript void TillorInbox.send({ name: "Jan Janssens", email: "jan@voorbeeld.be", phone: "+32 3 779 81 64", body: "Ik heb interesse in deze stacaravan.", open: true, }); ``` Sincronizar en vivo mientras alguien escribe: ```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, }); }); ``` ### Llamar pronto (antes del script del widget) [#vroeg-aanroepen-vóór-het-widget-script] Si llamas a un método antes de que se haya cargado el script, pon la llamada en la cola: ```html ``` ## Interfaz de chat propia [#eigen-chat-ui] Si creas una interfaz de chat propia en lugar del widget, usa la capa REST de abajo. Autenticación: encabezado `X-Tillor-Inbox-Widget-Key` (valor de *Configuración > Integraciones > Chat web*). ### Indicador de escritura [#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` cuando el visitante escribe; `false` cuando el campo está vacío o el visitante deja de escribir (el widget envía `false` tras unos 4 segundos sin entrada) - `visitorName` / `visitorEmail` / `visitorPhone` son opcionales - Usa el mismo `visitorId` que en `POST …/inbox/website/messages` y `GET …/inbox/website/messages` ### Tiempo real (SSE) [#realtime-sse] ```http GET /api/orgs/{orgId}/inbox/website/subscribe?visitorId=vis_… X-Tillor-Inbox-Widget-Key: iwk_xxx Accept: text/event-stream ``` | Evento | Cuándo | |-------|-------| | `inbox:website:message-created` | Nuevo mensaje del equipo o de la IA | | `inbox:website:message-updated` | Mensaje del equipo o de la IA modificado o eliminado | | `inbox:website:typing-changed` | Cambia `data.staffTyping` o `data.staffOutboundSenderType` | La forma del payload es la misma que en el [SSE de la organización](/ontwikkelaars/sse#event-formaat) (`event`, `data`, `timestamp`). Vuelve a conectarte tras una interrupción; no hay reanudación. El widget oficial usa SSE como capa principal y vuelve a obtener `GET …/messages` cada **5 segundos** como respaldo (cada **1 segundo** con el panel abierto cuando SSE se interrumpe un momento). Así, las respuestas se marcan como **entregadas** mientras el visitante está en la página. ### Actividad del visitante [#bezoekersactiviteit] ```http POST /api/orgs/{orgId}/inbox/website/events X-Tillor-Inbox-Widget-Key: iwk_xxx Content-Type: application/json ``` `event`: `chat_closed`, `tab_hidden` o `navigation` (en la navegación también `url`). Tu equipo ve estos eventos como texto informativo en gris en la conversación, consulta [Conversaciones por chat web](/inbox/website-chat-gesprekken). ### Límites [#limieten] `POST …/inbox/website/messages` y `POST …/inbox/website/attachments/upload` responden `429` cuando un visitante o una red envía demasiado. El cuerpo incluye `data.reason` = `INBOX_WIDGET_RATE_LIMITED` y `data.retryAfterSeconds`. Límites por organización: | Ruta | Por visitante (`visitorId`) | Por red (dirección IP) | |------|-----------------------------|------------------------| | `messages` | 10 por minuto, 200 por día | 30 por minuto, 600 por día | | `attachments/upload` | 10 por hora | 50 por hora | Espera `retryAfterSeconds` antes de volver a intentarlo y muestra un aviso al visitante en lugar de reintentar automáticamente. ## Véase también [#zie-ook] # Un huésped en la barrera (/es-ES/praktijk/gast-aan-de-slagboom) Un huésped llega a la barrera de Recreatiepark Het Meer y debe poder pasar sin ayuda de recepción. Este ejemplo sigue a Jonas Maes desde que se configura su método de acceso hasta lo que ocurre cuando ese método deja de funcionar. Verás cómo colaboran un método de acceso, un controlador y un punto de acceso. ```mermaid flowchart LR A[Método de acceso del cliente] --> B[Huésped en el punto de acceso] B --> C{El controlador y Tillor comprueban} C -->|válido| D[Permitido, barrera abierta] C -->|caducado o bloqueado| E[Denegado, visible en el registro] ``` Antes de empezar: - Tu parque tiene al menos un punto de acceso vinculado a Tillor. Aparece en **Acciones rápidas** en la página **Control de acceso** con un botón **Abrir [nombre del punto de acceso]**. - El controlador de la barrera está vinculado a tu organización. Un controlador nuevo aparece en **Controladores** como **Pendiente de aprobación** hasta que haces clic en **Aprobar**. Consulta [Controladores](/controllers). - Para una etiqueta NFC: la etiqueta ya debe estar en Tillor. Eso ocurre solo en cuanto se ha acercado por primera vez a un lector. ## La ruta paso a paso [#de-route-stap-voor-stap] ### Añade un método de acceso [#voeg-een-toegangsmethode-toe] Ve a Clientes > Jonas Maes > Control de acceso y haz clic en **Añadir**. Elige el **Tipo** y, si quieres, rellena una **Fecha de inicio** y una **Fecha de fin**. Ese periodo determina cuándo funciona el método. Elige **Reconocimiento de matrículas** y rellena la **Matrícula**. La cámara del punto de acceso lee la matrícula y Tillor busca al cliente correspondiente. Elige **Código QR**. Tillor genera el código por sí mismo. En el menú del método, copia la **URL personal** y envíasela a Jonas. Él abre la página **Pase de acceso** y puede añadir el pase a Apple Wallet o Google Wallet, si está configurado para tu entorno. Elige **NFC** y selecciona una tarjeta NFC disponible en la lista. Si la lista está vacía, acerca primero la etiqueta a un lector. Consulta [Gestionar etiquetas](/nfc/nfc-tags). Consulta [Control de acceso](/toegangscontrole). ### Comprueba el controlador y el punto de acceso [#controleer-controller-en-toegangspunt] El controlador o la cámara del punto de acceso recibe de Tillor la lista de métodos válidos. En **Operaciones del controlador**, en la página **Control de acceso**, ves cuándo se ha enviado un pase o un código QR al punto de acceso. Si la operación aún no aparece, la sincronización sigue en curso. ### Sigue lo que ocurre en la barrera [#volg-wat-er-aan-de-slagboom-gebeurt] El bloque **Registro de acceso** muestra cada intento con fecha, método, cliente, punto de acceso y estado. Un huésped que entra aparece en la tabla **Vehículos en el parque** con el estado **Dentro**. Si se marcha, pasa a **Salido**. ### Abre tú mismo la barrera si hace falta [#open-de-slagboom-zelf-als-het-nodig-is] En **Acciones rápidas**, haz clic en **Abrir [nombre del punto de acceso]** y confirma con **Sí, abrir [nombre del punto de acceso]**. Cerrar solo es posible si el punto de acceso lo admite. ## ¿Qué ocurre con un método caducado? [#wat-gebeurt-er-bij-een-verlopen-methode] Si pasa la **Fecha de fin**, el método ya no da acceso y el intento aparece en el registro con el estado **Caducado**. Otros estados que encontrarás son **Bloqueado**, **Inactivo** y **Denegado**. Para las matrículas existe un periodo de gracia, para que los huéspedes no se queden de noche ante una salida cerrada. Si **Permitir la salida de matrículas caducadas** está activado (por defecto), la barrera de salida todavía se abre durante el periodo de gracia. Este dura por defecto 2 días y como máximo 30. Solo funciona fuera del horario de apertura. Si recepción está abierta, el personal gestiona el vehículo en el mostrador. Una matrícula bloqueada o inactiva nunca recibe periodo de gracia, y las etiquetas NFC y los códigos QR no tienen periodo de gracia. Lo configuras en Soporte > Configuración > Control de acceso, consulta [Ajustes del control de acceso](/gebruikers/instellingen-toegangscontrole). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Cada intento permanece en el registro de acceso. Puedes filtrar por cliente, estado y punto de acceso y exportar a Excel. - Un vehículo que no se ha visto en un punto de acceso durante 7 días recibe el estado **Fantasma**. Si más adelante la matrícula se vuelve a ver en una entrada, vuelve a estar **Dentro**. - Si amplías la **Fecha de fin** del método, vuelve a funcionar tras la siguiente sincronización con el punto de acceso. ## ¿Problemas? [#problemen] Busca el intento en el registro de acceso y lee el estado. **Caducado** significa que la **Fecha de fin** ha pasado; **Bloqueado** o **Inactivo**, que el método está desactivado. Si el método es correcto, comprueba **Operaciones del controlador**. Si no puedes resolverlo rápido, abre la barrera desde **Acciones rápidas**. Entonces Tillor no ha recibido nada. Comprueba si el controlador está en línea y si la pantalla muestra un aviso. Consulta [Avisos en pantalla](/controllers/troubleshooting/scherm) y [Problemas de conexión](/controllers/troubleshooting/verbinding). Comprueba que la matrícula se haya rellenado sin espacios ni errores de escritura. Una matrícula leída mal también puede dejar un vehículo como **Fantasma**. La etiqueta aún no es conocida en Tillor o ya está asignada a otro cliente. Acércala primero a un lector, o desvincúlala del otro cliente. ## Véase también [#zie-ook] # Resumen (/es-ES/praktijk) En la mayoría de las tareas tocas más de un módulo: un cliente nuevo se convierte en una ocupación, un contrato, una factura y un pago. Estos ejemplos recorren una ruta así de principio a fin. Usan la organización de demostración Recreatiepark Het Meer, con el cliente Jonas Maes y la parcela 12. Cada paso remite a la página con la explicación completa. ## ¿Cómo se relaciona todo? [#hoe-hangt-dit-samen] ```mermaid flowchart LR K[Cliente] --> B[Ocupación] T[Parcela] --> B M[Contador] --> T B --> V[Consumo] K --> O[Solicitud de firma] B --> F[Factura] V --> F F --> P[Pago] P --> R[Informe de pagos] K --> TM[Método de acceso] TM --> TP[Punto de acceso] B -->|termina| A[Automatización] A --> TK[Tarea] ``` Lee los ejemplos como una ruta: puedes incorporarte en cualquier punto. Si quieres repasar los términos, consulta [Conceptos](/begrippen). ## Conceptos [#begrippen] - **Ocupación**: un cliente en una parcela durante un periodo largo. Consulta [Ocupación](/begrippen#bezetting). - **Parcela**: un lugar de tu parque. Consulta [Parcela](/begrippen#terrein). - **Solicitud de firma**: un pdf que se firma en línea. Consulta [Solicitud de firma](/begrippen#ondertekenverzoek). - **Automatización**: una regla que Tillor ejecuta por sí mismo. Consulta [Automatización](/begrippen#automatisering). # Dar de alta a un cliente de temporada (/es-ES/praktijk/seizoensklant-binnenhalen) Dar de alta a un cliente de temporada significa en Tillor: crear el cliente, asignarle una parcela, hacer firmar el contrato de alquiler, facturar la cuota de estancia y asegurarse de que el pago llega a su contabilidad. Este ejemplo recorre esa ruta con Jonas Maes, que alquila la parcela 12 del Recreatiepark Het Meer para la temporada. Cada paso remite a la página con la explicación completa. ```mermaid flowchart LR A[Klant aanmaken] --> B[Bezetting op terrein 12] B --> C[Huurcontract tekenen] C --> D[Staangeld factureren] D --> E[Betaling] E --> F[Betalingsrapport] ``` Antes de empezar: - La parcela 12 existe y no tiene ninguna ocupación activa. Si ya tiene una, no aparece en la lista de selección de **Crear ocupación**. - Hay un producto con la acción **Prolongar periodo de ocupación**, a menudo Cuota de estancia. Consulte [Vincular acciones a un producto](/producten/acties-instellen). - Tiene el contrato de alquiler listo en PDF. - Tiene el permiso **Gestionar solicitudes de firma** para hacer firmar el contrato. - Para firmar a distancia, el cliente necesita un correo electrónico o un número de teléfono. Para un mandato SEPA hace falta un correo electrónico. ## La ruta paso a paso [#de-route-stap-voor-stap] ### Cree el cliente [#maak-de-klant-aan] Vaya a Clientes > Resumen y haga clic en **Crear nuevo cliente**. Si hay un escaneo de identidad en la cola, elija ese escaneo en el menú de selección: Tillor rellena los datos a partir del documento. Si no, elija **Manual** y rellene **Nombre**, **Apellidos**, **Correo electrónico** y **Número de teléfono**. Tras crearlo, llegará al perfil de Jonas. Complete allí la dirección. Encontrará más información en [Gestión de clientes](/klantenbeheer) y [Escaneos de identidad](/identiteitsscans). ### Asigne a Jonas la parcela 12 [#geef-jonas-terrein-12] En su perfil, abra la pestaña **Resumen**, vaya a la tarjeta **Ocupaciones** y haga clic en **Crear ocupación**. En **Parcela** elija la parcela 12. Si es necesario, rellene **Pagado hasta**, el **Tipo** y la **Frecuencia de alquiler**. El precio viene por defecto de la parcela. Si la parcela 12 tiene contadores, ahora también puede rellenar las **Lecturas iniciales de contadores**. Consulte [Ocupaciones](/bezettingen#een-bezetting-aanmaken). ### Haga firmar el contrato de alquiler [#laat-het-huurcontract-tekenen] Vaya a Administración > Firmas y haga clic en **Solicitar firmas**. Elija a Jonas Maes como **Cliente**, suba el contrato, añada a Jonas como firmante con **Cliente: Jonas Maes** y coloque un campo de firma. Si lo desea, añada a un empleado como segundo firmante. Haga clic en **Enviar**. Jonas recibe un correo con un enlace personal, o un SMS si solo hay un número de teléfono. Firma en su propio dispositivo y confirma con un código de 6 cifras. Haga clic en **Enviar**, abra la solicitud y, junto a Jonas, haga clic en **Firmar en tableta**. Elija **Con código**, o **Sin código** si ha comprobado su identidad en el mostrador. El contrato se abre en la tableta, con su nombre en letras grandes. Encontrará todos los detalles en [Solicitar firmas](/handtekeningen/handtekening-vragen) y [Así firma una persona](/handtekeningen/ondertekenen). ### Contabilice la cuota de estancia [#boek-het-staangeld] Vuelva a la tarjeta **Ocupaciones** del perfil de Jonas, abra el menú de la ocupación y elija **Extender ocupación (factura)**. Haga clic en **Crear factura borrador**. Tillor crea una factura borrador con el producto que tiene la acción **Prolongar periodo de ocupación**. Compruebe el periodo en la factura y haga clic en **Contabilizar factura**. La factura recibe un número de factura y el estado Contabilizada. Consulte [Contabilizar una factura](/facturen/boeken) y [Prolongar la ocupación](/bezettingen#facturatie-bezetting-verlengen). ### Elija cómo paga Jonas [#kies-hoe-jonas-betaalt] Contabilizar no envía nada al cliente. Ahora elige cómo entra el dinero. Haga clic en **Enviar notificación** y elija un canal, por ejemplo **Correo**. Jonas recibe el botón **Consultar y pagar en línea** y completa el pago con, por ejemplo, iDEAL o Bancontact. Si prefiere que pague primero solo una parte, cree un [enlace para un pago parcial](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). Consulte [Pagar en línea](/betalingsverwerking/online). Solicite primero un mandato en Clientes > Jonas Maes > Facturación con **Crear mandato**. En cuanto el estado sea Activo, elija ese mandato en la factura, en **Mandato de domiciliación**. Tillor cobra entonces dos días después de contabilizar el importe, o dos días después de vincularlo si la factura ya estaba contabilizada. Consulte [Hacer firmar un mandato SEPA](/betalingsverwerking/mandaat) y [Cobrar una factura por domiciliación](/betalingsverwerking/incasso). Haga clic en **Realizar pago** y elija **Terminal**, **Efectivo** o **Transferencia**. Consulte [Registrar un pago](/betalingsverwerking/betaling-registreren). ### Vea cómo entra el pago [#zie-de-betaling-binnenkomen] En Administración > Pagos aparece el pago. Un pago en línea aparece en cuanto Mollie lo confirma. Una domiciliación tiene primero el estado Pendiente y pasa a Pagado al cabo de unos días. Cuando todo ha entrado, la factura queda en Pagada. Encontrará más información en [Encontrar pagos](/betalingsverwerking/betalingen-bekijken). ### Vea el pago en el informe de pagos [#zie-de-betaling-in-het-betalingsrapport] Vaya a Administración > Informes de pago. Los pagos de hoy aparecen en el informe con el estado **Borrador**. Tillor cierra el informe definitivamente en el siguiente control diario, los días laborables a las 09:00. Si su conexión contable está activa, Tillor envía el informe por sí mismo. Consulte [Informes de pago](/boekhouden/betalingsrapporten). ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La ocupación de Jonas está en curso. La parcela 12 ya no está disponible para otros clientes y el consumo de los contadores de la parcela se imputa a Jonas. - En cuanto todos han firmado, la solicitud queda en Completada. El PDF firmado con las páginas de evidencia está en sus **Documentos**. Si quiere que una automatización haga algo entonces, por ejemplo crear una tarea, use el disparador **Solicitud de firma completada**. - Al contabilizar la factura, Tillor pone **Facturado hasta** al final de la línea de factura. Tras el pago, **Pagado hasta** avanza. Consulte [Pagado hasta, tipo, frecuencia de alquiler y precio](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs). - La próxima temporada, prolongue la misma ocupación de nuevo con **Extender ocupación (factura)**, o para todas las ocupaciones de un cliente a la vez con **Extender todas**. - Los pagos de Mollie aparecen en el informe borrador como anticipo de Mollie, hasta que se conoce la liquidación. ## ¿Problemas? [#problemen] Una parcela solo puede estar vinculada a un cliente a la vez. Si ya hay una ocupación activa, no aparece en la lista. Finalice primero esa ocupación, consulte [Finalizar una ocupación](/bezettingen#een-bezetting-beëindigen). Tillor comprueba la solicitud e indica qué falta: un firmante sin campo de firma, un firmante sin correo electrónico ni número de teléfono, o un título vacío. Corríjalo e inténtelo de nuevo. Consulte [Solicitar firmas](/handtekeningen/handtekening-vragen#problemen). Pase el ratón por encima del botón, Tillor muestra el motivo. A menudo falta una fecha de inicio o de fin en una línea con una ocupación, o el importe supera el máximo del mandato vinculado. Consulte [Cuando no se puede contabilizar](/facturen/boeken#problemen). Debe existir al menos un producto con la acción **Prolongar periodo de ocupación**. Sin un producto así, Tillor no puede construir la línea. Cree el producto o añada la acción, consulte [Vincular acciones a un producto](/producten/acties-instellen). Jonas no tiene un mandato con el estado Activo cuyo importe máximo sea suficientemente alto. Compruebe la tarjeta **Mandatos** en su pestaña **Facturación**. El pago se ha iniciado, pero el dinero aún no ha entrado definitivamente. Es normal en una domiciliación. En cuanto el pago se procesa, el estado pasa a **Pagada**. Consulte [Estados](/facturen/statussen). ## Véase también [#zie-ook] # Una caravana estática queda libre (/es-ES/praktijk/stacaravan-komt-vrij) Cuando un cliente se va de una caravana estática, hay trabajo por hacer: hay que revisar la caravana y devolver la fianza al cliente. Este ejemplo muestra cómo lo reúne Tillor. Usted finaliza la ocupación, una automatización crea una tarea de revisión, un compañero la completa y después gestiona la fianza. Usamos como ejemplo a Jonas Maes y la parcela 12 del Recreatiepark Het Meer, ahora como inquilino de una caravana estática. ```mermaid flowchart LR A[Bezetting stoppen] --> B[Automatisering] B --> C[Nalooptaak met subtaken] C --> D[Collega rondt af] D --> E[Waarborg terug via creditnota] ``` Antes de empezar: - La parcela 12 tiene el tipo de parcela **Caravana estática** y Jonas tiene una ocupación activa en ella. Consulte [Tipos de parcela](/terreinen#terreintypes). - Hay una automatización preparada que crea una tarea al terminar una ocupación. Cómo construirla está en [Ejemplo: revisar una caravana de alquiler](/automatiseringen/voorbeeld-nalopen). En los entornos de demostración ya está preparada con el nombre **Revisar caravana de alquiler**, en pausa, hasta que active el interruptor **Activa**. - Para la fianza: el producto de fianza tiene activada la opción **Vigilar el saldo del cliente en esta cuenta**. Consulte [Vigilar el saldo del cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken). ## La ruta paso a paso [#de-route-stap-voor-stap] ### Finalice la ocupación [#stop-de-bezetting] Abra el perfil de Jonas, vaya en la pestaña **Resumen** a la tarjeta **Ocupaciones**, abra el menú de la ocupación y elija **Eliminar**. En **Fecha** elija el día en que se va. Si la parcela tiene contadores, rellene las **Lecturas finales de contadores**. Haga clic en **Eliminar**. Después, la parcela 12 vuelve a estar libre para una nueva ocupación. Consulte [Finalizar una ocupación](/bezettingen#een-bezetting-beëindigen). ### Deje que la automatización cree la tarea de revisión [#laat-de-automatisering-de-nalooptaak-maken] No tiene que hacer nada. La automatización se inicia en cuanto termina la ocupación y primero comprueba si la parcela tiene el tipo de parcela **Caravana estática**. Después busca si ya hay una tarea abierta **Revisar** para esta parcela. - Si todavía no hay una tarea abierta, crea una tarea **Revisar parcela 12** con cinco subtareas (**Limpieza**, **Inventario**, **Internet + TV**, **Marco con código QR** y **Revisar trabajos pendientes**) y un plazo de 7 días. La tarea también va al compañero que finalizó la ocupación. - Si ya hay una tarea abierta, por ejemplo porque la caravana quedó libre dos veces seguidas en poco tiempo, no crea una segunda. La prioridad de la tarea existente sube un nivel, hasta **Alta**. Puede seguir lo que hizo la automatización en [Pruebas y ejecuciones](/automatiseringen/testen-en-uitvoeringen). ### Complete la tarea [#werk-de-taak-af] El compañero encuentra la tarea en la tarjeta **Tareas para usted** del panel, en la pestaña **Tareas** de Jonas, o en una vista dentro de **Tareas**. La tarea está vinculada a la parcela 12 y a Jonas. Abra la tarea y marque cada subtarea en cuanto esté hecha. Junto a la tarea aparece un contador como **2/5**. Cuando todas las subtareas estén listas, ponga el estado en **Completada**. Si pone la tarea principal en **Completada**, las subtareas abiertas se completan también. Si ha ampliado la automatización con el paso **Pedir una decisión**, por ejemplo para decidir si la fianza se devuelve por completo, en la tarea aparecen botones bajo **Elige una acción para terminar esta tarea**. Un clic completa la tarea. Si la elección pide un motivo, se abre **¿Por qué esta elección?**. Una elección hecha ya no se puede deshacer. Consulte [Tareas con botones de elección](/taken/taakdetails#taken-met-keuzeknoppen) y [Pedir una decisión](/automatiseringen/logica#vraag-om-een-beslissing). ### Compruebe el saldo de la fianza [#controleer-het-saldo-van-de-waarborg] Abra el perfil de Jonas y vaya a la pestaña **Facturación**. En la tabla **Cuentas** ve el saldo por cuenta contable. La cuenta de la fianza muestra lo que Jonas tiene aún a su favor. ### Cree la nota de crédito de la fianza [#maak-de-creditnota-voor-de-waarborg] Abra la factura de fianza de Jonas, haga clic en los tres puntos de arriba a la derecha y elija **Rectificar factura**. Tillor crea una factura borrador con las mismas líneas en importes negativos. Si retiene una parte, por ejemplo por daños, ajuste el importe. Haga clic en **Contabilizar factura**. La factura pasa a ser una **Factura de abono**. Tillor rechaza una factura que deje el saldo de la cuenta de fianza por debajo de cero. Así no se puede devolver una fianza dos veces. Consulte [Rectificar una factura](/facturen/corrigeren#een-factuur-omkeren). ### Compense el importe [#verreken-het-bedrag] Si Jonas tiene todavía una factura pendiente, por ejemplo por el último consumo, puede compensar el importe con el método de pago **Transferencia interna**. Consulte [Hacer una transferencia interna](/betalingsverwerking/interne-overboeking). Tillor registra la nota de crédito y la compensación. Devolver el importe a la cuenta bancaria del cliente se hace a través de su banco. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - La parcela vuelve a estar libre. Un nuevo cliente puede tomar una ocupación en ella o recibir una reserva. - Los periodos de consumo pendientes de Jonas quedan cerrados, con las lecturas finales que usted rellenó. El consumo hasta la fecha de fin se conserva y todavía puede facturarlo. Consulte [Cobrar el consumo](/praktijk/verbruik-aanrekenen). - La tarea y las acciones sobre ella aparecen en la cronología de la tarea y en el perfil de Jonas. Los cambios en la ocupación están en su pestaña **Eventos**. - La nota de crédito pasa a la contabilidad como cualquier otra factura. ## ¿Problemas? [#problemen] Compruebe tres cosas. ¿Está activado el interruptor **Activa** de la automatización? ¿El tipo de parcela de la parcela 12 es **Caravana estática**? Mire en [Pruebas y ejecuciones](/automatiseringen/testen-en-uitvoeringen) si la automatización se inició y dónde se detuvo. La automatización busca una tarea abierta con exactamente el mismo título, **Revisar** seguido del nombre de la parcela, para la misma parcela, el mismo cliente o la misma reserva. Si el título no coincide, no encuentra la tarea existente y crea una nueva. Una tarea abierta solo recibe una prioridad más alta, no una segunda tarea. Si pone **La termina su automatización**, solo la automatización puede completar la tarea y la tarea no tiene **Eliminar**. Consulte [Detalles de la tarea](/taken/taakdetails#taken-met-keuzeknoppen). Puede elegir quien tiene asignada la tarea y un administrador. Si no hay nadie asignado, puede elegir cualquiera que vea la tarea. Si aparece una marca de verificación en lugar de botones, la tarea no procede de un paso **Pedir una decisión**. El saldo de la cuenta de fianza quedaría por debajo de cero. Compruebe la tabla **Cuentas** y el importe de la factura. Con el permiso **Anular el saldo de la cuenta** puede contabilizar igualmente, con una justificación que queda en la cronología de la factura. ## Véase también [#zie-ook] # Cobrar el consumo (/es-ES/praktijk/verbruik-aanrekenen) Cobrar el consumo funciona en Tillor a través de la parcela: un contador pertenece a una parcela, un cliente llega a la parcela mediante una ocupación y el consumo del contador va a ese cliente. Este ejemplo sigue el contador de electricidad de la parcela 12 del Recreatiepark Het Meer, desde la vinculación hasta la factura de Jonas Maes. Al final se explica cómo Tillor también puede crear y enviar esa factura por sí mismo. ```mermaid flowchart LR A[Meter] -->|koppelen| B[Terrein 12] B --- C[Bezetting van Jonas] A -->|meterstanden| D[Verbruik van Jonas] D --> E[Openstaand verbruik] E --> F[Factuur] F -.->|automatisch| G[Nutsfactuur op vaste dag] ``` Antes de empezar: - El contador ya existe en Parque > Contadores y todavía no está vinculado a una parcela. Un contador que ya está en una parcela no aparece en la lista de selección. - Jonas tiene una ocupación activa en la parcela 12. Consulte [Dar de alta a un cliente de temporada](/praktijk/seizoensklant-binnenhalen). Sin ocupación, Tillor no sabe a quién corresponde el consumo. - Para la factura automática, Jonas necesita un correo electrónico o un número de teléfono, y para el cobro automático un mandato activo. ## La ruta paso a paso [#de-route-stap-voor-stap] ### Vincule el contador a la parcela 12 [#koppel-de-meter-aan-terrein-12] Vaya a Parque > Parcelas, abra la parcela 12 y desplácese hasta la tarjeta **Contadores**. Haga clic en **Añadir contador**, elija el contador y haga clic en **Asignar contador**. Consulte [Gestión de contadores](/meterbeheer/meter-koppelen) y [Parcelas](/terreinen). ### Registre la lectura inicial [#leg-de-beginstand-vast] Si Jonas ya está inscrito en la parcela 12, rellene la lectura inicial en la ocupación. Si crea la ocupación ahora, rellene **Lecturas iniciales de contadores**. Si lo deja vacío, Tillor toma la última lectura conocida. Así, el primer lote de consumo empieza enseguida en la lectura correcta. Consulte [Ocupaciones](/bezettingen#een-bezetting-aanmaken). ### Siga las lecturas [#volg-de-meterstanden] Los contadores inteligentes envían su lectura por sí mismos, normalmente a diario o cada semana. Un contador manual lo lee y lo introduce usted mismo. Consulte [Gestión de contadores](/meterbeheer). El consumo se ve en dos sitios. En la página del contador, en Parque > Contadores, está la tarjeta **Consumo** con el consumo pendiente y liquidado por cliente. En el perfil de Jonas está la tarjeta **Lecturas**, con todos los contadores de sus parcelas. Si alguien introduce una lectura inferior a la anterior, Tillor avisa. Si la lectura es correcta de todos modos (se ha sustituido el contador), Tillor cierra el periodo en curso y empieza uno nuevo. Consulte [Lotes de consumo](/meterbeheer/consumptie-batches). ### Vea lo que está pendiente [#bekijk-wat-openstaat] Vaya a Clientes > Consumo pendiente. Ve por cliente el importe total, la **Última factura de suministros** y el número de contadores. Jonas aparece en cuanto hay consumo que todavía no está en una factura. ### Cree la factura [#maak-de-factuur] Tiene dos maneras. Haga clic en el icono de envío al final de la fila de Jonas. La ventana **Crear factura** muestra el importe total, el desglose por tipo y el número de contadores. Marque los canales con los que Tillor envía la factura de inmediato y haga clic en **Crear factura**. Tillor crea la factura, la contabiliza y la envía. Si Jonas tiene un mandato para facturas de suministros, aparece preseleccionado en **Cobrar con mandato**. Abra el perfil de Jonas y, en la tarjeta **Lecturas**, haga clic en **Facturar consumo**. Tillor pone por cada periodo de consumo una línea principal con debajo una línea informativa con la fecha y las lecturas. Si ya existe una factura borrador adecuada, las líneas se añaden a ella. Compruebe la factura, contabilícela y envíela usted mismo. Consulte [Contabilizar una factura](/facturen/boeken) y [Enviar una factura](/facturen/versturen). ### Deje que Tillor lo haga por sí mismo [#laat-tillor-het-zelf-doen] Abra el perfil de Jonas, vaya a Clientes > Jonas Maes > Facturación y abra la tarjeta **Configuración de facturación**. Allí configura: - **Facturación automática de suministros**: un día del mes. Si elige el 31 y el mes no tiene 31 días, la factura se emite el último día del mes. - **Mandato**: el mandato con el que Tillor cobra la factura de suministros. Consulte [Cobrar una factura por domiciliación](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen). - **Importe mínimo**: un límite inferior propio para Jonas. Si lo deja vacío, rige el mínimo de la organización en Soporte > Configuración > Facturación. El día elegido, Tillor crea la factura por sí mismo y la envía. Si el importe pendiente está por debajo del mínimo, Tillor espera a un próximo día de facturación. ## ¿Qué ocurre después? [#wat-gebeurt-er-daarna] - Los periodos de consumo facturados quedan cerrados. Si la ocupación continúa, Tillor inicia un nuevo periodo en la lectura final del anterior, de modo que no queda ningún hueco. - Si la factura está contabilizada, sigue su curso como cualquier otra factura: pago, reclamación e informe de pagos. Consulte [Dar de alta a un cliente de temporada](/praktijk/seizoensklant-binnenhalen). - Al terminar la ocupación, Tillor cierra los periodos pendientes. El consumo hasta la fecha de fin se conserva y todavía puede facturarlo. - Si elimina una factura borrador con consumo, el consumo vuelve a **Consumo pendiente**. Si el consumo pendiente de electricidad o agua es al menos el doble de lo que Jonas suele consumir, Tillor no crea la factura automática. Recibirá un correo en la dirección de soporte de la organización. Compruebe la lectura del contador y facture usted mismo el consumo si todo es correcto. ## ¿Problemas? [#problemen] La lista solo muestra contadores sin parcela. Si el contador ya está en otra parcela, desvincúlelo primero desde el menú del contador en esa parcela, con **Desvincular de la parcela**. El consumo va al cliente con una ocupación activa en la parcela. Compruebe si Jonas tiene una ocupación en la parcela 12 y si el contador está vinculado a la parcela. Por defecto, la lista solo muestra clientes sin facturación automática. Ponga el filtro **Facturación automática** en **Con fecha** para ver los clientes con un día de factura automática. Hay dos motivos habituales. El importe pendiente está por debajo del mínimo, y entonces Tillor espera a un próximo día de facturación. O el consumo está muy por encima de lo habitual, y entonces recibe un correo en la dirección de soporte y la factura no se emite hasta que alguien la revise. Consulte [Gestión de contadores](/meterbeheer/verbruik-factureren#automatisch-factureren). Abra el periodo en la tarjeta **Lecturas** o **Consumo**, haga clic en el icono de advertencia junto al periodo y confirme con **Sí, marcar como facturado**. El periodo se cierra entonces sin factura. Solo puede deshacerlo para periodos sin factura vinculada. ## Véase también [#zie-ook]