İçeriğe geç
KuryeSoft

API başvurusu

Hazır işaretle

Paketin hazır olduğunu bildirir; atanmış kuryeye bildirim gider.
POSThttps://kurye.firmaniz.com/api/v1/orders/{ref}/ready

Mutfakta paket hazır olduğunda çağırın. Kurye atanmışsa telefonuna "Sipariş hazır" bildirimi gider; sipariş henüz bekliyorsa atama hemen yeniden denenir. Kurye firması "hazır olunca ata" senaryosunu kullanıyorsa otomatik atama ancak bu çağrıdan sonra başlar. Bkz. Hazırlık süresi.

Gövde gerekmez. Zaten hazır işaretli siparişte tekrar çağırmak zararsızdır. Hazır işareti webhook olayı üretmez.

Yol parametreleri

refmetinzorunlu
Sipariş başvurusu: sistemdeki sipariş kimliği (1842), sipariş numarası (2611200042) ya da gönderdiğiniz kimliğin başına ext: eklenmiş hali (ext:POS-10452). Bkz. Temel kavramlar.

Örnek istek

curl -X POST "https://kurye.firmaniz.com/api/v1/orders/ext:POS-10452/ready" \
  -H "X-Api-Key: $KURYESOFT_API_KEY"

Yanıt

200 Başarılı

Sipariş (hazır işaretli). Gövde bir sipariş nesnesidir.

200 · application/json
{
  "id": 1842,
  "code": "2611200042",
  "external_id": "POS-10452",
  "status": "pending",
  "status_label": "Bekliyor",
  "restaurant_id": 1,
  "tracking_url": "https://kurye.firmaniz.com/takip/oKe9xPqrlr7b_4jbNQiNCw",
  "courier": null,
  "distance_m": 1754,
  "eta_at": null,
  "delivery_fee": 70,
  "total_amount": 285.5,
  "collect_amount": 285.5,
  "created_at": "2026-11-20T18:10:32.000Z",
  "assigned_at": null,
  "picked_up_at": null,
  "delivered_at": null,
  "cancelled_at": null,
  "cancel_reason": null
}

Hatalar

Hata gövdesi her zaman { "error": { "code", "message", "fields" } } biçimindedir. Bu uçta karşılaşabileceğiniz kodlar (bütün liste için Hatalar):

API_KEY_REQUIRED
HTTP:401
Anlamı:İstekte API anahtarı yok ya da ks_ ile başlamıyor.
API_KEY_INVALID
HTTP:401
Anlamı:Anahtar yanlış, silinmiş ya da pasif.
NOT_FOUND
HTTP:404
Anlamı:Sipariş ya da işletme bulunamadı. Anahtarınızın göremediği bir işletmenin siparişi de böyle görünür.
ORDER_FINAL
HTTP:400
Anlamı:Sipariş sonuçlanmış (teslim edildi, teslim edilemedi); değiştirilemez.
İpucu:

429 RATE_LIMITED ve 5xx yanıtlarında kısa bir beklemeyle yeniden deneyin. Bkz. Yeniden deneme.