Variables en documentos recurrentes
Cuando una tarea recurrente genera un documento, los textos (conceptos, notas, descripciones) son copia exacta de lo que pusiste al configurar la tarea — pero a veces necesitas que ciertos valores cambien en cada ejecución: la fecha del documento, el mes, el número de factura, el nombre del cliente, el importe…
Para eso existen las variables: marcadores que escribes en el texto con la sintaxis {{nombre}} y que FacturaDirecta sustituye por el valor real en el momento de generar el documento.
Ejemplo típico, en el concepto de una factura mensual:
Cuota de servicio {{date}}
Al ejecutarse el 1 de marzo de 2026, el documento generado mostrará:
Cuota de servicio 01/03/2026
Dónde se usan
Las variables están disponibles en los campos de texto largo de los documentos: concepto, descripción, líneas, notas, asuntos del email, etc.
Junto a cada campo soportado verás un botón Variables con un icono de lista (📝). Al pulsarlo se abre un menú con las variables disponibles agrupadas por categoría. Al elegir una, se inserta en el texto la sintaxis {{...}} correspondiente en la posición del cursor.
También puedes escribir directamente {{nombre_variable}} a mano si recuerdas el nombre exacto.
Variables generales del documento
El primer grupo del menú "Variables" cubre los datos comunes a cualquier documento generado:
Variable | Significado | Ejemplo al sustituir |
| Número de documento asignado al documento al guardarse. |
|
| Nombre del contacto destinatario (cliente / proveedor). |
|
| Nombre comercial del contacto (si difiere del nombre fiscal). |
|
| Importe total del documento (con impuestos). |
|
| Importe total antes de impuestos (base imponible). |
|
| Fecha del documento en el formato configurado en la empresa. |
|
| Fecha de vencimiento del documento (la primera, si tiene varias). |
|
Variables para domiciliaciones (SEPA Direct Debit)
Si la tarea recurrente está configurada para cobrarse por domiciliación bancaria (SEPA Direct Debit), aparecen variables extra:
Variable | Significado | Ejemplo |
| Número de IBAN completo del cliente. |
|
| Últimos 4 dígitos del IBAN (para no exponer la cuenta entera en el cuerpo del documento). |
|
| Referencia del mandato SEPA asociado al cobro. |
|
Útiles para concepto de cobro o notas: "Cargo en cuenta {{iban4}} con mandato {{mandateId}}".
Opciones avanzadas para fechas
El menú Variables tiene una sub-sección Opciones avanzadas para fechas que cubre formatos y cálculos derivados de la fecha del documento:
Variable | Significado | Ejemplo |
| Año de la fecha del documento. |
|
| Año siguiente a la fecha del documento. Útil para conceptos como "Cuota anual {{nextYearOfDate}}" emitida en diciembre. |
|
| Fecha del documento formateada en inglés ( |
|
Hay más variables y formatos avanzados disponibles según versión. El menú Variables muestra siempre las disponibles en tu cuenta — úsalo como referencia viva.
Buenas prácticas
No abuses. Cuantas más variables, más difícil de leer queda el texto al configurar la tarea. Limítate a las que aportan valor real al cliente o al equipo administrativo.
Pruébalo antes. Crea una tarea recurrente en modo provisional (para facturas) con una fecha de inicio inmediata. Comprueba que el documento se genera con las variables sustituidas correctamente. Cuando estés contento, cambia a definitiva.
Evita formato mixto. Si tu cliente verá un PDF en castellano, no uses
{{dateFormattedEnglish}}— quedaría raro. Esa variable solo tiene sentido en contextos internacionales.Las variables sirven para constancia, no para condicionales. No hay sintaxis de "si/entonces". Si necesitas que el documento cambie según el mes, divide la recurrencia en varias tareas más específicas.
Variables incorrectas
Si escribes una variable con un nombre que no existe (típico: {{fecha}} en castellano en vez de {{date}}), no se sustituye y el documento generado mostrará literalmente la cadena {{fecha}}. No hay error — solo no se reemplaza.
Por eso es importante probar la tarea con una ejecución real antes de dejarla corriendo en producción.
Recursos relacionados
Crear una tarea recurrente — donde configuras los textos en los que insertar variables.
Trabajar con el listado de tareas recurrentes — para localizar tareas existentes y modificar sus textos / variables.