Talep ile Aktarım
Talebi Alma(claimErpRequest)
POST/erp-requests/{id}/claim
Talebi al ("hazırlıyorum")
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
pending → in_progress; süre en az 10 dk uzar (toplam ömür created_at + 40 dk); panelde "ERP aldı, hazırlıyor" görünür. Aynı anahtarla tekrar 200 (idempotent); başka anahtar almışsa 409 request_already_claimed — o anahtar iptal edildiyse talep sahipsiz kalır ve başka bir anahtar alabilir; açık değilse 409 request_not_active. İsteğe bağlı: doğrudan complete örtük claim yapar. dry_run → would.claim süre ve sahipliği de hesaba katar.
Servis
| Metot | POST |
| Adres | https://mutabakat.ai/api/v1/erp-requests/{id}/claim |
| Kapsam | talebin türüne göre counterparties:write / statements:write / balance:write (sıra: kayıt 404 → kapsam 403) |
| Idempotency-Key | Kabul edilir (önerilir) |
| dry_run | Destekleniyor (?dry_run=true) |
İstek Parametreleri
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| id (yol) | string (uuid) | Evet | Talep kimliği |
| dry_run (sorgu) | "true" | Hayır | true ise hiçbir şey yazılmaz; doğrulama + "ne olacak" raporu döner (yalnız bu yazım). |
| Idempotency-Key (başlık) | string | Hayır | Aynı anahtar + aynı gövde 24 saat boyunca aynı yanıtı verir (Idempotency-Replayed: true); aynı anahtar farklı gövde 409. Toplu yazma uçlarında zorunlu. |
İstek Gövdesi
Gövde alanı yoktur; boş gövde ya da {} gönderin.
Yanıt
200Alındı
| Alan | Tür | Açıklama |
|---|---|---|
| data | ErpRequest | |
| request_id | RequestId |
Hata Kodları
Bu uç için dönebilecek HTTP durumları: 400 · 401 · 403 · 404 · 409 · 429 · 500 · 503. Zarf biçimi ve kod listesi için Hata Kodları sayfasına bakın.
Örnek İstek
curl -X POST https://mutabakat.ai/api/v1/erp-requests/<id>/claim \
-H "Authorization: Bearer $MAI_API_KEY"