Aktuellt för våra partners

2026-10-20

Från 30 april 2027 tillkommer nya valideringar och Kivra kommer att bli striktare med validering av innehåll som skickas via API:et för att ge mottagarna en bättre upplevelse och att göra utskick säkrare och mer förutsägbara. Innehåll som inte klarar valideringen kommer att avvisas. Från 1 februari 2027 kommer ni att kunna testa i sandbox. Vi inför även nya svarskoder som redan är live.

Det här ändras

• Validering mot den tekniska specifikationen. Innehåll som inte följer specifikationen avvisas. Det gäller även fält som inte finns med i specifikationen.
• Nya valideringar. Bland annat ska PDF-filer vara giltiga, MIME-typen ska stämma och varje inskick får bara ha en mottagaridentifierare. Alla nya valideringar finns nedan.
• Tydligare felsvar vid inskick. När ett inskick avvisas visar svaret vilka fält som är fel och varför. Flera felkoder samlas samtidigt under en gemensam error kod. Se felsvar och felkod.

Vad behöver ni göra?

• Kontrollera att era inskick följer specifikationen
• Anpassa era inskick efter de nya valideringarna
• Uppdatera intern logik som bygger på de nuvarande svarskoderna
• Testa i sandbox från 1 februari 2027

Det här valideras för alla typningar

• PDF är obligatoriskt och måste vara en giltig PDF-fil. Skicka inte Word, XML eller bildfiler. Vi rekommenderar PDF/A, som är tillgänglig för fler läsare.
• Deklarerad MIME-typ måste stämma med filens faktiska typ. Om en del deklareras som PDF kontrollerar vi att filen är en riktig PDF. Annars avvisas content av säkerhetsskäl.
• subject måste finnas och får inte vara null eller en tom sträng.
• Fält som inte är fritext får inte ha inledande eller avslutande mellanslag. Exempel: "letter " accepteras inte, "letter" gör det.
• content type måste skrivas med gemener. Exempel: invoice.reminder accepteras, Invoice.Reminder avvisas.
• Content med okända metadatafält avvisas. Det är för att undvika att personuppgifter eller annan information av misstag hamnar hos oss.
• Responsivt content får inte använda någon form av script. Alla resurser inom det responsiva HTML-dokumentet, till exempel bilder eller typsnitt, behöver vara inbäddade i dokumentet.
• Endast en mottagaridentifierare per innehåll. Skicka antingen personnummer eller e-postadress.
• Skicka inte campaign_tag om content inte tillhör en kampanj.

Det här valideras för fakturor Gäller invoice, invoice.reminder, invoice.renewal, invoice.debtcollection, invoice.debtcampaign, invoice.paymentnotice och invoice.donation.

• Alla fakturatyper kräver betalningsmetadata.
• due_date ska ligga i framtiden när Kivra tar emot innehållet. Det gäller invoice, invoice.renewal och invoice.paymentnotice.

Det här valideras för utskick för någon annans räkning (behalf_of)

Skickar ni behalf_of ska vat_number vara ett giltigt svenskt momsregistreringsnummer. Det består av SE, organisationsnumret och 01, totalt 14 tecken, till exempel SE556677889901. Gäller letter.signed, invite.research, invite.gift, invite.sign, invite.voucher och invite.kyc.

Ändringar i API:t

• generated_at tas bort.
• payment_multiple_options.status godkänns inte längre.

Nytt och valfritt

• Ni kan ange betalmetod i klartext, till exempel bankgiro eller bg och plusgiro eller pg.
• Nytt valfritt fält för att undanta en enskild faktura från Autogiro, även om mottagaren har Autogiro aktiverat.

2026-10-14

Era avsändare kan nu skicka fakturor till små och medelstora företag med strukturerad data utöver PDF:en. Mottagarens ekonomisystem läser uppgifterna direkt i stället för att tolka en PDF, vilket ger färre fel och snabbare hantering. Det gäller mottagare som har kopplat Kivra Företag till sitt ekonomisystem. Fortnox är först ut, och fler system kommer.

