Ugrás a fő tartalomhoz
POST
Küldeményrendelés létrehozása a megadott feladási helyszínről. A céllaboratóriumot a destination_lab paraméterrel adod meg. A küldemény ennek a laboratóriumnak a regisztrált szállítási címére megy. A shipments_manage scope szükséges hozzá. Küldj opcionális Idempotency-Key fejlécet, hogy a létrehozás biztonságosan újrapróbálható legyen — ugyanazzal a kulccsal megismételve az eredeti válasz érkezik vissza egy újabb létrehozása helyett. Lásd: Idempotencia.

Kérés

Törzsparaméterek

string
kötelező
A feladási teszthelyszín UUID-je. A helyszínnek aktívnak kell lennie, és az API-kulcsod hozzáférési körébe kell tartoznia. Az elérhető helyszínazonosítók lekéréséhez használd a Helyszínek listázása végpontot.
string
kötelező
Céllaboratórium. A következő értékek egyike lehet: zotzklimas, labclinic, nordicgroup, biomes, imd vagy quade. A küldemény az ehhez a laboratóriumhoz regisztrált szállítási címre megy. Regisztrált szállítási cím nélküli laboratórium esetén a válasz 400.
string
Opcionális időpont-UUID, amelyhez a küldeményt a létrehozáskor hozzákapcsolhatod. Az időpontnak az API-kulcsod hozzáférési körébe kell tartoznia. A kapcsolat beágyazott elemként jelenik meg a küldemény appointments tömbjében, és fordítva, az időpont shipments tömbjében. Ha a létrehozás után további időpontokat szeretnél csatolni, vagy eltávolítanád a kezdeti kapcsolatot, használd az Időpontok csatolása küldeményhez és az Időpontok leválasztása küldeményről végpontokat.
string
kötelező
A felvétel dátuma YYYY-MM-DD formátumban (pl. 2026-04-15), a feladási helyszín időzónájában értelmezve. Hétköznapnak (hétfő–péntek), valamint mai vagy jövőbeli napnak kell lennie. Aznapi felvétel 16:00 (Europe/Berlin) után nem érhető el.
string
kötelező
A legkorábbi felvételi idő HH:MM formátumban (pl. 09:00), a feladási helyszín időzónája szerinti helyi időként értelmezve. 09:00 és 19:00 között kell lennie.
string
kötelező
A legkésőbbi felvételi idő HH:MM formátumban (pl. 12:00), a feladási helyszín időzónája szerinti helyi időként értelmezve. 09:00 és 19:00 között kell lennie. Az időablaknak (pickup_time_till - pickup_time_from) legalább 2 órának kell lennie.
integer
alapértelmezett:"1"
Csomagok száma. Alapértelmezett érték: 1.
number
alapértelmezett:"0.5"
Tömeg kg-ban. Alapértelmezett érték: 0.5.
string
Utasítások a futárnak a felvételhez (feladói megjegyzés). Ha nincs megadva, a felvételi címhez tárolt megjegyzés lép érvénybe (vagy üres marad, ha a címhez nincs ilyen). Legfeljebb 128 karakter.
string
Szabad szöveges leírás a csomag tartalmáról, amely megjelenik a futárnak, és a válaszban contents mezőként tér vissza. Legfeljebb 40 karakter (pl. Medizinisch freigestellte Probe).
string
Opcionális belső megjegyzések. Legfeljebb 128 karakter.

Válasz

Sikeres kérés esetén az API 201 Created válasszal és az új küldeménnyel tér vissza.
string
kötelező
A küldemény referenciaazonosítója (pl. P2604151234).
string
kötelező
A küldemény életciklus-állapota. A következő értékek egyike: pending, in_transit, delivered, fault vagy cancelled.
string
kötelező
Logisztikai szolgáltató. Lehetséges értékei: go, dhl_parcel, dhl_warenpost, rotrunner, rapido, ups vagy dhl_express. Az otthoni tesztkészlet-csomag dhl_parcel, illetve dhl_warenpost, ha külföldre megy Warenpost International küldeményként.
string
A logisztikai szolgáltatótól kapott külső csomagkövetési szám. Lehet null.
string
A csomag tartalmának szabad szöveges leírása, ahogyan a létrehozáskor megadták. Lehet null.
string
kötelező
Ki nyomtatta a címkét: aniva vagy external. Az általad létrehozott küldemény értéke aniva.
string
A kétcsomagos szállítmány másik csomagjának referenciája. Egyirányú csomagnál null.
object
Felvételi cím. Lehet null.
object
Kézbesítési cím. Ugyanolyan szerkezetű, mint az origin. Lehet null.
object
Ütemezett felvételi időablak. Lehet null.
string
Opcionális megjegyzések. Lehet null.
object[]
kötelező
A logisztikai szolgáltató időrendi életciklus-eseményei (a legrégebbitől kezdve). Minden elem tartalmazza a state, code, detail_code, status, description, location és time mezőket. Az egyes mezőket lásd a Küldemény lekérdezése oldalon. A létrehozás után azonnal üres tömb. A háttérszinkronizálás hozzáadja az eseményeket, amint a szolgáltató jelenti őket.
ShipmentAppointmentLink[]
kötelező
Az ehhez a küldeményhez kapcsolt időpontok, a legrégebben kapcsolttól kezdve. Minden elem { id, added_at } formátumú; az egyes id értékeket az Időpont lekérdezése végponttal vetheted össze. Közvetlenül a létrehozás után az appointment_id mezőben megadott időpontot tartalmazza (ha volt ilyen).
ShipmentHomeKitOrderLink[]
kötelező
Az ehhez a küldeményhez kapcsolt otthoni tesztkészlet-rendelések, ugyanabban az { id, added_at } szerkezetben. Az általad létrehozott küldeményeknél üres tömb.
string
Mikor történt a küldemény utolsó egyeztetése a futárszolgálattal, UTC időpillanatként. Az első szinkronizálásig null.
string
kötelező
Létrehozási időbélyeg (ISO 8601).
string
Utolsó frissítés időbélyege (ISO 8601). Lehet null.

Hibaválaszok