> ## Documentation Index
> Fetch the complete documentation index at: https://docs.muhasip.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Entegrasyon kabul listesi

> Entegrasyonunuzu devreye almadan önce kimlik, veri, mali işlem ve hata davranışlarını doğrulayın.

Bu kontrolleri yetkili firma ve kayıtlarla uygulayın. Yazma istekleri gerçek belge, ödeme veya sipariş kaydı oluşturabilir; yalnız onayladığınız işlemlerle ilerleyin.

| Kontrol | Beklenen davranış |
| - | - |
| Hizmete erişim | `/health` kimliksiz `200` döndürür. |
| Kimlik doğrulama | Kimliksiz `/apps` isteği ve geçersiz kimlik bilgileri `401` döndürür. |
| Anahtar geçerliliği | API kullanıcısı ve firma etkin, erişim süresi geçerli olmalıdır. |
| İzinler | İzin listesi tanımlanmışsa ilgili modül için `read` veya `write` gerekir; yazma izni tek başına okuma izni sağlamaz. |
| IP kısıtı | Tanımlı IP listesinde çıkış adresi bulunmalıdır; eşleşmeyen adres `403` döndürür. |
| Kayıt ilişkileri | Cari, hesap, fatura, proje ve alt kayıtlar aynı firmaya ait olmalıdır. |
| Bağlantı durumları | Banka, POS ve e-belge işlemlerinden önce ilgili hizmet bağlantısı etkin olmalıdır. |
| Google bağlantısı | Sorgu yalnız bağlantının kayıtlı olup olmadığını boolean olarak döndürür. |
| Yan etkili GET | Yazma izni gerekir; `HEAD` aynı işlemi başlatmadan `405` döndürür. |
| İşlem anahtarı | Gerekli çağrılarda `Idempotency-Key` olmadan istek `400` ile reddedilir. |
| Anahtar biçimi | 1–128 görünür ASCII karakteri kullanılır; boşluk ve kontrol karakterleri reddedilir. |
| Tamamlanmış tekrar | Aynı işlem ve içerik yeni mali etki oluşturmadan `replayed:true`, işlem makbuzu ve sonuç kimliklerini döndürebilir. |
| İçerik çatışması | Aynı anahtar farklı içerikle kullanıldığında `409` döner. |
| Devam eden işlem | Yeni anahtar üretmek aynı kayıt üzerinde çakışan işlemi yeniden başlatmaz. |
| Eş zamanlı mali yazma | Aynı firmada çakışan banka onayı, fatura veya pazaryeri aktarımı `409` döndürebilir; okumalar kullanılabilir. |
| İşlem durumu | `operationId` ile sonuç okunur; geçersiz veya erişilemeyen kayıt `404` döndürür. |
| Fatura taslağı | `type=view` taslak oluşturur; dönen UUID ve işlem kimliği saklanır. |
| Fatura onayı | 1–100 benzersiz UUID kullanılır; gönderim sonucu her belge için doğrulanır. |
| Fatura eşitleme | Daha önce aktarılmış UUID ikinci kayıt oluşturmaz; alt belge `operationIds` değerleri takip edilir. |
| Desteklenmeyen fatura iptali | `INVOICE_COMPLEX_PAYMENT_CANCEL_UNSUPPORTED` veya `INVOICE_EXCLUDED_SOURCE_CANCEL_UNSUPPORTED` hatasında iptal başlatılmaz. |
| Banka yenileme | Devam eden sorguda `409`, hizmet hatasında `502` döner; ek sorgu parametresi reddedilir. |
| Banka onayı | Cari, fatura, firma, yön ve para birimi eşleşir; IBAN ilgili cariye yazılır. |
| Tam fatura ödemesi | Yalnız açık ve daha önce ödeme almamış faturanın tam tutarı mahsup edilir. |
| Döviz ve kısmi ödeme | Geçersiz kur, kur farkı, kısmi veya önceden ödemeli fatura `422` döndürür; ödeme başlatılmaz. |
| Banka otomasyonu | TRY hesapları ve tek `invoice` aksiyonu kullanılır; ayarlar tamamlanır ve işlem anahtarı gönderilir. |
| Otomasyon sonucu | Bütün satırlar başarılıysa veya işlenecek hareket yoksa başarıdır; belirsiz satırda `review_required` incelenir. |
| POS hesapları | `isDefault=true` varsayılan, `false` ek hesapları seçer. Varsayılan hesabı arşivleme `409` döndürür. |
| Tahsilat bağlantısı | Dönen `orderId` ve `paymentId` saklanır; bağlantı oluşturma tahsilat yapılmış sayılmaz. |
| Tahsilat iptali | Yalnız aynı gün onaylanmış, başarılı ve henüz iade edilmemiş kayıt iptal edilir. |
| Online işlemler | `status` boolean gönderilir; güncellemede atlanan `domain` korunur. |
| Görev ve geçmiş | Liste için `page/limit`, geçmiş için `page/pageSize` kullanılır; toplamlar ayrı değerlendirilir. |
| Ajanda görünürlüğü | Ortak notlar ve API kullanıcısının oluşturduğu özel notlar okunur; başka kullanıcıların özel notları gösterilmez. |
| Takvim tarihleri | Sorgu aralığıyla kesişen etkinlikler listelenir; başlangıç tarihi bitişten sonra olamaz. |
| İş akışı alanları | Alan ve seçenek kimlikleri ilgili iş akışına ait olmalı; tekrarlanan kimlikler reddedilmelidir. |
| GİB e-Arşiv | Kesin ETTN olmadan başarı varsayılmaz; çıktı alırken `signed` boolean olarak gönderilir. |
| SMS imzası | Aynı `oid` farklı kodla kullanıldığında `409` dönebilir; kesin yanlış kod reddinden sonra yeni SMS işlemi başlatılır. |
| Hız sınırı | `429` ve varsa `Retry-After` başlığı işlenir; doğrulama için gereksiz yük oluşturulmaz. |
| Zaman aşımı | Yeni mali istek göndermeden önce işlem durumu ve ilgili kayıtlar incelenir. |
| Cevap biçimi | JSON, HTML ve dosya cevapları ilgili işlem şemasına göre ayrıştırılır. |

Beklenmeyen sonuçlarda yöntem, işlem yolu, yaklaşık zaman, HTTP kodu, hata kodu ve varsa işlem kimliğini kaydedin. Anahtar, SMS kodu, müşteri belgesi veya kişisel verileri genel loglara ve destek mesajlarına eklemeyin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.