Vad behöver ni göra? Ni behöver bygga stöd för innehållstypen accounting.invoice i vårt API för att skicka innehåll. Den fungerar som en vanlig faktura, men med mer metadata. Välj exemplet “accounting invoice to company” i listrutan i dokumentationen för att se strukturen. Lär mer här på våra developer-sidor. Kontakta vårt partnerteam om ni vill komma igång.

2025-08-27

I samband med introduktionen av nya tjänster har vi uppdaterat Tjänstebeskrivning och Särskilda Villkor med tillhörande ändringar i vår behandling av personuppgifter. I säkerhetsbilagan har vi endast gjort editoriella ändringar. Allt ovan rör både avtalspaketet för er som partner och avtalspaketet för avsändare som skickar via partners.

I avtalspaketet för er som partner har vi även uppdaterat Servicenivåavtalet för att inkludera den nya tjänsten Rekommenderade E-försändelser samt förtydligat vad som gäller vid felsökning.

Uppdaterade dokument för er som partner:

• Tjänstebeskrivning och Särskilda Villkor
• Underbilaga A Specifikation till Underbiträdesavtal
• Underbilaga B Säkerhet till Underbiträdesavtal
• Servicenivåavtal

Uppdaterade dokument för avsändare som skickar via partner:

• Tjänstebeskrivning och Särskilda Villkor
• Underbilaga A Specifikation till Personuppgiftsbiträdesavtal
• Underbilaga B Säkerhet till Personuppgiftsbiträdesavtal

Ändringarna gäller direkt.

2025-05-05

Nu kan ni som partner registrera er för webhooks genom att kontakta vår Sender Success. Med webhooks kommer ett anrop att göras när nytt innehåll kommit till en av era kunders företagsinkorgar så att ni inte längre behöver “polla” en inkorg efter nytt innehåll. Läs mer här på våra developer-sidor.

2024-11-19

Från om med den 30 april 2025 kommer Kivra stänga av version 1 av usermatch i matchningstjänsten.

Att flytta till v2 av usermatch innebär flera fördelar för er som integrerande part. Bland annat kan ni med usermatch på v2 matcha användare mot verifierad epostadress och även företag mot VAT-nummer (VAT), utöver att matcha på personnummer (SSN).

Vad behöver ni göra? Här är de två stegen för att gå från v1 till v2:

1 Ändra URL från/v1/tenant/{tenantKey}/usermatch till

• /v2/tenant/{tenantKey}/usermatch/ssn
• /v2/tenant/{tenantKey}/usermatch/verified_email
• /v2/tenant/{tenantKey}/companymatch/vatnr 2 Ändra SSNs till LIST i metadatan för både request och svar

2024-11-01

Nu är det ännu smidigare för er som partner att integrera med Kivra Företag, som används av över 175 000 företag. Med den nya integrationen kan era kunder enkelt registrera sig för Kivra Företag direkt i ert system, och integrationen aktiveras automatiskt. Era kunder kan sedan läsa och hantera all sin företagspost – myndighetsbrev och andra viktiga dokument – direkt i ert system. Det sparar både tid och krångel!

Vill ni veta mer om hur ni integrerar ert system med Kivra Företag och möjligheterna med en skräddarsydd onboarding-process för företagsbrevlådor? Kontakta adrian.fickler(at)kivra.com!

2024-03-05

Vi har förenklat ytterligare för dig som partner. Från och med nu kan du använda vår usermatch-funktionalitet även för företag och organisationer dvs när det matchas med VAT-nummer.

Läs detaljer här

2023-11-28

Vi vill uppmärksamma er på att Kivra kommer införa 3 viktiga förändringar i sender API, enligt nedan.

1. 31a maj 2024 kommer vi stänga v1/tenant/TENANT_ID/content och ber alla som är integrerade mot Kivras API att istället använda v2/tenant/TENANT_ID/content
2. I och med övergången till v2 blir attributen type and subject obligatoriska i metadatastrukturen för v2/tenant/TENANT ID/content
3. Vi tar bort [payment] metadatastrukturen. Dess funktionalitet kommer att ersättas med den redan existerande [payment_multiple_options] metadatastrukturen

Exempel av betalning i v1 och v2 av content endpoint

