Ett certifikat är en e-legitimation som används för säker anslutning mellan två system och bland annat medger krypterad datatrafik, som förhindrar att informationen påverkas eller avlyssnas när den skickas mellan system. För att kunna ansluta ett verksamhetsstödsystem till tjänsten behövs ett klientcertifikat. Som regel behöver verksamhetsutövare ha ett klientcertifikat, förutom när man köper verksamhetsstödsystemet som en tjänst från en tjänsteleverantör.

Kostnad för klientcertifikat och hur lång tid det tar att få det varierar mellan certifikatutfärdarna. Normalt kan det ta ett par veckor att få sitt certifikat på plats, och ibland kan det krävas ett fysiskt besök hos leverantörerna för att verifiera sin identitet.

Läs mer under avsnittet Certifikat krävs för att identifiera anslutande system.

Inloggningsuppgifter och åtkomstnycklar skickas via Mina meddelanden eller krypterad e-post. Naturvårdsverket rekommenderar att man ansluter sin organisation till en digital brevlåda för att ta emot åtkomstnycklar via Mina meddelanden. Det går bra att ansluta sig till valfri digital brevlåda.

Digital post för dig som företag (DIGG)

Min myndighetspost

För att kunna genomföra tekniska tester av en integration gentemot avfallsregistret krävs åtkomst till testmiljön. Anslutande part skickar in en begäran om åtkomst för testanslutning tillsammans med ett klientcertifikat (utställt på samma organisationsnummer som begäran avser). Naturvårdsverket returnerar inloggningsuppgifter och åtkomstnyckel till testmiljön via Mina meddelanden eller krypterad e-post.

Tillsammans med teknisk personal hos Naturvårdsverket verifierar anslutande aktör att man har åtkomst till testmiljö, samt genomför givna testfall. Efter godkända resultat har mottagits av Naturvårdsverkets tekniska förvaltning är systemet nu godkänt för teknisk anslutning till avfallsregistrets produktionsmiljö.

Läs mer under avsnittet Checklista för test av integration.

För att lämna uppgifter till avfallsregistret via API måste verksamhetsutövaren och/eller tjänsteleverantören ingå avtal för produktionsanslutning med Naturvårdsverket. Avtalsmallen ska fyllas i, skrivas ut i ett exemplar, undertecknas av behörig firmatecknare och skannas för att sedan mailas kundtjanst@naturvardsverket.se. Det går också bra att skicka in via post.

Läs mer under avsnittet Avtal och certifikat för avfallsregistret.

kundtjanst@naturvardsverket.se

I samband med retur av avtal för produktionsanslutning får verksamhetsutövaren och/eller tjänsteleverantören inloggningsuppgifter och åtkomstnyckel till produktionsmiljö via Mina meddelanden eller kypterad e-post. Efter en genomförd anslutning till produktionsmiljö meddelar anslutande aktör detta till Naturvårdsverkets tekniska förvaltning, varpå ärendet kan avslutas.

Den aktör som utvecklar en integration mot avfallsregistrets API måste genomföra tester mot testmiljön innan systemet kan godkännas för produktionsanslutning. För att kunna genomföra dessa tester behövs åtkomst till testmiljön. 

1. Fyll i mall ”Begäran om anslutning till API för testmiljö” 
2. Maila till kundtjanst@naturvardsverket.se tillsammans med följande bilaga:
   a. Klientcertifikat utställt på samma organisationsnummer som begäran avser. 

Begäran om anslutning till API för testmiljö v. 2.0 (pdf 103 kb)

Användarvillkor API för testmiljö – Bastjänst Farligt Avfall

När ett system är godkänt för anslutning till produktionsmiljön måste också ett avtal om produktionsanslutning upprättas med Naturvårdsverket för att möjliggöra uppgiftslämnande till avfallsregistret. 

Verksamhetsutövare som avser ansluta till avfallsregistrets API för produktionsmiljö ska upprätta avtal med Naturvårdsverket enligt följande:

