Hoppa till innehåll

Odoo-rapporter med QWeb: anpassa fakturor och ordrar

PDF-rapporter som matchar ditt varumärke

Odoo genererar PDF-rapporter för fakturor, försäljningsordrar, leveranssedlar, lageroperationer och mer. Alla bygger på QWeb-templates (XML-baserat templating) som du kan anpassa.

QWeb-grunder

QWeb är Odoos template-motor. Den använder XML med speciella attribut: t-field för att visa fältvärden, t-foreach för loopar, t-if för villkor, t-esc för rå text. Syntaxen liknar Jinja2 men är XML-baserad.

Anpassa en befintlig rapport

Skapa en ny template som ärver (inherit) den befintliga. Använd XPath för att hitta och ersätta specifika element. Byt logga, ändra layout, lägg till extra fält. Hela anpassningen görs i en modul utan att röra kärnkoden.

Fakturamall

Den vanligaste anpassningen. Lägg till företagets logga, bankuppgifter i sidfoten, anpassade färger och typografi. Referens-template: account.report_invoice_document. Inherit den och modifiera med XPath.

Papper och marginaler

Under Inställningar → Tekniskt → Rapportering → Pappersformat. A4 är standard i Sverige. Ställ in marginaler (topp, botten, vänster, höger). Sidhuvud och sidfot kan definieras per företag.

WeasyPrint

Odoo 18 har gått över till WeasyPrint för PDF-rendering (ersätter wkhtmltopdf). Det ger bättre CSS-stöd, snabbare rendering och konsekventare resultat. CSS grid och flexbox fungerar nu i rapporter.

Tips

Testa rapporten med riktiga data, inte bara testdata. Långa produktnamn, fakturor med 50 rader, kunder med långa adresser. Det är i kanterna det brukar gå sönder. Och testa utskrift: marginaler i PDF och marginaler vid utskrift kan skilja sig.

Odoo XML-RPC: integrera med Python, Node och Go
Odoos externa gränssnitt förklarat