API - eCoC for opprettelse av kjøretøy i Kjøretøyregisteret
API for kjøretøyimportører som skal sende inn elektroniske samsvarserklæringer (eCoC, Certificate of Conformity) for kjøretøy.
Statens vegvesen tilbyr en tjeneste gjennom et elektronisk grensesnitt (API) som gjør det mulig for kjøretøyimportører å sende inn elektroniske samsvarserklæringer (eCoC, Certificate of Conformity) for alle kjøretøygrupper.
Løsningen til Statens vegvesen håndterer alle kjøretøygrupper i samme tjeneste, men gjennom to ulike endepunkter:
- API Pre-registrering - med eCoC via EUCARIS
- API Pre-registrering - med innbakt eCoC
Hvilket endepunkt som skal benyttes, avhenger av om eCoC ligger i en europeisk database (UCARIS) eller ikke.
Hvem kan benytte tjenesten?
Tjenesten er tilgjengelig for kjøretøyimportører eller fabrikanter med norsk organisasjonsnummer som importerer eller produserer kjøretøy som skal førstegangsregistreres i Norge. Tjenesten legger til rette for at importører og deres forhandlere enkelt, raskt og sikkert skal kunne gjennomføre førstegangsregistrering, etter at kjøretøyet er opprettet i Kjøretøyregisteret.
Hvis virksomheten ikke har norsk organisasjonsnummer i Brønnøysundregistrene, må virksomheten først registreres som et norskregistrert utenlandsk foretak (NUF) for å kunne bruke Maskinporten. Maskinporten er en felles autentiseringstjeneste i Norge for maskin-til-maskin-kommunikasjon. Når virksomheten er registrert som et NUF, følger man vanlig framgangsmåte for å ta i bruk Maskinporten som konsument, som beskrevet nedenfor.
Før overgang til produksjonsmiljø må importøren inngå avtale om bruk av tjenesten med Statens vegvesen. Inntil videre inngås avtale manuelt ved å sende forespørsel til Brukerstøtte.
Når og hvordan brukes de to endepunktene?
API Pre-registrering - med eCoC via EUCARIS
Tjenesten forutsetter at fabrikanten av kjøretøyet har en løsning for å laste eCoC opp til en europeisk eCoC-database (EUCARIS). Regelverket gjelder i hovedsak for kjøretøygruppene M, N og O, men andre kjøretøygrupper kan også benytte samme løsning dersom fabrikanten laster eCoC opp til en europeisk eCoC-database.
Importør sender inn melding om pre-registrering av kjøretøyet. Meldingen skal inneholde VIN-nummer. Dersom avgiftsklassifiseringen er 315 må avgiftsklassifiseringen og totalt antall sitteplasser også sendes med.
Statens vegvesen henter eCoC for det aktuelle kjøretøyet gjennom Eucaris. Innsender får tilbakemelding fra tjenesten om kjøretøyet er opprettet, om eCoC ikke er funnet eller om andre feil har oppstått.
Ved behov for å trekke tilbake en tidligere innsendt pre-registrering, før førstegangsregistrering av kjøretøyet er gjennomført, kan man benytte en egen tjeneste for sletting av pre-registrering.
API Pre-registrering - med innbakt eCoC
Importør sender inn melding om pre-registrering av kjøretøy med innbakt eCoC i XML-format, som definert av IVI-formatet (Initial Vehicle Information). Tjenesten gir innsender tilbakemelding på om kjøretøyet er opprettet i Kjøretøyregisteret, eller en feilmelding dersom påkrevde felter mangler informasjon. Den vil også gi advarsler for felter der vi ønsker mer informasjon.
Ved behov for å trekke tilbake en tidligere innsendt pre-registrering, før førstegangsregistrering av kjøretøyet er gjennomført, kan innsender benytte en egen tjeneste for sletting av pre-registrering.
Hvordan ta i bruk tjenestene?
Importør eller fabrikant må selv utvikle funksjonalitet for å ta i bruk API-ene, eller benytte en tredjepart som har en tjeneste man kan knytte seg til som importør.
Det er den norske importøren eller fabrikanten som er ansvarlig for at innsendte data er korrekte. Feil kjøretøydata eller feil avgiftskoder kan gi feilaktige registreringer og feilberegnede avgifter.
Tilgangsstyring
For å ta i bruk API-ene må innsender autentisere seg via Maskinporten.
For an English guide go to Maskinporten (eng).
Rettigheter (scopes) settes i Maskinporten av Statens vegvesen.
| Scope | Beskrivelse |
|---|---|
| svv:kjoretoy/ecoc | Scopet gir en virksomhet (konsument) tilgang til å melde inn eCoC |
| svv:kjoretoy/ecoc.delegert | Scopet gir en virksomhet (leverandør) tilgang til å melde inn eCoC på vegne av annen |
En importør eller fabrikant som selv benytter API-ene direkte vil ha rollen som konsument. Se hvordan du tar i bruk Maskinporten som konsument.
Hvis en importør eller fabrikant benytter en tredjepart for å benytte API-ene, vil denne tredjeparten ha rollen som leverandør. Se hvordan du tar i bruk Maskinporten som leverandør.
Hvis du som virksomhet ønsker å gi leverandør tilgang til å benytte API-ene på vegne av din virksomhet, må du opprette avtale om bruk. Se Altinn sin dokumentasjon om å delegere API-tilganger til leverandør,
Tredjeparts leverandører
Det er flere leverandører som har utviklet/utvikler løsninger for å melde inn eCoC på vegne av importører. Det forutsettes at dataene som sendes inn er avgitt av fabrikanten.
| Leverandør | Kontaktperson | E-post |
|---|---|---|
| KPMG Law Advokatfirma AS | Stine Sophie Johnsen |
stine.johnsen@kpmg.no |
| Autosys.no | Kristian Gullhav | kgu@computerservice.no |
| Ecoc.no | Richard W. Naas | richard@ecoc.no |
| AutoNet AS | Zaen Khilji | zk@autonet.no |