1. Fyll i avtalsmallen.
2. Skriv ut i ett exemplar.
3. Avtalet undertecknas av behörig firmatecknare.
4. Skanna avtalet och maila till kundtjanst@naturvardsverket.seeller via post till Naturvårdsverket, 106 48 Stockholm.
5. Skicka med följande bilagor:
   a) Registreringsbevis (ej äldre än tre månader) som styrker att undertecknande person är behörig.
   b) Ev. klientcertifikat.

Naturvårdsverket granskar avtalet och returnerar det signerat med e-post till den kontaktperson som anges på avtalet. Då både avtal och klientcertifikat är godkända skickas inloggningsuppgifter och åtkomstnyckel till produktionsmiljö via Mina meddelanden eller krypterad e-post (se Checklista för anslutning).

Notera att som tumregel krävs ett avtal och klientcertifikat per juridisk person. Moderbolag kan dock agera som tjänsteleverantör för sina dotterbolag. Ta kontakt med kundtjanst@naturvardsverket.se för att få veta mer. 

Om viss information som lämnats av verksamhetsutövaren i avtalet i efterhand ändras, som exempelvis att en verksamhet efter en viss tid byter kontaktperson, är det viktigt att verksamhetsutövaren kontaktar Naturvårdsverket med uppdaterad information.

Avtal om produktionsanslutning – BTFA och API för anteckning v. 3.0 (pdf 188 kB)

Allmänna villkor för anslutning till BTFA via API för anteckning

Bilaga A – Teknisk beskrivning av Naturvårdsverkets Bastjänst Farligt Avfall och API för anteckning v. 1.3 (pdf 325 kB)

Beställ registreringsbevis (Bolagsverket)

Både offentliga och privata verksamheter kan ansluta sina verksamhetssystem till Naturvårdsverkets API:er för att lämna in information. För att det ska ske på ett säkert sätt används så kallade klient- och servercertifikat.

Ett certifikat fungerar som en e-legitimation mellan system och är en förutsättning för krypterad trafik, som förhindrar att informationen påverkas eller avlyssnas när den skickas mellan system. Med ett server-certifikat, som Naturvårdsverket har, kan anslutande part också vara säker på att anropet skickas till rätt tjänst och att det returnerade svaret är pålitligt. Ett klient-certifikat gör att Naturvårdsverket som erbjuder API-tjänsten kan vara säker på att information skickas från en betrodd part, vilket regleras genom avtal och kvalificeras genom tester.

Notera att det är det anslutande systemet som behöver kunna identifieras med hjälp av klientcertifikatet, inte den anslutande aktören. Se avsnittet Det här gäller för olika aktörer. Respektive anslutande organisation identifieras genom den tilldelade Inloggningsuppgifter och åtkomstnyckeln.

Tabellen nedan beskriver respektive metod i API:et och motsvarande paragraf i avfallsförordningens (2020:614) sjätte kapitel.

• Konfigurera er miljö att använda certifikatet i anropen och genomför de tester i testmiljön.
• Utför egenkontroll genom att använda er av de två GET-anropen som finns beskrivna under ”Beskrivning av metoder och resurser” och i Swagger UI.
• När ni är klara fyller ni i Onboarding-verifiering-mallen med minst en anteckning av varje metod, antecknings- och transaktionstyp ni kommer använda.
• När vi verifierat era anteckningar så meddelar vi er och om allt är godkänt så kan ni skicka in ett avtal om produktionsanslutning för att få åtkomst till produktionsmiljön.

Testfallsöversikt v 1.0 (2020-11-02) (pdf 145 kB)

Onboarding-verifiering-mall (2021-06-16) (xlsx, 19 kB)

{
    "Title": "InputValidationException",
    "StatusCode": 400,
    "Message": "Ett eller flera valideringsfel har inträffat.",
    "TraceId": "80010652-0001-fc00-b63f-84710c7967bb",
    "Errors": [
        {
            "Message": "Ogiltig JSON payload",
            "Code": 10000
        }
    ]
}

• Nånting är fel med din Requestbody, det kanske saknas ett kommatecken eller nåt fält kanske innehåller bokstäver när det bara får vara siffror. Många verktyg, ex Postman eller Notepad++ visar med rött vad som är fel med requestbodyn.

