Endringslogg MO-vei v1 til MO-vei v2

Bakgrunn

Det har vært omfattende endringer mellom versjon 1 og versjon 2 av Tolletatens API for melding og fremlegging for kjøretøy på vei/ferge. Dokumentasjonen av disse finnes på henholdsvis

1. versjon 1
og
2. versjon 2

Hovedendringer

Følgende endringer beskriver de overordnede endringene i meldingene for innsending av opplysninger for MO-vei:

• Struktur endret fra to meldinger til tre meldinger:
  • Melding om transport (ROAD001) splittet opp i to meldinger
    • melding om transport
    • melding om hovedforsendelse (Master Consignment)
  • Melding om forsendelse
• Nøkler og koblinger mellom nivåene er endret:
  • Melding om forsendelse er identifisert med fraktbrevnummer og har to forskjellige konsepter for kobling fra forsendelse til hovedforsendelse, et for post og et for alle andre:
    • Melding om forsendelse skal, senest når transport ankommer grensen, inneholde nøkkel til melding om hovedforsendelse (ikke post) – nøkkel er hovedfraktbrevnummer
    • Melding om forsendelse skal, senest når transport ankommer grensen, inneholde nøkkel til receptacle ("postsekk", kun postsendinger) – nøkkel er postsekknummer
  • Melding om hovedforsendelse er identifisert av et hovedfraktbrevnummer
    • Melding om hovedforsendelse kan ha en liste med postsekknummer (kun post)
  • Melding transport identifiseres med registreringsnummer og estimert ankomsttid
    • Melding om transport skal, senest når transport ankommer grensen, inneholde en liste av hovedfraktbrevnummer
      

      Knytning av meldinger ved hjelp av fraktbrev		Knytning av meldinger ved hjelp av postsekk-id (kun posten)

• Både forsendelse og hovedforsendelse skal, senest når transport ankommer grensen, inneholde en nøkkel til transportør (carrier, som spesifisert i melding om transport)
• Meldinger kan sendes inn i vilkårlig rekkefølge, men det er en forutsetning at strukturen er komplett med alle koblinger senest når transport ankommer grensen
• Totalt sett er det et vesentlig redusert datakrav

Melding om fremlegging er utvidet til å omfatte Melde- og opplysningsplikten. Endringene skal ikke være slik at de vil gjøre det nødvendig med endringer for eksisterende bruk av fremlegging for ICS2.
På sikt vil endepunkt for fremlegging av ENS, som brukt i ICS2, bli fjernet og erstattet med endepunkt for fremlegging av hovedforsendelse (Master Consignment), vi anbefaler en overgang til det nye endepunktet.
For de som ikke har implementert fremlegging for ICS2, anbefaler vi å bruke endepunkt for fremlegging av Master Consignment i stedet for ENS.

Detaljer

Melding om forsendelse (House Consignment)

I hovedsak er endringene for forsendelse fjerning av påkrevde og frivillige dataelementer.
Det er lagt til dataelementer for koblinger, og dataelementer for VOEC er gjort mer tydelige.
Siden laste- og lossested ikke er relevant for forsendelse, er dette endret til akseptansested og leveringssted.
Som angitt under, finnes det en del dataelementer som er frivillige i grensesnittet, men som vi forventer vil bli gjort påkrevd ved en senere revisjon av lov eller forskrift. Vi anbefaler derfor at disse fylles ut allerede nå.

Følgende dataelementer er fjernet:

