Rapportmaler
Utleggsappen genererer automatisk en PDF-faktura for hver rapport som godkjennes. Fakturaene bruker en systemstandard mal, men organisasjoner kan få tildelt en egen tilpasset mal for eget utseende og innhold.
Standardmal
Alle organisasjoner har én systemstandard mal. Standardmalen brukes automatisk så lenge ingen tilpasset mal er tildelt. Den dekker det vanlige innholdet i en godkjent rapport — kostnadsposter, satser, kjøreruter og konteringslinjer.
Tilpassede maler per organisasjon
Organisasjoner med egne layoutbehov kan få tildelt en tilpasset mal. Malene er Handlebars-baserte og vedlikeholdes av support.
Tildeling håndteres via API og krever global admin-rolle:
| Metode | Endepunkt | Beskrivelse |
|---|---|---|
GET | /organizations/:id/report-template | Hent malstatus |
PUT | /organizations/:id/report-template | Tildel eller oppdater tilpasset mal |
DELETE | /organizations/:id/report-template | Fjern tilpasset mal (faller tilbake til standard) |
Hvis en mal feiler
Dersom en tilpasset mal feiler under PDF-generering, flagges fakturaen som mislykket. Rapporten forblir godkjent, men faktura-PDF-en genereres ikke. Support varsles og kan rette malen — rapporten trenger ikke godkjennes på nytt. Standardmalen er garantert å produsere et gyldig dokument.
Se også
Nerdehjørnet
Maler løses i denne prioritetsrekkefølgen:
- Organisasjonens tildelte mal (
PUT /organizations/:id/report-template) - Systemstandard (brukes automatisk hvis ingen org-mal er tildelt)
Renderingsfeil fra en tilpasset mal resulterer i at fakturastatus settes til FAILED og en InvoiceErrorEvent emitteres. Integrasjoner som lytter på fakturastatuser bør håndtere dette tilfellet eksplisitt — suksess er ikke garantert selv om rapporten er godkjent.
For å teste en mal mot syntetisk testdata uten å bruke ekte rapporter:
POST /report-templates/test-pdf
Body: { "templateId": "<id>" } // eller "content": "<handlebars-string>"
Tilgang krever global admin-rolle.