Kobling av meldinger

Generelt kobles meldingene i melde- og opplysning gjennom nøkler som oppgis av innsender.

Kobling mellom transport og hovedforsendelse (master consignment)

Melding om transport inneholder en liste av nøkler til melding om hovedforsendelser. I den listen oppgis nøkkelen til en hovedforsendelse, som består av hovedfraktbrevnummer (transportDocumentMasterLevel.documentNumber+transportDocumentMasterLevel.type). For at koblingen skal bli korrekt må transportørens identifikator være den samme i melding om hovedforsendelse (carrier.IdentificationNumber) og melding om transport (carrier.IdentificationNumber).

Kobling mellom transport og forsendelse (house consignment) – uten bruk av hovedforsendelse

Melding om transport inneholder en liste av nøkler til melding om forsendelser. I den listen oppgis nøkkelen til en melding om forsendelse, som består av fraktbrevnummer (transportDocumentHouseLevel.documentNumber + transportDocumentHouseLevel.type). For at koblingen skal bli korrekt må transportørens identifikator være den samme i melding om forsendelse (tranportLevel.carrierIdentificationNumber) og melding om transport (carrier.IdentificationNumber).
I melding om forsendelse må et flagg settes for at dette er en forsendelse som kobles direkte til en transport: "directConsignment": true.

Kobling mellom forsendelse (house consignment) og hovedforsendelse (master consignment)

Melding om forsendelse inneholder en nøkkelreferanse til melding om hovedforsendelse. I den referansen oppgis nøkkelen til en melding om hovedforsendelse, som består av hovedfraktbrevnummer (transportDocumentMasterLevel.documentNumber + transportDocumentMasterlevel.type). For at koblingen skal bli korrekt må transportørens identifikator være den samme i melding om forsendelse (consignemntMasterLevel.carrierIdentificationNumber) og melding om hovedforsendelse (carrier.IdentificationNumber).

Kobling mellom forsendelse (house consignment) og hovedforsendelse (master consignment) for forsendelser som er post dekket av UPU-konvensjoner

Melding om forsendelse inneholder en nøkkelreferanse til en postbeholder (receptacle). I den referansen i melding om forsendelse oppgis nøkkelen til en postbeholder (receptacleIdentificationNumber).
Melding om hovedforsendelse inneholder en liste med nøkkelreferanser til postbeholdere. I disse referansene i melding om hovedforsendelse oppgis nøkkelen til en postbeholder (receptacleIdentificationNumber).

Sammenheng mellom nøkler

For post-operatører gjelder egne koblinger via postbeholder:

  • ved hjelp av at postbeholder-id er referert både i forsendelse og i hovedforsendelse (kun i bruk for post-operatører)
Sammenheng mellom nøkler ved postsekk

Oppdateringer av meldinger (PUT)

På samme måte som for innsending (POST), skal man ved oppdatering (PUT) sende inn melding og motta en referanse (requestid), for så å spørre om validering. PUT er en fullstendig erstatning av tidligere innsending og må referere til mottatt MRN for meldingen som nøkkel. I tillegg til å måtte referere til MRN, må nøkkelinformasjon for meldingen være uendret ved oppdatering:

  • For transport kan ikke identifikatoren (kjennemerke og registreringsnummer: identificationNumber + typeOfIdentification), rutenummer (conveyanceReferenceNumber) (kun fly) og opprinnelig ankomsttid (scheduledDateAndTimeOfArrival) oppdateres.
  • For hovedforsendelse (master consignment) kan ikke hovedfraktbrevnummer (documentNumber + type) og transportøridentifikator (carrierId) oppdateres.
  • For forsendelse (house consignment) kan ikke fraktbrevnummer (documentNumber + type) oppdateres.

Ellers følger oppdatering (PUT) samme mønster som innsending (POST). Se API-dokumentasjon lenket til under for detaljer om endepunktene.

Sletting/kansellering av melding (DELETE)

På samme måte som for innsending (POST) og oppdatering (PUT), skal man ved sletting (DELETE) sende inn melding og motta en referanse (requestid), for så å spørre om validering. DELETE kansellerer tidligere innsendt melding og må referere til mottatt MRN for meldingen som nøkkel. Ellers følger sletting (DELETE) samme mønster som innsending (POST) og oppdatering (PUT). Se API-dokumentasjon lenket til under for detaljer om endepunktene.

Automatisk kansellering av meldinger

Meldinger om transport blir automatisk kansellert 72 timer etter estimert ankomst dersom ankomst ikke er registrert. Meldinger om hovedforsendelse / forsendelse som ikke er koblet til en transport vil bli kansellert 30 dager etter siste oppdatering av meldingen.