• declarant
• declarant→name
• declarant→identificationNumber
• declarant→address
• declarant→address→city
• declarant→address→country
• declarant→address→subDivision
• declarant→address→postcode
• declarant→address→streetLine
• declarant→address→streetAdditionalLine
• declarant→address→number
• declarant→address→poBox
• declarant→communication
• declarant→communication→identifier
• declarant→communication→type
• consignmentHouseLevel→referenceNumberUCR
• consignmentHouseLevel→placeOfLoading
• consignmentHouseLevel→placeOfLoading→location
• consignmentHouseLevel→placeOfLoading→unlocode
• consignmentHouseLevel→placeOfLoading→address
• consignmentHouseLevel→placeOfLoading→address→country
• consignmentHouseLevel→placeOfUnloading
• consignmentHouseLevel→placeOfUnloading→location
• consignmentHouseLevel→placeOfUnloading→unlocode
• consignmentHouseLevel→placeOfUnloading→address
• consignmentHouseLevel→placeOfUnloading→address→country
• consignmentHouseLevel→additionalSupplyChainActor
• consignmentHouseLevel→additionalSupplyChainActor→identificationNumber
• consignmentHouseLevel→additionalSupplyChainActor→role
• consignmentHouseLevel→goodsItem→declarationGoodsItemNumber
• consignmentHouseLevel→goodsItem→transitGoodsItemNumber
• consignmentHouseLevel→goodsItem→referenceNumberUCR
• consignmentHouseLevel→goodsItem→typeOfGoods
• consignmentHouseLevel→goodsItem→itemAmountInvoiced
• consignmentHouseLevel→goodsItem→itemAmountInvoiced→value
• consignmentHouseLevel→goodsItem→itemAmountInvoiced→currency
• consignmentHouseLevel→goodsItem→additionalSupplyChainActor
• consignmentHouseLevel→goodsItem→additionalSupplyChainActor→identificationNumber
• consignmentHouseLevel→goodsItem→additionalSupplyChainActor→role
• consignmentHouseLevel→goodsItem→commodity
• consignmentHouseLevel→goodsItem→commodity→descriptionOfGoods
• consignmentHouseLevel→goodsItem→commodity→cusCode
• consignmentHouseLevel→goodsItem→commodity→commodityCode
• consignmentHouseLevel→goodsItem→commodity→commodityCode→harmonizedSystemSubheadingCode
• consignmentHouseLevel→goodsItem→commodity→commodityCode→combinedNomenclatureCode
• consignmentHouseLevel→goodsItem→commodity→dangerousGoods
• consignmentHouseLevel→goodsItem→commodity→dangerousGoods
• consignmentHouseLevel→goodsItem→commodity→goodsMeasure
• consignmentHouseLevel→goodsItem→commodity→goodsMeasure→netMass
• consignmentHouseLevel→goodsItem→commodity→goodsMeasure→grossMass
• consignmentHouseLevel→goodsItem→commodity→goodsMeasure→supplementaryUnits
• consignmentHouseLevel→goodsItem→countryOfOrigin
• consignmentHouseLevel→goodsItem→countryOfOrigin→country
• consignmentHouseLevel→goodsItem→packaging
• consignmentHouseLevel→goodsItem→packaging→shippingMarks
• consignmentHouseLevel→goodsItem→packaging→numberOfPackages
• consignmentHouseLevel→goodsItem→packaging→typeOfPackages
• consignmentHouseLevel→goodsItem→passiveTransportMeans
• consignmentHouseLevel→goodsItem→passiveTransportMeans→identificationNumber
• consignmentHouseLevel→goodsItem→passiveTransportMeans→typeOfIdentification
• consignmentHouseLevel→goodsItem→passiveTransportMeans→typeOfMeansOfTransport
• consignmentHouseLevel→goodsItem→passiveTransportMeans→countryCode
• consignmentHouseLevel→goodsItem→transportEquipment
• consignmentHouseLevel→goodsItem→transportEquipment→containerSizeAndType
• consignmentHouseLevel→goodsItem→transportEquipment→containerPackedStatus
• consignmentHouseLevel→goodsItem→transportEquipment→containerSupplierType
• consignmentHouseLevel→goodsItem→transportEquipment→containerIdentificationNumber
• consignmentHouseLevel→transportCharges
• consignmentHouseLevel→transportCharges→methodOfPayment
• consignmentHouseLevel→transportCharges→currency
• consignmentHouseLevel→transportCharges→value
• consignmentHouseLevel→countriesOfRoutingOfConsignment
• consignmentHouseLevel→countriesOfRoutingOfConsignment→sequenceNumber
• consignmentHouseLevel→countriesOfRoutingOfConsignment→country
• consignmentHouseLevel→passiveBoarderTransportMeans
• consignmentHouseLevel→passiveBoarderTransportMeans→identificationNumber
• consignmentHouseLevel→passiveBoarderTransportMeans→typeOfIdentification
• consignmentHouseLevel→passiveBoarderTransportMeans→typeOfMeansOfTransport
• consignmentHouseLevel→passiveBoarderTransportMeans→countryCode
• consignmentHouseLevel→totalAmountInvoiced→
• consignmentHouseLevel→totalAmountInvoiced→value
• consignmentHouseLevel→totalAmountInvoiced→curreny

 

