La systemet snakke faktura, ikke EHF
Bruk de norske fakturabegrepene produktet allerede kjenner. FakturaAPI tar ansvaret fra fakturadata til validert og levert EHF.
Hva EHF betyr
EHF står for Elektronisk handelsformat. En EHF-faktura er en strukturert elektronisk faktura, ikke en PDF. Mottakersystemet leser feltene direkte, så organisasjonsidentitet, referanser, linjer, MVA og summer må være konsistente.
Datamodellen deres trenger ikke UBL-elementer eller Peppol-identifikatorer. Bruk de norske fakturabegrepene systemet allerede har.
Fordel ansvaret tydelig
Systemet deres bør eie kunden, fakturanummeret, tidspunktet for fakturering, bokføring og betalingsoppfølging. FakturaAPI kan kontrollere mottakeren, gjøre fakturadataene om til EHF, levere dokumentet og gi en status dere kan følge.
Da slipper dere å vedlikeholde samme kunderegister eller reskontro to steder.
Bruk samme nøkkel ved nye forsøk
Etter en nettverksfeil vet du ikke alltid om en POST ble mottatt. Bruk én fast idempotensnøkkel per faktura, og send samme innhold på nytt.
Leveringsstatus bør behandles asynkront. Lagre hendelses-ID-er hos mottakeren, og sørg for at samme webhook kan behandles flere ganger uten doble virkninger.
Send fakturadataene systemet allerede har
Kunde, organisasjonsnummer, fakturanummer, datoer, referanser, fakturalinjer, priser, MVA og KID hører hjemme i fakturamodellen. UBL-elementer, Peppol-profiler og aksesspunktstatuser gjør ikke det.