> ## 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.

# Gönderi oluştur

> Belirtilen çıkış ve varış noktalarıyla bir lojistik gönderi siparişi oluştur

Belirtilen çıkış konumundan bir gönderi siparişi oluştur. Hedef laboratuvarı `destination_lab` ile belirtirsin. Gönderi, o laboratuvarın kayıtlı gönderim adresine gider.

`shipments_manage` kapsamını gerektirir.

Bu oluşturma işlemini güvenle yeniden denenebilir kılmak için isteğe bağlı bir `Idempotency-Key` başlığı gönder — aynı anahtarın tekrarı ikincisini oluşturmak yerine ilk yanıtı döndürür. [İdempotans](https://docs.anivahealth.com/tr/concepts/idempotency.md) bölümüne bak.

## İstek

### Gövde parametreleri

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

Çıkış test konumunun UUID'si. Konum aktif ve API anahtarının erişim kapsamında olmalıdır.
Mevcut konum ID'lerini bulmak için [Konumları listele](https://docs.anivahealth.com/tr/api/locations/list-locations.md) uç noktasını kullan.

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

Hedef laboratuvar. `zotzklimas`, `labclinic`, `nordicgroup`, `biomes`, `imd` veya
`quade` değerlerinden biri. Gönderi, bu laboratuvar için kayıtlı gönderim adresine gider. Kayıtlı gönderim
adresi olmayan bir laboratuvar `400` döndürür.

**appointment\_id** `string`

Oluşturma sırasında bu gönderiye bağlanacak isteğe bağlı randevu UUID'si. Randevu, API
anahtarının erişim kapsamında olmalıdır. Bağlantı, gönderinin `appointments` dizisinde bir giriş
olarak, karşılığında da randevunun `shipments` dizisinde bir giriş olarak görünür. Oluşturma sonrasında
ek randevular bağlamak veya ilk bağlantıyı kaldırmak için [Randevuları gönderiye
bağla](https://docs.anivahealth.com/tr/api/shipments/attach-appointments-to-shipment.md) ve [Randevuları gönderiden
ayır](https://docs.anivahealth.com/tr/api/shipments/detach-appointments-from-shipment.md) uç noktalarını kullan.

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

`YYYY-MM-DD` biçiminde alım tarihi (ör. `2026-04-15`), çıkış konumunun saat dilimine göre
yorumlanır. Hafta içi bir gün (Pazartesi–Cuma), bugün veya gelecekte bir tarih olmalıdır. Europe/Berlin saatine göre 16:00'dan
sonra aynı gün alım yapılamaz.

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

`HH:MM` biçiminde en erken alım saati (ör. `09:00`), çıkış konumunun saat dilimindeki yerel saat
olarak yorumlanır. `09:00` ile `19:00` arasında olmalıdır.

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

`HH:MM` biçiminde en geç alım saati (ör. `12:00`), çıkış konumunun saat dilimindeki yerel saat
olarak yorumlanır. `09:00` ile `19:00` arasında olmalıdır. Aralık (`pickup_time_till -
    pickup_time_from`) en az 2 saat olmalıdır.

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

Paket sayısı. Varsayılan olarak `1` kullanılır.

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

kg cinsinden ağırlık. Varsayılan olarak `0.5` kullanılır.

**pickup\_remarks** `string`

Alım sırasında kurye için talimatlar (gönderici notları). Belirtilmediğinde, alım adresinin
kayıtlı notları kullanılır (adreste yoksa hiçbiri kullanılmaz). En fazla 128 karakter.

**contents** `string`

Paketin içinde ne olduğuna dair serbest metin açıklaması, kuryeye gösterilir ve `contents` olarak
geri döndürülür. En fazla 40 karakter (ör. `Medizinisch freigestellte Probe`).

**notes** `string`

İsteğe bağlı dahili notlar. En fazla 128 karakter.

## Yanıt

Başarılı olduğunda API, yeni gönderi ile birlikte `201 Created` döndürür.

**id** `string` *required*

Gönderi referans kimliği (ör. `P2604151234`).

**status** `string` *required*

Gönderi yaşam döngüsü durumu. `pending`, `in_transit`, `delivered`, `fault` veya `cancelled` değerlerinden biri.

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

Lojistik sağlayıcı. `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` veya `dhl_express` değerlerinden biri. Ev kiti paketi `dhl_parcel` veya yurt dışına Warenpost International olarak
gittiğinde `dhl_warenpost` olur.

**tracking\_number** `string`

Lojistik sağlayıcıdan alınan harici takip numarası. `null` olabilir.

**contents** `string`

Oluşturma sırasında belirtildiği şekliyle paketin içeriğine dair serbest metin açıklaması. `null` olabilir.

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

Etiketi kimin yazdırdığı: `aniva` veya `external`. Oluşturduğun bir gönderi `aniva` olur.

**paired\_with** `string`

İki paketli bir sevkiyattaki diğer paketin referansı. Tek yönlü bir paket için `null`.

**origin** `object`

Alım adresi. `null` olabilir.

**adres nesnesi**

**name** `string` *required*

Alıcı, şirket veya konum adı.

**company\_name** `string`

Şirket / c/o satırı. `null` olabilir.

**street** `string` *required*

Kapı numarası olmadan sokak adı.

**house\_number** `string`

Kapı numarası. `null` olabilir.

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

Bina, giriş veya kat. `null` olabilir.

**city** `string` *required*

Şehir.

**state** `string`

Eyalet veya il. `null` olabilir.

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

Posta kodu.

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

ISO 3166-1 alpha-2 ülke kodu.

**phone** `string`

İletişim telefon numarası. `null` olabilir.

**email** `string`

İletişim e-postası. `null` olabilir.

**destination** `object`

Teslimat adresi. `origin` ile aynı yapıdadır. `null` olabilir.

**pickup** `object`

Planlanan alım aralığı. `null` olabilir.

**pickup nesnesi**

**from** `string` *required*

Alım aralığının UTC zamanı olarak başlangıcı (`Z` son ekli ISO 8601).

**till** `string` *required*

Alım aralığının UTC zamanı olarak bitişi (`Z` son ekli ISO 8601).

**timezone** `string` *required*

Alım konumunun IANA saat dilimi (ör. `Europe/Berlin`). `from` / `till` değerlerini alım konumunun yerel saatinde göstermek için kullan.

**notes** `string`

İsteğe bağlı notlar. `null` olabilir.

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

Lojistik sağlayıcıdan gelen kronolojik yaşam döngüsü olayları (en eskisi önce). Her girişte
`state`, `code`, `detail_code`, `status`, `description`, `location` ve `time` bulunur. Her alan için [Gönderiyi
getir](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) sayfasına bak. Oluşturulduktan hemen sonra boş dizidir.
Arka plan senkronizasyonu, sağlayıcı bildirdikçe olayları ekler.

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

Bu gönderiye bağlı randevular, en eski bağlantı önce olacak şekilde. Her giriş `{ id, added_at }` biçimindedir;
her `id` değerini [Randevuyu getir](https://docs.anivahealth.com/tr/api/appointments/get-appointment.md) ile karşılaştır.
Oluşturulduktan hemen sonra, varsa `appointment_id` ile iletilen randevuyu içerir.

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

Bu gönderiye bağlı ev kiti siparişleri, aynı `{ id, added_at }` yapısında. Oluşturduğun bir
gönderi için boş dizidir.

**synced\_at** `string`

Gönderinin kargo şirketiyle en son ne zaman eşleştirildiği, UTC zamanı olarak. İlk
senkronizasyona kadar `null`.

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

Oluşturulma zaman damgası (ISO 8601).

**updated\_at** `string`

Son güncelleme zaman damgası (ISO 8601). `null` olabilir.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — ör. geçersiz tarih biçimi, hafta sonu tarihi, alım aralığının çok dar olması, aynı gün için son saatin aşılması. `destination_lab` veya çıkış konumunun kayıtlı bir adresi olmadığında da döndürülür. |
| `403` | Erişim engellendi — API anahtarının bu işleme erişimi yok veya konum erişim kapsamının dışında. |
| `404` | Konum bulunamadı veya aktif değil ya da `appointment_id` verildi ancak randevu mevcut değil. |
| `409` | `Idempotency-Key` zaten farklı bir istek gövdesiyle kullanıldı veya ilk isteği henüz tamamlanmadı. |
| `500` | Dahili sunucu hatası. |
| `502` | Lojistik sağlayıcı isteği reddetti. Sağlayıcının hata mesajını içerir. |

```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.