Hvordan fylle ut melding om forsendelse, sjø
Grensesnittbeskrivelse
Tjenestene gjøres tilgjengelige som REST-tjenester over HTTPS, med data på JSON-format.
POST https://<env>/api/movement/maritime/v1/transport
POST https://<env>/api/movement/maritime/v1/master-consignment
POST https://<env>/api/movement/maritime/v1/house-consignment
PUT/DELETE https://<env>/api/movement/maritime/v1/transport/{MRN}
PUT/DELETE https://<env>/api/movement/maritime/v1/master-consignment/{MRN}
PUT/DELETE https://<env>/api/movement/maritime/v1/house-consignment/{MRN}
GET https://<env>/api/movement/maritime/status/v1/transport/validation-status/{requestId}
GET https://<env>/api/movement/maritime/status/v1/master-consignment/validation-status/{requestId}
GET https://<env>/api/movement/maritime/status/v1/house-consignment/validation-status/{requestId}
der
-
<env> byttes ut med
- api.toll.no for produksjon
- api-test.toll.no for playground (testmiljø)
- {requestId} byttes ut med referansen som returneres ved POST/PUT/DELETE-kall
- {MRN} byttes ut med referansen som returneres fra ".../validation-status..."-endepunktene.
Dersom du oppdager sikkerhetsutfordringer i våre løsninger ber vi deg ta kontakt; se her for info
API Tjenester
API: movement-maritime-api
For å kunne bruke tjenesten må scope for autentisering mot Maskinporten settes til toll:movement/maritime
API: movement-maritime-query-api
For å kunne bruke tjenesten må scope for autentisering mot Maskinporten settes til toll:movement/maritime
API: movement-presentation-api
API: movement-routing-api
Importprosedyre
IMMEDIATE_RELEASE_IMPORT (Overgang til fri disponering ved grensepassering)
|
Beskrivelse av tollprosedyre og prosedyre fram til grensen |
Det er på forhånd levert deklarasjon for overgang til fri disponering. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik) |
|
| Felt | Kodeverk | Variant 1 |
|---|---|---|
|
importProcedure |
må fylles ut |
|
|
importProcedure |
IMMEDIATE_RELEASE_IMPORT |
|
|
outgoingProcedure |
- |
|
|
hasOutgoingProcedure |
- |
false |
|
previousDocuments |
liste må ha ett innslag av type: |
|
|
referenceNumber |
- |
- |
|
typeOfReference |
må være = CUDE |
|
|
declarantNumber |
- |
<må ha verdi> |
|
declarationDate |
- |
<må ha verdi> |
|
sequenceNumber |
- |
<må ha verdi> |
|
exportFromEU |
- |
|
|
exportId |
- |
- |
|
typeOfExport |
- |
|
|
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen. |
INCOMPLETE_CUDE_DOCUMENTATION |
|
IMMEDIATE_RELEASE_VOEC (VOEC sendinger som frigis ved grensepassering)
|
Beskrivelse av tollprosedyre og prosedyre fram til grensen |
VOEC-forsendelser. Annen tollmyndighet har klarert foregående prosedyre, eller verdi under verdigrensen for krav om eksport. |
|
| Felt | Kodeverk | Variant 7 |
|---|---|---|
|
importProcedure |
må fylles ut |
|
|
importProcedure |
IMMEDIATE_RELEASE_VOEC |
|
|
outgoingProcedure |
- |
|
|
hasOutgoingProcedure |
- |
- |
|
previousDocuments |
- |
|
|
referenceNumber |
- |
- |
|
typeOfReference |
- |
|
|
declarantNumber |
- |
- |
|
declarationDate |
- |
- |
|
sequenceNumber |
- |
- |
|
exportFromEU |
- |
|
|
exportId |
- |
- |
|
typeOfExport |
- |
|
|
goodsItem |
må fylles ut |
|
|
itemAmountInvoicedVOEC |
- |
må fylles ut |
|
value |
- |
<må ha verdi> |
|
numberOfItems |
- |
<må ha verdi> |
|
commodityCodeVOEC |
- |
må fylles ut |
|
harmonizedSystemSubheadingCode |
- |
<må ha verdi> |
|
additionalFiscalReferences |
- |
må fylles ut |
|
vatIdentificationNumber |
- |
<må ha verdi> |
|
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen. |
INCOMPLETE_VOEC_DOCUMENTATION |
|
WAREHOUSE_RELEASE (Innlegg på tollager og godsregistering)
NB! Denne koden skal brukes FØR det er levert en grensepassering innlegg på tollager deklarasjon.
Fram til 01.03.2027 kan den også brukes for varer som direktekjøres.
|
Beskrivelse av tollprosedyre og prosedyre fram til grensen |
Det er på forhånd levert deklarasjon for innlegg på tollager. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik) |
|
| Felt | Kodeverk | Variant 11 |
|---|---|---|
|
importProcedure |
må fylles ut |
|
|
importProcedure |
WAREHOUSE_RELEASE |
|
|
outgoingProcedure |
- |
|
|
hasOutgoingProcedure |
- |
false |
|
previousDocuments |
liste må ha ett innslag av type: |
|
|
referenceNumber |
- |
- |
|
typeOfReference |
må være = CUDE |
|
|
declarantNumber |
- |
<må ha verdi> |
|
declarationDate |
- |
<må ha verdi> |
|
sequenceNumber |
- |
<må ha verdi> |
|
exportFromEU |
- |
|
|
exportId |
- |
- |
|
typeOfExport |
- |
|
|
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen. |
INCOMPLETE_DOCUMENTATION |
|
COLLECTIVE_RELEASE (Varer som skal samlefortolles)
|
Beskrivelse av tollprosedyre og prosedyre fram til grensen |
Forsendelse som skal samlefortolles etter grensepassering. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik) |
|
| Felt | Kodeverk | Variant 15 |
|---|---|---|
|
importProcedure |
må fylles ut |
|
|
importProcedure |
COLLECTIVE_RELEASE |
|
|
outgoingProcedure |
- |
|
|
hasOutgoingProcedure |
- |
false |
|
previousDocuments |
- |
|
|
referenceNumber |
- |
- |
|
typeOfReference |
- |
|
|
declarantNumber |
- |
- |
|
declarationDate |
- |
- |
|
sequenceNumber |
- |
- |
|
exportFromEU |
- |
|
|
exportId |
- |
- |
|
typeOfExport |
- |
|
|
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen. |
||
DOCUMENTS_NOT_OBLIGED_RELEASE (Ikke-deklarasjonspliktige dokumenter)
|
Beskrivelse av tollprosedyre og prosedyre fram til grensen |
Forsendelse som ikke har deklarasjonsplikt etter § 4-1-25/29 i vareførselsforskriften. Annen tollmyndighet har klarert foregående prosedyre (f.eks. dansk toll før ferge til Larvik) |
|
| Felt | Kodeverk | Variant 19 |
|---|---|---|
|
importProcedure |
må fylles ut |
|
|
importProcedure |
DOCUMENTS_NOT_OBLIGED_RELEASE |
|
|
outgoingProcedure |
- |
|
|
hasOutgoingProcedure |
- |
false |
|
previousDocuments |
- |
|
|
referenceNumber |
- |
- |
|
typeOfReference |
- |
|
|
declarantNumber |
- |
- |
|
declarationDate |
- |
- |
|
sequenceNumber |
- |
- |
|
exportFromEU |
liste må ha MINST ett innslag av type: |
|
|
exportId |
- |
<må ha verdi> |
|
typeOfExport |
må være en av [AES_EXPORT, EUEIR_EXPORT, EIDR_EXPORT] |
|
|
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen. |
INCOMPLETE_EXP_DOCUMENTATION |
|
ATA_CARNET / TIR_CARNET
|
Beskrivelse av tollprosedyre og prosedyre fram til grensen |
ATA-Carnet |
TIR-Carnet |
|
| Felt | Kodeverk | Variant 27 | Variant 28 |
|---|---|---|---|
|
importProcedure |
må fylles ut |
må fylles ut |
|
|
importProcedure |
ATA_CARNET |
TIR_CARNET |
|
|
outgoingProcedure |
- |
- |
|
|
hasOutgoingProcedure |
- |
false |
false |
|
previousDocuments |
OG liste må ha ett innslag av type: |
OG liste må ha ett innslag av type: |
|
|
referenceNumber |
- |
<må ha verdi> |
<må ha verdi> |
|
typeOfReference |
må være = N955 |
må være = N952 |
|
|
declarantNumber |
- |
- |
- |
|
declarationDate |
- |
- |
- |
|
sequenceNumber |
- |
- |
- |
|
exportFromEU |
- |
- |
|
|
exportId |
- |
- |
- |
|
typeOfExport |
- |
- |
|
|
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen. |
INCOMPLETE_DOCUMENTATION |
INCOMPLETE_DOCUMENTATION |
|
CUSTOMS_DECLARATION (Tolldeklarering)
|
Beskrivelse av tollprosedyre og prosedyre fram til grensen |
Forsendelse med referanse til Tvinn-deklarasjon. Kan brukes uavhengig av om deklarasjonen er overgang til fri disposisjon eller innlegg på tollager (Tiltak 7) Ingen forutgående prosedyre |
Forsendelse med referanse til Tvinn-deklarasjon. Kan brukes uavhengig av om deklarasjonen er overgang til fri disposisjon eller innlegg på tollager (Tiltak 7) Eksport er foregående prosedyre og skal klareres ved grensepassering. |
Forsendelse med referanse til Tvinn-deklarasjon. Kan brukes uavhengig av om deklarasjonen er overgang til fri disposisjon eller innlegg på tollager (Tiltak 7) Transittering er foregående prosedyre og skal avsluttes ved grensepassering. |
Forsendelse med referanse til Tvinn-deklarasjon. Kan brukes uavhengig av om deklarasjonen er overgang til fri disposisjon eller innlegg på tollager (Tiltak 7) Transittering og eksport er foregående prosedyre og skal avsluttes ved grensepassering. |
|||
| Felt | Kodeverk | Variant 30 | Variant 31 | Variant 32 | Variant 33 | ||
|---|---|---|---|---|---|---|---|
|
importProcedure |
må fylles ut |
må fylles ut |
må fylles ut |
må fylles ut |
|||
|
importProcedure |
CUSTOMS_DECLARATION |
CUSTOMS_DECLARATION |
CUSTOMS_DECLARATION |
CUSTOMS_DECLARATION |
|||
|
outgoingProcedure |
- |
EXP |
TRA |
TRE |
|||
|
hasOutgoingProcedure |
- |
false |
true |
true |
true |
||
|
previousDocuments |
liste må ha ett innslag av type: |
liste må ha ett innslag av type: |
liste må ha ett innslag av type: |
OG liste må ha ett innslag av type: |
liste må ha ett innslag av type: |
OG liste må ha ett innslag av type: |
|
|
referenceNumber |
- |
- |
- |
- |
<må ha verdi> |
- |
<må ha verdi> |
|
typeOfReference |
må være = CUDE |
må være = CUDE |
må være = CUDE |
må være = N820 |
må være = CUDE |
må være = N820 |
|
|
declarantNumber |
- |
<må ha verdi> |
<må ha verdi> |
<må ha verdi> |
- |
<må ha verdi> |
- |
|
declarationDate |
- |
<må ha verdi> |
<må ha verdi> |
<må ha verdi> |
- |
<må ha verdi> |
- |
|
sequenceNumber |
- |
<må ha verdi> |
<må ha verdi> |
<må ha verdi> |
- |
<må ha verdi> |
- |
|
exportFromEU |
- |
liste må ha MINST ett innslag av type: |
- |
liste må ha MINST ett innslag av type: |
|||
|
exportId |
- |
- |
<må ha verdi> |
- |
<må ha verdi> |
||
|
typeOfExport |
- |
må være en av [AES_EXPORT, EUEIR_EXPORT, EIDR_EXPORT] |
- |
må være en av [AES_EXPORT, EUEIR_EXPORT, EIDR_EXPORT] |
|||
|
Mulige valideringsmeldinger dersom informasjonen ikke er komplett. Vi forutsetter da at den manglende informasjonen er innlevert senest ved ankomst til grensen. |
INCOMPLETE_DOCUMENTATION INCOMPLETE_CUDE_DOCUMENTATION |
INCOMPLETE_DOCUMENTATION INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION |
INCOMPLETE_DOCUMENTATION INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION |
INCOMPLETE_DOCUMENTATION INCOMPLETE_CUDE_DOCUMENTATION INCOMPLETE_EXP_DOCUMENTATION INCOMPLETE_TRA_DOCUMENTATION |
|||