Dinaup DocsDocumentos dinámicos
Genera contenido a medida (HTML, JSON, XML, PDF o emails) mezclando tus datos con plantillas programables, para impresión, dashboards, emails o APIs.
Un documento dinámico es una plantilla programable que mezcla tus datos de Dinaup con código para producir un resultado a medida: una factura en PDF, un email personalizado, un panel con gráficos o una respuesta JSON para otro sistema. Tú defines la plantilla una vez y Dinaup la rellena con datos reales cada vez que se usa.
La plantilla se escribe con DinaScript sobre tecnología web estándar (HTML, CSS, JavaScript). El mismo documento puede imprimirse, enviarse por email, incrustarse como widget en un dashboard o consultarse desde una API externa.
¿Es tu primer documento dinámico? Salta a Crear documento dinámico para entender el flujo básico (código + variables) y vuelve aquí cuando quieras elegir el tipo adecuado o ver un ejemplo completo.
Tipos de documento dinámico
No todos los documentos dinámicos sirven para lo mismo. Al crearlo eliges un tipo, y ese tipo determina qué genera y dónde se usa. Estos son los disponibles:
| Tipo | Qué produce | Para qué sirve |
|---|---|---|
| Diseño de informe | Una plantilla visual asociada a un informe | Dar formato a los resultados de un informe (cómo se ven las filas y los totales al presentarlos). |
| Documento de lectura libre (HTML) | Una página HTML completa | Impresión (facturas, albaranes, presupuestos en PDF), emails y paneles con gráficos o tablas. Es el tipo más versátil. |
| API de lectura libre (JSON / XML) | Datos estructurados en JSON o XML | Exponer información de Dinaup a otro sistema mediante un endpoint que se consulta en remoto. |
| API de escritura | Una operación que recibe datos y los guarda | Recibir información desde fuera y crear o actualizar registros en tus secciones. |
| Documento contable | Asientos y datos para contabilidad | Generar la información contable derivada de tus registros con el formato que necesita la contabilidad. |
Si dudas, casi siempre quieres un Documento de lectura libre (HTML): cubre impresión, email y dashboards con la misma plantilla. Reserva los tipos de API para cuando otro sistema vaya a hablar con Dinaup, y el Documento contable para cuando el destino sea la contabilidad.
Cuándo usar cada uno
Elige el tipo según adónde va el resultado:
- Lo vas a imprimir o enviar por email → Documento de lectura libre (HTML). Diseñas la página con HTML y CSS, la generas en PDF para imprimir o la mandas como cuerpo de un correo. Es el caso de una factura, un albarán o un presupuesto. Ver Plantilla de impresión de facturas.
- Lo quieres mostrar dentro de Dinaup → Documento de lectura libre (HTML) incrustado como widget en un dashboard: el resumen de un proyecto, un panel con gráficos, una tabla de seguimiento.
- Quieres dar formato a un informe → Diseño de informe, asociado al informe cuyos resultados quieres presentar con un aspecto concreto.
- Otro sistema va a leer datos de Dinaup → API de lectura libre (JSON / XML). Publicas un endpoint que devuelve los datos ya estructurados, listos para que la otra aplicación los consuma.
- Otro sistema va a enviar datos a Dinaup → API de escritura. El documento recibe la entrada y la convierte en registros nuevos o actualizados en tus secciones.
- El destino es la contabilidad → Documento contable, para producir asientos y la información contable a partir de tus datos.
Qué puedes hacer con ellos
Con documentos dinámicos resuelves, entre muchas otras cosas:
- Enviar correos electrónicos personalizados con los datos de cada registro.
- Crear plantillas de impresión, como facturas o albaranes en PDF.
- Mostrar el resumen de un proyecto o un panel a medida.
- Construir una página con gráficos y tablas para un dashboard.
- Publicar o guardar datos en JSON / XML para integraciones.
- Generar ficheros para transferencias bancarias (SEPA).
- Hacer cálculos matemáticos o financieros sobre tus datos.
- Producir la información contable derivada de tus movimientos.
Tecnologías compatibles
La plantilla se escribe sobre web estándar, así que puedes apoyarte en herramientas que ya conoces:
- HTML, CSS y JavaScript para el contenido y el diseño.
- Bootstrap para maquetar rápido sin escribir CSS desde cero.
- Vue para partes interactivas.
- Google Charts para gráficos en paneles e informes.
El código que rellena la plantilla con tus datos lo pones con DinaScript: defines variables, recorres los registros y vuelcas el resultado.
Por dónde empezar
Crea tu primer documento
Sigue Crear documento dinámico para dar de alta una plantilla, elegir su tipo y abrir el editor de código con sus variables.
Parte de un ejemplo real
En Ejemplos tienes plantillas completas (una factura para imprimir, un libro registro en HTML) listas para copiar y adaptar a tu negocio.
Conéctalo a tus datos
Ajusta las secciones, campos y textos de la plantilla para que reflejen tu información, guarda y prueba el resultado.
Preguntas frecuentes
→ Crear documento dinámico → Plantilla de impresión de facturas → Ejemplos → Informes → DinaScript