Løsningen for melde- og opplysning har API for å koble meldinger sammen

Bakgrunn:

Dagens løsning krever:

• At innsender av transportmelding har ansvar for å sende hvilke hovedfraktbrev og fraktbrev (direkteforsendelse) som er med i transporten.
• At innsender av forsendelse har ansvar for å sende inn referanse til overliggende hovedfraktbrevnummer (eller overliggende transport ved direkteforsendelser) samt referanse til deklarasjonen i TVINN.

Næringslivsaktørene har etterlyst en større fleksibilitet for hvilke innsendere som kan ta ansvar for at nødvendig koblingsinformasjon er på plass i meldingene innsendt i MO.

Tolletaten har derfor lagt til rette for at aktørene kan avtale seg imellom hvem som er best egnet til å sende inn nødvendig koblingsinformasjon ved å skille ut koblingene i egne koblingsmeldinger (kalt relation i API).

Koblingsmeldingene er et tillegg til dagens løsning med innsendelse av referanser i de respektive meldinger.

Koblings-API:

Koblingsmeldinger følger standard mønster:

• Opprette (POST) – Virksomhet oppretter request-id, Tolletaten oppretter og returnerer MRN
• Slette (DELETE) – Virksomhet sender inn request-id og MRN

Hovedprinsippet er at man i koblingsmeldingen angir de to MRN (inkl. type MRN) som identifiserer de meldingene som skal kobles sammen.

Hvis en kobling skal endres, gjøres dette ved å slette den innsendte koblingsmeldingen (DELETE i API) og opprette en ny koblingsmelding.

API-dokumentasjon ligger som en del av Melde- og opplysnings API-ene for hver transportmåte, under Relation for vei, tilsvarende for andre transportmåter. Det er ikke eksplisitte API-er for hver koblingstype.

API for å slå opp og få returnert MRN

Dersom innsender av relationship-melding ikke kjenner MRN, vil Digitoll i fremtiden ha et spørre-API som gjør det mulig å slå opp MRN på en melding dersom man besitter annen identifiserende informasjon om et objekt.

Se API-dokumentasjon for spørre-API på vei her.

Avgrensninger:

Det lages kun støtte for å koble sammen Digitoll-meldinger. Støtte for å koble deklarasjons-id (fra TVINN) til forsendelse (house) vil bli utviklet senere, men i første versjon er ikke dette med.

Det lages ikke støtte for at man via relationship-melding kan sende inn referanse hverken til transittering, svensk eksport, postsekk (receptacle) eller ATA-carnet for å koble disse til transport/forsendelser.

Koblingsmeldinger vil ikke løse utfordringen til næringslivet hvis aktørene som skal samhandle ikke kjenner hverandre / ikke utveksler nødvendig informasjon. Koblingsmeldinger åpner kun for at det blir mer fleksibelt hvem som tar ansvar for å samle og sende inn hvilken informasjon.

Case eksempel:

• Speditør sender inn hovedforsendelse før avtale om transport er avtalt. Digitoll utsteder MRN for meldingen.
• Transportør/fører sender inn transportmelding (ikke autentisert løsning eller ordinær Digitoll) uten referanse til hovedfraktbrev. Digitoll utsteder MRN for meldingen.
  • Transportør/fører distribuerer MRN for transportmelding til de aktører transportør etterhvert avtaler å transportere gods for.
• Speditør sender inn koblingsmelding (MRN til hovedforsendelse og MRN til transport) for å etablere nødvendig kobling når frakt er avtalt.

Kodeeksempel:

• Request:

  {
    "representative": "123456789",
    "parentObjectType": "TRANSPORT",
    "parentObjectReference": "24NO02091D3HAVFST5",
    "childObjectType": "MASTER_CONSIGNMENT",
    "childObjectReference": "24NO02091DW4BIEST4"
  }
                  

• Response: 202, 400, 401, 403, 415, 500 (som i dag)