Documento: el registro se vuelve papel membretado.

El pedido de venta nº 1052, en PDF

El encabezado trae la empresa. Después vienen los datos del cliente, la tabla de ítems, el total y las líneas de firma. El total es el mismo que está guardado en la base de datos.

Abrir este PDF (ejemplo en portugués)

Una plantilla con los campos del registro

El diseño es una plantilla que recibe los campos del registro. El controller junta los datos y devuelve el PDF listo para descargar, enviar por correo o adjuntar.

// Controller: toma los datos y devuelve el PDF$html = MadBlade::renderString($template, ['venda'   => $venda,'cliente' => $venda->cliente->nome,'itens'   => $itens,'total'   => number_format($venda->valor_total, 2, ',', '.'),]);return response(MadDocPdf::fromHtml($html, ['paper' => 'A4']))->header('Content-Type', 'application/pdf');

Una central para guardar los documentos

La app generada también trae una central de documentos lista. Tiene carpetas, etiquetas, favoritos, recientes, compartidos conmigo, archivo y papelera. Ahí guardas lo que generaste y lo que recibiste.

Cuándo usar el documento

Usa el documento cuando un registro necesita volverse papel para enviar, imprimir o firmar, siempre con el mismo diseño.

• Pedido y presupuesto. Cliente, ítems y total, listos para enviar al cliente.
• Orden de servicio. El servicio realizado y la firma del cliente y del técnico.
• Contrato. Cláusulas en texto corrido, salto de página y la firma de las dos partes.
• Recibo. Valor, CPF o CNPJ ya formateados y un código QR que lleva al registro.
• Etiqueta de inventario. Código de barras en un papel del tamaño de la etiqueta.

Para varios registros en un solo PDF, con grupos y totales, usa el informe. Para crear y editar los datos, el formulario. Lo que entrega el diseñador de documentos está en la generación de código.

Lo que configuras

El diseño se arma en bloques. Estos ajustes son los que más cambian el papel.

Papel y orientación size

A4 en vertical es el predeterminado. Para una etiqueta, el tamaño puede ser a medida, en milímetros.

Márgenes y letra margins

Los cuatro márgenes, la fuente (font) y el tamaño de letra (font-size) de todo el documento.

Marca de agua watermark-text

Un texto en diagonal en la página, como COPIA, con opacidad, ángulo y color ajustables.

Formato del campo format

Moneda, número, porcentaje, fecha, CPF, CNPJ, CEP o teléfono. Un texto antes del valor, como "Cliente:", va en prefix.

Tabla de ítems model

Las filas de otra tabla, como los productos del pedido, filtradas por el registro del documento (filter).

Línea de firma role

Una línea para firmar, con el nombre (name) y el rol de la persona, como Cliente o Vendedor.

Lo que va al proyecto Laravel

El documento es una clase en app/Control con un método que arma y devuelve el PDF, como en el fragmento de arriba, más un diseño Blade hecho de etiquetas <mad-doc-...>. En la práctica:

• Una dirección por registro. La ruta sigue el formato /app/docs/{documento}/{id}. Cambiando el número, sale el PDF de otro registro.
• Botón de PDF en el listado. Una acción en la fila (<mad-nav>) abre el documento de ese registro.
• PDF armado en el servidor. Quien dibuja el archivo es DomPDF, una librería PHP de código abierto que corre dentro de la app.

Como toda pantalla de MadBuilder, esos archivos se abren en tu editor, van a tu Git y aceptan código a mano en bloques protegidos, que siguen ahí cuando la pantalla se genera de nuevo. Mira cómo se genera el código.

Preguntas sobre el documento

Y más

Mira también el Formulario o los tipos de página.