Send brev fra ditt eget system

telkit sender brevet til Digipost. Har mottakeren en postkasse der, havner brevet i den. Har mottakeren ingen postkasse, skriver Digipost det ut og sender det i posten til adressen du oppga.

Du trenger altså ikke vite på forhånd hvem som har Digipost. Adressen må likevel alltid være med, fordi den brukes når brevet blir papir.

Digitalt

Brevet havner i mottakerens Digipost. Pris: 5 kr.

Papir

Brevet skrives ut og sendes i posten. Pris: 19 kr med opptil 2 ark, og 1,50 kr per ark utover det.

Farge

Utskrift i farger koster 1,50 kr per ark.

Når du sender, holder telkit av papirprisen. Blir brevet levert digitalt, betaler du den digitale prisen, og resten frigjøres.

Kravene kommer fra Digipost, som skriver ut papirbrevene. Digipost oppgir dette:

Filtype

PDF, versjon 1.7 eller lavere

Format

A4

Sider

Høyst 20

Kryptering

Filen kan ikke være passordbeskyttet

Marg

15 mm. Digipost legger en QR-kode i margen ved utskrift: venstre marg på stående sider, nedre marg på liggende.

Skrift

En standardskrift, eller en skrift som er bygget inn i PDF-en. Ellers byttes den ut.

Digipost skriver ut på begge sider av arket i 300 dpi, og legger til en forside med mottaker og returadresse. Baksiden av forsiden er blank. Brevet sendes i en vinduskonvolutt.

telkit sjekker PDF-en før sending og avviser den med koden letter_pdf_invalid hvis den ikke kan leses, er passordbeskyttet, er tom, ikke er A4, har skrift som verken er innebygd eller standard, eller er større enn 8 MB. Et papirbrev kan ha høyst 10 ark, forsiden medregnet.

curl https://api.telkit.no/v1/letters \
  -H "Authorization: Bearer $TELKIT_API_KEY" \
  -H "Idempotency-Key: faktura-2026-1043" \
  -H "Content-Type: application/json" \
  -d '{
  "profileId": "<profilens id>",
  "recipient": {
    "name": "Kari Nordmann",
    "lines": [
      "Storgata 1"
    ],
    "postalCode": "0155",
    "city": "Oslo"
  },
  "subject": "Faktura 1043",
  "content": {
    "kind": "pdf",
    "pdfBase64": "JVBERi0xLjcK…"
  }
}'

profileId

Profilen som sender. Den må ha et godkjent brevhode.

recipient

Navn, én eller to adresselinjer, postnummer på fire sifre og poststed. Brev sendes til norske adresser.

subject

Tittelen mottakeren ser i Digipost.

content

Nøyaktig én av: pdf (PDF-en som base64), upload (en fil du har lastet opp), template (en mal med verdier) eller text (ren tekst som settes under brevhodet).

colour

Skriv ut i farger. Gjelder bare papir.

Som for SMS må forespørselen ha en Idempotency-Key, slik at et brev aldri sendes to ganger når du prøver igjen etter et brudd i nettverket.

Vil du se prisen først, sender du det samme innholdet til POST /v1/letters/quote. Svaret gir antall sider og ark, den digitale prisen og papirprisen.

1. Verifisert bedrift. Brev kan bare sendes når bedriften er verifisert.
2. Et brevhode per profil. Avsendernavn, returadresse og eventuelt logo. telkit godkjenner brevhodet før det brukes.
3. Brev slått på for profilen.

Brevet får en status som endrer seg underveis: i kø, sendt til Digipost, til utskrift, levert digitalt, postlagt eller feilet. telkit gir endringene videre som hendelsen letter.status på webhooken din, og du kan lese brevet med GET /v1/letters/{id}.

Digipost sender ikke statusen til telkit av seg selv. telkit henter den med jevne mellomrom, så en statusendring kan komme litt etter at den skjedde.

Digipost oppgir at papirbrev som kommer inn før klokka 02.30, normalt sendes neste virkedag. Hvor lang tid posten bruker etter det, avgjøres av posten.