Følgende dataelementer er flyttet:

Disse feltene er kun for VOEC og skal bare fylles ut for forsendelser som er underlagt VOEC-ordningen. Hvis importProcedure er satt til VOEC skal disse alltid fylles ut

• Før: consignmentHouseLevel→additionalFiscalReference
  Nå:consignmentHouseLevel→goodsItem→additionalFiscalReference
• Før: consignmentHouseLevel→additionalFiscalReference→vatIdentificationNumber
  Nå: consignmentHouseLevel→goodsItem→additionalFiscalReference→vatIdentificationNumber
• Før: consignmentHouseLevel→additionalFiscalReference→role
  Nå: consignmentHouseLevel→goodsItem→additionalFiscalReference→role

Følgende dataelementer er lagt til:

• consignmentHouseLevel→receptacleIdentificationNumber
  Dette er nøkkelen til postsekk og brukes for å koble forsendelse og hovedforsendelse for post. Skal kun oppgis når det er en postforsendelse
• consignmentHouseLevel→numberOfPackages
  Antall kolli som forsendelsen inneholder totalt. Dette er summen av antall kolli på varelinjenivå
• consignmentHouseLevel→goodsDescription
  Grov varebeskrivelse, se Swagger for forklaring på hvordan dette skal fylles ut
• consignmentHouseLevel→importProcedure→hasOutgoingProcedure
• consignmentHouseLevel→placeOfAcceptance
  Place of acceptance er frivillig, men vi anbefaler at dere fyller de ut. Det er sannsynlig at disse feltene blir påkrevd i en senere versjon
• consignmentHouseLevel→placeOfAcceptance→location
• consignmentHouseLevel→placeOfAcceptance→unlocode
• consignmentHouseLevel→placeOfAcceptance→address
• consignmentHouseLevel→placeOfAcceptance→address→country
• consignmentHouseLevel→placeOfDelivery
  Place of delivery er frivillig, men vi anbefaler at dere fyller de ut. Det er sannsynlig at disse feltene blir påkrevd i en senere versjon
• consignmentHouseLevel→placeOfDelivery→location
• consignmentHouseLevel→placeOfDelivery→unlocode
• consignmentHouseLevel→placeOfDelivery→address
• consignmentHouseLevel→placeOfDelivery→address→country
• consignmentHouseLevel→consignmentMasterLevel
• consignmentHouseLevel→consignmentMasterLevel→carrierIdentificationNumber
  Dette er nøkkel til transportør, som oppgitt på melding om transport. Skal seinest være oppgitt ved ankomst av transport til grensen
• consignmentHouseLevel→consignmentMasterLevel→transportDocumentMasterLevel
  De to feltene under er nøkkel til hovedforsendelse. Skal brukes når det ikke er post, seinest ved ankomst av transport til grensen
• consignmentHouseLevel→consignmentMasterLevel→transportDocumentMasterLevel→documentNumber
• consignmentHouseLevel→consignmentMasterLevel→transportDocumentMasterLevel→type
• consignmentHouseLevel→goodsItem→itemAmountInvoicedVOEC
  Disse feltene er for VOEC og frivillig å sende inn, men vi anbefaler at dere fyller de ut. Det er sannsynlig at disse feltene blir påkrevd i en senere versjon
• consignmentHouseLevel→goodsItem→itemAmountInvoicedVOEC→value
• consignmentHouseLevel→goodsItem→itemAmountInvoicedVOEC→numberOfItems
• consignmentHouseLevel→goodsItem→commodityCodeVOEC
  Disse feltene er for VOEC og frivillig å sende inn, men vi anbefaler at dere fyller de ut. Det er sannsynlig at disse feltene blir påkrevd i en senere versjon
• consignmentHouseLevel→goodsItem→commodityCodeVOEC→harmonizedSystemSubheadingCode

 

Melding om hovedforsendelse (Master Consignment)

Denne meldingen er ny i grensesnittet.

Det er i hovedsak dataelementer for hovedforsendelse (Master Consignment) fra den tidligere Melding om transport som er flyttet til denne meldingen.

