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.
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. Naturvårdsverket arbetar för att ge även tjänsteleverantörer och mjukvaruleverantörer möjlighet att ansluta till avfallsregistrets API.
Införskaffa klientcertifikat
Ett certifikat fungerar ä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 verksamhetssystem till tjänsten behövs ett klientcertifikat. Som regel behöver verksamhetsutövare ha ett klientcertifikat, förutom när man köper verksamhetssystemet 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 det ett fysiskt besök på hos leverantörerna för att verifiera sin identitet.
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.
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 ett 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.
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.
Avtalets ingående och godkänd anslutning
Naturvårdsverket genomför ett tekniskt test av anslutningen (inkl. kontroll av ev. klientcertifikat) 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.
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.
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 eventuellt klientcertifikat.
- Ta reda på CFAR-nummer för dina resp. verksamheter/arbetsställen.
Information till systemutvecklare
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 tjänste- och mjukvaruutvecklare ska tas fram och kommer att publiceras på Naturvårdsverkets webbplats
Mer information kommer
Denna vägledning uppdateras så fort det finns ny information.
Kontakt
Har du frågor kontakta vår kundtjänst.