Dinaup DocsMostrar e imprimir
Cómo se ejecuta un documento dinámico por la API o el SDK, qué devuelve, qué botones ofrece el visor de Play y cómo sale en PDF.
Un documento dinámico devuelve una página HTML completa, con sus estilos y sus scripts. Play la muestra en su visor; si la pides por la API, la muestras tú.
Lo que devuelve el servidor
Por la API REST, con una clave API y la URL de tu empresa (Tu endpoint base en Desarrollo → Inicio):
curl -X POST "https://<clave-de-conexion>.dinaup.io/api/dynamicdocuments?id=<id-del-documento>" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{ "factura": "<id-de-la-factura>" }'- El cuerpo lleva una respuesta por pregunta, con su nombre interno sin
v.como clave. El de la primera pregunta sale de la etiqueta singular de la sección sin espacios: «Pedido de venta» daPedidoDeVenta. - La respuesta es
200con el documento como texto (text/plain), no como JSON. Unidque no es GUID devuelve400. - Si falta la respuesta de alguna pregunta, el documento no se ejecuta y el cuerpo llega vacío.
Con el SDK .NET, DynamicDocuments_ExecuteAsync(documentId, params) devuelve DynamicDocumentsGetResponse:
var respuesta = await client.DynamicDocuments_ExecuteAsync(
"<id-del-documento>",
new Dictionary<string, string> { ["factura"] = "<id-de-la-factura>" });| Campo JSON | En el SDK | Qué es |
|---|---|---|
documento | Content | El HTML ejecutado. Con el metadato enurl a 1, la URL del fichero temporal. |
nombre | Name | El metadato titulo. FileName devuelve email_attachment_name si existe y, si no, Name. |
metadatos | Metadata | Todas las claves fijadas con F.MetaData_Set. |
estado | Status | 0 con contenido, 3 si faltan respuestas. |
El visor de Play
El menú de impresión de una ficha abre el documento en un visor de 240 mm de ancho. Los botones dependen de los metadatos:
| Botón | Cuándo aparece | Qué hace |
|---|---|---|
| Imprimir | Con contenido | Abre el diálogo de impresión del navegador. |
| Enviar por email | Sin email_sign | Abre la vista previa del correo. Ver Envío de emails. |
| Enviar a firmar | Con email_sign | Genera el PDF y abre el diálogo de firma. Tras enviarlo pasa a Enviado a firmar. |
| Cerrar | Siempre | Cierra el visor. |
Incrustado en un panel o en la pantalla de cobro, el visor no lleva botones. La vista de resultado de un informe lleva Imprimir / Guardar PDF.
Cómo convierte Dinaup a PDF
Dinaup convierte a PDF el documento que adjunta un correo y el que va a firma, y lo guarda en una URL temporal. Declara el papel y el margen en la plantilla con @page, no con el padding de un contenedor:
@page { size: A4; margin: 14mm 14mm 12mm; }Mostrarlo en tu web
Muestra el HTML en su propio iframe, con los scripts permitidos: las plantillas con Vue necesitan ejecutar JavaScript para tener datos. Llama a la API desde tu backend para que la clave API no llegue al navegador. Las plantillas cargan Bootstrap y Vue de internet.