> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Izveidot sūtījumu

> Izveidot loģistikas sūtījuma pasūtījumu ar norādītu sākumpunktu un galamērķi

Izveido sūtījuma pasūtījumu no norādītās izcelsmes vietas. Galamērķa laboratoriju norādi ar `destination_lab`. Sūtījums tiek nosūtīts uz šīs laboratorijas reģistrēto piegādes adresi.

Nepieciešams `shipments_manage` tvērums.

Nosūti neobligātu `Idempotency-Key` galveni, lai šo izveides pieprasījumu varētu droši atkārtot — atkārtojot to pašu atslēgu, tiek atgriezta sākotnējā atbilde, nevis izveidots otrs pieraksts. Skati [Idempotence](https://docs.anivahealth.com/lv/concepts/idempotency.md).

## Pieprasījums

### Pieprasījuma satura parametri

**location\_id** `string` *required*

Izcelsmes testēšanas vietas UUID. Atrašanās vietai jābūt aktīvai un tavas API atslēgas piekļuves kontekstā.
Lai atrastu pieejamos atrašanās vietu ID, izmanto [Uzskaitīt atrašanās vietas](https://docs.anivahealth.com/lv/api/locations/list-locations.md).

**destination\_lab** `string` *required*

Galamērķa laboratorija. Viena no šīm vērtībām: `zotzklimas`, `labclinic`, `nordicgroup`, `biomes`, `imd` vai
`quade`. Sūtījums tiek nosūtīts uz šai laboratorijai reģistrēto piegādes adresi. Ja laboratorijai
nav reģistrētas piegādes adreses, tiek atgriezts `400`.

**appointment\_id** `string`

Neobligāts pieraksta UUID, ko sasaistīt ar šo sūtījumu izveides brīdī. Pierakstam jābūt
tavas API atslēgas piekļuves kontekstā. Saite parādās tieši kā ieraksts sūtījuma
`appointments` masīvā un attiecīgi kā ieraksts pieraksta `shipments` masīvā. Lai pēc izveides
pievienotu papildu pierakstus vai noņemtu sākotnējo saiti, izmanto [Pievienot pierakstus
sūtījumam](https://docs.anivahealth.com/lv/api/shipments/attach-appointments-to-shipment.md) un [Atvienot pierakstus no
sūtījuma](https://docs.anivahealth.com/lv/api/shipments/detach-appointments-from-shipment.md).

**pickup\_date** `string` *required*

Paņemšanas datums formātā `YYYY-MM-DD` (piem., `2026-04-15`), kas tiek interpretēts izcelsmes vietas
laika joslā. Jābūt darba dienai (pirmdiena–piektdiena), šodienai vai nākotnē. Paņemšana tajā pašā dienā nav
pieejama pēc 16:00 (Europe/Berlin).

**pickup\_time\_from** `string` *required*

Agrākais paņemšanas laiks formātā `HH:MM` (piem., `09:00`), kas tiek interpretēts kā vietējais laiks
izcelsmes vietas laika joslā. Jābūt no `09:00` līdz `19:00`.

**pickup\_time\_till** `string` *required*

Vēlākais paņemšanas laiks formātā `HH:MM` (piem., `12:00`), kas tiek interpretēts kā vietējais laiks izcelsmes
vietas laika joslā. Jābūt no `09:00` līdz `19:00`. Laika logam (`pickup_time_till -
    pickup_time_from`) jābūt vismaz 2 stundas garam.

**package\_count** `integer` (default: 1)

Paku skaits. Noklusējuma vērtība ir `1`.

**weight** `number` (default: 0.5)

Svars kg. Noklusējuma vērtība ir `0.5`.

**pickup\_remarks** `string`

Norādījumi kurjeram paņemšanas brīdī (nosūtītāja piezīmes). Ja tas netiek norādīts, tiek izmantotas
paņemšanas adresē saglabātās piezīmes (vai nekādas, ja adresei to nav). Ne vairāk kā 128 rakstzīmes.

**contents** `string`

Brīva teksta apraksts par pakas saturu, kas tiek parādīts kurjeram un atgriezts kā
`contents`. Ne vairāk kā 40 rakstzīmes (piem., `Medizinisch freigestellte Probe`).

**notes** `string`

Neobligātas iekšējās piezīmes. Ne vairāk kā 128 rakstzīmes.

## Atbilde

Veiksmīgas darbības gadījumā API atgriež `201 Created` ar jauno sūtījumu.

**id** `string` *required*

Sūtījuma atsauces identifikators (piem., `P2604151234`).

**status** `string` *required*

Sūtījuma dzīves cikla statuss. Viena no šīm vērtībām: `pending`, `in_transit`, `delivered`, `fault` vai `cancelled`.

**logistics\_provider** `string` *required*

Loģistikas pakalpojumu sniedzējs. Viena no vērtībām: `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` vai `dhl_express`. Mājas komplekta paka ir `dhl_parcel` vai `dhl_warenpost`, ja tā dodas uz ārzemēm
kā Warenpost International.

**tracking\_number** `string`

Loģistikas pakalpojumu sniedzēja ārējais izsekošanas numurs. Var būt `null`.

**contents** `string`

Brīvā teksta apraksts par pakas saturu, kā norādīts izveides brīdī. Var būt `null`.

**booked\_by** `string` *required*

Kas izdrukāja etiķeti: `aniva` vai `external`. Tevis izveidots sūtījums ir `aniva`.

**paired\_with** `string`

Otras pakas atsauce divu paku sūtījumā. `null` vienvirziena pakai.

**origin** `object`

Paņemšanas adrese. Var būt `null`.

**adreses objekts**

**name** `string` *required*

Saņēmēja, uzņēmuma vai atrašanās vietas nosaukums.

**company\_name** `string`

Uzņēmuma / c/o rinda. Var būt `null`.

**street** `string` *required*

Ielas nosaukums bez mājas numura.

**house\_number** `string`

Mājas numurs. Var būt `null`.

**address\_line\_2** `string`

Ēka, ieeja vai stāvs. Var būt `null`.

**city** `string` *required*

Pilsēta.

**state** `string`

Štats vai province. Var būt `null`.

**postal\_code** `string` *required*

Pasta indekss.

**country\_code** `string` *required*

ISO 3166-1 alpha-2 valsts kods.

**phone** `string`

Kontakttālruņa numurs. Var būt `null`.

**email** `string`

Kontakta e-pasts. Var būt `null`.

**destination** `object`

Piegādes adrese. Tāda pati struktūra kā `origin`. Var būt `null`.

**pickup** `object`

Ieplānotais paņemšanas laika logs. Var būt `null`.

**pickup objekts**

**from** `string` *required*

Paņemšanas laika loga sākums kā UTC laika punkts (ISO 8601 ar `Z` sufiksu).

**till** `string` *required*

Paņemšanas laika loga beigas kā UTC laika punkts (ISO 8601 ar `Z` sufiksu).

**timezone** `string` *required*

Paņemšanas vietas IANA laika josla (piem., `Europe/Berlin`). Izmanto, lai parādītu `from` / `till` paņemšanas vietas vietējā laikā.

**notes** `string`

Neobligātas piezīmes. Var būt `null`.

**status\_updates** `object[]` *required*

Hronoloģiski loģistikas pakalpojumu sniedzēja dzīves cikla notikumi (vecākie vispirms). Katram ierakstam ir
`state`, `code`, `detail_code`, `status`, `description`, `location` un `time`. Katra lauka aprakstu skati sadaļā [Iegūt
sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md). Uzreiz pēc izveides tas ir tukšs masīvs.
Fona sinhronizācija pievieno notikumus, tiklīdz pakalpojumu sniedzējs par tiem ziņo.

**appointments** `ShipmentAppointmentLink[]` *required*

Ar šo sūtījumu saistītie pieraksti, sākot ar vecāko saiti. Katrs ieraksts ir `{ id, added_at }`;
katru `id` pārbaudi ar [Iegūt pierakstu](https://docs.anivahealth.com/lv/api/appointments/get-appointment.md).
Uzreiz pēc izveides satur ar `appointment_id` padoto pierakstu (ja tāds ir).

**home\_kit\_orders** `ShipmentHomeKitOrderLink[]` *required*

Ar šo sūtījumu saistītie mājas komplektu pasūtījumi tādā pašā `{ id, added_at }` formā. Tevis izveidotam
sūtījumam tas ir tukšs masīvs.

**synced\_at** `string`

Laiks, kad sūtījums pēdējo reizi tika salāgots ar pārvadātāju, kā UTC laika punkts. `null` līdz pirmajai
sinhronizācijai.

**created\_at** `string` *required*

Izveides laikspiedols (ISO 8601).

**updated\_at** `string`

Pēdējās atjaunināšanas laikspiedols (ISO 8601). Var būt `null`.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — piem., nederīgs datuma formāts, nedēļas nogales datums, pārāk šaurs paņemšanas laika logs, pārsniegts tās pašas dienas pieteikšanas laiks. Tiek atgriezts arī tad, ja `destination_lab` vai izcelsmes vietai nav reģistrētas adreses. |
| `403` | Aizliegts — tavai API atslēgai nav piekļuves šai darbībai vai atrašanās vieta ir ārpus tava piekļuves konteksta. |
| `404` | Atrašanās vieta nav atrasta vai nav aktīva, vai tika norādīts `appointment_id`, bet pieraksts neeksistē. |
| `409` | `Idempotency-Key` jau tika izmantots ar citu pieprasījuma pamattekstu, vai tā sākotnējais pieprasījums vēl nav pabeigts. |
| `500` | Iekšēja servera kļūda. |
| `502` | Loģistikas pakalpojumu sniedzējs noraidīja pieprasījumu. Ietver pakalpojumu sniedzēja kļūdas ziņojumu. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/shipments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "destination_lab": "labclinic",
    "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
    "pickup_date": "2026-04-15",
    "pickup_time_from": "09:00",
    "pickup_time_till": "12:00",
    "notes": "Handle with care — temperature-sensitive samples"
  }'
```

```json 201 theme={null}
{
  "id": "P2611194821",
  "status": "pending",
  "logistics_provider": "go",
  "tracking_number": null,
  "contents": null,
  "booked_by": "aniva",
  "paired_with": null,
  "origin": {
    "name": "Aniva Berlin Mitte",
    "company_name": null,
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "postal_code": "10117",
    "city": "Berlin",
    "state": null,
    "country_code": "DE",
    "phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com"
  },
  "destination": {
    "name": "LabClinic GmbH",
    "company_name": null,
    "street": "Laborstraße",
    "house_number": "10",
    "address_line_2": null,
    "postal_code": "80331",
    "city": "München",
    "state": null,
    "country_code": "DE",
    "phone": null,
    "email": null
  },
  "pickup": {
    "from": "2026-04-15T07:00:00Z",
    "till": "2026-04-15T10:00:00Z",
    "timezone": "Europe/Berlin"
  },
  "notes": "Handle with care — temperature-sensitive samples",
  "status_updates": [],
  "appointments": [
    {
      "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "home_kit_orders": [],
  "synced_at": null,
  "created_at": "2026-04-15T07:00:00Z",
  "updated_at": null
}
```

```json 400 theme={null}
{
  "error": "pickup_date must be a weekday (Monday–Friday)"
}
```

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```

```json 502 theme={null}
{
  "error": "Logistics provider error: Pickup on weekend/holiday not possible",
  "logistics_error_code": 2001
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.