Syftet med informationen här är att ge överblick och grundläggande kunskap om vad det innebär att ansluta verksamhetens it-system till Naturvårdsverkets API och hur det går till. Notera att avtal och testmiljöer finns tillgängligt först när lagstiftningen är beslutad.
PÅ DEN HÄR SIDAN:
Att lämna uppgifter via API
En verksamhet kommer kunna lämna uppgifter till Naturvårdsverkets avfallsregister med hjälp av API. API är en webbtjänst som möjliggör att två olika system kan utbyta information med varandra.
Så här sker informationsutbytet:
- Det avsändande systemet anropar avfallsregistrets API genom att skicka uppgifterna i anteckningen om avfallet.
- Avfallsregistrets API kontrollerar att uppgifterna är korrekta, accepterar och returnerar ett OK-svar tillbaka tillsammans med ett avfalls-id.
- Om uppgifterna i anteckningen inte kan tas emot returnerar avfallsregistrets API ett felmeddelande.
Avfalls-id är ett slags löpnummer som systemen kan använda för att ”länka ihop” en och samma avfallsmängd i efterföljande anteckningar. I det egna stödsystemet är denna uppgift frivillig att använda.
Checklista inför anslutning till avfallsregistrets API
Vem kan ansluta?
Verksamhetsutövare som är anteckningsskyldiga enligt avfallsförordningen ska lämna uppgifter digitalt till avfallsregistret.
1. Införskaffa klientcertifikat
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. För att kunna ansluta till tjänsten behövs ett klientcertifkat.
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 det ett fysiskt besök på hos leverantörerna för att verifiera sin identitet.
2. Anslut er organisation till en digital brevlåda
API-nycklar skickas digitalt, via Mina meddelanden, eller rekommenderat brev. Naturvårdsverket rekommenderar att man ansluter sin organisation till en digital brevlåda för att ta emot API-nycklar via Mina meddelanden. Det går bra att ansluta sig till valfri digital brevlåda.
3. Ingå avtal avseende anslutning till avfallsregistrets API
För att kunna ansluta till avfallsregistrets API måste verksamhetsutövaren ingå avtal med Naturvårdsverket. Avtalsmallen ska fyllas i, skrivas ut i två exemplar, undertecknas av behörig firmatecknare och skannas för att sedan mailas kundtjanst@naturvardsverket.se. Det går också bra att returnera via post.
4. Påbörja utveckling utifrån teknisk dokumentation
API för anteckning är ett publikt REST-baserat API som Naturvårdsverket erbjuder för att kunna lämna uppgifter direkt till avfallsregistret. För att utveckla organisationens integration gentemot avfallsregistrets API, utgå från den tekniska dokumentation som finns publicerad, vilket omfattar bl.a. informationsmodeller, användningsfall och teknisk guide.
5. Avtalets ingående och godkänd anslutning
Naturvårdsverket genomför ett tekniskt test av anslutningen och godkänner efter undertecknande av avtalet anslutningen till API:et. I samband med att Naturvårdsverket returnerar avtalet, skickas även API-nyckel för testmiljö via Mina meddelanden eller i rekommenderat brev.
6. Genomför tester gentemot AT-miljö
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, skickas API-nyckel för produktionsmiljö via Mina meddelanden eller rekommenderat brev.
7. Anslut till produktionsmiljö
Efter en genomförd anslutning till produktionsmiljö meddelar anslutande aktör detta till Naturvårdsverkets tekniska förvaltning, varpå ärendet kan avslutas.
Vad kan mitt företag förbereda redan nu?
- Anslut din organisation till en digital brevlåda så att ni kan ta emot API-nycklar via Mina Meddelanden.
- Skaffa klientcertifikat.
- Ta reda på CFAR-nummer för dina resp. verksamheter/arbetsställen.
Information till tredjepartsutvecklare
Dessa avtal avser anslutning till den digitala lösningens produktionsmiljö, vilken endast är för de verksamhetsutövare som enligt sjätte kapitlet i avfallsförordningen är skyldiga att lämna uppgifter digitalt till avfallsregistret. Separata avtal för tredjepartsutvecklare ska tas fram och kommer att publiceras på Naturvårdsverkets webbplats.
Mer information kommer
Denna vägledning uppdateras så fort det finns ny information. Innan bestämmelserna är framtagna och beslutade ska alla uppgifter betraktas som preliminära.
Information om testmiljöer kommer att publiceras inom kort.
Kontakt
Har du frågor kontakta vår kundtjänst.