Spring til hovedindhold
POST
Opret en forsendelsesordre fra den angivne afsenderlokation. Du angiver modtagerlaboratoriet med destination_lab. Forsendelsen sendes til laboratoriets registrerede forsendelsesadresse. Kræver scopet shipments_manage. Send en valgfri Idempotency-Key-header for at gøre denne oprettelse sikker at prøve igen — gentages den samme nøgle, returneres det oprindelige svar i stedet for at oprette endnu en. Se Idempotens.

Forespørgsel

Body-parametre

string
påkrævet
UUID for afsendende testlokation. Lokationen skal være aktiv og inden for din API-nøgles adgangskontekst. Brug Vis lokationer til at finde tilgængelige lokations-id’er.
string
påkrævet
Modtagerlaboratorium. En af zotzklimas, labclinic, nordicgroup, biomes, imd eller quade. Forsendelsen sendes til den forsendelsesadresse, der er registreret for dette laboratorium. Et laboratorium uden en registreret forsendelsesadresse returnerer 400.
string
Valgfri UUID for en tid, som denne forsendelse skal tilknyttes ved oprettelse. Tiden skal være inden for din API-nøgles adgangskontekst. Tilknytningen vises direkte som en post i forsendelsens appointments-array og omvendt som en post i tidens shipments-array. For at tilknytte flere tider efter oprettelse eller fjerne den første tilknytning skal du bruge Tilknyt tider til forsendelse og Fjern tider fra forsendelse.
string
påkrævet
Afhentningsdato i YYYY-MM-DD-format (f.eks. 2026-04-15), fortolket i afsenderlokationens tidszone. Skal være en hverdag (mandag–fredag), i dag eller i fremtiden. Afhentning samme dag er ikke mulig efter kl. 16:00 Europe/Berlin.
string
påkrævet
Tidligste afhentningstidspunkt i HH:MM-format (f.eks. 09:00), fortolket som lokalt klokkeslæt i afsenderlokationens tidszone. Skal være mellem 09:00 og 19:00.
string
påkrævet
Seneste afhentningstidspunkt i HH:MM-format (f.eks. 12:00), fortolket som lokalt klokkeslæt i afsenderlokationens tidszone. Skal være mellem 09:00 og 19:00. Tidsrummet (pickup_time_till - pickup_time_from) skal være mindst 2 timer.
integer
standard:"1"
Antal pakker. Standard er 1.
number
standard:"0.5"
Vægt i kg. Standard er 0.5.
string
Instruktioner til kureren ved afhentning (afsenderbemærkninger). Hvis feltet udelades, bruges afhentningsadressens gemte bemærkninger (eller ingen, hvis adressen ikke har nogen). Maksimalt 128 tegn.
string
Fritekstbeskrivelse af pakkens indhold, som vises til kureren og returneres som contents. Maksimalt 40 tegn (f.eks. Medizinisch freigestellte Probe).
string
Valgfrie interne noter. Maksimalt 128 tegn.

Svar

Ved succes returnerer API’et 201 Created med den nye forsendelse.
string
påkrævet
Reference-id for forsendelsen (f.eks. P2604151234).
string
påkrævet
Forsendelsens livscyklusstatus. En af pending, in_transit, delivered, fault eller cancelled.
string
påkrævet
Logistikudbyder. En af go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups eller dhl_express. En hjemmekit-pakke er dhl_parcel, eller dhl_warenpost, når den sendes til udlandet som Warenpost International.
string
Eksternt sporingsnummer fra logistikudbyderen. Kan være null.
string
Fritekstbeskrivelse af pakkens indhold, som angivet ved oprettelsen. Kan være null.
string
påkrævet
Hvem der udskrev pakkelabelen: aniva eller external. En forsendelse, du opretter, er aniva.
string
Reference til den anden pakke i en forsendelse med to pakker. null for en enkeltvejspakke.
object
Afhentningsadresse. Kan være null.
object
Leveringsadresse. Samme struktur som origin. Kan være null.
object
Planlagt afhentningstidsrum. Kan være null.
string
Valgfrie noter. Kan være null.
object[]
påkrævet
Kronologiske livscyklushændelser fra logistikudbyderen (ældste først). Hver post har state, code, detail_code, status, description, location og time. Se Hent forsendelse for hvert felt. Tomt array lige efter oprettelse. Baggrundssynkroniseringen tilføjer hændelser, efterhånden som udbyderen rapporterer dem.
ShipmentAppointmentLink[]
påkrævet
Tider tilknyttet denne forsendelse, ældste tilknytning først. Hver post er { id, added_at }; slå hvert id op via Hent tid. Indeholder den tid, der eventuelt blev sendt via appointment_id, lige efter oprettelse.
ShipmentHomeKitOrderLink[]
påkrævet
Hjemmetestordrer tilknyttet denne forsendelse i samme { id, added_at }-format. Tomt array for en forsendelse, du opretter.
string
Hvornår forsendelsen sidst blev afstemt med fragtfirmaet, som UTC-tidspunkt. null indtil første synkronisering.
string
påkrævet
Tidsstempel for oprettelse (ISO 8601).
string
Tidsstempel for seneste opdatering (ISO 8601). Kan være null.

Fejlsvar