För att säkerställa att du som partner skickar in korrekt och alltid har stöd för våra nya och kommande tjänster så rekommenderar vi att ni planerar in en övergång till Kivras Content API v2.

Vi har lanserat version 2 av vårt API. Till denna version har vi överfört följande funktioner:

• Responsive Design: Anpassa innehållet efter enheten det visas på. Med HTML öppnar vi upp för bl.a grafer, diagram, dropdown-menyer och karuseller - en tjusigare layout helt enkelt.
  
• Forms: Skapa och skicka formulär genom vårt ‘Forms’-API och samla in värdefull info från användare.
  
• Matchning på Email: Vi möjliggör nu även att matcha Kivra användare på emailadress och inte bara personnummer som tidigare.
  
• Campaigns by Tag: Möjlighet att rikta kampanjer baserat på era avsändares egna segmentering.
  Denna förändring genomfördes på grund av begränsningar i v1:s metadatastruktur. API v2 har en plattare och mer flexibel struktur, vilket gör det enklare att utveckla och förbättra våra tjänster.
  
  För närvarande har ovanstående fyra tjänster redan övergått till API v2. Övriga tjänster kommer successivt flyttas från V1 till V2.

2023-09-05

Möjligheten att lägga till en Kampanj-tag när du skickar innehåll via vårt API finns nu tillgänglig i betaversion. Avsändaren behöver aktivera ett nytt metadatafält för att möjliggöra användning av en Kampanj-tag.

Kampanjen skapas genom att lägga till en tagg i 'Campaigns'. När innehåll sänds genom Kivras content-API och en tag läggs till i det nya metadatafältet, kopplar Kivra kampanjen om det finns en matchning. Denna tag-segmentering kommer då att ersätta alla andra alternativ i 'Campaigns'.

För mer information, kontakta oss.

2021-09-07

Batchintegrationen stängs ner 31 december 2022

Kivra har tagit beslut om att stänga ner all vår batch-integration. Det innebär att det – om en tid – inte längre kommer vara möjligt att exempelvis hämta user accept-filer eller skicka in filer till oss.

Varför görs förändringen?

Vi gör förändringen för att vi tillsammans med våra partners ska kunna introducera nya tjänster och funktionalitet som kräver realtidsinteraktion. Batch-lösningen är inte optimerad för det. Däremot stödjer Kivras API-tjänst nya funktioner till fullo.

Vad innebär det för partners?

För er som partner innebär det att ni behöver se över och förändra hela eller delar av er intergrationsuppsättning och istället övergå till vår API-tjänst. Vi förstår att det innebär extra arbete för er. Därför har vi satt en väl tilltagen deadline – 31 december, 2022.

Mer om förändringen

Det finns fler skäl till att vi överger batch-lösningen. Det primära att vi ökat vår utvecklingstakt på Kivra och flera betydande funktioner har inte fullt stöd i den äldre lösningen. En stor del av vår partner- och kundbas har redan gjort skiftet och vi vill såklart att ni ska ha samma förutsättningar att ta del av hela vårt produktutbud.

Frågor och plan för migrering?

Vi kommer vara behjälpliga med stöd för tekniska frågor under övergången. Vi bistår också gärna med en plan för er att migrera från batchlösningen till API-tjänsten. Frågor om övergången besvaras av er Partneransvarige. Ni hittar kontaktuppgifter till supporten längst ner på denna sida om ni behöver hjälp med att integrera via Kivras API.

2021-08-31

Som vi meddelade för ett år sedan via kivrastatus.se och mail (https://kivrastatus.se/details/b01e178293096) bör partner och avsändare använda följande API endpoints för att kommunicera via Kivra:

• Produktionsmiljö: sender.api.kivra.com (istället för api.kivra.com).
• Sandbox-miljö: sender.sandbox-api.kivra.com (istället för sandbox.kivra.com).

Partners och avsändare som ännu inte har uppdaterat API endpoints måste ändra snarast, dock senast den 31 oktober 2021.

Vid frågor vänligen kontakta partner@kivra.com eller paolo.leva@kivra.com

För frågor om hur ni integrerar via vårt API, kontakta oss här.