EHF: elektronisk faktura ut og inn
Issue #14. EHF er UBL 2.1 med PEPPOL-profil (BIS Billing 3.0): obligatorisk mot det offentlige, forventet i B2B. Denne saken leverer de to endene vi kan stå inne for uten et aksesspunkt: dokumentet vi sender, og dokumentet vi leser.
To tiere, som for bank
Section titled “To tiere, som for bank”| Tier | Status |
|---|---|
| Dokumentet — rendre gyldig EHF ut, lese mottatt EHF inn | ✅ her |
| Transporten — sending/mottak gjennom et aksesspunkt (Peppol SMP-oppslag, AS4) | krever avtale med en aksesspunktleverandør |
Egen AP-sertifisering er bevisst utenfor (ROADMAP: frugal). Når transporttieren kommer, er det sendingen som logges — samme mønster som e-postutsendelsen (docs/faktura.md): loggraden er meldingen.
Ut: rendret og lagret ved utstedelse
Section titled “Ut: rendret og lagret ved utstedelse”EHF-en rendres med regnmed-core::ehf — hand-rolled og deterministisk,
som SAF-T, mva-meldingen og pain.001 — i samme transaksjon som
fakturaen utstedes, og lagres som vedlegg på fakturabilaget ved
siden av PDF-en (#222). GET /companies/{id}/invoices/{iid}/ehf
leverer det lagrede dokumentet, hash-sjekket ved lesing som alle
vedlegg (docs/blob-store.md).
Hvorfor lagret, og ikke rendret ved hvert oppslag: dokumentet bærer selgerens og kjøperens adresse, e-post og kontonummer, og de er redigerbare stamdata, ikke hashet. Rendret på nytt etter at kunden flyttet, var EHF-en ikke lenger dokumentet som ble utstedt — og fra 1.1.2027 skal en elektronisk faktura oppbevares i sitt opprinnelige format (bokføringsloven § 13 annet ledd, LOV-2026-06-19-39). PDF-en og EHF-en er to representasjoner av samme utstedelse, rendret av de samme radene i samme øyeblikk; den tidligere avgjørelsen om å ikke lagre EHF-en («to sannheter») holdt bare så lenge EHF-en aldri ble sendt (docs/efaktura.md §3.5).
- Uten kjøperens orgnr lagres ingen EHF — i Peppol er orgnr adressen, og endepunktet sier fra som før.
- En kontantfaktura utstedt etter #222 (betalt ved utstedelse, også
Stripe-betalte abonnementsfakturaer) får ingen
cac:PaymentMeans: KID og kontonummer for penger som alt er mottatt er en feil instruks. En kontantfaktura fra før #222 rendres ved oppslag, og ingenting lagret sier at den var kontant — dens EHF bærer fortsatt betalingsinformasjon. - Bare dokumentet utstedelsen selv skrev, er fakturaens EHF. Oppslaget krever at vedlegget har samme tidsstempel som fakturaen (begge settes av utstedelsestransaksjonen), så en XML en bruker senere legger ved samme bilag aldri kan stå i fakturaens sted. Det samme gjelder PDF-en.
- PDF og EHF skrives til objektlagringen samtidig, mens utstedelsestransaksjonen (og fakturanummertelleren) holdes — én rundtur, ikke to. Renderingen inne i transaksjonen gjør ingen nye oppslag: mva-satsene per linje og registreringsstatusen er de utstedelsen alt har slått opp.
- Fakturaer utstedt før #222 har ingen lagret EHF og rendres fortsatt fra radene ved oppslag. De får ingen etterlagret EHF: et dokument rendret i dag av dagens stamdata ville vært nettopp feilen over.
- En rettelse i rendreren (f.eks. kjøperreferansen, #221) gjelder fakturaer utstedt etter rettelsen; et utstedt dokument endres ikke, som PDF-en.
Detaljer verdt å vite:
- Deltakeridentifikator er norsk orgnr under ISO 6523 ICD 0192 —
både
EndpointID,PartyIdentificationogPartyLegalEntity/CompanyID. - Mva-satsen på hver linje er den som gjaldt på fakturadatoen (samme daterte oppslag som posteringen brukte), så dokumentet kan ikke drive fra hovedboken.
- Ett
TaxSubtotalper sats; en linje uten mva-kode blir nullsats (Z), ikke utelatt. - Kreditnota bruker
CreditNote-elementene, koden 381, og navngir fakturaen den krediterer iBillingReference. Ingen forfallsdato, ingen betalingsinformasjon. - Leveringstidspunktet (
cac:Delivery/cbc:ActualDeliveryDate, BT-72) følger med på både faktura og kreditnota — lovpålagt på salgsdokumentet uansett kanal (bokføringsforskriften §5-1-1 nr. 4, docs/faktura.md).cac:Deliveryligger mellom kjøperparten og betalingsopplysningene; UBL-sekvensen er bundet, og XSD-kjøringen i testene og CI fanger feil plassering. Fakturaer utstedt før #81 har ingen registrert leveringsdato, og da utelates elementet helt framfor å gjette. - Adressen vår er fritekst i masterdata og EHF vil ha den delt; en form vi kjenner igjen («Storgata 1, 0155 Oslo») deles, en vi ikke kjenner igjen går ut hel som gatelinje. Bedre en komplett adresse i ett felt enn en gal fordeling.
- Mangler mottakeren organisasjonsnummer, sier endepunktet fra i stedet for å sende en tom id — i Peppol er orgnr adressen.
cbc:BuyerReference(BT-10) er kjøperens egen referanse («Deres referanse», #221) fra fakturaen, ellers kundens faste referanse. Uten noen av dem går vårt kundenummer i feltet, fordi PEPPOL-EN16931-R003 krever én (docs/faktura.md).
Ærlig begrensning
Section titled “Ærlig begrensning”XSD-validering (offisiell UBL 2.1, vendored i docs/ehf/, kjørt med
xmllint i tester og CI) beviser at dokumentet er velformet UBL —
ikke at det oppfyller alle PEPPOL BIS-forretningsreglene. De er
Schematron, og kjøres av aksesspunktet ved innsending. Det vi vet er
verifisert: profil-id-ene, deltakeridentifikatorene, at beløpene
summerer, og at strukturen er skjemagyldig.
Kategoriene E (fritak) og AE (omvendt avgiftsplikt) utledes ikke automatisk — de krever en begrunnelsestekst, og å gjette den ville vært å påstå noe om avgiftsplikt vi ikke vet.
Inn: originalen lagres, forslaget regnes ut
Section titled “Inn: originalen lagres, forslaget regnes ut”En mottatt EHF lastes opp i bilagsinnboksen som ethvert annet bilag: innholdet er uforanderlig fra ankomst og hash-sjekket (docs/bilagsinnboks.md).
GET /companies/{id}/inbox/{doc}/ehf leser den lagrede originalen og
returnerer et bokføringsforslag: selger (matchet mot
leverandørreskontroen på orgnr), fakturanummer, datoer, KID,
kontonummer, netto/mva/brutto og linjene med sats.
Ingenting utledet lagres. Det gir to ting gratis: originalen er den eneste sannheten, og et forbedret forslag gjelder også for dokumenter som allerede ligger i innboksen.
Dette er den strukturerte enden av bilagstolkning (#34): når dokumentet er EHF, er leverandør og beløp ikke gjetning — de står i filen. Mennesket bokfører (eller avviser) fortsatt gjennom innboksen, med attestering når policyen er på (docs/attestering.md).
Parseren er tolerant i camt.053-stil: den leser bare det bokføringen
trenger, hopper over ukjente elementer, godtar både Invoice og
CreditNote og hvilket som helst prefiks — vi kontrollerer ikke
avsenderen. Advarsler (ukjent leverandør, netto + mva som ikke
stemmer med forfalt beløp, fremmed valuta) følger forslaget i stedet
for å stoppe det.
Endpoints
Section titled “Endpoints”GET /companies/{id}/invoices/{iid}/ehf— EHF for en utstedt faktura/kreditnotaGET /companies/{id}/inbox/{doc}/ehf— bokføringsforslag fra en mottatt EHF
Portal: EHF-knapp på fakturalinjene (Faktura), og en EHF-knapp på XML-dokumenter i innboksen som leser filen og fyller ut bokføringsskjemaet.
Tester
Section titled “Tester”regnmed-core/src/ehf.rs— profil-id-er, ICD 0192, beløp som heltall øre med punktum og valutakode, én avgiftsgruppe per sats, kreditnotaens egne elementnavn, escaping, determinisme, og XSD-validering av begge dokumenttyper.regnmed-core/src/ehf_import.rs— round-trip mot vår egen renderer (det vi skriver, kan vi lese), kreditnota gjenkjent, et fremmed dokument med ukjente elementer og uten linjesats, avvisning av noe som ikke er EHF, beløpsformater.regnmed-api/tests/grupper/ehf.rs(ekte Postgres, også CI): faktura fra databasen rendret og XSD-validert, adressen delt riktig, KID med, EHF-en lagret ved utstedelse og uendret etter at kunden flytter (#222), kreditnotaens EHF lagret, ingen EHF og ingen feil ved utstedelse til kjøper uten orgnr, en bruker-XML på bilaget som ikke serveres som EHF, kreditnota som peker tilbake; mottatt EHF i innboksen gir forslag med leverandøren matchet på orgnr, originalen står urørt, og et dokument som ikke er EHF sier fra.