Informasjon og meldinger
API-ene støtter innsending av opplysninger knyttet til melde og opplysningsplikten for post, ekspress, flyfrakt, kjøretøy på vei og ferge i henhold til vareførselsloven § 2-3 og forskrift om inn- og utførsel av varer.
API-ene for innsending er delt i 3 forskjellige meldinger:
- en for innsending av opplysninger om transport
- en for innsending av opplysninger om hovedforsendelse
- en for innsending av opplysninger om forsendelser
Meldingene sendes inn hver for seg og uavhengig av hverandre med tanke på
både rekkefølge og avsender.
Melding om transport skal, ved grensepassering, inneholde en liste med
sporingsnummer til alle hovedforsendelsene og/eller forsendelsene som skal
være med på transporten.
Merk at det både kan knyttes forsendelser til transport direkte eller
via hovedforsendelse på samme transport.
Forsendelse knyttes til hovedforsendelsen eller til transporten:
- ved hjelp av at fraktbrevnummer til hovedforsendelsen oppgis i melding om forsendelse (kan brukes av alle andre enn post-operatører)
- ved at transporten inneholder en liste av forsendelser (kan brukes av alle andre enn post-operatører)
Sekvens for innsending – synkron og asynkron respons
Se også dokumentasjon her: hvordan-sende-inn-meldinger, dette er likt for alle transportformer.
Generelt fungerer innsending av informasjon slik at
aktøren sender inn en melding (POST) og mottar en
referanse (requestId). Ved å bruke den mottatte
referansen kan aktøren spørre (GET) om resultat av
innsendingen og ved suksess motta en permanent
referanse til meldingen, utstedt av
Tolletaten. Dette gjøres på et eget endepunkt
(/validation-status) i spørre-API-et (query API)
linket til lengre nede på denne siden. Disse
tjenestene er asynkrone og man må derfor spørre
inntil man får svar. Valideringsrespons vil
vanligvis være tilgjengelig i løpet 1 til 2
sekunder, men det kan ta lenger tid i
enkelttilfeller.
Spørring gjøres på
/validation-status-endepunktet, som vil returnere
den permanente referansen, et Master Reference
Number, forkortet MRN ved suksess og en liste med
valideringsfeil hvis de finnes.
Eksempel på innsendingssekvens for forsendelse (house consignment). Mønsteret er det samme for de andre meldingene, hovedforsendelse (master consignment) og transport.
MRN brukes når meldinger skal oppdateres eller kanselleres (put/delete) for å referere til tidligere innsendte meldinger. Valideringsendepunktet vil også kunne returnere en liste med dokumentstatuser for å indikere manglende opplysninger, se mo-kodeverk.html#incompleteDocumentationReason. Anbefalt metode for innsending er at aktøren sender inn alle meldinger for oppretting (POST) som er aktuelle, og så venter 1-2 sekunder før spørring om validering (query API).
For eksempel: om man har 500 forsendelser for en hovedforsendelse på en transport, så sender man inn (POST) alle 500 meldingene om forsendelse, venter et par sekunder, ber om validering og får tilbake MRN og status for alle de 500 meldingene. Dersom man får status 404 ved kall til valideringsendepunktet må man vente litt og spørre igjen. Det anbefales å lage en algoritme som gjør gjentatte forsøk, inntil valideringsrespons mottas.
