diff --git a/docs/quality/uygulama-durumu.md b/docs/quality/uygulama-durumu.md
index 3c83ca6..5da0624 100644
--- a/docs/quality/uygulama-durumu.md
+++ b/docs/quality/uygulama-durumu.md
@@ -12,7 +12,9 @@ Bu beş adayın canlı `/api/documents/ilan` çağrıları da read-only denendi
 
 Belge URL’si, ilan metni ve tarayıcı belge metni endpoint’leri artık 502 durumunda `code: SOURCE_UNAVAILABLE` ve `retryable: true` alanlarını döndürüyor. İstemciler kaynak kesintisini kalıcı biçim hatasından ayırıp yeniden deneme sunabilir.
 
-Doğrulama: 292/292 otomatik test geçti.
+İhale detay istemcisi bu kodu tanıyıp “Resmi ihale kaynağı geçici olarak erişilemiyor; birkaç dakika sonra yeniden deneyin” mesajına dönüştürüyor; normal 503 gibi diğer durumlar özgün HTTP hatası olarak korunuyor.
+
+Doğrulama: 292/292 otomatik test ve üretim derlemesi başarılı.
 
 ## Kanıtlanan ilk değişiklikler
 
diff --git a/src/services/tenderApi.js b/src/services/tenderApi.js
index 35cd76e..11d0d50 100644
--- a/src/services/tenderApi.js
+++ b/src/services/tenderApi.js
@@ -23,8 +23,11 @@ export async function fetchTenderDetail(tenderId, {signal, timeoutMs = 30000} =
     const searchResult=String(tenderId).startsWith('ekap-');
     const url=searchResult ? `/api/documents/ilan?ikn=${encodeURIComponent(tenderId.slice(5))}` : `/api/tenders/${encodeURIComponent(tenderId)}/detail`;
     const res = await fetch(url, {signal:controller.signal});
-    if (!res.ok) throw new Error(`Detay API hatası: HTTP ${res.status}`);
-    const data = await res.json();
+    const data = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      if (data.code === 'SOURCE_UNAVAILABLE' && data.retryable) throw new Error('Resmi ihale kaynağı geçici olarak erişilemiyor. Birkaç dakika sonra yeniden deneyin.');
+      throw new Error(`Detay API hatası: HTTP ${res.status}`);
+    }
     if (!data.success) throw new Error(data.error || 'Detay alınamadı');
     if (searchResult) {
       if (data.ikn !== tenderId.slice(5)) throw new Error('Kaynak yanıtındaki İKN aranan ihaleyle uyuşmuyor.');
diff --git a/tests/tender-detail-fetch.test.mjs b/tests/tender-detail-fetch.test.mjs
index fc552f4..736cca4 100644
--- a/tests/tender-detail-fetch.test.mjs
+++ b/tests/tender-detail-fetch.test.mjs
@@ -10,6 +10,8 @@ test('detail loading rejects empty source, supports retry and stops on timeout/c
     assert.equal((await fetchTenderDetail('ilan-1')).aciklama,'Tam ilan metni');
     globalThis.fetch=async()=>new Response('error',{status:503});
     await assert.rejects(()=>fetchTenderDetail('ilan-1'),/HTTP 503/);
+    globalThis.fetch=async()=>Response.json({success:false,code:'SOURCE_UNAVAILABLE',retryable:true,error:'kaynak yok'},{status:502});
+    await assert.rejects(()=>fetchTenderDetail('ilan-1'),/geçici olarak erişilemiyor.*yeniden deneyin/);
     globalThis.fetch=async(url,{signal})=>new Promise((resolve,reject)=>{
       if(signal.aborted) reject(new DOMException('Cancelled','AbortError'));
       else signal.addEventListener('abort',()=>reject(new DOMException('Cancelled','AbortError')),{once:true});