Fremlegging og kontrolldirigering

Fremlegging og kontrolldirigering består av to API-er:

  1. Fremlegging (movement-presentation-api)
  2. Kontrolldirigering (movement-routing-api)

Begge API-ene dekkes av scopet toll:movement/entry.

Tolletaten vil forsøke å automatisk detektere ankomst av transport ved grensepassering. Dersom automatisk ankomst blir detektert vil Tolletaten gjennomføre en automatisk digital fremlegging av alle forventede forsendelser på den ankommende transport.

Deretter vil Tolletaten gjøre dirigering tilgjengelig i vårt API for de forventede forsendelsene. Aktører som er koblet til de fremlagte forsendelser vil kunne hente ut kontrolldirigering på API (movement-routing-api).

De aktører som automatisk er slik koblet er den aktøren som sendte inn informasjon om forsendelsen i Tolletatens API (autentisert i Maskinporten) og eventuell tollrepresentant nevnt i melding om forsendelse, hovedforsendelse eller transport.

API-et for kontrolldirigering fungerer ved at det kontinuerlig publiseres dirigeringssignal for forsendelser som er fremlagt. Som regel vil fremleggingen skje automatisk ved ankomst av transportmiddel, men kan også bli trigget av kall til API for fremlegging (movement-presentation-api).

  • Hvert kall til API-et returnerer en liste med opptil 1000 dirigeringssignal som er tilgjengelige for den organisasjonen som har autentisert seg med Maskinporten.
  • Parameter marker brukes for å si hvilket dirigeringssignal du leste sist.
  • Aller første gang du kaller API-et skal du ikke sende med noen marker. Du vil da få en liste med de første dirigeringssignalene.
  • Hver gang du har behandlet et sett av dirigeringssignaler henter du ut verdien til feltet routingResult.id fra det siste dirigeringssignalet i listen og tar vare på dette.
    Neste gang du kaller API-et bruker du verdien du tok vare på som marker og vil da få de neste dirigeringssignalene.
  • Fortsett å gjøre dette frem til du får en tom liste. Da er det ingen flere dirigeringssignal tilgjengelig for din organisasjon.

Ta vare på den siste ID-en du leste. For å få dirigeringssignal for forsendelser på neste transport bruker du denne som marker. Da slipper du å lese gjennom alle dirigeringssignalene for den forrige transporten på nytt.

Les mer om fremlegging og kontrolldirigering her (med eksempler).

Dirigering (routing) for forsendelser

Den som har fremlagt sendingene, automatisk av Tolletaten eller ved egen fremlegging, skal bruke tjenesten for kontrolldirigering (movement-routing-api).

Basert på resultatet fra kontrolldirigering skal aktøren plukke ut sendingene som skal fysisk kontrolleres. Disse sendingene skal snarest overleveres avtalt kontrollsted. Når en aktør ber om dirigering gjennom å bruke denne tjenesten vil Tolletaten svare med én dirigering per forsendelse (House Consignment).

Dersom forsendelsen er meldt inn gjennom forhåndsvarsling (ICS2), det vil si gods fra tredjeland (utenfor EUs sikkerhetssone), vil det medfølge informasjon om ENS MRN og postsekker (receptacle) dere det er relevant. Hvis forsendelsen ikke er meldt inn gjennom forhåndsvarsling vil disse dataelementene være tomme.

Hvem kan be om dirigering?

Næringslivsaktørene som har vært involvert i innsendingen av meldinger knyttet til forsendelsen kan da be om å få en liste med dirigeringer for alle forsendelser som de er involvert part i.

  • Den som har sendt inn eller er nevnt som tollrepresentant for transport kan få dirigering for alle forsendelser meldt på transporten (fører, i praksis transportør, er juridisk ansvarlig)
  • Den som har sendt inn eller er nevnt som tollrepresentant for hovedforsendelse (master consignment) kan få dirigering for alle forsendelser meldt for hovedforsendelsen
  • Den som har sendt inn, er nevnt som tollrepresentant for, eller har fremlagt digitalt forsendelse (house consignment), kan få dirigering for forsendelsen

Hvordan får man dirigering?

Når næringslivet ber om å få dirigeringssignal for aktuelle forsendelser, skjer dette gjennom et kall til et grensesnitt (API) hos Tolletaten (Movement routing API).

Dette grensesnittet er uavhengig av transportmåte og vil gi dirigeringer for alle forsendelser som er meldt på alle transporter som har ankommet tollområdet og som er under behandling eller ferdig behandlet hos Tolletaten.

