{"id":444,"date":"2025-09-26T09:49:35","date_gmt":"2025-09-26T09:49:35","guid":{"rendered":"https:\/\/sienna-manatee-218967.hostingersite.com\/blogs\/reportes-qweb-2\/"},"modified":"2026-05-01T18:54:30","modified_gmt":"2026-05-01T18:54:30","slug":"reportes-qweb","status":"publish","type":"post","link":"https:\/\/exdoo.mx\/blogs\/reportes-qweb\/","title":{"rendered":"Reportes QWEB"},"content":{"rendered":"

\"\"<\/p>\n

\u00bfQu\u00e9 son los reportes QWeb en Odoo?<\/u><\/em><\/p>\n

\n
\ud83d\udcd8 ART\u00cdCULO T\u00c9CNICO<\/div>\n

Son el sistema principal para generar documentos en PDF, HTML o texto a partir de plantillas QWeb, que es un motor de renderizado de vistas que usa sintaxis XML.<\/p>\n<\/div>\n

Caracter\u00edsticas de los reportes QWeb<\/u><\/em><\/p>\n

Por mencionar algunas:<\/p>\n

    \n
  • Permiten combinar HTML con expresiones din\u00e1micas en Python (t-esc, t-foreach, t-if, etc.).<\/li>\n
  • Los reportes son, en esencia, vistas QWeb dise\u00f1adas para impresi\u00f3n.<\/li>\n
  • Se asocian a un modelo (por ejemplo, sale.order) y se pueden ejecutar desde botones, men\u00fas o acciones autom\u00e1ticas.<\/li>\n
  • Se usan para documentos como facturas, \u00f3rdenes de venta, cotizaciones, \u00f3rdenes de compra, etiquetas, etc.<\/li>\n
  • Permites personalizaci\u00f3n completa de dise\u00f1o con HTML, CSS y condicionales.<\/li>\n<\/ul>\n

    Tipos de reportes QWeb<\/u><\/em><\/p>\n

      \n
    • qweb-pdf:<\/strong> Genera un archivo PDF listo para imprimir o enviar. Se utiliza en facturas, cotizaciones, compras, etc.<\/li>\n
    • qweb-html:<\/strong> Muestra el reporte directamente en el navegador como una vista previa en HTML. Se utiliza en la previsualizaci\u00f3n de documentos.<\/li>\n
    • qweb-text:<\/strong> Genera salida en texto plano. Ideal para integraciones o reportes que no necesitan formato gr\u00e1fico.<\/li>\n<\/ul>\n

      Ejemplo de reporte QWeb en Odoo<\/h3>\n

      Se utilizar\u00e1 el m\u00f3dulo de ventas para crear un reporte dentro de las cotizaciones (modelo sale.order).<\/p>\n

      Dentro de un m\u00f3dulo personalizado agregamos el archivo ir_actions_report.xml<\/em><\/strong> dentro de la carpeta report<\/em><\/strong>. Es importante notar que no es estricto el nombre y la ubicaci\u00f3n del archivo, y pueden ser a decisi\u00f3n del desarrollador o usuario. El c\u00f3digo del archivo es el siguiente:<\/p>\n

      \"\"<\/p>\n

      donde:<\/p>\n

        \n
      • name:<\/strong> Es el nombre de la acci\u00f3n que genera el reporte. En este caso \u201cReporte Ventas\u201d, el cual veremos dentro del modelo sale.order.<\/li>\n
      • model:<\/strong> Es el nombre t\u00e9cnico del modelo del que se generar\u00e1 el reporte. En este caso, ventas o cotizaciones (sale.order).<\/li>\n
      • report_type:<\/strong> El tipo del reporte que ser\u00e1 renderizado. Debe ser uno entre sus posibles valores: qweb-htlml, qweb-pdf y qweb-text.<\/li>\n
      • report_name:<\/strong> Es el identificador t\u00e9cnico interno del reporte.<\/li>\n
      • report_file:<\/strong> Es el nombre de la plantilla que define la estructura del reporte.<\/li>\n
      • print_report_name:<\/strong> El nombre que tendr\u00e1 el archivo. En este caso, se utiliza una condicional para obtener el nombre seg\u00fan el estado de la venta. Si el estado es Cotizaci\u00f3n (draft) o Cotizaci\u00f3n enviada (sent), el nombre ser\u00e1 \u2018Cotizaci\u00f3n – [folio_de_la_order]\u2019, en caso contrario, ser\u00e1 \u2018Venta – [folio_de_la_order]\u2019.<\/li>\n
      • binding_model_id:<\/strong> M\u00f3dulo y nombre del que se generar\u00e1 el reporte.<\/li>\n<\/ul>\n

        Definimos report_sale_order<\/em><\/strong> como el nombre de la plantilla que define la estructura del reporte, por lo que creamos un archivo ir_actions_report_template.xml<\/em><\/strong> dentro de la carpeta report<\/em><\/strong> del m\u00f3dulo personalizado (el nombre y ubicaci\u00f3n pueden ser a decisi\u00f3n del desarrollador\/usuario) con id igual a report_sale_order. La estructura b\u00e1sica en c\u00f3digo de la plantilla es la siguiente.<\/p>\n

        \"\"<\/p>\n

        Al mapear los dos archivos anteriores dentro del m\u00f3dulo e instalarlo en una base, observamos que el modelo sale.order ya tiene disponible la acci\u00f3n \u201cReporte Ventas\u201d para generar el reporte.<\/p>\n

        \"\"<\/p>\n

        Al accionar el bot\u00f3n, se descarga el reporte a partir de la plantilla b\u00e1sica que definimos anteriormente. En este caso, la plantilla es solo una p\u00e1gina en blanco.<\/p>\n

        \"\"<\/p>\n

        Notemos que en nuestra plantilla utilizamos la plantilla modular html_container<\/em><\/strong>, perteneciente al m\u00f3dulo web<\/em><\/strong>. Esta plantilla modular contiene la informaci\u00f3n necesaria para generar el reporte, pero no es la \u00fanica plantilla modular del m\u00f3dulo. Por ejemplo, el m\u00f3dulo tambi\u00e9n a\u00f1ade varias plantillas modulares que funcionan como cabeceras, las mismas que pueden ser modificadas o personalizadas dentro del propio sistema. En este caso, utilizaremos la plantilla modular external_layout<\/em><\/strong> del m\u00f3dulo web<\/em><\/strong>, y al llamarla, declaramos las variables doc<\/em><\/strong>, forced_vat<\/em><\/strong> y address<\/em><\/strong> que la plantilla espera recibir para construir el encabezado. El c\u00f3digo de nuestra plantilla queda de la siguiente manera:<\/p>\n

        \"\"<\/p>\n

        Y al volver a imprimir el reporte, notamos que se agreg\u00f3 el encabezado en autom\u00e1tico:<\/p>\n

        \"\"<\/p>\n

        donde la imagen es el logo de la empresa asociada al registro del modelo de ventas.<\/p>\n

        Dentro de nuestra plantilla podemos llamar a otros campos de la venta. Agregamos el folio de la venta dentro del reporte, modificando nuestra plantilla de la siguiente manera:<\/p>\n

        \"\"<\/p>\n

        El cual nos genera el siguiente reporte:<\/p>\n

        \"\"<\/p>\n

        Por lo que de esta forma podemos agregar campos de la orden para mostrarlos en el reporte seg\u00fan el dise\u00f1o que queramos.<\/p>\n

        Por \u00faltimo, en este caso estamos utilizando un reporte tipo qweb-pdf<\/em><\/strong>, pero una buena pr\u00e1ctica es primero utilizar qweb-html<\/em><\/strong> para definir la estructura general del reporte y visualizarla directo en el navegador sin tener que imprimir el reporte cada vez que hagamos cambios. A la acci\u00f3n que genera el reporte le cambiamos el tipo qweb-pdf<\/em><\/strong> por qweb-html<\/em><\/strong> de la siguiente manera:<\/p>\n

        \"\"<\/p>\n

        Y al volver a generar el reporte desde la venta, vemos que se previsualiza directo en el navegador.<\/span><\/p>\n

        \"\"<\/p>\n

        Consejos r\u00e1pidos:<\/strong><\/span><\/p>\n

          \n
        • Define correctamente el report_type (qweb-pdf, qweb-html, qweb-text) seg\u00fan el formato que necesites.<\/span><\/li>\n
        • Usa clases CSS de Bootstrap (ya incluidas en Odoo) para dar formato a tablas y textos sin complicarte.<\/span><\/li>\n
        • Testea primero en HTML (qweb-html) antes de exportar a PDF para detectar problemas de dise\u00f1o.<\/span><\/li>\n
        • Mant\u00e9n las plantillas modulares: utiliza t-call para incluir fragmentos y no duplicar c\u00f3digo.<\/span><\/li>\n
        • Aprovecha las expresiones din\u00e1micas para recorrer listas, aplicar condiciones y mostrar datos de forma segura en el reporte.<\/span><\/li>\n
        • Personaliza el nombre del archivo generado de acuerdo a tus necesidades<\/span>.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

          \u00bfQu\u00e9 son los reportes QWeb en Odoo? \ud83d\udcd8 ART\u00cdCULO T\u00c9CNICO Son el sistema principal para generar documentos en PDF, HTML o texto a partir de plantillas QWeb, que\u2026<\/p>\n","protected":false},"author":1,"featured_media":432,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"class_list":["post-444","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/posts\/444","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/comments?post=444"}],"version-history":[{"count":3,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/posts\/444\/revisions"}],"predecessor-version":[{"id":1958,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/posts\/444\/revisions\/1958"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/media\/432"}],"wp:attachment":[{"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/media?parent=444"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/categories?post=444"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/exdoo.mx\/blogs\/wp-json\/wp\/v2\/tags?post=444"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}