<ams:fault xmlns:ams="http://wso2.org/apimanager/security">
    <ams:code>900901</ams:code>
    <ams:message>Invalid Credentials</ams:message>
    <ams:description>Access failure for API: /btfa/anteckning/v1, version: v1 status: (900901) - Invalid Credentials. Make sure you have provided the correct security credentials</ams:description>
</ams:fault>

• Dubbelkolla om du angivit rätt Token.

<head>
<title>502 Bad Gateway</title> 
</head> 
<body> 
  <center> 
   <h1>502 Bad Gateway</h1> 
  </center> 
   <hr> 
   <center>Microsoft-Azure-Application-Gateway/v2</center> 
</body>

• Ditt certifikat har troligtvis gått ut. Dubbelkolla certifikatets giltighetstid och om det behöver förnyas.

Enligt bilaga 1 och 2 till avfallsförordningen anges behandlingsmetod enligt så kallade R- och D-koder. För statistikändamål innehåller dock dessa koder inte tillräcklig information för att kunna klassificera avfallsbehandling i enlighet med de krav som finns. Varje R- eller D-kod behöver en underkategori där man väljer den mest lämpliga behandlingstypen för varje avfallsslag.

Till varje R- eller D-kod finns en till åtta underkoder med bokstavsbeteckning A-O, se tabell 2. Hur underkoder relaterar till resp. R- och D-kod finns beskrivet i tabell 3.

Tabell 6 finns som pdf:

Uppgift om resultatet av behandling av oljor (pdf 265 kB)

Nej, ingen måste ansluta sig, utan alla ska kunna använda registrets e-tjänst. Däremot finns möjligheten att ansluta sitt verksamhetssystem till registret via en API- lösning. En API-lösning skulle kunna innebära att verksamheten enbart behöver lämna uppgifterna en gång i sitt eget system.

Avtal krävs endast om man ska ansluta till API:et.

Med API-lösningen ansluter verksamheten sitt eget verksamhetstödssystem till avfallsregistret genom en så kallad onboarding-process. Ert verksamhetstödssystem kommer sannolikt att behöva anpassas innan det är möjligt att koppla ihop systemen.

I korta drag sker följande steg:

1. Först behöver organisationen ansöka om att få tillgång till ett API.
2. Därefter kommer Naturvårdsverket att pröva om organisationen uppfyller juridiska och tekniska villkor för att koppla upp sitt verksamhetsstödsystem via API-lösningen.
3. Uppfyller organisationen juridiska och tekniska krav ingår Naturvårdsverket avtal med organisationen om API-användning.
4. Därefter behöver organisationen sannolikt utveckla en integration som genom testning visar att korrekt data skickas.
5. Till sist behöver organisationen få ett så kallat “klient-certifikat”. Genom certifikatet kan organisationens server kommunicera med Naturvårdsverkets server på ett säkert sätt.

Mer information finns att läsa i guiden.

Se avsnittet Teknisk guide för API

Varje enskild juridisk person tecknar avtal enligt den firmateckningsrätt som varje bolag har enligt sin bolagsordning (och som finns antecknad i bolagsregistret).

Detta innebär att en koncernmoder inte per automatik kan teckna firma (ingå avtal) för ett dotterbolags räkning.

Verksamhetsutövare som är anteckningsskyldiga enligt avfallsförordningen ska lämna uppgifter digitalt till avfallsregistret, och har möjlighet att ansluta till API:et. Även ombud kan lämna uppgifter via API.

Det går inte att blockera att uppgifter lämnas från till exempel vissa organisationsnummer i e-tjänsten.

För att ansluta till API:et krävs att man har ett så kallat klientcertifikat för att identifiera sin organisation. E-legitimation krävs endast för att logga in till e-tjänsten.

Du som verksamhetsutövare har inte tillgång till de uppgifter som lämnats till avfallsregistret. Uppgifter som rapporteras in bör därför göras tillgängliga för er på annat sätt, till exempel genom att de sparas i ert ombuds IT-system.

Ja, så länge du har ditt avfalls-id kan du ersätta tidigare inlämnade uppgifter, antingen via e-tjänst eller API.

I princip fungerar API:et med alla typer av system, förutsatt att systemet innehåller den information som behövs och att det går att utveckla en integration. Ett anropande system kan till exempel vara ett ordersystem.

