Sipariş İptali¶

Mevcut bir siparişi iptal etmek için bu akışı kullanın. İptaller hem sizin tarafınızdan hem de MuditaKurye tarafından başlatılabilir.

MuditaKurye Tarafından İptal (Webhook)¶

Restoran, kurye veya sistem bir siparişi iptal ettiğinde, MuditaKurye yapılandırdığınız Cancel Webhook URL'sine bildirim gönderir.

Cancel Webhook Payload¶

{
  "event": "order.canceled",
  "orderId": "order_123456",
  "yemekKuryeOrderId": "550e8400-e29b-41d4-a716-446655440000",
  "reason": "Ürün kalmadı",
  "cancelReasonId": "OUT_OF_STOCK",
  "canceledBy": "Restaurant",
  "timestamp": "2025-11-10T17:50:00+03:00"
}

İptal Nedenleri¶

`cancelReasonId`	`canceledBy`	Açıklama
`CUSTOMER_REQUEST`	Restaurant	Müşteri istedi
`OUT_OF_STOCK`	Restaurant	Ürün kalmadı
`WRONG_ADDRESS`	Courier	Adres bulunamadı
`CUSTOMER_NOT_AVAILABLE`	Courier	Müşteriye ulaşılamadı
`COURIER_NOT_AVAILABLE`	System	Kurye bulunamadı
`RESTAURANT_CLOSED`	System	Restoran kapalı
`OTHER`	Restaurant/Courier	Diğer nedenler

Sizin Tarafınızdan İptal (API'ye İstek)¶

Henüz Desteklenmiyor

Şu anda üçüncü taraf sistemlerin doğrudan API üzerinden sipariş iptal etmesi desteklenmemektedir. İptal taleplerinizi MuditaKurye destek ekibine iletmeniz gerekmektedir.

Gelecek sürümlerde DELETE /webhook/third-party/order/{orderId} endpoint'i eklenecektir.

İptal Akışı¶

sequenceDiagram
    participant POS as POS Sistemi
    participant API as MuditaKurye API
    participant Rest as Restoran

    Note over Rest: Restoran siparişi iptal eder
    Rest->>API: İptal talebi
    API->>API: Siparişi iptal et
    API->>API: Aktif kurye atamasını iptal et
    API->>POS: POST /webhook/cancel
    Note over POS: İptal payload'ını al
    POS->>POS: Kendi sisteminde siparişi kapat
    POS-->>API: HTTP 200 OK

İptal Sonrası Davranış¶

İptal edilen siparişler terminal durumdadır — başka bir duruma geçemez
DELIVERED veya CANCELED durumundaki siparişler tekrar iptal edilemez
Aktif kurye ataması varsa otomatik olarak iptal edilir
İptal webhook'u başarısız olursa retry mekanizması devreye girer

Sonraki Adım¶

Tüm webhook detayları için Webhook'lar sayfasına bakın.