Denne meldingen inneholder i hovedsak informasjon om hovedforsendelsen, sender og mottaker av hovedforsendelsen, beholder(e) som hovedforsendelsen fraktes i og tilknyttede steder.
Tilknyttede steder for lasting, lossing, overtagelse og levering vil være frivillige felter, men vi anbefaler at disse fylles ut, da vi forventer at de vil bli påkrevd i en senere revisjon av lov eller forskrift.
For post vil denne meldingen inneholde en liste over postsekker som er knyttet til hovedforsendelsen.

 

Melding om transport (Transport)

Den tidligere melding om transport er splittet i to meldinger. Informasjon om hovedforsendelse er tatt ut av denne meldingen og er nå i melding om hovedforsendelse.
Dette muliggjør å kunne sende inn flere hovedforsendelser for hver transport.

Denne meldingen vil nå i hovedsak inneholde informasjon om tid og sted for grensepassering, transportmiddel, fører og transportør.

Følgende dataelementer er fjernetfra melding om transport:

• activeBorderTransportMeans→actualDateAndTimeOfDeparture
• activeBorderTransportMeans→estimatedDateAndTimeOfDeparture
• activeBorderTransportMeans→estimatedDateAndTimeOfArrival (denne er flyttet til rotnivå og dukker opp litt lenger nede)
• activeBorderTransportMeans→countriesOfRoutingOfMeansOfTransport
• activeBorderTransportMeans→countriesOfRoutingOfMeansOfTransport→sequenceNumber
• activeBorderTransportMeans→countriesOfRoutingOfMeansOfTransport→Country
• declarant
• declarant→name
• declarant→identificationNumber
• declarant→address
• declarant→address→city
• declarant→address→country
• declarant→address→subDivision
• declarant→address→postcode
• declarant→address→streetLine
• declarant→address→streetAdditionalLine
• declarant→address→number
• declarant→address→poBox
• declarant→communication
• declarant→communication→identifier
• declarant→communication→type
• releasedConfirmation
• releasedConfirmation→emailAddress
• consignmentMasterLevel (dette er fjernet og gjort om til en liste, se under)
• consignmentMasterLevel→containerIndicator
• consignmentMasterLevel→grossMass
• consignmentMasterLevel→referenceNumberUCR
• consignmentMasterLevel→carrier (denne er flyttet til rotnivå, se under)
• consignmentMasterLevel→carrier→name
• consignmentMasterLevel→carrier→identificationNumber
• consignmentMasterLevel→carrier→address
• consignmentMasterLevel→carrier→address→ city
• consignmentMasterLevel→carrier→address→country
• consignmentMasterLevel→carrier→address→subDivision
• consignmentMasterLevel→carrier→address→postcode
• consignmentMasterLevel→carrier→address→streetLine
• consignmentMasterLevel→carrier→address→streetAdditionalLine
• consignmentMasterLevel→carrier→address→number
• consignmentMasterLevel→carrier→address→poBox
• consignmentMasterLevel→carrier→communication
• consignmentMasterLevel→carrier→communication→identifier
• consignmentMasterLevel→carrier→communication→type
• consignmentMasterLevel→transportDocumentMasterLevel
• consignmentMasterLevel→transportDocumentMasterLevel→documentNumber
• consignmentMasterLevel→transportDocumentMasterLevel→type
• consignmentMasterLevel→consignee
• consignmentMasterLevel→consignee→name
• consignmentMasterLevel→consignee→identificationNumber
• consignmentMasterLevel→consignee→typeOfPerson
• consignmentMasterLevel→consignee→address
• consignmentMasterLevel→consignee→address→ city
• consignmentMasterLevel→consignee→address→country
• consignmentMasterLevel→consignee→address→subDivision
• consignmentMasterLevel→consignee→address→postcode
• consignmentMasterLevel→consignee→address→streetLine
• consignmentMasterLevel→consignee→address→streetAdditionalLine
• consignmentMasterLevel→consignee→address→number
• consignmentMasterLevel→consignee→address→poBox
• consignmentMasterLevel→consignee→communication
• consignmentMasterLevel→consignee→communication→identifier
• consignmentMasterLevel→consignee→communication→type
• consignmentMasterLevel→consignor
• consignmentMasterLevel→consignor→name
• consignmentMasterLevel→consignor→identificationNumber
• consignmentMasterLevel→consignor→typeOfPerson
• consignmentMasterLevel→consignor→address
• consignmentMasterLevel→consignor→address→ city
• consignmentMasterLevel→consignor→address→country
• consignmentMasterLevel→consignor→address→subDivision
• consignmentMasterLevel→consignor→address→postcode
• consignmentMasterLevel→consignor→address→streetLine
• consignmentMasterLevel→consignor→address→streetAdditionalLine
• consignmentMasterLevel→consignor→address→number
• consignmentMasterLevel→consignor→address→poBox
• consignmentMasterLevel→consignor→communication
• consignmentMasterLevel→consignor→communication→identifier
• consignmentMasterLevel→consignor→communication→type
• consignmentMasterLevel→placeOfLoading
• consignmentMasterLevel→placeOfLoading→location
• consignmentMasterLevel→placeOfLoading→unlocode
• consignmentMasterLevel→placeOfLoading→address
• consignmentMasterLevel→placeOfLoading→address→country
• consignmentMasterLevel→placeOfUnloading
• consignmentMasterLevel→placeOfUnloading→location
• consignmentMasterLevel→placeOfUnloading→unlocode
• consignmentMasterLevel→placeOfUnloading→address
• consignmentMasterLevel→placeOfUnloading→address→country
• consignmentMasterLevel→passiveBoarderTransportMeans
• consignmentMasterLevel→passiveBoarderTransportMeans→identificationNumber
• consignmentMasterLevel→passiveBoarderTransportMeans→typeOfIdentification
• consignmentMasterLevel→passiveBoarderTransportMeans→typeOfMeansOfTransport
• consignmentMasterLevel→passiveBoarderTransportMeans→countryCode
• consignmentMasterLevel→transportEquipment
• consignmentMasterLevel→transportEquipment→containeridentificationNumber
• consignmentMasterLevel→additionalSupplychainActor
• consignmentMasterLevel→additionalSupplychainActor→identificationNumber
• consignmentMasterLevel→additionalSupplychainActor→role
• consignmentMasterLevel→consignmentHouseLevel
• consignmentMasterLevel→consignmentHouseLevel→transportDocumentHouseLevel
• consignmentMasterLevel→consignmentHouseLevel→transportDocumentHouseLevel→documentNumber
• consignmentMasterLevel→consignmentHouseLevel→transportDocumentHouseLevel→type

