Talep ile Aktarım
Talebi Başarısız İşaretleme(failErpRequest)
POST/erp-requests/{id}/fail
Talebi başarısız işaretle
Son güncelleme: 21 Eylül 2026 · Sözleşme sürümü 1.0.0
ERP veriyi hazırlayamadı (cari yok, ERP kapalı…). reason panelde muhasebe personeline gösterilir (≤300 karakter; anahtar/sır içermesin — sunucu maskeler). Yalnız claim eden anahtar (ya da pending'den örtük claim). dry_run → would.fail süre ve sahipliği de hesaba katar.
Servis
| Metot | POST |
| Adres | https://mutabakat.ai/api/v1/erp-requests/{id}/fail |
| 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
İçerik türü application/json.
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| reason | string | Evet | Kullanıcıya gösterilecek kısa sebep |
Örnek gövde
{
"reason": "Cari 0001000045 ERP'de bulunamadı"
}Yanıt
200İşaretlendi
| 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>/fail \
-H "Authorization: Bearer $MAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"reason":"Cari 0001000045 ERP'de bulunamadı"}'