> ## 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önderiyi güncelle

> Teslim alınmadan önce gönderi ayrıntılarını değiştir

Alım programı, paket sayısı veya notlar gibi gönderi ayrıntılarını güncelle. Lojistikle ilgili herhangi bir alan değişirse (alım tarihi, saati, paket sayısı veya ağırlık), mevcut lojistik siparişi iptal edilir ve otomatik olarak yenisi oluşturulur. Belirtmediğin alanlar mevcut gönderiden korunur. Güncellenen program alanları [alım programı kuralları](https://docs.anivahealth.com/tr/concepts/shipments.md#teslim-alma-programi-kurallari) kapsamında doğrulanır.

> [!WARNING]
>
> Gönderiler alındıktan sonra değiştirilemez. Zaten alınmış bir gönderiyi güncellemeye çalışmak
> `409 Conflict` döndürür.

Bir evde test kiti paketinin etiketi zaten yazdırılmıştır, bu nedenle yalnızca `notes` değişebilir.
Bir evde test kiti paketi için yeni bir alım zaman aralığı veya ağırlık `409 Conflict` döndürür;
bunun yerine gönderiyi iptal et ve yeni bir gönderi oluştur.

Bir evde test kiti paketini güncellemek için bağlı her evde test kiti siparişi erişim bağlamında
olmalıdır. Aksi takdirde çağrı `403` döndürür. [Erişim](https://docs.anivahealth.com/tr/concepts/shipments.md#erisim) bölümüne bak.

## İstek

### Yol parametreleri

**id** `string` *required*

Gönderi referans ID'si (ör. `P2611194821`).

### Gövde parametreleri

Tüm gövde parametreleri isteğe bağlıdır — yalnızca değiştirmek istediğin alanları ekle.

**pickup\_date** `string`

`YYYY-MM-DD` biçiminde yeni alım tarihi, çıkış konumunun saat diliminde yorumlanır.

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

`HH:MM` biçiminde yeni en erken alım saati, çıkış konumunun saat diliminde yerel saat olarak
yorumlanır.

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

`HH:MM` biçiminde yeni en geç alım saati, çıkış konumunun saat diliminde yerel saat olarak
yorumlanır.

**package\_count** `integer`

Yeni paket sayısı.

**weight** `number`

Yeni ağırlık (kg).

**notes** `string`

Yeni notlar veya açıklamalar. En fazla 128 karakter.

## Yanıt

Başarılı olduğunda API, güncellenmiş gönderiyle `200 OK` döndürür.

**id** `string` *required*

Gönderi referans tanımlayıcısı.

**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`. Bu çağrıyı yalnızca `aniva` gönderileri kabul eder.

**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. Henüz bir olay gözlemlenmediyse boş dizidir.

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

Bu gönderiye bağlı randevular, en eski bağlantıdan başlayarak. Her giriş `{ id, added_at }`
şeklindedir; her `id` değerini [Randevuyu getir](https://docs.anivahealth.com/tr/api/appointments/get-appointment.md) ile
karşılaştır.
Yalnızca erişim bağlamındaki randevular listelenir.

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

Bu gönderiye bağlı ev kiti siparişleri, en eski bağlantı önce olacak şekilde, aynı `{ id, added_at }` yapısında.
Yalnızca erişim kapsamındaki siparişler listelenir. Muayenehane paketleri 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ı — örn. geçersiz tarih veya saat biçimi. |
| `403` | Yasak — API anahtarının bu işleme erişimi yok, gönderi erişim bağlamının dışında veya bağlantılı bir ev kiti siparişi erişim bağlamının dışında. |
| `404` | Gönderi bulunamadı. |
| `409` | Gönderi teslim alındıktan sonra değiştirilemez ya da etiketi yazdırılmış bir ev kiti paketidir ve istek `notes` dışında alanları değiştiriyordur. |
| `501` | Gönderi `external` durumundadır — Aniva üzerinden oluşturulmamıştır ve buradan değiştirilemez. |
| `500` | Dahili sunucu hatası. |
| `502` | Lojistik sağlayıcısı isteği reddetti (örn. iptal veya yeniden oluşturma başarısız oldu). Sağlayıcının hata mesajını içerir. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/shipments/P2611194821 \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "pickup_date": "2026-04-16",
    "pickup_time_from": "10:00",
    "pickup_time_till": "13:00"
  }'
```

```json 200 theme={null}
{
  "id": "P2611194821",
  "status": "pending",
  "logistics_provider": "go",
  "tracking_number": null,
  "contents": "Medizinisch freigestellte Probe",
  "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-16T08:00:00Z",
    "till": "2026-04-16T11:00:00Z",
    "timezone": "Europe/Berlin"
  },
  "notes": null,
  "status_updates": [],
  "appointments": [],
  "home_kit_orders": [],
  "synced_at": "2026-04-03T15:00:00Z",
  "created_at": "2026-04-03T14:30:00Z",
  "updated_at": "2026-04-03T15:10:00Z"
}
```

```json 409 theme={null}
{
  "error": "Shipment cannot be modified after pickup"
}
```

```json 502 theme={null}
{
  "error": "Logistics provider error: The cancellation notice period has already been exceeded. Cancellation is no longer possible via the web service. Please contact the GO! station.",
  "logistics_error_code": 4006
}
```


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