> ## 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 iptal et

> Bir gönderi siparişini iptal et

Bir gönderi siparişini iptal et. Bu işlem, siparişi iptal etmek için lojistik sağlayıcı API'sini çağırır ve gönderi durumunu `cancelled` olarak günceller.

Zaten `cancelled` durumundaki bir gönderiyi iptal etmek bu gönderiyle birlikte `200` döndürür ve sağlayıcı yalnızca bir kez çağrılır. Tekrarlanan çağrıyı işlemi gerçekleştiren çağrıdan ayırt edebilmen için yanıt `Idempotent-Replayed: true` başlığını içerir. Bkz. [İdempotentlik](https://docs.anivahealth.com/tr/concepts/idempotency.md).

> [!WARNING]
>
> Gönderiler alımdan sonra iptal edilemez — bu durumda `409 Conflict` döner.

Bir DHL iade etiketi tek başına iptal edilemez; bu da `409 Conflict` döndürür. Bunun yerine
gidiş paketini iptal et. Bir DHL gidiş paketini iptal etmek, `pending` durumundaki dönüş aşaması
satırlarını da iptal eder. Her biri, `status_updates` içinde `RETURN_LEG_CANCELLED` kaydıyla `cancelled` durumuna geçer. Bkz.
[İade etiketleri](https://docs.anivahealth.com/tr/concepts/shipments.md#iade-etiketleri).

Birden fazla kit içeren bir kutuda, kutu tek bir kitin etiketiyle gönderilse bile her kitin kendi gidiş satırı ve kendi iade etiketi
vardır. Bir kitin gidiş satırını iptal etmek, o kitin iade etiketini de
iptal eder.

Bir ev kiti paketini iptal etmek için bağlı tüm ev kiti siparişlerinin erişim bağlamında olması gerekir.
Aksi halde çağrı `403` döndürür. Bkz. [Erişim](https://docs.anivahealth.com/tr/concepts/shipments.md#erisim).

## İstek

### Yol parametreleri

**id** `string` *required*

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

## Yanıt

Başarılı olduğunda API, iptal edilen gönderi nesnesiyle birlikte `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. Başarılı bir iptalden sonra `cancelled` olur.

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

**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*

İptalden önce bu gönderiye bağlı olan randevular. 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.
Yalnızca erişim kapsamı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` | Geçersiz ID biçimi. |
| `403` | Erişim engellendi — API anahtarının bu işleme erişimi yok, gönderi erişim kapsamının dışında veya bağlı bir ev kiti siparişi erişim kapsamının dışında. |
| `404` | Gönderi bulunamadı. |
| `409` | Gönderi iptal edilemez — zaten alınmış veya teslim edilmiş ya da bir DHL iade etiketi (bunun yerine giden paketi iptal et). |
| `501` | Gönderi `external` — Aniva üzerinden oluşturulmadı ve buradan iptal edilemez. |
| `500` | Dahili sunucu hatası. |
| `502` | Lojistik sağlayıcı isteği reddetti (ör. iptal süresi geçti). Sağlayıcının hata mesajını içerir. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/shipments/P2611194821 \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "P2611194821",
  "status": "cancelled",
  "logistics_provider": "go",
  "tracking_number": "GO1234567890",
  "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-15T07:00:00Z",
    "till": "2026-04-15T10: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-03T16:45:00Z"
}
```

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

```json 409 (return label) theme={null}
{
  "error": "Shipment K260904P3XD is the return label of K2609041FQ7. DHL cannot cancel a return label on its own. Cancel the outbound parcel while it is pending. After the outbound parcel ships, the label stays valid and Aniva closes this shipment manually."
}
```

```json 403 (Aniva-managed parcel) theme={null}
{
  "error": "Access denied: only Aniva can change this parcel."
}
```

```json 404 theme={null}
{
  "error": "Shipment not found"
}
```

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