Digitoll - API mot Maskinporten

 

For English click here

1. 📥 Få tilgang til Samarbeidsportalen

• Gå til samarbeid.digdir.no og logg inn eller registrer ny bruker.

• For å få tilgang til produksjonsmiljøet, må en administrator i virksomheten delegere rettigheten "Selvbetjening av integrasjoner i ID-porten/Maskinporten" til deg via Altinn.

• Når du har riktig rolle, får du opp valget om produksjonsmiljø i portalen.

---

2. 🆕 Opprett en ny integrasjon

• Naviger til “Integrasjoner”  og “Integrasjoner” under Produksjon.

  

• klikk på “Ny integrasjon”.

  
  

• Velg Difi-tjeneste: Maskinporten.

• Fyll inn feltene for navn og beskrivelse.

• Legg til følgende scopes etter behov:

  • movement-road-api-v2, movement-road-query-api-v2: toll:movement/road/v2
  • movement-air-api, movement-air-query-api: toll:movement/air
  • movement/presentation, movement/routing: toll:movement/entry
  • Dokumentopplasting: toll:goodsdeclaration/document.write
    
    
• Til slutt velger Opprett, kopier IntegrasjonsID og send til support@emmasys.com

---

📚 Forklaring av relevante scopes

toll:movement/road/v2

• Gjelder API-er: movement-road-api-v2, movement-road-query-api-v2

• Beskrivelse: Brukes for innsending og henting av data knyttet til varebevegelser på vei, inkludert deklarasjoner og spørringer på eksisterende forsendelser.

toll:movement/air

• Gjelder API-er: movement-air-api, movement-air-query-api

• Beskrivelse: Benyttes for rapportering og spørring av luftbårne forsendelser. Typisk brukt av flyfraktselskaper og logistikkaktører innen lufttransport.

toll:movement/entry

• Gjelder API-er: movement/presentation, movement/routing

• Beskrivelse: Brukes for å melde inn og styre varebevegelser ved innpassering i Norge. Dekker presentasjon av varer og ruting etter ankomst.

toll:goodsdeclaration/document.write

• Gjelder API: Dokumentopplasting

• Beskrivelse: Gir tilgang til å laste opp støttedokumentasjon (som fakturaer og transportdokumenter) til tolldeklarasjoner.

 

 

English guide:

 

1. 📥 Access the Collaboration Portal

Go to samarbeid.digdir.no and log in or register a new user account.

To gain access to the production environment, an administrator in your organization must assign you the “Self-service for integrations in ID-porten/Maskinporten” role via Altinn.

Once the correct role is assigned, you’ll see the option to access the production environment in the portal.

---

2. 🆕 Create a New Integration

1. Navigate to “Integrasjoner” (Integrations) under the Production section.

    
   

2. Click “Ny integrasjon” (New Integration).

    
   

3. Choose the Difi service: Maskinporten.

    
   

4. Fill in the fields for Name and Description.

Add the following scopes as needed:

• movement-road-api-v2, movement-road-query-api-v2
  Scope: toll:movement/road/v2

• movement-air-api, movement-air-query-api
  Scope: toll:movement/air

• movement/presentation, movement/routing
  Scope: toll:movement/entry

• Document upload
  Scope: toll:goodsdeclaration/document.write

Once complete, click Create, then copy the Integration ID and send it to support@emmasys.com.

---

📚 Explanation of Relevant Scopes

toll:movement/road/v2

• Applies to APIs: movement-road-api-v2, movement-road-query-api-v2

• Description: Used for submitting and retrieving data related to road cargo movements, including declarations and queries on existing shipments.

toll:movement/air

• Applies to APIs: movement-air-api, movement-air-query-api

• Description: Used for reporting and querying air cargo shipments. Typically relevant for air freight companies and logistics providers involved in air transport.

toll:movement/entry

• Applies to APIs: movement/presentation, movement/routing

• Description: Used for notifying and managing goods movements at the point of entry into Norway. Covers goods presentation and routing after arrival.

toll:goodsdeclaration/document.write

• Applies to API: Document Upload

• Description: Grants access to upload supporting documentation (such as invoices and transport documents) for customs declarations.