Signering i praksis

Signering sender et PDF-dokument til én eller flere parter og gir deg det tilbake signert, med innebygd bevis. Denne guiden dekker valgene du må ta.

Velg nivå

Alle nivåer gir juridisk bindende signatur etter eIDAS. Forskjellen er bevisstyrken: med eid får du verifisert navn og fødselsdato fra eID-leverandøren, lagret i signaturbeviset.

Du kan kombinere: nivaa kan settes per part, slik at utleier (et selskap) signerer med eid mens vitnet signerer enkel.

Opprett jobben

jobb = spire.signeringer.opprett(
    tittel="Leieavtale Strandgaten 18",
    dokument=open("leieavtale.pdf", "rb"),
    nivaa="eid",
    parter=[
        {"navn": "Ingrid Åsheim", "epost": "ingrid@example.no", "mobil": "+4791234567", "rolle": "leietaker"},
        {"navn": "Petter Lunde", "epost": "petter@example.no", "rolle": "utleier", "rekkefolge": 2},
    ],
    frist="2026-11-17",
    paaminnelser=[1, 3, 7],
    lagring_dager=365,
)

Dokumentet kan sendes som multipart eller som dokument_url (vi henter det én gang). Maks 25 MB, PDF 1.4 til 2.0, ikke kryptert.

Rekkefølge. Uten rekkefolge signerer alle parallelt. Med rekkefolge får part 2 beskjed først når part 1 har signert. Flere parter kan ha samme rekkefølgetall.

Låsing til identitet. Med fodselsnummer_hash (SHA-256 av fødselsnummeret) på en part, godtas bare en eID-signatur fra den personen. Fødselsnummeret sendes aldri til Spire i klartekst.

To måter å vise flyten

Sendt av Spire. Standard. Hver part får e-post (og SMS hvis mobil er satt) med en lenke til signer.spireapi.com, eller ditt eget domene på Skala. Påminnelser sendes automatisk.

Innebygd. Sett innebygd: true, og du får en lenke per part som du viser i en iframe i din egen app. Ingen e-post sendes. Du styrer når og hvor parten ser dokumentet.

<iframe src="https://signer.spireapi.com/s/8f3k2…?innebygd=1" allow="camera"></iframe>

Iframen sender postMessage med { spire: 'signert' | 'avvist' | 'lukket' } når parten er ferdig, så du kan lukke den og gå videre. Lenkene er gyldige i 1 time og kan fornyes med POST /v1/signeringer/{id}/parter/{part_id}/lenke.

Følg med

Webhooks forteller deg alt:

Ved signering.fullfort, last ned dokumentet og arkiver det hos deg:

pdf = spire.signeringer.dokument(jobb.id)  # bytes

Dokumentet er PAdES med lang tids validering. Signaturene kan verifiseres i Adobe Reader og andre PDF-lesere uten at Spire finnes. Signaturbeviset (hvem, når, hvordan, fra hvilken IP) ligger både i PDF-en og i GET /v1/signeringer/{id}.

Utfylling før signering

Har PDF-en skjemafelt, kan partene fylle dem ut før de signerer. Angi hvilke felt hver part skal fylle:

"parter": [
  { "navn": "Ingrid Åsheim", "epost": "…", "felt": ["kontonummer", "innflyttingsdato"] }
]

Feltverdiene kommer tilbake i data.parter[].feltverdier på signering.part_signert. Feltene låses når dokumentet signeres.

Lagring og sletting

lagring_dager styrer hvor lenge vi beholder dokumentet etter fullføring: 0 (slettes så snart du har lastet det ned via webhook), 30 (standard) eller opptil 3650. Lagring over 30 dager koster 0,10 kr per dokument per måned. Slett tidligere med DELETE /v1/signeringer/{id}/dokument.

Signaturbeviset (uten dokumentet) beholdes i 10 år uansett, fordi det kan trengs ved tvist.

Vanlige feil

• ingen_tilgang på nivaa: "eid": Start-planen har bare enkel. Oppgrader til Vekst.
• ugyldig_parameter på dokumentet: PDF-en er kryptert, har JavaScript, eller er over 25 MB. Flat den ut først.
• Parten finner ikke e-posten: sjekk signering.aapnet. Mangler den, send påminnelse med POST /v1/signeringer/{id}/paaminn eller bytt til mobil.