Følgende dataelementer er lagt til/flyttet til rotnivå:

• carrier (flyttet fra consignmentMasterLevel)
• carrier→name
• carrier→identificationNumber
• carrier→address
• carrier→address→ city
• carrier→address→country
• carrier→address→subDivision
• carrier→address→postcode
• carrier→address→streetLine
• carrier→address→streetAdditionalLine
• carrier→address→number
• carrier→address→poBox
• carrier→communication
• carrier→communication→identifier
• carrier→communication→type
• estimatedDateAndTimeOfArrival (flyttet fra activeBorderTransportMeans)
• scheduledDateAndTimeOfArrival
• consignmentMasterLevel (er nå en liste)
• consignmentMasterLevel→consignmentHouseLevel→transportDocumentHouseLevel
• consignmentMasterLevel→consignmentHouseLevel→transportDocumentHouseLevel→documentNumber
• consignmentMasterLevel→consignmentHouseLevel→transportDocumentHouseLevel→type
• activeBorderTransportMeans→conveyanceReferenceNumber

 

Melding om fremlegging (Presentation)

Det er lagt til dataelementer slik at det skal være mulig å fremlegge forsendelser for melde- og opplysning i tillegg til ICS2 (forhåndsvarsel).

Nye dataelementer for endepunkt for fremlegging av postsekk (/receptacle):

• transportMRN

Nye dataelementer for endepunkt for forsendelse / House Consignment (/house-consignment)

• tranportMRN
• consignmentHouseLevel→tranportDocumentHouseLevel→documentNumber (dette erstatter referenceNumber, men referenceNumber kan fremdeles sendes inn for ICS2 inntil videre)

Nytt endepunkt for hovedforsendelse / MasterConsignment (/master-consignment)
Dette endepunktet skal erstatte endepunktet for ENS (/entry-summary-declaration) for ICS2 og dekker nå også behovet for melde og opplysning.

Deprecated endepunkt for ENS (/entry-summary-declaration)
Bruk endepunkt for hovedforsendelse (/master-consignment) i stedet.