Næringslivsaktøren som skal benytte dette grensesnittet må identifisere seg via Maskinporten. Det er organisasjonsnummeret til næringslivsaktøren som bestemmer hvilke dirigeringer som gjøres tilgjengelige ved et kall.

URL-en til routing for forsendelse er:

PLAYGROUND
https://api-test.toll.no/api/movement/routing/v1/house-consignment
PROD
https://api.toll.no/api/movement/routing/v1/house-consignment

Inngangsparameter for bruk av API

Grensesnittets (API) inngangsparameter består av en markør, definert som: 

marker string($uuid)

Denne markøren bestemmer fra hvilket sted i listen (av dirigeringer som finnes for næringslivsaktøren) responsen skal begynne fra. Responsen fra grensesnittet vil da levere en liste med dirigeringer fra og med det stedet markøren viser og de som er nyere.

Grensesnittet vil vise maksimalt 1000 dirigeringer per kall. Ved flere dirigeringer må grensesnittet kalles flere ganger. Første gang man kaller API-et skal det kalles uten markør (for å begynne på begynnelsen), deretter skal alltid markør brukes.

Tjeneste for fremlegging

Tjenesten brukes for digital oppfyllelse av fremleggelsesplikten (Vareførselsloven § 2-4.Fremleggelse av varer for kontroll). Tjenesten kan benyttes felles for sendinger som er omfattet av melde- og opplysningsplikten og/eller som er forhåndsmeldt til EU i ICS2-løsningen.
Fremlegging (movement-presentation-api) kan meldes for forsendelser som er meldt inn på forhånd gjennom de to nevnte plikter, det vil si de forsendelser som er forventet fremlagt.

Fremlegging kan gjøres ved å fremlegge en hovedforsendelse, en forsendelse eller en postsekk innsendt for melde og opplysningsplikten. Dersom en postsekk eller en hovedforsendelse fremlegges, vil alle forsendelser under denne bli fremlagt. En part som fremlegger forsendelser (gjennom overnevnte API), og ikke før er koblet til forsendelsene, vil da bli koblet, og kan derfor hente ut kontrolldirigeringer for de samme forsendelsene.

For forhåndsmelding (ICS2), kan fremlegging gjøres for en hel forflytningsdeklarasjon (ENS), en postsekk eller enkeltsendinger. Dersom en postsekk eller en forflytningsdeklarasjon fremlegges, vil alle enkeltsendingene under denne bli fremlagt.



Dirigeringssignal

For en forsendelse vil det gis et dirigeringssignal: 

routing

og om eventuell videre behandling skal skje på eller etter grensepasseringssted: 

routingControlLocation

sammen med identifikator som beskrevet over.

Dirigeringssignalet (routing) vil kunne ha følgende verdier:

TO_ENTRY
Denne koden betyr at forsendelsen er gitt overgang til neste tollprosedyre. Det kan for eksempel være til fri disponering eller innlegg på tollager.
TO_CONTROL
Denne koden betyr at forsendelsen er tatt ut til fysisk kontroll av Tolletaten, og skal overleveres for kontroll så snart som mulig.
ENTRY_PENDING
Denne koden betyr at forsendelsen har mangler som er nødvendig for overgang til neste tollprosedyre.
Den ansvarlige næringslivsaktøren må straks sørge for å rette de avvik som finnes, slik at ny dirigering kan gis. Forsendelsen kan ikke gis ut til mottaker.
ENTRY_DENIED
Denne koden betyr at forsendelsen er beslaglagt av Tolletaten og ikke vil bli utlevert.

Dataelementet routingControlLocation angir hvor videre behandling av forsendelsen skal utføres. Dette elementet angir om forsendelsen må behandles på grensepasseringsstedet, eller om forsendelsen tillates å fraktes til et annet sted for behandling.

Dersom forsendelsen har dirigeringssignal som innebærer videre behandling, det vil si TO_CONTROL eller ENTRY_PENDING, vil routingControlLocation angi om denne behandlingen skal foregå på grensepasseringsstedet eller om forsendelsen kan fraktes til et annet sted (for eksempel aktørens sorteringsanlegg) for behandling.

Hvor videre behandling av forsendelsen skal utføres (routingControlLocation) vil kunne ha følgende verdier:

ON_ENTRY
Behandling av forsendelsen må foregå på grensepasseringsstedet. Dette kan være på et tollsted (på vei) eller på dertil egnet sted på en flyplass (bakketjenesteselskap), i en havn (havneagent) eller jernbaneterminal (togoperatør).
AFTER_ENTRY
Behandling av forsendelsen kan foregå på et sted etter grensepassering, typisk i aktørens lokaler. Eksempel på dette kan være aktørens sorteringsanlegg.