När ni anropar avfallsregistrets API för att lämna uppgifter får ni ett svar som bekräftar att uppgifterna har tagits emot, samt returnerar ett avfalls-id. Om uppgifterna ej har tagits emot returneras ett felmeddelande.

Detta skiljer sig mot e-tjänsten där man får en bekräftelse via en pdf som går att ladda ner.

Naturvårdsverket tar inte ut någon avgift för att ansluta till API:et eller för att handlägga avtal.

Det är kostnadsfritt att ansluta till API:et, men kostnaden för respektive organisation att anpassa sina system är svår för Naturvårdsverket att uppskatta då det skiljer sig mycket åt.

Det krävs ett avtal per organisation som ansluter till API:et.

Det finns ingen koppling mellan CFAR-nummer och auktorisering i API:et. CFAR-nummer är en uppgift som ska lämnas i samband med att avfall uppkommer, det vill säga för respektive avfallsproducent.

Om man lämnar in uppgifter via API får man en bekräftelse som bland annat innehåller avfalls-id. Det är upp till mottagande system att lagra dessa uppgifter och eventuellt skapa en pdf. Naturvårdsverket sammanställer ingen pdf för uppgifter inlämnade via API.

I dagsläget finns det inga avtal som endast avser anslutning till testmiljö. Naturvårdsverket arbetar med att ta fram dessa, för att möjliggöra för systemleverantörer att testa sina integrationer. Det går dock bra att bedriva utvecklingsarbete utifrån den tekniska guide som finns tillgänglig på webben.

Det finns en checklista för vad som behöver finnas på plats för att ansluta till API:et. Om man inte kan bedriva utveckling själv, kan det vara bra att till exempel prata med sin systemleverantör eller andra aktörer som utvecklar it-system.

Avfallsregistret via API

API-nyckeln är giltig i ett år och ska sedan förnyas. Information kring förnyelseprocess skickas ut i samband att ni får er API-nyckel.

API-nyckeln är inte personlig utan ställs ut per organisation.

I dagsläget finns kodtabellerna inte på fil, men går lätt att kopiera från hemsidan. Avfallskoderna återfinns i avfallsförordningens bilaga 3.

Klientcertifikatet ska ligga på företagets server, så flera datorer kan använda samma certifikat.

Det kan se lite olika ut, men en tumregel är att om verksamhetsutövaren köper affärssystemet som en tjänst är det systemleverantörens ansvar. Om verksamhetsutövaren däremot köper tjänsteutveckling för att ta fram ett eget system, så är det verksamhetsutövarens ansvar att skaffa ett klientcertifikat.

För produktionsmiljö krävs klientcertifikat av typen Qualified Certificate for Website Authentication (QWAC) för att sätta upp en integration mot API:et. Naturvårdsverket arbetar med att ta fram en lösning för att ansluta till testmiljön med tillfälligt certifikat.

För att sätta upp en integration mot API:et i produktionsmiljö krävs ett klientcertifikat av typen Qualified Certificate for Website Authentication (QWAC). Notera att man kan bedriva utveckling och komma ganska långt utan att koppla upp sig mot test-API. All information som behövs för att utveckla finns i teknisk guide. Naturvårdsverket arbetar med att ta fram en lösning för att ansluta till testmiljön med tillfälligt certifikat.

Teknisk guide för API

Ja.

Ja, man kan skicka å, ä, ö i alla textfält, till exempel i adress eller organisationsnamn.

För produktionsmiljö krävs klientcertifikat av typen Qualified Certificate for Website Authentication (QWAC) för att sätta upp en integration mot API:et. Naturvårdsverket arbetar med att ta fram en lösning för att ansluta till testmiljön med tillfälligt certifikat.

Företagets namn och organisationsnummer samt kontaktuppgifter ska stämma med avtalet. Vad gäller extensions gäller client authentication (ej PSD2).

REST (Representational State Transfer) beskriver hur tjänster för maskin-till-maskin-kommunikation sätts upp. JSON (JavaScript Object Notation) är ett kompakt, textbaserat format som används för att utbyta data.