| 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. |
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.
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.